Commit graph

28 commits

Author SHA1 Message Date
Colin Walters
8083452d6f docs: Describe one mechanism for "targeted" updates
Came up in downstream discussions.

Signed-off-by: Colin Walters <walters@verbum.org>
2025-06-17 11:48:25 -04:00
Colin Walters
d66a444b33 docs: Rebrand custom base -> from scratch
Per discussion, "from scratch" is more descriptive of what's
going on. Every bootc base image is custom in a sense.

Also, link the from scratch flow from the "don't run dnf -y update"
section, as folks doing that probably want scratch builds
instead.

Signed-off-by: Colin Walters <walters@verbum.org>
2025-05-13 06:47:52 -04:00
Valentin Rothberg
d2fa0a5428 use fedora-bootc:42
Update the reference to the Fedora images to the newly released 42.

Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
2025-04-28 09:27:31 +02:00
arburka
eec5bfbf06 moved config content to building-containers.adoc 2025-04-01 13:57:32 +00:00
Valentin Rothberg
1549613a7f docs: change refs to old bootc docs URL to new variable
Move all references to the previous docs site to the new variable.

Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
2025-03-13 10:31:26 +01:00
Valentin Rothberg
943d5bdb8a kernel management: fix heredoc
The `<<` did not render correctly.

Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
2025-03-13 10:19:24 +01:00
Valentin Rothberg
762d321483 best practices: fix unit rendering
I missed one dash for the opening and closing of the source.

Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
2025-03-12 16:31:45 +01:00
Valentin Rothberg
13595f14e5 best practices: elaborate on build environment
Certain things do not work in a container-build environment that are
worth mentioning.  Overall, I expect this section to evolve over time
and maybe turn into something more formal.

Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
2025-03-12 14:11:25 +01:00
69bdcd90e4 building-containers: Add kernel management examples 2025-03-05 17:19:44 -05:00
Valentin Rothberg
c6348ac124 building containers: fix links
Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
2025-01-23 17:09:51 +01:00
Valentin Rothberg
c455924e52 Merge branch 'doc-usergroup-packages' into 'main'
building: Talk about RPMs and useradd

See merge request fedora/bootc/docs!82
2025-01-23 09:18:43 +00:00
Colin Walters
00a3ab5a20 building: Talk about RPMs and useradd
xref https://gitlab.com/fedora/bootc/tracker/-/issues/50
2025-01-22 13:43:32 -05:00
Valentin Rothberg
532c8fa7cf building containers: mention GH Actions
Document a trick to free up space on the runner to increase the chances
of not running into a space issue.

Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
2024-12-15 18:07:49 +01:00
Valentin Rothberg
d0e73bf45b building containers: recommend bootc-container-lint
Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
2024-12-12 16:20:47 +01:00
Valentin Rothberg
4255d9b03a building containers: drop /etc/alternatives section
The referened issue has been fixed in the meantime, so don't bother
users with it.  /etc/alternatives just works today.

Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
2024-12-12 10:30:41 +01:00
Colin Walters
47b18a42d6 docs: Avoid dnf -y update
It will just break for too many things today unfortunately.

Signed-off-by: Colin Walters <walters@verbum.org>
2024-11-08 14:36:39 -05:00
Valentin Rothberg
8cc78a6970 building derived images: add best practices
Based on some lessons I've learned this week, I figured to share them in
form of best practices in the docs.  I believe those will help users
during the on-boarding process and can be further improved and extended.

Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
2024-07-12 09:42:54 +02:00
Valentin Rothberg
3e8331e0d0 build derived bootc images: mention Dockerfiles
I want to be explicit on mentioning Dockerfiles as a way to customize
base bootc images.  It is somehow implied but not explicitly mentioned
until the http example.

Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
2024-06-25 13:27:59 +02:00
Colin Walters
174b8ece65 tree-wide: Drop double spaces
This is a habit that has just been deeply ingrained and I have
a hard time breaking...but it's long since gone out of style.
2024-05-03 18:37:41 -04:00
b0764f738e
Miscellaneous tweaks and fixes
Since this repo is still in flux, it didn't seem worth trying to
meticulously split out smaller commits.

Briefly:
- fix/improve the rendering of various boxes/paragraphs/code blocks
- fix some links
- use Fedora for one of the httpd example; add fix required for that
- define the `caddy.container` file before the `Containerfile` since the
  latter references the former
- remove some repetitions
- use codestyle for the quay.io/ references
- reference the minimal image built from the same official repo instead
  of the experimental one for consistency
2024-05-02 15:15:45 -04:00
faeb7e4e98 building-containers: Add missing link in example Containerfile
Signed-off-by: John Eckersberg <jeckersb@redhat.com>
2024-04-29 16:45:30 -04:00
abe926fffb docs: add attribute for podman-docs
Signed-off-by: John Eckersberg <jeckersb@redhat.com>
2024-04-29 16:43:03 -04:00
2dd236a1c3 building-containers: fix incorrect link text syntax
Signed-off-by: John Eckersberg <jeckersb@redhat.com>
2024-04-29 16:18:54 -04:00
Colin Walters
785a4c8666 Tweak examples section 2024-04-27 17:24:11 -04:00
Colin Walters
9ab6e39c22 Add vsphere, more agent, authentication work 2024-04-21 12:12:50 -04:00
Colin Walters
b836d5592f More virt/authentication work 2024-04-21 10:21:43 -04:00
Colin Walters
b5bc2ddeff Link container builds 2024-04-20 17:48:20 -04:00
Colin Walters
e872031ccd A lot more, add AWS etc 2024-04-11 21:32:55 -04:00