rpms/skopeo
7
0
Fork 0
Code Issues Pull Requests Releases Activity

import skopeo-1.2.2-2.module+el8.4.0+10198+36d1d0e3

Browse Source
This commit is contained in:
CentOS Sources 2021-03-30 12:04:46 -04:00 committed by Stepan Oksanichenko
parent 75a68c5166
commit 934672c0b2
19 changed files with 3402 additions and 271 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
.gitignore vendored
View File

@ -1 +1 @@
SOURCES/v1.1.0.tar.gz SOURCES/release-1.2-e72dd9c.tar.gz

2
.skopeo.metadata
View File

@ -1 +1 @@
1796def947b9f2d8ee1b11eab02b8a49dda7801a SOURCES/v1.1.0.tar.gz a4755f6059727897a3dde8b77756e871409ef459 SOURCES/release-1.2-e72dd9c.tar.gz

11
SOURCES/containers-auth.json.5.md
View File

@ -6,8 +6,15 @@ containers-auth.json - syntax for the registry authentication file
# DESCRIPTION # DESCRIPTION
A credentials file in JSON format used to authenticate against container image registries. A credentials file in JSON format used to authenticate against container image registries.
On Linux it is stored at `${XDG_RUNTIME_DIR}/containers/auth.json`; The primary (read/write) file is stored at `${XDG_RUNTIME_DIR}/containers/auth.json` on Linux;
on Windows and macOS, at `$HOME/.config/containers/auth.json` on Windows and macOS, at `$HOME/.config/containers/auth.json`.
When searching for the credential for a registry, the following files will be read in sequence until the valid credential is found:
first reading the primary (read/write) file, or the explicit override using an option of the calling application.
If credentials are not present, search in `${XDG\_CONFIG\_HOME}/containers/auth.json`, `$HOME/.docker/config.json`, `$HOME/.dockercfg`.
Except the primary (read/write) file, other files are read-only, unless the user use an option of the calling application explicitly points at it as an override.
## FORMAT ## FORMAT

2
SOURCES/containers-mounts.conf.5.md
View File

@ -10,7 +10,7 @@ The mounts.conf file specifies volume mount directories that are automatically m
The format of the mounts.conf is the volume format `/SRC:/DEST`, one mount per line. For example, a mounts.conf with the line `/usr/share/secrets:/run/secrets` would cause the contents of the `/usr/share/secrets` directory on the host to be mounted on the `/run/secrets` directory inside the container. Setting mountpoints allows containers to use the files of the host, for instance, to use the host's subscription to some enterprise Linux distribution. The format of the mounts.conf is the volume format `/SRC:/DEST`, one mount per line. For example, a mounts.conf with the line `/usr/share/secrets:/run/secrets` would cause the contents of the `/usr/share/secrets` directory on the host to be mounted on the `/run/secrets` directory inside the container. Setting mountpoints allows containers to use the files of the host, for instance, to use the host's subscription to some enterprise Linux distribution.
## FILES ## FILES
Some distributions may provide a `/usr/share/containers/mounts.conf` file to provide default mounts, but users can create a `/etc/containers/mounts.conf`, to specify their own special volumes to mount in the container. Some distributions may provide a `/usr/share/containers/mounts.conf` file to provide default mounts, but users can create a `/etc/containers/mounts.conf`, to specify their own special volumes to mount in the container. When Podman runs in rootless mode, the file `$HOME/.config/containers/mounts.conf` will override the default if it exists.
## HISTORY ## HISTORY
Aug 2018, Originally compiled by Valentin Rothberg <vrothberg@suse.com> Aug 2018, Originally compiled by Valentin Rothberg <vrothberg@suse.com>

41
SOURCES/containers-policy.json.5.md
View File

@ -177,7 +177,7 @@ One of the following alternatives are supported:
```json ```json
{"type":"matchRepoDigestOrExact"} {"type":"matchRepoDigestOrExact"}
``` ```
- The identity in the signature must be in the same repository as the image identity. This is useful e.g. to pull an image using the `:latest` tag when the image is signed with a tag specifing an exact image version. - The identity in the signature must be in the same repository as the image identity. This is useful e.g. to pull an image using the `:latest` tag when the image is signed with a tag specifying an exact image version.
```json ```json
{"type":"matchRepository"} {"type":"matchRepository"}
@ -200,6 +200,30 @@ One of the following alternatives are supported:
"dockerRepository": docker_repository_value "dockerRepository": docker_repository_value
} }
``` ```
- Prefix remapping:
If the image identity matches the specified prefix, that prefix is replaced by the specified “signed prefix”
(otherwise it is used as unchanged and no remapping takes place);
matching then follows the `matchRepoDigestOrExact` semantics documented above
(i.e. if the image identity carries a tag, the identity in the signature must exactly match,
if it uses a digest reference, the repository must match).
The `prefix` and `signedPrefix` values can be either host[:port] values
(matching exactly the same host[:port], string),
repository namespaces, or repositories (i.e. they must not contain tags/digests),
and match as prefixes *of the fully expanded form*.
For example, `docker.io/library/busybox` (*not* `busybox`) to specify that single repository,
or `docker.io/library` (not an empty string) to specify the parent namespace of `docker.io/library/busybox`==`busybox`).
The `prefix` value is usually the same as the scope containing the parent `signedBy` requirement.
```js
{
"type": "remapIdentity",
"prefix": prefix,
"signedPrefix": prefix,
}
```
If the `signedIdentity` field is missing, it is treated as `matchRepoDigestOrExact`. If the `signedIdentity` field is missing, it is treated as `matchRepoDigestOrExact`.
@ -260,6 +284,21 @@ selectively allow individual transports and scopes as desired.
"keyType": "GPGKeys", "keyType": "GPGKeys",
"keyPath": "/path/to/reviewer-pubkey.gpg" "keyPath": "/path/to/reviewer-pubkey.gpg"
} }
],
/* A way to mirror many repositories from a single vendor */
"private-mirror:5000/vendor-mirror": [
{ /* Require the image to be signed by the original vendor, using the vendor's repository location.
For example, private-mirror:5000/vendor-mirror/productA/image1:latest needs to be signed as
vendor.example/productA/image1:latest . */
"type": "signedBy",
"keyType": "GPGKeys",
"keyPath": "/path/to/vendor-pubkey.gpg",
"signedIdentity": {
"type": "remapIdentity",
"prefix": "private-mirror:5000/vendor-mirror",
"signedPrefix": "vendor.example.com",
}
}
] ]
} }
} }

69
SOURCES/containers-registries.conf.5.md
View File

@ -102,6 +102,75 @@ internet without having to change `Dockerfile`s, or to add redundancy).
*Note*: Redirection and mirrors are currently processed only when reading images, not when pushing *Note*: Redirection and mirrors are currently processed only when reading images, not when pushing
to a registry; that may change in the future. to a registry; that may change in the future.
#### Short-Name Aliasing
The use of unqualified-search registries entails an ambiguity as it is
unclear from which registry a given image, referenced by a short name,
may be pulled from.
As mentioned in the note at the end of this man page, using short names is
subject to the risk of hitting squatted registry namespaces. If the
unqualified-search registries are set to `["registry1.com", "registry2.com"]`
an attacker may take over a namespace of registry1.com such that an image may
be pulled from registry1.com instead of the intended source registry2.com.
While it is highly recommended to always use fully-qualified image references,
existing deployments using short names may not be easily changed. To
circumvent the aforementioned ambiguity, so called short-name aliases can be
configured that point to a fully-qualified image
reference.
Short-name aliases can be configured in the `[aliases]` table in the form of
`"name"="value"` with the left-hand `name` being the short name (e.g., "image")
and the right-hand `value` being the fully-qualified image reference (e.g.,
"registry.com/namespace/image"). Note that neither "name" nor "value" can
include a tag or digest. Moreover, "name" must be a short name and hence
cannot include a registry domain or refer to localhost.
When pulling a short name, the configured aliases table will be used for
resolving the short name. If a matching alias is found, it will be used
without further consulting the unqualified-search registries list. If no
matching alias is found, the behavior can be controlled via the
`short-name-mode` option as described below.
Note that tags and digests are stripped off a user-specified short name for
alias resolution. Hence, "image", "image:tag" and "image@digest" all resolve
to the same alias (i.e., "image"). Stripped off tags and digests are later
appended to the resolved alias.
Further note that drop-in configuration files (see containers-registries.conf.d(5))
can override aliases in the specific loading order of the files. If the "value" of
an alias is empty (i.e., ""), the alias will be erased. However, a given
"name" may only be specified once in a single config file.
#### Short-Name Aliasing: Modes
The `short-name-mode` option supports three modes to control the behaviour of
short-name resolution.
* `enforcing`: If only one unqualified-search registry is set, use it as there
is no ambiguity. If there is more than one registry and the user program is
running in a terminal (i.e., stdout & stdin are a TTY), prompt the user to
select one of the specified search registries. If the program is not running
in a terminal, the ambiguity cannot be resolved which will lead to an error.
* `permissive`: Behaves as enforcing but does not lead to an error if the
program is not running in a terminal. Instead, fallback to using all
unqualified-search registries.
* `disabled`: Use all unqualified-search registries without prompting.
If `short-name-mode` is not specified at all or left empty, default to the
`permissive` mode. If the user-specified short name was not aliased already,
the `enforcing` and `permissive` mode if prompted, will record a new alias
after a successful pull. Note that the recorded alias will be written to
`$XDG_CONFIG_HOME/containers/short-name-aliases.conf` to have a clear
separation between possibly human-edited registries.conf files and the
machine-generated `short-name-aliases-conf`. Note that `$HOME/.config` is used
if `$XDG_CONFIG_HOME` is not set. If an alias is specified in a
`registries.conf` file and also the machine-generated
`short-name-aliases.conf`, the `short-name-aliases.conf` file has precedence.
#### Normalization of docker.io references #### Normalization of docker.io references
The Docker Hub `docker.io` is handled in a special way: every push and pull The Docker Hub `docker.io` is handled in a special way: every push and pull

37
SOURCES/containers-registries.conf.d.5.md Normal file
View File

@ -0,0 +1,37 @@
% CONTAINERS-REGISTRIES.CONF.D(5)
% Valentin Rothberg
% Mar 2020
# NAME
containers-registries.conf.d - directory for drop-in registries.conf files
# DESCRIPTION
CONTAINERS-REGISTRIES.CONF.D is a system-wide directory for drop-in
configuration files in the `containers-registries.conf(5)` format.
By default, the directory is located at `/etc/containers/registries.conf.d`.
# CONFIGURATION PRECEDENCE
Once the main configuration at `/etc/containers/registries.conf` is loaded, the
files in `/etc/containers/registries.conf.d` are loaded in alpha-numerical
order. Then the conf files in `$HOME/.config/containers/registries.conf.d` are loaded in alpha-numerical order, if they exist. If the `$HOME/.config/containers/registries.conf` is loaded, only the conf files under `$HOME/.config/containers/registries.conf.d` are loaded in alpha-numerical order.
Specified fields in a conf file will overwrite any previous setting. Note
that only files with the `.conf` prefix are loaded, other files and
sub-directories are ignored.
For instance, setting the `unqualified-search-registries` in
`/etc/containers/registries.conf.d/myregistries.conf` will overwrite previous
settings in `/etc/containers/registries.conf`. The `[[registry]]` tables merged
by overwriting existing items if the prefixes are identical while new ones are
added.
All drop-in configuration files must be specified in the version 2 of the
`containers-registries.conf(5)` format.
# SEE ALSO
`containers-registries.conf(5)`
# HISTORY
Mar 2020, Originally compiled by Valentin Rothberg <rothberg@redhat.com>

8
SOURCES/containers-registries.d.5.md
View File

@ -12,7 +12,7 @@ The registries configuration directory contains configuration for various regist
so that the configuration does not have to be provided in command-line options over and over for every command, so that the configuration does not have to be provided in command-line options over and over for every command,
and so that it can be shared by all users of containers/image. and so that it can be shared by all users of containers/image.
By default (unless overridden at compile-time), the registries configuration directory is `/etc/containers/registries.d`; By default, the registries configuration directory is `$HOME/.config/containers/registries.d` if it exists, otherwise `/etc/containers/registries.d` (unless overridden at compile-time);
applications may allow using a different directory instead. applications may allow using a different directory instead.
## Directory Structure ## Directory Structure
@ -61,6 +61,11 @@ more general scopes is ignored. For example, if _any_ configuration exists for
`docker.io/library/busybox`, the configuration for `docker.io` is ignored `docker.io/library/busybox`, the configuration for `docker.io` is ignored
(even if some element of the configuration is defined for `docker.io` and not for `docker.io/library/busybox`). (even if some element of the configuration is defined for `docker.io` and not for `docker.io/library/busybox`).
### Built-in Defaults
If no `docker` section can be found for the container image, and no `default-docker` section is configured,
the default directory, `/var/lib/containers/sigstore` for root and `$HOME/.local/share/containers/sigstore` for unprivileged user, will be used for reading and writing signatures.
## Individual Configuration Sections ## Individual Configuration Sections
A single configuration section is selected for a container image using the process A single configuration section is selected for a container image using the process
@ -77,6 +82,7 @@ described above. The configuration section is a YAML mapping, with the followin
This key is optional; if it is missing, no signature storage is defined (no signatures This key is optional; if it is missing, no signature storage is defined (no signatures
are download along with images, adding new signatures is possible only if `sigstore-staging` is defined). are download along with images, adding new signatures is possible only if `sigstore-staging` is defined).
## Examples ## Examples
### Using Containers from Various Origins ### Using Containers from Various Origins

2
SOURCES/containers-signature.5.md
View File

@ -224,7 +224,7 @@ The contents of this string is not defined in detail; however each implementatio
Consumers of container signatures MAY recognize specific values or sets of values of `optional.creator` Consumers of container signatures MAY recognize specific values or sets of values of `optional.creator`
(perhaps augmented with `optional.timestamp`), (perhaps augmented with `optional.timestamp`),
and MAY change their processing of the signature based on these values and MAY change their processing of the signature based on these values
(usually to acommodate violations of this specification in past versions of the signing software which cannot be fixed retroactively), (usually to accommodate violations of this specification in past versions of the signing software which cannot be fixed retroactively),
as long as the semantics of the invalid document, as created by such an implementation, is clear. as long as the semantics of the invalid document, as created by such an implementation, is clear.
If consumers of signatures do change their behavior based on the `optional.creator` value, If consumers of signatures do change their behavior based on the `optional.creator` value,

61
SOURCES/containers-storage.conf.5.md
View File

@ -27,29 +27,28 @@ No bare options are used. The format of TOML can be simplified to:
The `storage` table supports the following options: The `storage` table supports the following options:
**driver**="" **driver**=""
container storage driver (default: "overlay") container storage driver
Default Copy On Write (COW) container storage driver. Valid drivers are "overlay", "vfs", "devmapper", "aufs", "btrfs", and "zfs". Some drivers (for example, "zfs", "btrfs", and "aufs") may not work if your kernel lacks support for the filesystem. Default Copy On Write (COW) container storage driver. Valid drivers are "overlay", "vfs", "devmapper", "aufs", "btrfs", and "zfs". Some drivers (for example, "zfs", "btrfs", and "aufs") may not work if your kernel lacks support for the filesystem.
This field is requiered to guarantee proper operation.
**graphroot**="" **graphroot**=""
container storage graph dir (default: "/var/lib/containers/storage") container storage graph dir (default: "/var/lib/containers/storage")
Default directory to store all writable content created by container storage programs. Default directory to store all writable content created by container storage programs.
The rootless graphroot path supports environment variable substitutions (ie. `$HOME/containers/storage`)
**rootless_storage_path**="$HOME/.local/share/containers/storage" **rootless_storage_path**="$HOME/.local/share/containers/storage"
Storage path for rootless users. By default the graphroot for rootless users Storage path for rootless users. By default the graphroot for rootless users
is set to `$XDG_DATA_HOME/containers/storage`, if XDG_DATA_HOME is set. is set to `$XDG_DATA_HOME/containers/storage`, if XDG_DATA_HOME is set.
Otherwise `$HOME/.local/share/containers/storage` is used. This field can Otherwise `$HOME/.local/share/containers/storage` is used. This field can
be used if administrators need to change the storage location for all users. be used if administrators need to change the storage location for all users.
The rootless storage path supports environment variable substitutions (ie. `$HOME/containers/storage`)
The rootless storage path supports three substations:
* `$HOME` => Replaced by the users home directory.
* `$UID` => Replaced by the users UID
* `$USER` => Replaced by the users name
A common use case for this field is to provide a local storage directory when user home directories are NFS-mounted (podman does not support container storage over NFS). A common use case for this field is to provide a local storage directory when user home directories are NFS-mounted (podman does not support container storage over NFS).
**runroot**="" **runroot**=""
container storage run dir (default: "/var/run/containers/storage") container storage run dir (default: "/run/containers/storage")
Default directory to store all temporary writable content created by container storage programs. Default directory to store all temporary writable content created by container storage programs.
The rootless runroot path supports environment variable substitutions (ie. `$HOME/containers/storage`)
### STORAGE OPTIONS TABLE ### STORAGE OPTIONS TABLE
@ -77,7 +76,7 @@ The `storage.options` table supports the following options:
remap-group = "containers" remap-group = "containers"
**root-auto-userns-user**="" **root-auto-userns-user**=""
Root-auto-userns-user is a user name which can be used to look up one or more UID/GID ranges in the /etc/subuid and /etc/subgid file. These ranges will be partioned to containers configured to create automatically a user namespace. Containers configured to automatically create a user namespace can still overlap with containers having an explicit mapping set. This setting is ignored when running as rootless. Root-auto-userns-user is a user name which can be used to look up one or more UID/GID ranges in the /etc/subuid and /etc/subgid file. These ranges will be partitioned to containers configured to create automatically a user namespace. Containers configured to automatically create a user namespace can still overlap with containers having an explicit mapping set. This setting is ignored when running as rootless.
**auto-userns-min-size**=1024 **auto-userns-min-size**=1024
Auto-userns-min-size is the minimum size for a user namespace created automatically. Auto-userns-min-size is the minimum size for a user namespace created automatically.
@ -138,6 +137,9 @@ The `storage.options.thinpool` table supports the following options for the `dev
6: LogLevelInfo 6: LogLevelInfo
7: LogLevelDebug 7: LogLevelDebug
**metadata_size**=""
metadata_size is used to set the `pvcreate --metadatasize` options when creating thin devices. (Default 128k)
**min_free_space**="" **min_free_space**=""
Specifies the min free space percent in a thin pool required for new device creation to succeed. Valid values are from 0% - 99%. Value 0% disables. (default: 10%) Specifies the min free space percent in a thin pool required for new device creation to succeed. Valid values are from 0% - 99%. Value 0% disables. (default: 10%)
@ -148,7 +150,7 @@ The `storage.options.thinpool` table supports the following options for the `dev
Comma separated list of default options to be used to mount container images. Suggested value "nodev". Mount options are documented in the mount(8) man page. Comma separated list of default options to be used to mount container images. Suggested value "nodev". Mount options are documented in the mount(8) man page.
**size**="" **size**=""
Maximum size of a container image. This flag can be used to set quota on the size of container images. (format: <number>[<unit>], where unit = b (bytes), k (kilobytes), m (megabytes), or g (gigabytes)) Maximum size of a container image. This flag can be used to set quota on the size of container images. (format: <number>[<unit>], where unit = b (bytes), k (kilobytes), m (megabytes), or g (gigabytes))
**use_deferred_deletion**="" **use_deferred_deletion**=""
Marks thinpool device for deferred deletion. If the thinpool is in use when the driver attempts to delete it, the driver will attempt to delete device every 30 seconds until successful, or when it restarts. Deferred deletion permanently deletes the device and all data stored in the device will be lost. (default: true). Marks thinpool device for deferred deletion. If the thinpool is in use when the driver attempts to delete it, the driver will attempt to delete device every 30 seconds until successful, or when it restarts. Deferred deletion permanently deletes the device and all data stored in the device will be lost. (default: true).
@ -166,6 +168,39 @@ The `storage.options.overlay` table supports the following options:
**ignore_chown_errors** = "false" **ignore_chown_errors** = "false"
ignore_chown_errors can be set to allow a non privileged user running with a single UID within a user namespace to run containers. The user can pull and use any image even those with multiple uids. Note multiple UIDs will be squashed down to the default uid in the container. These images will have no separation between the users in the container. (default: false) ignore_chown_errors can be set to allow a non privileged user running with a single UID within a user namespace to run containers. The user can pull and use any image even those with multiple uids. Note multiple UIDs will be squashed down to the default uid in the container. These images will have no separation between the users in the container. (default: false)
**force_mask** = "0000|shared|private"
ForceMask specifies the permissions mask that is used for new files and
directories.
The values "shared" and "private" are accepted. (default: ""). Octal permission
masks are also accepted.
``: Not set
All files/directories, get set with the permissions identified within the
image.
`private`: it is equivalent to 0700.
All files/directories get set with 0700 permissions. The owner has rwx
access to the files. No other users on the system can access the files.
This setting could be used with networked based home directories.
`shared`: it is equivalent to 0755.
The owner has rwx access to the files and everyone else can read, access
and execute them. This setting is useful for sharing containers storage
with other users. For instance, a storage owned by root could be shared
to rootless users as an additional store.
NOTE: All files within the image are made readable and executable by any
user on the system. Even /etc/shadow within your image is now readable by
any user.
`OCTAL`: Users can experiment with other OCTAL Permissions.
Note: The force_mask Flag is an experimental feature, it could change in the
future. When "force_mask" is set the original permission mask is stored in the
"user.containers.override_stat" xattr and the "mount_program" option must be
specified. Mount programs like "/usr/bin/fuse-overlayfs" present the extended
attribute permissions to processes within containers rather then the
"force_mask" permissions.
**mount_program**="" **mount_program**=""
Specifies the path to a custom program to use instead of using kernel defaults Specifies the path to a custom program to use instead of using kernel defaults
for mounting the file system. In rootless mode, without the CAP_SYS_ADMIN for mounting the file system. In rootless mode, without the CAP_SYS_ADMIN
@ -220,7 +255,7 @@ The semanage command above tells SELinux to setup the default labeling of `NEWST
Now all new content created in these directories will automatically be created with the correct label. Now all new content created in these directories will automatically be created with the correct label.
## SEE ALSO ## SEE ALSO
`semanage(8)`, `restorecon(8)`, `mount(8)` `semanage(8)`, `restorecon(8)`, `mount(8)`, `fuse-overlayfs(1)`
## FILES ## FILES

8
SOURCES/containers-transports.5.md
View File

@ -41,10 +41,14 @@ If `name` does not contain a slash, it is treated as `docker.io/library/name`.
Otherwise, the component before the first slash is checked if it is recognized as a `hostname[:port]` (i.e., it contains either a . or a :, or the component is exactly localhost). Otherwise, the component before the first slash is checked if it is recognized as a `hostname[:port]` (i.e., it contains either a . or a :, or the component is exactly localhost).
If the first component of name is not recognized as a `hostname[:port]`, `name` is treated as `docker.io/name`. If the first component of name is not recognized as a `hostname[:port]`, `name` is treated as `docker.io/name`.
### **docker-archive:**_path[:docker-reference]_ ### **docker-archive:**_path[:{docker-reference|@source-index}]_
An image is stored in the docker-save(1) formatted file. An image is stored in the docker-save(1) formatted file.
_docker-reference_ is only used when creating such a file, and it must not contain a digest. _docker-reference_ must not contain a digest.
Alternatively, for reading archives, @_source-index_ is a zero-based index in archive manifest
(to access untagged images).
If neither _docker-reference_ nor @_source_index is specified when reading an archive, the archive must contain exactly one image.
It is further possible to copy data to stdin by specifying `docker-archive:/dev/stdin` but note that the used file must be seekable. It is further possible to copy data to stdin by specifying `docker-archive:/dev/stdin` but note that the used file must be seekable.
### **docker-daemon:**_docker-reference|algo:digest_ ### **docker-daemon:**_docker-reference|algo:digest_

160
SOURCES/containers.conf
View File

@ -52,36 +52,36 @@
# Options are: # Options are:
# `enabled` Enable cgroup support within container # `enabled` Enable cgroup support within container
# `disabled` Disable cgroup support, will inherit cgroups from parent # `disabled` Disable cgroup support, will inherit cgroups from parent
# `no-conmon` Container engine runs run without conmon # `no-conmon` Do not create a cgroup dedicated to conmon.
# #
# cgroups = "enabled" # cgroups = "enabled"
# List of default capabilities for containers. If it is empty or commented out, # List of default capabilities for containers. If it is empty or commented out,
# the default capabilities defined in the container engine will be added. # the default capabilities defined in the container engine will be added.
# #
# default_capabilities = [ default_capabilities = [
# "AUDIT_WRITE", "NET_RAW",
# "CHOWN", "CHOWN",
# "DAC_OVERRIDE", "DAC_OVERRIDE",
# "FOWNER", "FOWNER",
# "FSETID", "FSETID",
# "KILL", "KILL",
# "MKNOD", "NET_BIND_SERVICE",
# "NET_BIND_SERVICE", "SETFCAP",
# "NET_RAW", "SETGID",
# "SETGID", "SETPCAP",
# "SETPCAP", "SETUID",
# "SETUID", "SYS_CHROOT"
# "SYS_CHROOT", ]
# ]
# A list of sysctls to be set in containers by default, # A list of sysctls to be set in containers by default,
# specified as "name=value", # specified as "name=value",
# for example:"net.ipv4.ping_group_range = 0 1000". # for example:"net.ipv4.ping_group_range = 0 0".
# #
# default_sysctls = [ default_sysctls = [
# "net.ipv4.ping_group_range=0 1000", "net.ipv4.ping_group_range=0 0",
# ] ]
# A list of ulimits to be set in containers by default, specified as # A list of ulimits to be set in containers by default, specified as
# "<ulimit name>=<soft limit>:<hard limit>", for example: # "<ulimit name>=<soft limit>:<hard limit>", for example:
@ -92,7 +92,7 @@
# Ulimits has limits for non privileged container engines. # Ulimits has limits for non privileged container engines.
# #
# default_ulimits = [ # default_ulimits = [
# "nofile"="1280:2560", # "nofile=1280:2560",
# ] # ]
# List of default DNS options to be added to /etc/resolv.conf inside of the container. # List of default DNS options to be added to /etc/resolv.conf inside of the container.
@ -116,18 +116,13 @@
# #
# env = [ # env = [
# "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", # "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
# "TERM=xterm",
# ] # ]
# Pass all host environment variables into the container. # Pass all host environment variables into the container.
# #
# env_host = false # env_host = false
# Path to OCI hooks directories for automatically executed hooks.
#
# hooks_dir = [
# "/usr/share/containers/oci/hooks.d",
# ]
# Default proxy environment variables passed into the container. # Default proxy environment variables passed into the container.
# The environment variables passed in include: # The environment variables passed in include:
# http_proxy, https_proxy, ftp_proxy, no_proxy, and the upper case versions of # http_proxy, https_proxy, ftp_proxy, no_proxy, and the upper case versions of
@ -152,9 +147,13 @@
# #
# ipcns = "private" # ipcns = "private"
# Flag tells container engine to whether to use container separation using # keyring tells the container engine whether to create
# MAC(SELinux)labeling or not. # a kernel keyring for use within the container.
# Flag is ignored on label disabled systems. # keyring = true
# label tells the container engine whether to use container separation using
# MAC(SELinux) labeling or not.
# The label flag is ignored on label disabled systems.
# #
# label = true # label = true
@ -205,6 +204,15 @@
# #
# shm_size = "65536k" # shm_size = "65536k"
# Set timezone in container. Takes IANA timezones as well as "local",
# which sets the timezone in the container to match the host machine.
#
# tz = ""
# Set umask inside the container
#
# umask="0022"
# Default way to to create a UTS namespace for the container # Default way to to create a UTS namespace for the container
# Options are: # Options are:
# `private` Create private UTS Namespace for the container. # `private` Create private UTS Namespace for the container.
@ -239,6 +247,9 @@
# network_config_dir = "/etc/cni/net.d/" # network_config_dir = "/etc/cni/net.d/"
[engine] [engine]
# ImageBuildFormat indicates the default image format to building
# container images. Valid values are "oci" (default) or "docker".
# image_build_format = "oci"
# Cgroup management implementation used for the runtime. # Cgroup management implementation used for the runtime.
# Valid options "systemd" or "cgroupfs" # Valid options "systemd" or "cgroupfs"
@ -279,10 +290,22 @@
# #
# enable_port_reservation = true # enable_port_reservation = true
# Environment variables to be used when running the container engine (e.g., Podman, Buildah).
# For example "http_proxy=internal.proxy.company.com".
# Note these environment variables will not be used within the container.
# Set the env section under [containers] table, if you want to set environment variables for the container.
# env = []
# Selects which logging mechanism to use for container engine events. # Selects which logging mechanism to use for container engine events.
# Valid values are `journald`, `file` and `none`. # Valid values are `journald`, `file` and `none`.
# #
# events_logger = "journald" events_logger = "file"
# Path to OCI hooks directories for automatically executed hooks.
#
# hooks_dir = [
# "/usr/share/containers/oci/hooks.d",
# ]
# Default transport method for pulling and pushing for images # Default transport method for pulling and pushing for images
# #
@ -307,6 +330,12 @@
# #
# lock_type** = "shm" # lock_type** = "shm"
# MultiImageArchive - if true, the container engine allows for storing archives
# (e.g., of the docker-archive transport) with multiple images. By default,
# Podman creates single-image archives.
#
# multi_image_archive = "false"
# Default engine namespace # Default engine namespace
# If engine is joined to a namespace, it will see only containers and pods # If engine is joined to a namespace, it will see only containers and pods
# that were created in the same namespace, and will create new containers and # that were created in the same namespace, and will create new containers and
@ -316,6 +345,15 @@
# #
# namespace = "" # namespace = ""
# Path to the slirp4netns binary
#
# network_cmd_path=""
# Default options to pass to the slirp4netns binary.
# For example "allow_host_loopback=true"
#
# network_cmd_options=[]
# Whether to use chroot instead of pivot_root in the runtime # Whether to use chroot instead of pivot_root in the runtime
# #
# no_pivot_root = false # no_pivot_root = false
@ -329,6 +367,11 @@
# Whether to pull new image before running a container # Whether to pull new image before running a container
# pull_policy = "missing" # pull_policy = "missing"
# Indicates whether the application should be running in remote mode. This flag modifies the
# --remote option on container engines. Setting the flag to true will default
# `podman --remote=true` for access to the remote Podman service.
# remote = false
# Directory for persistent engine files (database, etc) # Directory for persistent engine files (database, etc)
# By default, this will be configured relative to where the containers/storage # By default, this will be configured relative to where the containers/storage
# stores containers # stores containers
@ -338,7 +381,7 @@
# Directory for temporary files. Must be tmpfs (wiped after reboot) # Directory for temporary files. Must be tmpfs (wiped after reboot)
# #
# tmp_dir = "/var/run/libpod" # tmp_dir = "/run/libpod"
# Directory for libpod named volumes. # Directory for libpod named volumes.
# By default, this will be configured relative to where containers/storage # By default, this will be configured relative to where containers/storage
@ -349,7 +392,7 @@
# Default OCI runtime # Default OCI runtime
# #
# runtime = "runc" # runtime = "crun"
# List of the OCI runtimes that support --format=json. When json is supported # List of the OCI runtimes that support --format=json. When json is supported
# engine will use it for reporting nicer errors. # engine will use it for reporting nicer errors.
@ -364,18 +407,27 @@
# #
# runtime_supports_kvm = ["kata"] # runtime_supports_kvm = ["kata"]
# Paths to look for a valid OCI runtime (runc, runv, kata, etc) # Number of seconds to wait for container to exit before sending kill signal.
[engine.runtimes] # stop_timeout = 10
# runc = [
# "/usr/bin/runc",
# "/usr/sbin/runc",
# "/usr/local/bin/runc",
# "/usr/local/sbin/runc",
# "/sbin/runc",
# "/bin/runc",
# "/usr/lib/cri-o-runc/sbin/runc",
# ]
# Index to the active service
# active_service = production
# map of service destinations
# [service_destinations]
# [service_destinations.production]
# URI to access the Podman service
# Examples:
# rootless "unix://run/user/$UID/podman/podman.sock" (Default)
# rootfull "unix://run/podman/podman.sock (Default)
# remote rootless ssh://engineering.lab.company.com/run/user/1000/podman/podman.sock
# remote rootfull ssh://root@10.10.1.136:22/run/podman/podman.sock
# uri="ssh://user@production.example.com/run/user/1001/podman/podman.sock"
# Path to file containing ssh identity key
# identity = "~/.ssh/id_rsa"
# Paths to look for a valid OCI runtime (crun, runc, kata, etc)
[engine.runtimes]
# crun = [ # crun = [
# "/usr/bin/crun", # "/usr/bin/crun",
# "/usr/sbin/crun", # "/usr/sbin/crun",
@ -386,6 +438,16 @@
# "/run/current-system/sw/bin/crun", # "/run/current-system/sw/bin/crun",
# ] # ]
# runc = [
# "/usr/bin/runc",
# "/usr/sbin/runc",
# "/usr/local/bin/runc",
# "/usr/local/sbin/runc",
# "/sbin/runc",
# "/bin/runc",
# "/usr/lib/cri-o-runc/sbin/runc",
# ]
# kata = [ # kata = [
# "/usr/bin/kata-runtime", # "/usr/bin/kata-runtime",
# "/usr/sbin/kata-runtime", # "/usr/sbin/kata-runtime",
@ -397,11 +459,11 @@
# "/usr/bin/kata-fc", # "/usr/bin/kata-fc",
# ] # ]
# Number of seconds to wait for container to exit before sending kill signal. [engine.volume_plugins]
#stop_timeout = 10 # testplugin = "/run/podman/plugins/test.sock"
# The [engine.runtimes] table MUST be the last entry in this file. # The [engine.volume_plugins] table MUST be the last entry in this file.
# (Unless another table is added) # (Unless another table is added)
# TOML does not provide a way to end a table other than a further table being # TOML does not provide a way to end a table other than a further table being
# defined, so every key hereafter will be part of [runtimes] and not the main # defined, so every key hereafter will be part of [volume_plugins] and not the
# config. # main config.

391
SOURCES/containers.conf.5.md
View File

@ -47,168 +47,216 @@ The containers table contains settings pertaining to the OCI runtime that can
configure and manage the OCI runtime. configure and manage the OCI runtime.
**devices**=[] **devices**=[]
List of devices.
Specified as 'device-on-host:device-on-container:permissions', List of devices.
for example: "/dev/sdc:/dev/xvdc:rwm". Specified as 'device-on-host:device-on-container:permissions'.
Example: "/dev/sdc:/dev/xvdc:rwm".
**volumes**=[] **volumes**=[]
List of volumes.
Specified as "directory-on-host:directory-in-container:options", List of volumes.
for example: "/db:/var/lib/db:ro". Specified as "directory-on-host:directory-in-container:options".
Example: "/db:/var/lib/db:ro".
**apparmor_profile**="container-default" **apparmor_profile**="container-default"
Used to change the name of the default AppArmor profile of container engines.
Used to change the name of the default AppArmor profile of container engines.
The default profile name is "container-default". The default profile name is "container-default".
**cgroupns**="private" **cgroupns**="private"
Default way to to create a cgroup namespace for the container.
Options are: Default way to to create a cgroup namespace for the container.
`private` Create private Cgroup Namespace for the container. Options are:
`host` Share host Cgroup Namespace with the container. `private` Create private Cgroup Namespace for the container.
`host` Share host Cgroup Namespace with the container.
**cgroups**="enabled" **cgroups**="enabled"
Determines whether the container will create CGroups.
Options are: Determines whether the container will create CGroups.
`enabled` Enable cgroup support within container Options are:
`disabled` Disable cgroup support, will inherit cgroups from parent `enabled` Enable cgroup support within container
`no-conmon` Container engine runs run without conmon `disabled` Disable cgroup support, will inherit cgroups from parent
`no-conmon` Do not create a cgroup dedicated to conmon.
**default_capabilities**=[] **default_capabilities**=[]
List of default capabilities for containers.
The default list is: List of default capabilities for containers.
The default list is:
``` ```
default_capabilities = [ default_capabilities = [
"AUDIT_WRITE", "AUDIT_WRITE",
"CHOWN", "CHOWN",
"DAC_OVERRIDE", "DAC_OVERRIDE",
"FOWNER", "FOWNER",
"FSETID", "FSETID",
"KILL", "KILL",
"MKNOD", "MKNOD",
"NET_BIND_SERVICE", "NET_BIND_SERVICE",
"NET_RAW", "NET_RAW",
"SETGID", "SETGID",
"SETPCAP", "SETPCAP",
"SETUID", "SETUID",
"SYS_CHROOT", "SYS_CHROOT",
] ]
``` ```
**default_sysctls**=[] **default_sysctls**=[]
A list of sysctls to be set in containers by default,
specified as "name=value", A list of sysctls to be set in containers by default,
for example:"net.ipv4.ping_group_range=0 1000". specified as "name=value".
Example:"net.ipv4.ping_group_range=0 1000".
**default_ulimits**=[] **default_ulimits**=[]
A list of ulimits to be set in containers by default,
specified as "name=soft-limit:hard-limit", A list of ulimits to be set in containers by default,
for example:"nofile=1024:2048". specified as "name=soft-limit:hard-limit".
Example: "nofile=1024:2048".
**dns_options**=[] **dns_options**=[]
List of default DNS options to be added to /etc/resolv.conf inside of the
List of default DNS options to be added to /etc/resolv.conf inside of the
container. container.
**dns_searches**=[] **dns_searches**=[]
List of default DNS search domains to be added to /etc/resolv.conf inside of
List of default DNS search domains to be added to /etc/resolv.conf inside of
the container. the container.
**dns_servers**=[] **dns_servers**=[]
A list of dns servers to override the DNS configuration passed to the
A list of dns servers to override the DNS configuration passed to the
container. The special value “none” can be specified to disable creation of container. The special value “none” can be specified to disable creation of
/etc/resolv.conf in the container. /etc/resolv.conf in the container.
**env**=["PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"] **env**=["PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", "TERM=xterm"]
Environment variable list for the container process, used for passing
Environment variable list for the container process, used for passing
environment variables to the container. environment variables to the container.
**env_host**=false **env_host**=false
Pass all host environment variables into the container.
**hooks_dir**=["/etc/containers/oci/hooks.d", ...] Pass all host environment variables into the container.
Path to the OCI hooks directories for automatically executed hooks.
**http_proxy**=false **http_proxy**=true
Default proxy environment variables will be passed into the container.
The environment variables passed in include: Default proxy environment variables will be passed into the container.
The environment variables passed in include:
`http_proxy`, `https_proxy`, `ftp_proxy`, `no_proxy`, and the upper case `http_proxy`, `https_proxy`, `ftp_proxy`, `no_proxy`, and the upper case
versions of these. The `no_proxy` option is needed when host system uses a proxy versions of these. The `no_proxy` option is needed when host system uses a proxy
but container should not use proxy. Proxy environment variables specified for but container should not use proxy. Proxy environment variables specified for
the container in any other way will override the values passed from the host. the container in any other way will override the values passed from the host.
**init**=false **init**=false
Run an init inside the container that forwards signals and reaps processes.
Run an init inside the container that forwards signals and reaps processes.
**init_path**="/usr/libexec/podman/catatonit" **init_path**="/usr/libexec/podman/catatonit"
Path to the container-init binary, which forwards signals and reaps processes
Path to the container-init binary, which forwards signals and reaps processes
within containers. Note that the container-init binary will only be used when within containers. Note that the container-init binary will only be used when
the `--init` for podman-create and podman-run is set. the `--init` for podman-create and podman-run is set.
**ipcns**="private" **ipcns**="private"
Default way to to create a IPC namespace for the container.
Options are: Default way to to create a IPC namespace for the container.
`private` Create private IPC Namespace for the container. Options are:
`host` Share host IPC Namespace with the container. `private` Create private IPC Namespace for the container.
`host` Share host IPC Namespace with the container.
**keyring**=true
Indicates whether the container engines create a kernel keyring for use within
the container.
**label**=true **label**=true
Indicates whether the container engines use MAC(SELinux) container separation via via labeling. Flag is ignored on disabled systems.
Indicates whether the container engine uses MAC(SELinux) container separation via labeling. This option is ignored on disabled systems.
**log_driver**="k8s-file" **log_driver**="k8s-file"
Logging driver for the container. Available options: `k8s-file` and `journald`.
Logging driver for the container. Available options: `k8s-file` and `journald`.
**log_size_max**=-1 **log_size_max**=-1
Maximum size allowed for the container's log file. Negative numbers indicate
Maximum size allowed for the container's log file. Negative numbers indicate
that no size limit is imposed. If it is positive, it must be >= 8192 to that no size limit is imposed. If it is positive, it must be >= 8192 to
match/exceed conmon's read buffer. The file is truncated and re-opened so the match/exceed conmon's read buffer. The file is truncated and re-opened so the
limit is never exceeded. limit is never exceeded.
**netns**="private" **netns**="private"
Default way to to create a NET namespace for the container.
Options are: Default way to to create a NET namespace for the container.
`private` Create private NET Namespace for the container. Options are:
`host` Share host NET Namespace with the container. `private` Create private NET Namespace for the container.
`none` Containers do not use the network. `host` Share host NET Namespace with the container.
`none` Containers do not use the network.
**no_hosts**=false **no_hosts**=false
Create /etc/hosts for the container. By default, container engines manage
Create /etc/hosts for the container. By default, container engines manage
/etc/hosts, automatically adding the container's own IP address. /etc/hosts, automatically adding the container's own IP address.
**pids_limit**=1024 **pids_limit**=1024
Maximum number of processes allowed in a container. 0 indicates that no limit
Maximum number of processes allowed in a container. 0 indicates that no limit
is imposed. is imposed.
**pidns**="private" **pidns**="private"
Default way to to create a PID namespace for the container.
Options are: Default way to to create a PID namespace for the container.
`private` Create private PID Namespace for the container. Options are:
`host` Share host PID Namespace with the container. `private` Create private PID Namespace for the container.
`host` Share host PID Namespace with the container.
**seccomp_profile**="/usr/share/containers/seccomp.json" **seccomp_profile**="/usr/share/containers/seccomp.json"
Path to the seccomp.json profile which is used as the default seccomp profile
Path to the seccomp.json profile which is used as the default seccomp profile
for the runtime. for the runtime.
**shm_size**="65536k" **shm_size**="65536k"
Size of `/dev/shm`. The format is `<number><unit>`. `number` must be greater
Size of `/dev/shm`. The format is `<number><unit>`. `number` must be greater
than `0`. than `0`.
Unit is optional and can be: Unit is optional and can be:
`b` (bytes), `k` (kilobytes), `m`(megabytes), or `g` (gigabytes). `b` (bytes), `k` (kilobytes), `m`(megabytes), or `g` (gigabytes).
If you omit the unit, the system uses bytes. If you omit the size entirely, If you omit the unit, the system uses bytes. If you omit the size entirely,
the system uses `65536k`. the system uses `65536k`.
**tz=**""
Set timezone in container. Takes IANA timezones as well as `local`, which sets the timezone in the container to match the host machine.
If not set, then containers will run with the time zone specified in the image.
Examples:
`tz="local"`
`tz="America/New_York"`
**umask**="0022"
Sets umask inside the container.
**utsns**="private" **utsns**="private"
Default way to to create a UTS namespace for the container.
Options are: Default way to to create a UTS namespace for the container.
`private` Create private UTS Namespace for the container. Options are:
`host` Share host UTS Namespace with the container. `private` Create private UTS Namespace for the container.
`host` Share host UTS Namespace with the container.
**userns**="host" **userns**="host"
Default way to to create a USER namespace for the container.
Options are: Default way to to create a USER namespace for the container.
`private` Create private USER Namespace for the container. Options are:
`host` Share host USER Namespace with the container. `private` Create private USER Namespace for the container.
`host` Share host USER Namespace with the container.
**userns_size**=65536 **userns_size**=65536
Number of UIDs to allocate for the automatic container creation. UIDs are
Number of UIDs to allocate for the automatic container creation. UIDs are
allocated from the “container” UIDs listed in /etc/subuid & /etc/subgid. allocated from the “container” UIDs listed in /etc/subuid & /etc/subgid.
## NETWORK TABLE ## NETWORK TABLE
@ -216,140 +264,229 @@ The `network` table contains settings pertaining to the management of CNI
plugins. plugins.
**cni_plugin_dirs**=["/opt/cni/bin/",] **cni_plugin_dirs**=["/opt/cni/bin/",]
List of paths to directories where CNI plugin binaries are located.
List of paths to directories where CNI plugin binaries are located.
**default_network**="podman" **default_network**="podman"
The network name of the default CNI network to attach pods to.
The network name of the default CNI network to attach pods to.
**network_config_dir**="/etc/cni/net.d/" **network_config_dir**="/etc/cni/net.d/"
Path to the directory where CNI configuration files are located.
Path to the directory where CNI configuration files are located.
## ENGINE TABLE ## ENGINE TABLE
The `engine` table contains configuration options used to set up container engines such as Podman and Buildah. The `engine` table contains configuration options used to set up container engines such as Podman and Buildah.
**image_build_format**="oci"
The default image format to building container images. Valid values are "oci" (default) or "docker".
**cgroup_check**=false **cgroup_check**=false
CgroupCheck indicates the configuration has been rewritten after an upgrade to Fedora 31 to change the default OCI runtime for cgroupsv2. CgroupCheck indicates the configuration has been rewritten after an upgrade to Fedora 31 to change the default OCI runtime for cgroupsv2.
**cgroup_manager**="systemd" **cgroup_manager**="systemd"
The cgroup management implementation used for the runtime. Supports `cgroupfs`
The cgroup management implementation used for the runtime. Supports `cgroupfs`
and `systemd`. and `systemd`.
**conmon_env_vars**=[] **conmon_env_vars**=[]
Environment variables to pass into Conmon.
Environment variables to pass into Conmon.
**conmon_path**=[] **conmon_path**=[]
Paths to search for the conmon container manager binary. If the paths are
Paths to search for the conmon container manager binary. If the paths are
empty or no valid path was found, then the `$PATH` environment variable will be empty or no valid path was found, then the `$PATH` environment variable will be
used as the fallback. used as the fallback.
The default list is: The default list is:
``` ```
conmon_path=[ conmon_path=[
"/usr/libexec/podman/conmon", "/usr/libexec/podman/conmon",
"/usr/local/libexec/podman/conmon", "/usr/local/libexec/podman/conmon",
"/usr/local/lib/podman/conmon", "/usr/local/lib/podman/conmon",
"/usr/bin/conmon", "/usr/bin/conmon",
"/usr/sbin/conmon", "/usr/sbin/conmon",
"/usr/local/bin/conmon", "/usr/local/bin/conmon",
"/usr/local/sbin/conmon", "/usr/local/sbin/conmon",
"/run/current-system/sw/bin/conmon", "/run/current-system/sw/bin/conmon",
] ]
``` ```
**detach_keys**="ctrl-p,ctrl-q" **detach_keys**="ctrl-p,ctrl-q"
Keys sequence used for detaching a container.
Specify the keys sequence used to detach a container. Keys sequence used for detaching a container.
Specify the keys sequence used to detach a container.
Format is a single character `[a-Z]` or a comma separated sequence of Format is a single character `[a-Z]` or a comma separated sequence of
`ctrl-<value>`, where `<value>` is one of: `ctrl-<value>`, where `<value>` is one of:
`a-z`, `@`, `^`, `[`, `\`, `]`, `^` or `_` `a-z`, `@`, `^`, `[`, `\`, `]`, `^` or `_`
**enable_port_reservation**=true **enable_port_reservation**=true
Determines whether the engine will reserve ports on the host when they are
Determines whether the engine will reserve ports on the host when they are
forwarded to containers. When enabled, when ports are forwarded to containers, forwarded to containers. When enabled, when ports are forwarded to containers,
they are held open by conmon as long as the container is running, ensuring that they are held open by conmon as long as the container is running, ensuring that
they cannot be reused by other programs on the host. However, this can cause they cannot be reused by other programs on the host. However, this can cause
significant memory usage if a container has many ports forwarded to it. significant memory usage if a container has many ports forwarded to it.
Disabling this can save memory. Disabling this can save memory.
**env**=[]
Environment variables to be used when running the container engine (e.g., Podman, Buildah). For example "http_proxy=internal.proxy.company.com".
Note these environment variables will not be used within the container. Set the env section under [containers] table,
if you want to set environment variables for the container.
**events_logger**="journald" **events_logger**="journald"
Default method to use when logging events.
Valid values: `file`, `journald`, and `none`. Default method to use when logging events.
Valid values: `file`, `journald`, and `none`.
**hooks_dir**=["/etc/containers/oci/hooks.d", ...]
Path to the OCI hooks directories for automatically executed hooks.
**image_default_transport**="docker://" **image_default_transport**="docker://"
Default transport method for pulling and pushing images.
Default transport method for pulling and pushing images.
**infra_command**="/pause" **infra_command**="/pause"
Command to run the infra container.
Command to run the infra container.
**infra_image**="k8s.gcr.io/pause:3.2" **infra_image**="k8s.gcr.io/pause:3.2"
Infra (pause) container image name for pod infra containers. When running a
Infra (pause) container image name for pod infra containers. When running a
pod, we start a `pause` process in a container to hold open the namespaces pod, we start a `pause` process in a container to hold open the namespaces
associated with the pod. This container does nothing other then sleep, associated with the pod. This container does nothing other then sleep,
reserving the pods resources for the lifetime of the pod. reserving the pods resources for the lifetime of the pod.
**lock_type**="shm" **lock_type**="shm"
Specify the locking mechanism to use; valid values are "shm" and "file".
Specify the locking mechanism to use; valid values are "shm" and "file".
Change the default only if you are sure of what you are doing, in general Change the default only if you are sure of what you are doing, in general
"file" is useful only on platforms where cgo is not available for using the "file" is useful only on platforms where cgo is not available for using the
faster "shm" lock type. You may need to run "podman system renumber" after you faster "shm" lock type. You may need to run "podman system renumber" after you
change the lock type. change the lock type.
**multi_image_archive**=false
Allows for creating archives (e.g., tarballs) with more than one image. Some container engines, such as Podman, interpret additional arguments as tags for one image and hence do not store more than one image. The default behavior can be altered with this option.
**namespace**="" **namespace**=""
Default engine namespace. If the engine is joined to a namespace, it will see
Default engine namespace. If the engine is joined to a namespace, it will see
only containers and pods that were created in the same namespace, and will only containers and pods that were created in the same namespace, and will
create new containers and pods in that namespace. The default namespace is "", create new containers and pods in that namespace. The default namespace is "",
which corresponds to no namespace. When no namespace is set, all containers which corresponds to no namespace. When no namespace is set, all containers
and pods are visible. and pods are visible.
**network_cmd_path**=""
Path to the slirp4netns binary.
**network_cmd_options**=[]
Default options to pass to the slirp4netns binary.
Example "allow_host_loopback=true"
**no_pivot_root**=false **no_pivot_root**=false
Whether to use chroot instead of pivot_root in the runtime.
Whether to use chroot instead of pivot_root in the runtime.
**num_locks**=2048 **num_locks**=2048
Number of locks available for containers and pods. Each created container or
Number of locks available for containers and pods. Each created container or
pod consumes one lock. The default number available is 2048. If this is pod consumes one lock. The default number available is 2048. If this is
changed, a lock renumbering must be performed, using the changed, a lock renumbering must be performed, using the
`podman system renumber` command. `podman system renumber` command.
**active_service**=""
Name of destination for accessing the Podman service.
**[service_destinations]**
**[service_destinations.{name}]**
**uri="ssh://user@production.example.com/run/user/1001/podman/podman.sock"**
Example URIs:
- **rootless local** - unix://run/user/1000/podman/podman.sock
- **rootless remote** - ssh://user@engineering.lab.company.com/run/user/1000/podman/podman.sock
- **rootfull local** - unix://run/podman/podman.sock
- **rootfull remote** - ssh://root@10.10.1.136:22/run/podman/podman.sock
**identity="~/.ssh/id_rsa**
Path to file containing ssh identity key
**pull_policy**="always"|"missing"|"never" **pull_policy**="always"|"missing"|"never"
Pull image before running or creating a container. The default is **missing**. Pull image before running or creating a container. The default is **missing**.
- **missing**: attempt to pull the latest image from the registries listed in registries.conf if a local image does not exist. Raise an error if the image is not in any listed registry and is not present locally. - **missing**: attempt to pull the latest image from the registries listed in registries.conf if a local image does not exist. Raise an error if the image is not in any listed registry and is not present locally.
- **always**: pull the image from the first registry it is found in as listed in registries.conf. Raise an error if not found in the registries, even if the image is present locally. - **always**: pull the image from the first registry it is found in as listed in registries.conf. Raise an error if not found in the registries, even if the image is present locally.
- **never**: do not pull the image from the registry, use only the local version. Raise an error if the image is not present locally. - **never**: do not pull the image from the registry, use only the local version. Raise an error if the image is not present locally.
**runtime**="crun" **remote** = false
Default OCI specific runtime in runtimes that will be used by default. Must Indicates whether the application should be running in remote mode. This flag modifies the
refer to a member of the runtimes table. --remote option on container engines. Setting the flag to true will default `podman --remote=true` for access to the remote Podman service.
**runtime**=""
Default OCI specific runtime in runtimes that will be used by default. Must
refer to a member of the runtimes table. Default runtime will be searched for
on the system using the priority: "crun", "runc", "kata".
**runtime_supports_json**=["crun", "runc", "kata"] **runtime_supports_json**=["crun", "runc", "kata"]
The list of the OCI runtimes that support `--format=json`.
The list of the OCI runtimes that support `--format=json`.
**runtime_supports_nocgroups**=["crun"] **runtime_supports_nocgroups**=["crun"]
The list of OCI runtimes that support running containers without CGroups.
The list of OCI runtimes that support running containers without CGroups.
**runtime_supports_kvm**=["kata"] **runtime_supports_kvm**=["kata"]
The list of OCI runtimes that support running containers with KVM separation.
The list of OCI runtimes that support running containers with KVM separation.
**static_dir**="/var/lib/containers/storage/libpod" **static_dir**="/var/lib/containers/storage/libpod"
Directory for persistent libpod files (database, etc).
Directory for persistent libpod files (database, etc).
By default this will be configured relative to where containers/storage By default this will be configured relative to where containers/storage
stores containers. stores containers.
**stop_timeout**=10 **stop_timeout**=10
Number of seconds to wait for container to exit before sending kill signal.
**tmp_dir**="/var/run/libpod" Number of seconds to wait for container to exit before sending kill signal.
The path to a temporary directory to store per-boot container.
**tmp_dir**="/run/libpod"
The path to a temporary directory to store per-boot container.
Must be a tmpfs (wiped after reboot). Must be a tmpfs (wiped after reboot).
**volume_path**="/var/lib/containers/storage/volumes" **volume_path**="/var/lib/containers/storage/volumes"
Directory where named volumes will be created in using the default volume
Directory where named volumes will be created in using the default volume
driver. driver.
By default this will be configured relative to where containers/storage store By default this will be configured relative to where containers/storage store
containers. This convention is followed by the default volume driver, but may containers. This convention is followed by the default volume driver, but may
not be by other drivers. not be by other drivers.
**[engine.volume_plugins]**
A table of all the enabled volume plugins on the system. Volume plugins can be
used as the backend for Podman named volumes. Individual plugins are specified
below, as a map of the plugin name (what the plugin will be called) to its path
(filepath of the plugin's unix socket).
# FILES # FILES
**containers.conf**
Distributions often provide a `/usr/share/containers/containers.conf` file to Distributions often provide a `/usr/share/containers/containers.conf` file to
define default container configuration. Administrators can override fields in define default container configuration. Administrators can override fields in
this file by creating `/etc/containers/containers.conf` to specify their own this file by creating `/etc/containers/containers.conf` to specify their own
@ -363,6 +500,16 @@ this path will be used. This is primarily used for testing.
Fields specified in the containers.conf file override the default options, as Fields specified in the containers.conf file override the default options, as
well as options in previously read containers.conf files. well as options in previously read containers.conf files.
**storage.conf**
The `/etc/containers/storage.conf` file is the default storage configuration file.
Rootless users can override fields in the storage config by creating
`$HOME/.config/containers/storage.conf`.
If the `CONTAINERS_STORAGE_CONF` path environment variable is set, this path
is used for the storage.conf file rather than the default.
This is primarily used for testing.
# SEE ALSO # SEE ALSO
containers-storage.conf(5), containers-policy.json(5), containers-registries.conf(5) containers-storage.conf(5), containers-policy.json(5), containers-registries.conf(5)

2
SOURCES/registries.conf
View File

@ -61,7 +61,7 @@ registries = []
# mirrors: # mirrors:
# #
# # An array of host[:port] registries to try when pulling an unqualified image, in order. # # An array of host[:port] registries to try when pulling an unqualified image, in order.
# unqualified-search-registries = ["example.com"] unqualified-search-registries = ["registry.fedoraproject.org", "registry.access.redhat.com", "registry.centos.org", "docker.io"]
# #
# [[registry]] # [[registry]]
# # The "prefix" field is used to choose the relevant [[registry]] TOML table; # # The "prefix" field is used to choose the relevant [[registry]] TOML table;

2352
SOURCES/rhel-shortnames.conf Normal file
View File

File diff suppressed because it is too large Load Diff

175
SOURCES/seccomp.json
View File

@ -52,6 +52,8 @@
"syscalls": [ "syscalls": [
{ {
"names": [ "names": [
"_llseek",
"_newselect",
"accept", "accept",
"accept4", "accept4",
"access", "access",
@ -66,11 +68,16 @@
"chown", "chown",
"chown32", "chown32",
"clock_adjtime", "clock_adjtime",
"clock_adjtime64",
"clock_getres", "clock_getres",
"clock_getres_time64",
"clock_gettime", "clock_gettime",
"clock_gettime64",
"clock_nanosleep", "clock_nanosleep",
"clone", "clock_nanosleep_time64",
"clone",
"close", "close",
"close_range",
"connect", "connect",
"copy_file_range", "copy_file_range",
"creat", "creat",
@ -91,6 +98,7 @@
"exit", "exit",
"exit_group", "exit_group",
"faccessat", "faccessat",
"faccessat2",
"fadvise64", "fadvise64",
"fadvise64_64", "fadvise64_64",
"fallocate", "fallocate",
@ -120,6 +128,8 @@
"ftruncate64", "ftruncate64",
"futex", "futex",
"futimesat", "futimesat",
"get_robust_list",
"get_thread_area",
"getcpu", "getcpu",
"getcwd", "getcwd",
"getdents", "getdents",
@ -145,12 +155,10 @@
"getresuid", "getresuid",
"getresuid32", "getresuid32",
"getrlimit", "getrlimit",
"get_robust_list",
"getrusage", "getrusage",
"getsid", "getsid",
"getsockname", "getsockname",
"getsockopt", "getsockopt",
"get_thread_area",
"gettid", "gettid",
"gettimeofday", "gettimeofday",
"getuid", "getuid",
@ -161,15 +169,15 @@
"inotify_init1", "inotify_init1",
"inotify_rm_watch", "inotify_rm_watch",
"io_cancel", "io_cancel",
"ioctl",
"io_destroy", "io_destroy",
"io_getevents", "io_getevents",
"ioprio_get",
"ioprio_set",
"io_setup", "io_setup",
"io_submit", "io_submit",
"ioctl",
"ioprio_get",
"ioprio_set",
"ipc", "ipc",
"keyctl", "keyctl",
"kill", "kill",
"lchown", "lchown",
"lchown32", "lchown32",
@ -179,7 +187,6 @@
"listen", "listen",
"listxattr", "listxattr",
"llistxattr", "llistxattr",
"_llseek",
"lremovexattr", "lremovexattr",
"lseek", "lseek",
"lsetxattr", "lsetxattr",
@ -197,6 +204,7 @@
"mlockall", "mlockall",
"mmap", "mmap",
"mmap2", "mmap2",
"mount",
"mprotect", "mprotect",
"mq_getsetattr", "mq_getsetattr",
"mq_notify", "mq_notify",
@ -213,23 +221,29 @@
"munlock", "munlock",
"munlockall", "munlockall",
"munmap", "munmap",
"name_to_handle_at",
"nanosleep", "nanosleep",
"newfstatat", "newfstatat",
"_newselect",
"open", "open",
"openat", "openat",
"openat2",
"pause", "pause",
"pidfd_getfd",
"pidfd_open",
"pidfd_send_signal",
"pipe", "pipe",
"pipe2", "pipe2",
"pivot_root", "pivot_root",
"poll", "poll",
"ppoll", "ppoll",
"ppoll_time64",
"prctl", "prctl",
"pread64", "pread64",
"preadv", "preadv",
"preadv2", "preadv2",
"prlimit64", "prlimit64",
"pselect6", "pselect6",
"pselect6_time64",
"pwrite64", "pwrite64",
"pwritev", "pwritev",
"pwritev2", "pwritev2",
@ -238,6 +252,7 @@
"readlink", "readlink",
"readlinkat", "readlinkat",
"readv", "readv",
"reboot",
"recv", "recv",
"recvfrom", "recvfrom",
"recvmmsg", "recvmmsg",
@ -257,11 +272,11 @@
"rt_sigsuspend", "rt_sigsuspend",
"rt_sigtimedwait", "rt_sigtimedwait",
"rt_tgsigqueueinfo", "rt_tgsigqueueinfo",
"sched_get_priority_max",
"sched_get_priority_min",
"sched_getaffinity", "sched_getaffinity",
"sched_getattr", "sched_getattr",
"sched_getparam", "sched_getparam",
"sched_get_priority_max",
"sched_get_priority_min",
"sched_getscheduler", "sched_getscheduler",
"sched_rr_get_interval", "sched_rr_get_interval",
"sched_setaffinity", "sched_setaffinity",
@ -281,6 +296,9 @@
"sendmmsg", "sendmmsg",
"sendmsg", "sendmsg",
"sendto", "sendto",
"set_robust_list",
"set_thread_area",
"set_tid_address",
"setfsgid", "setfsgid",
"setfsgid32", "setfsgid32",
"setfsuid", "setfsuid",
@ -301,11 +319,8 @@
"setreuid", "setreuid",
"setreuid32", "setreuid32",
"setrlimit", "setrlimit",
"set_robust_list",
"setsid", "setsid",
"setsockopt", "setsockopt",
"set_thread_area",
"set_tid_address",
"setuid", "setuid",
"setuid32", "setuid32",
"setxattr", "setxattr",
@ -339,36 +354,37 @@
"time", "time",
"timer_create", "timer_create",
"timer_delete", "timer_delete",
"timerfd_create",
"timerfd_gettime",
"timerfd_settime",
"timer_getoverrun", "timer_getoverrun",
"timer_gettime", "timer_gettime",
"timer_gettime64",
"timer_settime", "timer_settime",
"timerfd_create",
"timerfd_gettime",
"timerfd_gettime64",
"timerfd_settime",
"timerfd_settime64",
"times", "times",
"tkill", "tkill",
"truncate", "truncate",
"truncate64", "truncate64",
"ugetrlimit", "ugetrlimit",
"umask", "umask",
"umount",
"umount2",
"uname", "uname",
"unlink", "unlink",
"unlinkat", "unlinkat",
"unshare",
"utime", "utime",
"utimensat", "utimensat",
"utimensat_time64",
"utimes", "utimes",
"vfork", "vfork",
"vmsplice",
"wait4", "wait4",
"waitid", "waitid",
"waitpid", "waitpid",
"write", "write",
"writev", "writev"
"mount",
"umount2",
"reboot",
"name_to_handle_at",
"unshare"
], ],
"action": "SCMP_ACT_ALLOW", "action": "SCMP_ACT_ALLOW",
"args": [], "args": [],
@ -530,8 +546,7 @@
"names": [ "names": [
"s390_pci_mmio_read", "s390_pci_mmio_read",
"s390_pci_mmio_write", "s390_pci_mmio_write",
"s390_runtime_instr", "s390_runtime_instr"
"clone"
], ],
"action": "SCMP_ACT_ALLOW", "action": "SCMP_ACT_ALLOW",
"args": [], "args": [],
@ -749,8 +764,7 @@
"settimeofday", "settimeofday",
"stime", "stime",
"clock_settime", "clock_settime",
"clock_adjtime", "clock_settime64"
"adjtimex"
], ],
"action": "SCMP_ACT_ALLOW", "action": "SCMP_ACT_ALLOW",
"args": [], "args": [],
@ -775,6 +789,111 @@
] ]
}, },
"excludes": {} "excludes": {}
},
{
"names": [
"socket"
],
"action": "SCMP_ACT_ERRNO",
"args": [
{
"index": 0,
"value": 16,
"valueTwo": 0,
"op": "SCMP_CMP_EQ"
},
{
"index": 2,
"value": 9,
"valueTwo": 0,
"op": "SCMP_CMP_EQ"
}
],
"comment": "",
"includes": {},
"excludes": {
"caps": [
"CAP_AUDIT_WRITE"
]
},
"errnoRet": 22
},
{
"names": [
"socket"
],
"action": "SCMP_ACT_ALLOW",
"args": [
{
"index": 2,
"value": 9,
"valueTwo": 0,
"op": "SCMP_CMP_NE"
}
],
"comment": "",
"includes": {},
"excludes": {
"caps": [
"CAP_AUDIT_WRITE"
]
}
},
{
"names": [
"socket"
],
"action": "SCMP_ACT_ALLOW",
"args": [
{
"index": 0,
"value": 16,
"valueTwo": 0,
"op": "SCMP_CMP_NE"
}
],
"comment": "",
"includes": {},
"excludes": {
"caps": [
"CAP_AUDIT_WRITE"
]
}
},
{
"names": [
"socket"
],
"action": "SCMP_ACT_ALLOW",
"args": [
{
"index": 2,
"value": 9,
"valueTwo": 0,
"op": "SCMP_CMP_NE"
}
],
"comment": "",
"includes": {},
"excludes": {
"caps": [
"CAP_AUDIT_WRITE"
]
}
},
{
"names": [
"socket"
],
"action": "SCMP_ACT_ALLOW",
"args": null,
"comment": "",
"includes": {
"caps": [
"CAP_AUDIT_WRITE"
]
},
"excludes": {}
} }
] ]
} }

55
SOURCES/shortnames.conf Normal file
View File

@ -0,0 +1,55 @@
[aliases]
# centos
"centos" = "quay.io/centos/centos"
# containers
"skopeo" = "quay.io/skopeo/stable"
"buildah" = "quay.io/buildah/stable"
"podman" = "quay.io/podman/stable"
# docker
"alpine" = "docker.io/library/alpine"
"docker" = "docker.io/library/docker"
"registry" = "docker.io/library/registry"
"hello-world" = "docker.io/library/hello-world"
"swarm" = "docker.io/library/swarm"
# Fedora
"fedora-minimal" = "registry.fedoraproject.org/fedora-minimal"
"fedora" = "registry.fedoraproject.org/fedora"
# openSUSE
"opensuse/tumbleweed" = "registry.opensuse.org/opensuse/tumbleweed"
"opensuse/tumbleweed-dnf" = "registry.opensuse.org/opensuse/tumbleweed-dnf"
"opensuse/tumbleweed-microdnf" = "registry.opensuse.org/opensuse/tumbleweed-microdnf"
"opensuse/leap" = "registry.opensuse.org/opensuse/leap"
"opensuse/busybox" = "registry.opensuse.org/opensuse/busybox"
"tumbleweed" = "registry.opensuse.org/opensuse/tumbleweed"
"tumbleweed-dnf" = "registry.opensuse.org/opensuse/tumbleweed-dnf"
"tumbleweed-microdnf" = "registry.opensuse.org/opensuse/tumbleweed-microdnf"
"leap" = "registry.opensuse.org/opensuse/leap"
"tw-busybox" = "registry.opensuse.org/opensuse/busybox"
# SUSE
"suse/sle15" = "registry.suse.com/suse/sle15"
"suse/sles12sp5" = "registry.suse.com/suse/sles12sp5"
"suse/sles12sp4" = "registry.suse.com/suse/sles12sp4"
"suse/sles12sp3" = "registry.suse.com/suse/sles12sp3"
"sle15" = "registry.suse.com/suse/sle15"
"sles12sp5" = "registry.suse.com/suse/sles12sp5"
"sles12sp4" = "registry.suse.com/suse/sles12sp4"
"sles12sp3" = "registry.suse.com/suse/sles12sp3"
# Red Hat Enterprise Linux
"rhel" = "registry.access.redhat.com/rhel"
"rhel6" = "registry.access.redhat.com/rhel6"
"rhel7" = "registry.access.redhat.com/rhel7"
"ubi7" = "registry.access.redhat.com/ubi7"
"ubi7-init" = "registry.access.redhat.com/ubi7-init"
"ubi7-minimal" = "registry.access.redhat.com/ubi7-minimal"
"ubi8" = "registry.access.redhat.com/ubi8"
"ubi8-minimal" = "registry.access.redhat.com/ubi8-minimal"
"ubi8-init" = "registry.access.redhat.com/ubi8-init"
"ubi8-micro" = "registry.access.redhat.com/ubi8-micro"
"ubi8/ubi" = "registry.access.redhat.com/ubi8/ubi"
"ubi8/ubi-minimal" = "registry.access.redhat.com/ubi8-minimal"
"ubi8/ubi-init" = "registry.access.redhat.com/ubi8-init"
"ubi8/ubi-micro" = "registry.access.redhat.com/ubi8-micro"
# Debian
"debian" = "docker.io/library/debian"
# Oracle Linux
"oraclelinux" = "container-registry.oracle.com/os/oraclelinux"

48
SOURCES/storage.conf
View File

@ -4,11 +4,11 @@
# The "container storage" table contains all of the server options. # The "container storage" table contains all of the server options.
[storage] [storage]
# Default Storage Driver # Default Storage Driver, Must be set for proper operation.
driver = "overlay" driver = "overlay"
# Temporary storage location # Temporary storage location
runroot = "/var/run/containers/storage" runroot = "/run/containers/storage"
# Primary Read/Write location of container storage # Primary Read/Write location of container storage
graphroot = "/var/lib/containers/storage" graphroot = "/var/lib/containers/storage"
@ -47,7 +47,7 @@ additionalimagestores = [
# remap-group = "containers" # remap-group = "containers"
# Root-auto-userns-user is a user name which can be used to look up one or more UID/GID # Root-auto-userns-user is a user name which can be used to look up one or more UID/GID
# ranges in the /etc/subuid and /etc/subgid file. These ranges will be partioned # ranges in the /etc/subuid and /etc/subgid file. These ranges will be partitioned
# to containers configured to create automatically a user namespace. Containers # to containers configured to create automatically a user namespace. Containers
# configured to automatically create a user namespace can still overlap with containers # configured to automatically create a user namespace can still overlap with containers
# having an explicit mapping set. # having an explicit mapping set.
@ -67,7 +67,7 @@ additionalimagestores = [
# squashed down to the default uid in the container. These images will have no # squashed down to the default uid in the container. These images will have no
# separation between the users in the container. Only supported for the overlay # separation between the users in the container. Only supported for the overlay
# and vfs drivers. # and vfs drivers.
#ignore_chown_errors = false #ignore_chown_errors = "false"
# Path to an helper program to use for mounting the file system instead of mounting it # Path to an helper program to use for mounting the file system instead of mounting it
# directly. # directly.
@ -76,9 +76,45 @@ additionalimagestores = [
# mountopt specifies comma separated list of extra mount options # mountopt specifies comma separated list of extra mount options
mountopt = "nodev,metacopy=on" mountopt = "nodev,metacopy=on"
# Set to skip a PRIVATE bind mount on the storage home directory.
# skip_mount_home = "false"
# Size is used to set a maximum size of the container image. # Size is used to set a maximum size of the container image.
# size = "" # size = ""
# ForceMask specifies the permissions mask that is used for new files and
# directories.
#
# The values "shared" and "private" are accepted.
# Octal permission masks are also accepted.
#
# "": No value specified.
# All files/directories, get set with the permissions identified within the
# image.
# "private": it is equivalent to 0700.
# All files/directories get set with 0700 permissions. The owner has rwx
# access to the files. No other users on the system can access the files.
# This setting could be used with networked based homedirs.
# "shared": it is equivalent to 0755.
# The owner has rwx access to the files and everyone else can read, access
# and execute them. This setting is useful for sharing containers storage
# with other users. For instance have a storage owned by root but shared
# to rootless users as an additional store.
# NOTE: All files within the image are made readable and executable by any
# user on the system. Even /etc/shadow within your image is now readable by
# any user.
#
# OCTAL: Users can experiment with other OCTAL Permissions.
#
# Note: The force_mask Flag is an experimental feature, it could change in the
# future. When "force_mask" is set the original permission mask is stored in
# the "user.containers.override_stat" xattr and the "mount_program" option must
# be specified. Mount programs like "/usr/bin/fuse-overlayfs" present the
# extended attribute permissions to processes within containers rather then the
# "force_mask" permissions.
#
# force_mask = ""
[storage.options.thinpool] [storage.options.thinpool]
# Storage Options for thinpool # Storage Options for thinpool
@ -129,6 +165,10 @@ mountopt = "nodev,metacopy=on"
# device. # device.
# mkfsarg = "" # mkfsarg = ""
# metadata_size is used to set the `pvcreate --metadatasize` options when
# creating thin devices. Default is 128k
# metadata_size = ""
# Size is used to set a maximum size of the container image. # Size is used to set a maximum size of the container image.
# size = "" # size = ""

247
SPECS/skopeo.spec
View File

@ -1,55 +1,64 @@
%global with_debug 1
%global with_check 0 %global with_check 0
%if 0%{?with_debug}
%global _find_debuginfo_dwz_opts %{nil} %global _find_debuginfo_dwz_opts %{nil}
%global _dwz_low_mem_die_limit 0 %global _dwz_low_mem_die_limit 0
%else
%global debug_package %{nil}
%endif
%if 0%{?rhel} > 7 && ! 0%{?fedora} %if 0%{?rhel} > 7 && ! 0%{?fedora}
%define gobuild(o:) \ %define gobuild(o:) \
go build -buildmode pie -compiler gc -tags="rpm_crashtraceback libtrust_openssl ${BUILDTAGS:-}" -ldflags "${LDFLAGS:-} -compressdwarf=false -B 0x$(head -c20 /dev/urandom|od -An -tx1|tr -d ' \\n') -extldflags '%__global_ldflags'" -a -v -x %{?**}; go build -buildmode pie -compiler gc -tags="rpm_crashtraceback libtrust_openssl ${BUILDTAGS:-}" -ldflags "${LDFLAGS:-} -compressdwarf=false -B 0x$(head -c20 /dev/urandom|od -An -tx1|tr -d ' \\n') -extldflags '%__global_ldflags'" -a -v %{?**};
%else
%define gobuild(o:) GO111MODULE=off go build -buildmode pie -compiler gc -tags="rpm_crashtraceback ${BUILDTAGS:-}" -ldflags "${LDFLAGS:-} -B 0x$(head -c20 /dev/urandom|od -An -tx1|tr -d ' \\n') -extldflags '-Wl,-z,relro -Wl,-z,now -specs=/usr/lib/rpm/redhat/redhat-hardened-ld '" -a -v %{?**};
%endif %endif
%global provider github %global import_path github.com/containers/skopeo
%global provider_tld com %global branch release-1.2
%global project containers # Bellow definitions are used to deliver config files from a particular branch
%global repo skopeo # of c/image, c/common, c/storage vendored in all podman, skopeo, buildah.
# https://github.com/containers/skopeo # These vendored components must have the same version. If it is not the case,
%global provider_prefix %{provider}.%{provider_tld}/%{project}/%{repo} # pick the oldest version on c/image, c/common, c/storage vendored in
%global import_path %{provider_prefix} # podman/skopeo/podman.
%global git0 https://%{import_path} %global podman_branch v3.0
%global branch master %global image_branch v5.9.0
%global common_branch v0.33.0
%global storage_branch v1.24.5
%global shortnames_branch main
%global commit0 e72dd9c5c834f3cd7fb8b1aab4021d9d4412f305
%global shortcommit0 %(c=%{commit0}; echo ${c:0:7})
Epoch: 1 Epoch: 1
Name: %{repo} Name: skopeo
Version: 1.1.0 Version: 1.2.2
Release: 1%{?dist} Release: 2%{?dist}
Summary: Inspect container images and repositories on registries Summary: Inspect container images and repositories on registries
License: ASL 2.0 License: ASL 2.0
URL: %{git0} URL: %{git0}
# Build fails with: No matching package to install: 'golang >= 1.12.12-4' on i686 # https://fedoraproject.org/wiki/PackagingDrafts/Go#Go_Language_Architectures
ExcludeArch: i686 ExclusiveArch: %{go_arches}
Source0: %{git0}/archive/v%{version}.tar.gz %if 0%{?branch:1}
#Source1: https://raw.githubusercontent.com/containers/storage/%%{branch}/storage.conf Source0: https://%{import_path}/tarball/%{commit0}/%{branch}-%{shortcommit0}.tar.gz
Source1: https://src.fedoraproject.org/rpms/skopeo/raw/master/f/storage.conf %else
Source2: https://raw.githubusercontent.com/containers/storage/%{branch}/docs/containers-storage.conf.5.md Source0: https://%{import_path}/archive/%{commit0}/%{name}-%{version}-%{shortcommit0}.tar.gz
%endif
Source1: https://raw.githubusercontent.com/containers/storage/%{storage_branch}/storage.conf
Source2: https://raw.githubusercontent.com/containers/storage/%{storage_branch}/docs/containers-storage.conf.5.md
Source3: mounts.conf Source3: mounts.conf
Source4: https://raw.githubusercontent.com/containers/image/%{branch}/docs/containers-registries.conf.5.md Source4: https://raw.githubusercontent.com/containers/image/%{image_branch}/docs/containers-registries.conf.5.md
#Source5: https://raw.githubusercontent.com/containers/image/%%{image_branch}/registries.conf
Source5: registries.conf Source5: registries.conf
Source6: https://raw.githubusercontent.com/containers/image/%{branch}/docs/containers-policy.json.5.md Source6: https://raw.githubusercontent.com/containers/image/%{image_branch}/docs/containers-policy.json.5.md
#Source7: https://raw.githubusercontent.com/containers/libpod/%%{branch}/seccomp.json Source7: https://raw.githubusercontent.com/containers/common/%{common_branch}/pkg/seccomp/seccomp.json
Source7: https://src.fedoraproject.org/rpms/skopeo/raw/master/f/seccomp.json Source8: https://raw.githubusercontent.com/containers/podman/%{podman_branch}/docs/source/markdown/containers-mounts.conf.5.md
Source8: https://raw.githubusercontent.com/containers/libpod/%{branch}/docs/source/markdown/containers-mounts.conf.5.md Source9: https://raw.githubusercontent.com/containers/image/%{image_branch}/docs/containers-signature.5.md
Source9: https://raw.githubusercontent.com/containers/image/%{branch}/docs/containers-signature.5.md Source10: https://raw.githubusercontent.com/containers/image/%{image_branch}/docs/containers-transports.5.md
Source10: https://raw.githubusercontent.com/containers/image/%{branch}/docs/containers-transports.5.md Source11: https://raw.githubusercontent.com/containers/image/%{image_branch}/docs/containers-certs.d.5.md
Source11: https://raw.githubusercontent.com/containers/image/%{branch}/docs/containers-certs.d.5.md Source12: https://raw.githubusercontent.com/containers/image/%{image_branch}/docs/containers-registries.d.5.md
Source12: https://raw.githubusercontent.com/containers/image/%{branch}/docs/containers-registries.d.5.md Source13: https://raw.githubusercontent.com/containers/common/%{common_branch}/pkg/config/containers.conf
Source13: https://raw.githubusercontent.com/containers/common/%{branch}/pkg/config/containers.conf Source14: https://raw.githubusercontent.com/containers/common/%{common_branch}/docs/containers.conf.5.md
Source14: https://raw.githubusercontent.com/containers/common/%{branch}/docs/containers.conf.5.md Source15: https://raw.githubusercontent.com/containers/image/%{image_branch}/docs/containers-auth.json.5.md
Source15: https://raw.githubusercontent.com/containers/image/%{branch}/docs/containers-auth.json.5.md Source16: https://raw.githubusercontent.com/containers/image/%{image_branch}/docs/containers-registries.conf.d.5.md
Source17: https://raw.githubusercontent.com/containers/shortnames/%{shortnames_branch}/shortnames.conf
Source18: https://raw.githubusercontent.com/containers/image/%{image_branch}/docs/containers-registries.conf.5.md
Source19: rhel-shortnames.conf
BuildRequires: git BuildRequires: git
BuildRequires: golang >= 1.12.12-4 BuildRequires: golang >= 1.12.12-4
BuildRequires: go-md2man BuildRequires: go-md2man
@ -74,7 +83,7 @@ Provides: %{name}-containers = %{epoch}:%{version}-%{release}
Obsoletes: %{name}-containers <= 1:0.1.31-3 Obsoletes: %{name}-containers <= 1:0.1.31-3
Recommends: fuse-overlayfs Recommends: fuse-overlayfs
Recommends: slirp4netns Recommends: slirp4netns
Recommends: subscription-manager Suggests: subscription-manager
%description -n containers-common %description -n containers-common
This package installs a default signature store configuration and a default This package installs a default signature store configuration and a default
@ -87,6 +96,7 @@ Requires: %{name} = %{epoch}:%{version}-%{release}
Requires: gnupg Requires: gnupg
Requires: jq Requires: jq
Requires: podman Requires: podman
Requires: httpd-tools
%description tests %description tests
%{summary} %{summary}
@ -94,7 +104,13 @@ Requires: podman
This package contains system tests for %{name} This package contains system tests for %{name}
%prep %prep
%autosetup -Sgit %if 0%{?branch:1}
%autosetup -Sgit -n containers-%{name}-%{shortcommit0}
%else
%autosetup -Sgit -n %{name}-%{commit0}
%endif
sed -i 's/install-binary: bin\/%{name}/install-binary:/' Makefile
sed -i 's/install-docs: docs/install-docs:/' Makefile
%build %build
mkdir -p src/github.com/containers mkdir -p src/github.com/containers
@ -110,8 +126,10 @@ done
export GOPATH=$(pwd):$(pwd)/vendor:%{gopath} export GOPATH=$(pwd):$(pwd)/vendor:%{gopath}
export GO111MODULE=off export GO111MODULE=off
export CGO_CFLAGS="%{optflags} -D_GNU_SOURCE -D_LARGEFILE_SOURCE -D_LARGEFILE64_SOURCE -D_FILE_OFFSET_BITS=64"
export BUILDTAGS="exclude_graphdriver_btrfs btrfs_noversion $(hack/libdm_tag.sh) $(hack/ostree_tag.sh)" export BUILDTAGS="exclude_graphdriver_btrfs btrfs_noversion $(hack/libdm_tag.sh) $(hack/ostree_tag.sh)"
%gobuild -o %{name} ./cmd/%{name} mkdir -p bin
%gobuild -o bin/%{name} ./cmd/%{name}
%{__make} docs %{__make} docs
%install %install
@ -119,11 +137,12 @@ make \
DESTDIR=%{buildroot} \ DESTDIR=%{buildroot} \
SIGSTOREDIR=%{buildroot}%{_sharedstatedir}/containers/sigstore \ SIGSTOREDIR=%{buildroot}%{_sharedstatedir}/containers/sigstore \
install install
mkdir -p %{buildroot}%{_sysconfdir} install -dp %{buildroot}%{_sysconfdir}/containers/{certs.d,oci/hooks.d,registries.d,registries.conf.d}
mkdir -p %{buildroot}%{_sysconfdir}/containers/{certs.d,oci/hooks.d}
mkdir -p %{buildroot}%{_mandir}/man5
install -m0644 %{SOURCE1} %{buildroot}%{_sysconfdir}/containers/storage.conf install -m0644 %{SOURCE1} %{buildroot}%{_sysconfdir}/containers/storage.conf
install -p -m 644 %{SOURCE5} %{buildroot}%{_sysconfdir}/containers/ install -m0644 %{SOURCE5} %{buildroot}%{_sysconfdir}/containers/registries.conf
install -m0644 %{SOURCE17} %{buildroot}%{_sysconfdir}/containers/registries.conf.d/000-shortnames.conf
install -m0644 %{SOURCE19} %{buildroot}%{_sysconfdir}/containers/registries.conf.d/rhel-shortnames.conf
install -dp %{buildroot}%{_mandir}/man5
go-md2man -in %{SOURCE2} -out %{buildroot}%{_mandir}/man5/containers-storage.conf.5 go-md2man -in %{SOURCE2} -out %{buildroot}%{_mandir}/man5/containers-storage.conf.5
go-md2man -in %{SOURCE4} -out %{buildroot}%{_mandir}/man5/containers-registries.conf.5 go-md2man -in %{SOURCE4} -out %{buildroot}%{_mandir}/man5/containers-registries.conf.5
go-md2man -in %{SOURCE6} -out %{buildroot}%{_mandir}/man5/containers-policy.json.5 go-md2man -in %{SOURCE6} -out %{buildroot}%{_mandir}/man5/containers-policy.json.5
@ -132,10 +151,12 @@ go-md2man -in %{SOURCE9} -out %{buildroot}%{_mandir}/man5/containers-signature.5
go-md2man -in %{SOURCE10} -out %{buildroot}%{_mandir}/man5/containers-transports.5 go-md2man -in %{SOURCE10} -out %{buildroot}%{_mandir}/man5/containers-transports.5
go-md2man -in %{SOURCE11} -out %{buildroot}%{_mandir}/man5/containers-certs.d.5 go-md2man -in %{SOURCE11} -out %{buildroot}%{_mandir}/man5/containers-certs.d.5
go-md2man -in %{SOURCE12} -out %{buildroot}%{_mandir}/man5/containers-registries.d.5 go-md2man -in %{SOURCE12} -out %{buildroot}%{_mandir}/man5/containers-registries.d.5
go-md2man -in %{SOURCE18} -out %{buildroot}%{_mandir}/man5/containers-registries.conf.d.5
go-md2man -in %{SOURCE14} -out %{buildroot}%{_mandir}/man5/containers.conf.5 go-md2man -in %{SOURCE14} -out %{buildroot}%{_mandir}/man5/containers.conf.5
go-md2man -in %{SOURCE15} -out %{buildroot}%{_mandir}/man5/containers-auth.json.5 go-md2man -in %{SOURCE15} -out %{buildroot}%{_mandir}/man5/containers-auth.json.5
go-md2man -in %{SOURCE16} -out %{buildroot}%{_mandir}/man5/containers-registries.conf.d.5
mkdir -p %{buildroot}%{_datadir}/containers install -dp %{buildroot}%{_datadir}/containers
install -m0644 %{SOURCE3} %{buildroot}%{_datadir}/containers/mounts.conf install -m0644 %{SOURCE3} %{buildroot}%{_datadir}/containers/mounts.conf
install -m0644 %{SOURCE7} %{buildroot}%{_datadir}/containers/seccomp.json install -m0644 %{SOURCE7} %{buildroot}%{_datadir}/containers/seccomp.json
install -m0644 %{SOURCE13} %{buildroot}%{_datadir}/containers/containers.conf install -m0644 %{SOURCE13} %{buildroot}%{_datadir}/containers/containers.conf
@ -147,6 +168,19 @@ ln -s %{_sysconfdir}/pki/entitlement %{buildroot}%{_datadir}/rhel/secrets/etc-pk
ln -s %{_sysconfdir}/rhsm %{buildroot}%{_datadir}/rhel/secrets/rhsm ln -s %{_sysconfdir}/rhsm %{buildroot}%{_datadir}/rhel/secrets/rhsm
ln -s %{_sysconfdir}/yum.repos.d/redhat.repo %{buildroot}%{_datadir}/rhel/secrets/redhat.repo ln -s %{_sysconfdir}/yum.repos.d/redhat.repo %{buildroot}%{_datadir}/rhel/secrets/redhat.repo
# ship preconfigured /etc/containers/registries.d/ files with containers-common - #1903813
cat <<EOF > %{buildroot}%{_sysconfdir}/containers/registries.d/registry.access.redhat.com.yaml
docker:
registry.access.redhat.com:
sigstore: https://access.redhat.com/webassets/docker/content/sigstore
EOF
cat <<EOF > %{buildroot}%{_sysconfdir}/containers/registries.d/registry.redhat.io.yaml
docker:
registry.redhat.io:
sigstore: https://registry.redhat.io/containers/sigstore
EOF
# system tests # system tests
install -d -p %{buildroot}/%{_datadir}/%{name}/test/system install -d -p %{buildroot}/%{_datadir}/%{name}/test/system
cp -pav systemtest/* %{buildroot}/%{_datadir}/%{name}/test/system/ cp -pav systemtest/* %{buildroot}/%{_datadir}/%{name}/test/system/
@ -167,10 +201,14 @@ export GOPATH=%{buildroot}/%{gopath}:$(pwd)/vendor:%{gopath}
%dir %{_sysconfdir}/containers/registries.d %dir %{_sysconfdir}/containers/registries.d
%dir %{_sysconfdir}/containers/oci %dir %{_sysconfdir}/containers/oci
%dir %{_sysconfdir}/containers/oci/hooks.d %dir %{_sysconfdir}/containers/oci/hooks.d
%dir %{_sysconfdir}/containers/registries.conf.d
%config(noreplace) %{_sysconfdir}/containers/policy.json %config(noreplace) %{_sysconfdir}/containers/policy.json
%config(noreplace) %{_sysconfdir}/containers/registries.d/default.yaml %config(noreplace) %{_sysconfdir}/containers/registries.d/default.yaml
%config(noreplace) %{_sysconfdir}/containers/storage.conf %config(noreplace) %{_sysconfdir}/containers/storage.conf
%config(noreplace) %{_sysconfdir}/containers/registries.conf %config(noreplace) %{_sysconfdir}/containers/registries.conf
%config(noreplace) %{_sysconfdir}/containers/registries.conf.d/000-shortnames.conf
%config(noreplace) %{_sysconfdir}/containers/registries.conf.d/rhel-shortnames.conf
%config(noreplace) %{_sysconfdir}/containers/registries.d/*.yaml
%ghost %{_sysconfdir}/containers/containers.conf %ghost %{_sysconfdir}/containers/containers.conf
%dir %{_sharedstatedir}/containers/sigstore %dir %{_sharedstatedir}/containers/sigstore
%{_mandir}/man5/* %{_mandir}/man5/*
@ -195,6 +233,127 @@ export GOPATH=%{buildroot}/%{gopath}:$(pwd)/vendor:%{gopath}
%{_datadir}/%{name}/test %{_datadir}/%{name}/test
%changelog %changelog
* Tue Mar 02 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.2-2
- update rhel-shortnames.conf to include only trusted registries
- Resolves: #1931785
* Fri Feb 19 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.2-1
- update to the latest content of https://github.com/containers/skopeo/tree/release-1.2
(https://github.com/containers/skopeo/commit/e72dd9c)
- Related: #1883490
* Thu Feb 18 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-14
- rename shortnames.conf to 000-shortnames.conf to assure evaluation order
- Related: #1883490
* Thu Feb 18 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-13
- update to the latest content of https://github.com/containers/skopeo/tree/release-1.2
(https://github.com/containers/skopeo/commit/3abb778)
- Related: #1883490
* Mon Feb 15 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-12
- update to the latest content of https://github.com/containers/skopeo/tree/release-1.2
(https://github.com/containers/skopeo/commit/b4210c0)
- Resolves: #1914884
* Sat Feb 06 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-11
- update to the latest content of https://github.com/containers/skopeo/tree/release-1.2
(https://github.com/containers/skopeo/commit/6c0e35a)
- Related: #1883490
* Tue Feb 02 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-10
- update to the latest content of https://github.com/containers/skopeo/tree/release-1.2
(https://github.com/containers/skopeo/commit/a05ddb8)
- Related: #1883490
* Sun Jan 31 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-9
- define 8.4.0 branch for podman (v3.0)
- remove redundant source file
- Related: #1883490
* Sun Jan 31 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-8
- update to the latest content of https://github.com/containers/skopeo/tree/release-1.2
(https://github.com/containers/skopeo/commit/2e90a8a)
- Related: #1883490
* Fri Jan 29 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-7
- convert subscription-manager from weak dep to a hint
- Related: #1883490
* Tue Jan 19 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-6
- fix rhel-shortnames.conf generation (avoid duplicates and records
with invalid URL)
- Related: #1883490
* Mon Jan 18 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-5
- assure "NET_RAW" is always defined
- support rhel-shortnames.conf with generated shortname/registry aliases
- Related: #1883490
* Fri Jan 15 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-4
- add "NET_RAW" default capability
- Related: #1883490
* Tue Jan 12 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-3
- ship preconfigured /etc/containers/registries.d/ files with containers-common
- Related: #1883490
* Tue Jan 12 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-2
- add shortnames from https://github.com/containers/shortnames
- Related: #1883490
* Mon Jan 11 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.1-1
- update vendored component versions
- update to the latest content of https://github.com/containers/skopeo/tree/release-1.2
(https://github.com/containers/skopeo/commit/2e90a8a)
- Related: #1883490
* Fri Jan 08 2021 Jindrich Novy <jnovy@redhat.com> - 1:1.2.0-6
- gating tests fixes and bump podman branch
- Related: #1883490
* Tue Dec 08 2020 Jindrich Novy <jnovy@redhat.com> - 1:1.2.0-5
- still use arch exclude as the go_arches macro is broken for 8.4
- Related: #1883490
* Wed Dec 02 2020 Jindrich Novy <jnovy@redhat.com> - 1:1.2.0-4
- unify vendored branches
- add validation script
- Related: #1883490
* Thu Nov 05 2020 Jindrich Novy <jnovy@redhat.com> - 1:1.2.0-3
- simplify spec file
- use short commit ID in tarball name
- Related: #1883490
* Fri Oct 23 2020 Jindrich Novy <jnovy@redhat.com> - 1:1.2.0-2
- synchronize with stream-container-tools-rhel8
- Related: #1883490
* Thu Oct 22 2020 Jindrich Novy <jnovy@redhat.com> - 1:1.2.0-1
- synchronize with stream-container-tools-rhel8
- Related: #1883490
* Tue Aug 11 2020 Jindrich Novy <jnovy@redhat.com> - 1:1.1.1-3
- propagate proper CFLAGS to CGO_CFLAGS to assure code hardening and optimization
- Related: #1821193
* Wed Jul 29 2020 Jindrich Novy <jnovy@redhat.com> - 1:1.1.1-2
- drop applied patches
- Related: #1821193
* Wed Jul 29 2020 Jindrich Novy <jnovy@redhat.com> - 1:1.1.1-1
- update to https://github.com/containers/skopeo/releases/tag/v1.1.1
- Related: #1821193
* Thu Jul 23 2020 Eduardo Santiago <santiago@redhat.com> - 1:1.1.0-3
- fix broken gating tests: docker unexpectedly removed htpasswd from
their 'registry:2' image, so we now use htpasswd from httpd-tools on host.
* Fri Jul 17 2020 Jindrich Novy <jnovy@redhat.com> - 1:1.1.0-2
- fix "CVE-2020-14040 skopeo: golang.org/x/text: possibility to trigger an infinite loop in encoding/unicode could lead to crash [rhel-8]"
- Resolves: #1854719
* Fri Jun 19 2020 Jindrich Novy <jnovy@redhat.com> - 1:1.1.0-1 * Fri Jun 19 2020 Jindrich Novy <jnovy@redhat.com> - 1:1.1.0-1
- update to https://github.com/containers/skopeo/releases/tag/v1.1.0 - update to https://github.com/containers/skopeo/releases/tag/v1.1.0
- Related: #1821193 - Related: #1821193