Commit Graph

46 Commits

Author SHA1 Message Date
Liora Milbaum 686e0a5d4b centos-bootc-layered repo moved to gitlab.com 2024-02-12 09:39:34 +02:00
Liora Milbaum 41fd73cd82 markdownlint reporting error - line too long 2024-02-05 20:41:52 +02:00
Ben Breard 68bfea510c Update usage.md for air-gapped & disconnected updates
I added steps to move container image updates around with skopeo and apply them with bootc. Please double check that this is correc! It works really well on my side, but I'm unsure if bootc edit is a better option for changing where the update is pulled from.
2024-02-05 11:06:39 -05:00
Colin Walters 8c72e66bb0
Merge pull request #205 from cgwalters/doc-bootc-and-systemd-creds
docs/install: Doc direct bootc raw and systemd creds
2024-01-26 15:51:47 -05:00
Colin Walters 45124baff7 docs: Talk about ostree container commit
Came up in chat.
2024-01-25 16:28:52 -05:00
Colin Walters 95ca7361e9 docs: Update now that bib supports c9s now
Hooray!
2024-01-25 15:28:11 -05:00
Colin Walters dabf837e32 docs/install: Doc direct bootc raw and systemd creds
First, we're still in a situation where bib doesn't work with c9s.
Let's link to the existing docs for using `bootc install to-disk`
which *does* work (and fixes multiple other bugs at the same time too).

Second: Let's document using systemd credentials to inject a root
SSH key, because this works across every image we ship where
one can inject SMBIOS bits.  (But notably this doesn't work in
most production IaaS virt systems like KubeVirt, AWS etc. which
gets into cloud agents).
2024-01-25 09:55:00 -05:00
Colin Walters 73135ea845 docs/install: two minor tweaks
Mainly wanted to clarify the ISO situation.

Signed-off-by: Colin Walters <walters@verbum.org>
2024-01-24 18:10:45 -05:00
Colin Walters d893dd2aa7 docs/install: Cleanup, move bib earlier
Move bib earlier than anaconda as a more likely entrypoint.
2024-01-24 08:56:47 -05:00
Colin Walters 257cbde2d7
Merge pull request #169 from cgwalters/doc-units
docs: Explain about the `systemctl enable` trap
2024-01-23 02:15:10 -05:00
Colin Walters 568428be35
Update docs/usage.md
Co-authored-by: Valentin Rothberg <vrothberg@redhat.com>
2024-01-22 08:01:58 -05:00
Colin Walters 856e206ec4
Update docs/usage.md
Co-authored-by: Valentin Rothberg <vrothberg@redhat.com>
2024-01-22 08:01:54 -05:00
Colin Walters c93512c6b1 usage: Describe filesystem semantics
I was a bit confused into thinking our `-dev` images had
`root.transient` on, but they don't quite right now because
we don't regenerate the initramfs after installing the updated
ostree in that image.

However, because bootc-image-builder today is throwing away
the immutable bit on `/` (a different bug, see
https://github.com/ostreedev/ostree/pull/3094 ) we actually...
amazingly get a very similar effect in practice!

Anyways, let's go ahead and describe filesystem state here.
2024-01-21 11:11:17 -05:00
Colin Walters abb6a025c2 docs: Explain about the `systemctl enable` trap 2024-01-19 14:48:38 -05:00
Colin Walters 820837e765 docs/usage: New doc
There is some overlap with `install.md`, but that doc is all about
how to just get started.

This doc aims to cover things that are somewhat different about
the base image we ship here versus just what one might get
from installing the same RPM packages.

The automatic updates being on by default is a big one.

Signed-off-by: Colin Walters <walters@verbum.org>
2024-01-19 09:44:59 -05:00
Colin Walters 0a935522b1 docs: Describe how to avoid home directory persistence
Since many if not most of our initial target use cases I think
don't want this.

Signed-off-by: Colin Walters <walters@verbum.org>
2024-01-18 10:35:02 -05:00
Colin Walters c3124cad03 docs: Link a commonly hit issue
(I also pinned that and one other issue on that repo)
2024-01-10 13:30:46 -05:00
Daniel J Walsh f245a4feaf
Merge pull request #109 from cgwalters/add-examples-link
docs: Link to existing example repo
2023-12-22 08:02:23 -05:00
sallyom 6e56f66f5b update docs for bootc release 0.1.5
Signed-off-by: sallyom <somalley@redhat.com>
2023-12-20 13:13:27 -05:00
Colin Walters 948f774a70
Merge pull request #72 from poncovka/main-reqpart
docs: Remove workarounds from example.ks
2023-12-15 14:05:15 -05:00
Vendula Poncova 4886760829
docs: Mention releases that support example.ks
The kickstart file works with a Fedora 40+ (or ELN) installer ISO as
it requires https://github.com/rhinstaller/anaconda/pull/5342.

Co-authored-by: Colin Walters <walters@verbum.org>
2023-12-15 16:01:55 +01:00
Vendula Poncova 60d1992cb9
docs: Use reqpart in example.ks
The partitioning defined in the example kickstart file suggests that the
installer supports hybrid boot. That's misleading and not true. Let's use
the `reqpart` kickstart command to automatically create partitions required
by the detected platform instead of creating all of them for all platforms.

Note: The `reqpart` command doesn't work with `bootloader --location=none` or
`bootloader --disabled`, so this commit depends on the installer's support
for bootupd: https://github.com/rhinstaller/anaconda/pull/5298/
2023-12-15 16:01:54 +01:00
Vendula Poncova 807e82dde4
docs: Remove the bootupd workaround from example.ks
The installer supports bootupd now, so we can drop the workaround.
See: https://github.com/rhinstaller/anaconda/pull/5298/
2023-12-15 16:01:41 +01:00
Colin Walters 36041681ae docs: Link to existing example repo
I've started to put more content there.
2023-12-14 15:31:46 -05:00
Colin Walters a586acb8f5 docs: Add users and groups
Since this is a complex tricky topic.
2023-12-14 15:31:01 -05:00
Colin Walters 9149bc46eb docs: Add a builds.md
About time we start this.
2023-12-08 12:51:16 -05:00
Colin Walters ffc99c53cc docs/install: Link bootc-playground
Since it's got more fleshed out bits here.
2023-12-04 08:52:26 -05:00
Colin Walters d0718b2ed5 docs/install: Add ssh-key-dir workaround
We broke the FCOS switch with ec478a0a1b
because `ssh-key-dir` is not in ELN.  That's fixable but
for now let's document the current state.
2023-11-29 11:57:48 -05:00
Colin Walters ec10e79696
Merge pull request #75 from cgwalters/cloud-image-cleanup
docs/install: Fix cloud image link
2023-11-28 09:55:29 -05:00
Colin Walters dfd8d8e142 docs/install: Fix cloud image link
This moved in a recent PR.
2023-11-28 09:48:08 -05:00
Colin Walters 18be4b77fe install: Link osbuild-deploy-container 2023-11-28 09:45:04 -05:00
Colin Walters aef532fa34 docs: Tweak install a bit
Emphasize the accounts issue, suggest starting with cloud image.
2023-11-27 16:31:28 -05:00
Colin Walters 0047381f0d docs: Consolidate related projects 2023-11-27 16:31:28 -05:00
Colin Walters 0eebde9936 docs: Fix goals order 2023-11-27 15:53:31 -05:00
Liora Milbaum 03033108a5 Mass rename tier-1/boot => bootc 2023-11-23 14:42:56 +02:00
Colin Walters b1cbe4e900 docs: Link to new stream9 image and layered, dev images 2023-11-19 15:02:43 -05:00
Colin Walters cc83572a63 docs/example.ks: Update
We now have the static configs in bootupd, which significantly
simplifies this.  Still need to land the Anaconda PR.
2023-11-19 14:52:51 -05:00
Liora Milbaum 6bac286d87 Fix markdown linting errors 2023-11-13 12:17:07 +02:00
Colin Walters 6781666c0e docs/install: Link to cloud image
Many will find this easiest.
2023-11-12 17:54:18 -05:00
Timothée Ravier 3fab046f4b docs: Fix page ordering 2023-11-09 17:15:22 +01:00
Colin Walters 705afcb29b docs: More fixes
Put container image reference first, other cleanups.
2023-11-08 20:24:26 -05:00
Colin Walters 77cd8d5429 docs: Fix URLs
More copy-pasta from bootc docs (man it'd sure be nice to auto-inherit
this from the repo).
2023-11-08 20:05:47 -05:00
Colin Walters a42f336f05
Merge pull request #40 from cgwalters/doc-logins
docs: Improve login/tryout docs
2023-11-08 20:04:06 -05:00
Ben Breard 4989b9932c
Removed the obsolete sagano name explanation and fixed FCOS URL. 2023-11-08 16:03:46 -06:00
Colin Walters a172237629 docs: Improve login/tryout docs
- Add a preface about the base image not having cloud-init
- Migrate the Anaconda example code here and make it first
2023-11-08 15:32:53 -05:00
Colin Walters d913e9ba82 Add GH Pages infrastructure
Start to migrate from README.md to the Pages infrastructure
for nicer looking and more organized docs.
2023-11-07 15:31:53 -05:00