Renames and readmes
* Add readme for cloud templates * Modify readme for repo in general * Change Rocky-X-OCP to be a base variant
This commit is contained in:
parent
e9be780fe4
commit
d65003266c
20
README.md
20
README.md
@ -4,6 +4,26 @@ This branch has Rocky Linux 8 specific kickstarts. These kickstarts vary
|
|||||||
between cloud images and live images provided in our repositories and
|
between cloud images and live images provided in our repositories and
|
||||||
mirrors.
|
mirrors.
|
||||||
|
|
||||||
|
## Structure
|
||||||
|
|
||||||
|
In the root of the repository are the general kickstarts in use that any
|
||||||
|
user can pick up, use, or modify to their liking to make their own Rocky
|
||||||
|
Linux live images, cloud images, and so on. These kickstarts are generated
|
||||||
|
by templates that live in the various directories in this repository.
|
||||||
|
|
||||||
|
* `cloud` -> Cloud image templates
|
||||||
|
* `live` -> Live image templates
|
||||||
|
* `container` -> Container image templates
|
||||||
|
|
||||||
|
These kickstarts are generated using `ksflatten`. Changes made to the
|
||||||
|
kickstarts generally match between the templates and the full kickstarts
|
||||||
|
in the root.
|
||||||
|
|
||||||
|
For SIG/Core's usage, we use the `live` area as a "working" directory,
|
||||||
|
where we use the split parts in our automation for the images and the
|
||||||
|
pre-flattened versions are there for the convenience of all users. This
|
||||||
|
is easier than using the pre-made ones in empanadas.
|
||||||
|
|
||||||
## Building Live Images
|
## Building Live Images
|
||||||
|
|
||||||
To build live images, you will need to use `livecd-creator` or
|
To build live images, you will need to use `livecd-creator` or
|
||||||
|
49
cloud/README.md
Normal file
49
cloud/README.md
Normal file
@ -0,0 +1,49 @@
|
|||||||
|
# Cloud Templates
|
||||||
|
|
||||||
|
This directory contains templated versions of the cloud images. This is
|
||||||
|
extremely useful for us to be able to create more variants or modify
|
||||||
|
all variants at once if need be.
|
||||||
|
|
||||||
|
The general guidelines/ideas work like this:
|
||||||
|
|
||||||
|
* Start with a basic name, such as `rocky-${provider}-${variant}.ks`
|
||||||
|
* Optionally create additional kickstarts, such as an additional packages file
|
||||||
|
* Include the very base as necessary:
|
||||||
|
|
||||||
|
* rocky-cloud-base.ks
|
||||||
|
* rocky-cloud-parts-base.ks or rocky-cloud-parts-lvm.ks
|
||||||
|
|
||||||
|
* Include other customizations from another kickstart as necessary, such as an additional packages kickstart
|
||||||
|
* bootloader configuration and then final %post ... %end section
|
||||||
|
|
||||||
|
The most basic example of our most basic generic cloud image goes like this. See comments for details.
|
||||||
|
|
||||||
|
```
|
||||||
|
# rocky-genclo-base.ks
|
||||||
|
|
||||||
|
# Imports the absolute base for the cloud images. This is general setup settings.
|
||||||
|
%include rocky-cloud-base.ks
|
||||||
|
|
||||||
|
# Imports partition scheme and creation for the image. This is non-LVM.
|
||||||
|
%include rocky-cloud-parts-base.ks
|
||||||
|
|
||||||
|
# Imports base packages that all cloud images are expected to have
|
||||||
|
%include rocky-cloud-base-packages.ks
|
||||||
|
|
||||||
|
# bootloader information, each cloud will have different settings, so better we put it here.
|
||||||
|
bootloader --append="console=ttyS0,115200n8 no_timer_check crashkernel=auto net.ifnames=0" --location=mbr --timeout=1
|
||||||
|
|
||||||
|
# Anything else can go here that isn't fulfilled by custom or base templates.
|
||||||
|
# This can be repos if needed.
|
||||||
|
|
||||||
|
# the final post section is done here (we've removed all of it for the sake of the example)
|
||||||
|
%post --erroronfail
|
||||||
|
. . .
|
||||||
|
%end
|
||||||
|
```
|
||||||
|
|
||||||
|
At the end, you would run run ksflatten, and you now have a customized kickstart.
|
||||||
|
|
||||||
|
```
|
||||||
|
ksflatten -c rocky-genclo-base.ks -o Rocky-X-GenericCloud-Base.ks
|
||||||
|
```
|
Loading…
Reference in New Issue
Block a user