image-types/rhel8: streamline requirements

We don't need to specify these images again, but only explain some
non-obvious choices about deviation from the requirements.
This commit is contained in:
Lars Karlitski 2020-05-21 15:37:13 +02:00
parent b2fc0a384c
commit 02c913cf92
3 changed files with 15 additions and 48 deletions

View file

@ -2,18 +2,9 @@
*osbuild-composer* can create [Red Hat Enterprise Linux 8][rhel] images.
## Architectures
RHEL supports `x86_64`, `aarch64`, `ppc64le`, and `s390x`.
## Partitioning and Booting
The default file system is `xfs` on one bootable partition.
## Packages
By default, these images are created by installing the `@Core` group and the
`kernel` package.
A RHEL installation consists of the `@Core` group and the `kernel` package from
RHEL repositories. The default file system is `xfs`.
RHEL supports `x86_64`, `aarch64`, `ppc64le`, and `s390x` architectures.
[rhel]: https://access.redhat.com/products/red-hat-enterprise-linux

View file

@ -1,10 +1,11 @@
# Amazon EC2 Image
This image is meant to be used in [Amazon Elastic Compute Cloud (EC2)][ec2], a
popular cloud computing platform. It has to follow Amazons
popular cloud computing platform. It conforms to Amazons
[guidelines][guidelines] and [requirements][requirements] for shared AMIs.
## File Format
## Implementation Choices
EC2 uses Amazon Machine Images (AMIs) internally, which can only be created
inside EC2. An image in a standard format (ova, vmdk, vhd/x, or raw) must be
@ -12,21 +13,8 @@ imported from S3 storage. *osbuild-composer* generates this image type in the
VHDX format, because it is fairly modern, widely used, and uses less space than
RAW images.
The default image size is 6 GB.
## Architectures
Limited to `x86_64` and `aarch64`, because those are available on EC2.
## Partitioning and Booting
The image specifies partitions with a MBR partition table, because that is
required by EC2. It contains one bootable partition formatted with RHEL's
default file system `xfs`.
## Packages
`cloud-init` is included in this image, because it is required by EC2.
This image is availble for `x86_64` and `aarch64`, because those are the only
architectures available in EC2.
EC2 doesn't require any specialized firmware. Thus, in order to keep the
resulting image size small, all `-firmware` packages are excluded. An exception
@ -36,10 +24,6 @@ package depends on it.
`dracut-config-rescue` is excluded from the image, because the boot loader
entry it provides is broken.
## Kernel Command Line
`ro console=ttyS0,115200n8 console=tty0 net.ifnames=0 rd.blacklist=nouveau nvme_core.io_timeout=4294967295 crashkernel=auto`
[ec2]: https://aws.amazon.com/ec2
[guidelines]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/building-shared-amis.html

View file

@ -3,27 +3,19 @@
This image is meant to be run in an OpenStack environment. It has to conform to
OpenStacks [image requirements][requirements].
## File Format
This image is OpenStack's native file format is qcow2.
## Implementation Choices
The default image size is 2 GB.
## Partitioning and Booting
The generated images contain one bootable partition formatted with RHEL's
default file system `xfs`.
## Software
`cloud-init` is included in this image, because it is required by OpenStack.
To be usable in OpenStack, it is provided in the *qcow2* format and has
*cloud-init* installed and enabled.
`dracut-config-rescue` is excluded from the image, because the boot loader
entry it provides is broken.
## Kernel Command Line
`ro net.ifnames=0`
The environments this image is meant to be used in usually don't require any
specialized firmware. Thus, in order to keep the resulting image size small,
all `-firmware` packages are excluded. An exception is the `linux-firmware`
package, which cannot be excluded because the `kernel` package depends on it.
[requirements]: https://docs.openstack.org/image-guide/openstack-images.html