wiki/docs/documentation/references/empanadas_config.md

623 lines
12 KiB
Markdown

---
title: Empanadas config yaml Configuration
---
Each file in `empanads/config/` is a yaml file that contains configuration
items for the distribution release version. The configuration can heavily
dictate the functionality and what features are directly supported by empanadas
when ran.
See the items below to see which options are mandatory and optional.
# Config Items
## Top Level
The Top Level is the name of the profile and starts the YAML dictionary for the
release. It is alphanumeric and accepts punctuation within reason. Common
examples:
* `9`
* `9-beta`
* `8-lookahead`
### fullname
type: String
required: True
description: Needed for treeinfo and discinfo generation.
### revision
type: String
required: True
description: Full version of a release
### rclvl
type: String
required: True
description: Release Candidate or Beta descriptor. Sets names and versions with
this descriptor if enabled.
### major
type: String
required: True
description: Major version of a release
### minor
type: String
required: True
description: Minor version of a release
### profile
type: String
required: True
description: Matches the top level of the release. This should not differ from
the top level assignment.
### disttag
type: String
required: True
description: Sets the dist tag for mock configs.
### bugurl
type: String
required: True
description: A URL to the bug tracker for this release or distribution.
### checksum
type: String
required: True
description: Checksum type. Used when generating checksum information for
images.
### fedora_major
type: String
required: False
description: For future use with icicle.
### allowed_arches
type: list
required: True
description: List of supported architectures for this release.
### provide_multilib
type: boolean
required: True
description: Sets if architecture x86_64 will be multilib. It is recommended
that this is set to `True`.
### project_id
type: String
required: True
description: Appended to the base repo URL in common.py. For peridot, it is the
project id that is generated for the project you are pulling from. It can be set
to anything else if need be for non-peridot use.
### repo_symlinks
type: dict
required: False
description: For future use. Sets symlinks to repositories for backwards
compatibility. Key value pairs only.
### renames
type: dict
required: False
description: Renames a repository to the value set. For example, renaming `all`
to `devel`. Set to `{}` if no renames are goign to occur.
### all_repos
type: list
required: True
description: List of repositories that will be synced/managed by empanadas.
### structure
type: dict
required: True
description: Key value pairs of `packages` and `repodata`. These are appended
appropriately during syncing and ISO actions. Setting these are mandatory.
### iso_map
type: dictionary
required: True if building ISO's and operating with lorax.
description: Controls how lorax and extra ISO's are built.
If are you not building images, set to `{}`
#### xorrisofs
type: boolean
required: True
description: Dictates of xorrisofs is used to build images. Setting to false
uses genisoimage. It is recommended that xorrisofs is used.
#### iso_level
type: boolean
required: True
description: Set to false if you are using xorrisofs. Can be set to true when
using genisoimage.
#### images
type: dict
required: True
description: Dictates the ISO images that will be made or the treeinfo that will
be generated.
**Note**: The primary repository (for example, BaseOS) will need to be listed to
ensure the treeinfo data is correctly generated. `disc` should be set to `False`
and `isoskip` should be set to `True`. See the example section for an example.
##### name.disc
type: boolean
required: True
description: This tells the iso builder if this will be a generated ISO.
##### name.isoskip
type: boolean
required: False
description: This tells the iso builder if this will be skipped, even if `disc`
is set to `True`. Default is `False`.
##### name.variant
type: string
required: True
description: Names the primary variant repository for the image. This is set in
.treeinfo.
##### name.repos
type: list
required: True
description: Names of the repositories included in the image. This is added to
.treeinfo.
##### name.volname
type: string
required: True
required value: `dvd`
description: This is required if building more than the DVD image. By default,
the the name `dvd` is harcoded in the buildImage template.
#### lorax
type: dict
required: True if building lorax images.
description: Sets up lorax images and which repositories to use when building
lorax images.
##### lorax.repos
type: list
required: True
description: List of repos that are used to pull packages to build the lorax
images.
##### lorax.variant
type: string
required: True
description: Base repository for the release
##### lorax.lorax_removes
type: list
required: False
description: Excludes packages that are not needed when lorax is running.
##### lorax.required_pkgs
type: list
required: True
description: Required list of installed packages needed to build lorax images.
#### livemap
type: dict
required: False
description: Dictates what live images are built and how they are built.
##### livemap.git_repo
type: string
required: True
description: The git repository URL where the kickstarts live
##### livemap.branch
type: string
required: True
description: The branch being used for the kickstarts
##### livemap.ksentry
type: dict
required: True
description: Key value pairs of the live images being created. Key being the
name of the live image, value being the kickstart name/path.
##### livemap.allowed_arches
type: list
required: True
description: List of allowed architectures that will build for the live images.
##### livemap.required_pkgs
type: list
required: True
description: Required list of packages needed to build the live images.
#### cloudimages
type: dict
required: False
description: Cloud related settings.
Set to `{}` if not needed.
##### cloudimages.images
type: dict
required: True
description: Cloud images that will be generated and in a bucket to be pulled,
and their format.
###### cloudimages.images.name
type: dict
required: True
description: Name of the cloud image being pulled.
Accepted key value option `format`, which is `raw` or `qcow2`
#### repoclosure_map
type: dict
required: True
description: Repoclosure settings. These settings are absolutely required when
doing full syncs and need to check repositories for consistency.
##### repoclosure_map.arches
type: dict
required: True
description: For each architecture (key), dnf switches/settings that dictate how
repoclosure will check for consistency (value, string).
example: `x86_64: '--forcearch=x86_64 --arch=x86_64 --arch=athlon --arch=i686 --arch=i586 --arch=i486 --arch=i386 --arch=noarch'`
##### repoclosure_map.repos
type: dict
required: True
description: For each repository that is pulled for a given release(key),
repositories that will be included in the repoclosure check. A repository that
only checks against itself must have a value of `[]`.
#### extra_files
type: dict
required: True
description: Extra files settings and where they come from. Git repositories are
the only supported method.
##### extra_files.git_repo
type: string
required: True
description: URL to the git repository with the extra files.
##### extra_files.git_raw_path
type: string
required: True
description: URL to the git repository with the extra files, but the "raw" url
form.
example: `git_raw_path: 'https://git.rockylinux.org/staging/src/rocky-release/-/raw/r9/'`
##### extra_files.branch
type: string
required: True
description: Branch where the extra files are pulled from.
##### extra_files.gpg
type: dict
required: True
description: For each gpg key type (key), the relative path to the key in the
git repository (value).
These keys help set up the repository configuration when doing syncs.
By default, the RepoSync class sets `stable` as the gpgkey that is used.
##### extra_files.list
type: list
required: True
description: List of files from the git repository that will be used as "extra"
files and placed in the repositories and available to mirrors and will appear on
ISO images if applicable.
# Reference Example
```
---
'9':
fullname: 'Rocky Linux 9.0'
revision: '9.0'
rclvl: 'RC2'
major: '9'
minor: '0'
profile: '9'
disttag: 'el9'
bugurl: 'https://bugs.rockylinux.org'
checksum: 'sha256'
fedora_major: '20'
allowed_arches:
- x86_64
- aarch64
- ppc64le
- s390x
provide_multilib: True
project_id: '55b17281-bc54-4929-8aca-a8a11d628738'
repo_symlinks:
NFV: 'nfv'
renames:
all: 'devel'
all_repos:
- 'all'
- 'BaseOS'
- 'AppStream'
- 'CRB'
- 'HighAvailability'
- 'ResilientStorage'
- 'RT'
- 'NFV'
- 'SAP'
- 'SAPHANA'
- 'extras'
- 'plus'
structure:
packages: 'os/Packages'
repodata: 'os/repodata'
iso_map:
xorrisofs: True
iso_level: False
images:
dvd:
disc: True
variant: 'AppStream'
repos:
- 'BaseOS'
- 'AppStream'
minimal:
disc: True
isoskip: True
repos:
- 'minimal'
- 'BaseOS'
variant: 'minimal'
volname: 'dvd'
BaseOS:
disc: False
isoskip: True
variant: 'BaseOS'
repos:
- 'BaseOS'
- 'AppStream'
lorax:
repos:
- 'BaseOS'
- 'AppStream'
variant: 'BaseOS'
lorax_removes:
- 'libreport-rhel-anaconda-bugzilla'
required_pkgs:
- 'lorax'
- 'genisoimage'
- 'isomd5sum'
- 'lorax-templates-rhel'
- 'lorax-templates-generic'
- 'xorriso'
cloudimages:
images:
EC2:
format: raw
GenericCloud:
format: qcow2
livemap:
git_repo: 'https://git.resf.org/sig_core/kickstarts.git'
branch: 'r9'
ksentry:
Workstation: rocky-live-workstation.ks
Workstation-Lite: rocky-live-workstation-lite.ks
XFCE: rocky-live-xfce.ks
KDE: rocky-live-kde.ks
MATE: rocky-live-mate.ks
allowed_arches:
- x86_64
- aarch64
required_pkgs:
- 'lorax-lmc-novirt'
- 'vim-minimal'
- 'pykickstart'
- 'git'
variantmap:
git_repo: 'https://git.rockylinux.org/rocky/pungi-rocky.git'
branch: 'r9'
git_raw_path: 'https://git.rockylinux.org/rocky/pungi-rocky/-/raw/r9/'
repoclosure_map:
arches:
x86_64: '--forcearch=x86_64 --arch=x86_64 --arch=athlon --arch=i686 --arch=i586 --arch=i486 --arch=i386 --arch=noarch'
aarch64: '--forcearch=aarch64 --arch=aarch64 --arch=noarch'
ppc64le: '--forcearch=ppc64le --arch=ppc64le --arch=noarch'
s390x: '--forcearch=s390x --arch=s390x --arch=noarch'
repos:
devel: []
BaseOS: []
AppStream:
- BaseOS
CRB:
- BaseOS
- AppStream
HighAvailability:
- BaseOS
- AppStream
ResilientStorage:
- BaseOS
- AppStream
RT:
- BaseOS
- AppStream
NFV:
- BaseOS
- AppStream
SAP:
- BaseOS
- AppStream
- HighAvailability
SAPHANA:
- BaseOS
- AppStream
- HighAvailability
extra_files:
git_repo: 'https://git.rockylinux.org/staging/src/rocky-release.git'
git_raw_path: 'https://git.rockylinux.org/staging/src/rocky-release/-/raw/r9/'
branch: 'r9'
gpg:
stable: 'SOURCES/RPM-GPG-KEY-Rocky-9'
testing: 'SOURCES/RPM-GPG-KEY-Rocky-9-Testing'
list:
- 'SOURCES/Contributors'
- 'SOURCES/COMMUNITY-CHARTER'
- 'SOURCES/EULA'
- 'SOURCES/LICENSE'
- 'SOURCES/RPM-GPG-KEY-Rocky-9'
- 'SOURCES/RPM-GPG-KEY-Rocky-9-Testing'
...
```