Merge pull request #44 from cgwalters/main

docs: More fixes
This commit is contained in:
Liora Milbaum 2023-11-09 08:27:28 +02:00 committed by GitHub
commit e5f22d69fc
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 30 additions and 50 deletions

View File

@ -1,5 +1,5 @@
title: containers/bootc title: centos/centos-boot
description: bootc documentation description: centos-boot documentation
baseurl: "/centos-boot" baseurl: "/centos-boot"
url: "https://centos.github.io" url: "https://centos.github.io"
# Comment above and use below for local development # Comment above and use below for local development
@ -32,8 +32,8 @@ color_scheme: coreos
# Aux links for the upper right navigation # Aux links for the upper right navigation
aux_links: aux_links:
"bootc on GitHub": "centos-boot on GitHub":
- "https://github.com/containers/bootc" - "https://github.com/centos/centos-boot"
footer_content: "Copyright &copy; <a href=\"https://www.redhat.com\">Red Hat, Inc.</a> and <a href=\"https://github.com/containers\">others</a>." footer_content: "Copyright &copy; <a href=\"https://www.redhat.com\">Red Hat, Inc.</a> and <a href=\"https://github.com/containers\">others</a>."
@ -44,7 +44,7 @@ last_edit_time_format: "%b %e %Y at %I:%M %p"
# Footer "Edit this page on GitHub" link text # Footer "Edit this page on GitHub" link text
gh_edit_link: true gh_edit_link: true
gh_edit_link_text: "Edit this page on GitHub" gh_edit_link_text: "Edit this page on GitHub"
gh_edit_repository: "https://github.com/containers/bootc" gh_edit_repository: "https://github.com/centos/centos-boot"
gh_edit_branch: "main" gh_edit_branch: "main"
gh_edit_source: docs gh_edit_source: docs
gh_edit_view_mode: "tree" gh_edit_view_mode: "tree"

View File

@ -1,12 +1,20 @@
# Goals # Goals
This project's toplevel goal is to create base *bootable* container images This project's toplevel goal is to maintain default definitions for
from Fedora ELN and CentOS Stream packages. base *bootable* container images, locked with Fedora ELN and CentOS Stream 9.
## Status ## Status
This is an in-development project not intended for production use yet. This is an in-development project not intended for production use yet.
## Container images
The primary output of this project is container images. The current
main development target is [Fedora ELN](https://docs.fedoraproject.org/en-US/eln/)
and there is one image built:
- `quay.io/centos-boot/fedora-tier-1:eln`
## Trying it out ## Trying it out
See [install.md](./install.md). See [install.md](./install.md).
@ -23,9 +31,10 @@ include Ignition for example.
## Differences from RHEL CoreOS ## Differences from RHEL CoreOS
We sometimes say that RHEL CoreOS [has FCOS as an upstream](https://github.com/openshift/os/blob/master/docs/faq.md#q-what-is-coreos) but this is only We sometimes say that RHEL CoreOS
kind of true; RHEL CoreOS includes a subset of FCOS content, and is lifecycled [has FCOS as an upstream](https://github.com/openshift/os/blob/master/docs/faq.md#q-what-is-coreos)
with OCP. but this is only kind of true; RHEL CoreOS includes a subset of FCOS content,
and is lifecycled with OCP.
An explicit goal of this project is to produce bootable container images An explicit goal of this project is to produce bootable container images
that can be used as *base images* for RHEL CoreOS; for more on this, see e.g. that can be used as *base images* for RHEL CoreOS; for more on this, see e.g.
@ -35,53 +44,24 @@ that can be used as *base images* for RHEL CoreOS; for more on this, see e.g.
It is an explicit goal that CentOS boot also becomes a "base input" to RHEL for Edge. It is an explicit goal that CentOS boot also becomes a "base input" to RHEL for Edge.
## Demonstration base images for Project CentOS boot ## Understanding "tiers"
These images are technology demonstrators, not for production use. The There is a "tier-0" image, but it is not yet being automatically built. The "tier-0"
intention is that these images are generated by the OS vendor or contains:
distribution.
Or, you can fork this repository and generate your own via
`rpm-ostree compose image`.
## Operating system sources - kernel
- systemd
- bootc
- selinux-policy-targeted
At the moment these demonstration builds use Fedora ELN and CentOS Stream 9. The tier-1 is a reasonably large system:
## Tiers
### Tier 0
This is the basic tier; it has effectively just:
- kernel systemd selinux-policy-targeted bootc
You are generally going to need to generate derived images from this; installing
it on its own will boot to a system with no automatic networking support, no SSH,
and no default passwords etc.
### Tier 1
This is larger system.
- NetworkManager, chrony - NetworkManager, chrony
- rpm-ostree (to install packages and in case it's useful "day 2")
- openssh-server - openssh-server
- dnf (for installing packages in container builds)
- rpm-ostree (A lot of tooling uses this too)
At the current time, it does not include Ignition or cloud-init; so you will The content set for these images is subject to change.
still need to derive from it in order to inject a mechanism to log in in many
cases. However, it will work to install it using e.g. Anaconda and set up
users and passwords that way.
## Image matrix (Fedora)
- `quay.io/centos-boot/fedora-tier-1:eln`
### More about image sources
The current manifest definitions [tier-0](tier-0) and [tier-1](tier-1) were
forked from Fedora CoreOS, but significantly cut down.
The existing content set is obviously subject to change and debate.
## Building ## Building