Merge pull request #196 from cgwalters/more-doc-cleanups

docs/install: Cleanup, move bib earlier
This commit is contained in:
Colin Walters 2024-01-24 09:13:35 -05:00 committed by GitHub
commit b84f3436a7
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 16 additions and 10 deletions

View File

@ -17,6 +17,13 @@ with [the cloud image](https://github.com/CentOS/centos-bootc-layered/tree/main/
The [bootc playground](https://github.com/vrothberg/bootc-playground) repository
helps automate this.
## Use bootc-image-builder
The [bootc-image-builder tool](https://github.com/osbuild/bootc-image-builder)
supports generating disk images, including injecting user accounts.
NOTE: this tool [does not yet work with centos stream 9](https://github.com/osbuild/bootc-image-builder/issues/20).
## Installation using Anaconda
Tools like
@ -38,16 +45,6 @@ See [example.ks](example.ks) for an example Kickstart file. The
[virt-install --initrd-inject](https://github.com/virt-manager/virt-manager/blob/main/man/virt-install.rst#--initrd-inject)
helps inject kickstart for installation to virtual machines.
## Use osbuild-deploy-container
The in-development [osbuild-deploy-container tool](https://github.com/osbuild/osbuild-deploy-container)
supports generating disk images, including injecting user accounts.
NOTE: this tool [does not yet work with centos stream 9](https://github.com/osbuild/bootc-image-builder/issues/20).
There's also an [osbuildbootc](https://github.com/cgwalters/osbuildbootc) tool that
will be merged with the above.
## Using `bootc install to-filesystem --replace=alongside` with a cloud image
A toplevel goal of this project is that the "source of truth" for Linux
@ -79,6 +76,15 @@ There's a provisional KVM guest image uploaded here:
<https://fedorapeople.org/~walters/cloud-init-base-eln-20231029.qcow2.zst>
-->
## Using `bootc install to-disk --via-loopback` to generate a raw disk image
```shell
truncate -s 10G myimage.raw
podman run --rm --privileged --pid=host --security-opt label=type:unconfined_t -v .:/output <yourimage> bootc install to-disk --via-loopback /output/myimage.raw
```
This disk image can then be launched in a virtualization tool.
## Rebasing from Fedora CoreOS
[Fedora CoreOS](https://docs.fedoraproject.org/en-US/fedora-coreos/) supports