import containers-common-1-52.el9_2
This commit is contained in:
CentOS Sources
Stepan Oksanichenko
parent
59c905b0d2
commit
25f6a4559d
File diff suppressed because it is too large
Load Diff
@ -154,6 +154,47 @@ Current supported mount TYPES are bind, cache, secret and tmpfs.
|
||||
|
||||
· rw, read-write: allows writes on the mount.
|
||||
|
||||
**RUN --network**
|
||||
|
||||
`RUN --network` allows control over which networking environment the command
|
||||
is run in.
|
||||
|
||||
Syntax: `--network=<TYPE>`
|
||||
|
||||
**Network types**
|
||||
|
||||
| Type | Description |
|
||||
|----------------------------------------------|----------------------------------------|
|
||||
| [`default`](#run---networkdefault) (default) | Run in the default network. |
|
||||
| [`none`](#run---networknone) | Run with no network access. |
|
||||
| [`host`](#run---networkhost) | Run in the host's network environment. |
|
||||
|
||||
##### RUN --network=default
|
||||
|
||||
Equivalent to not supplying a flag at all, the command is run in the default
|
||||
network for the build.
|
||||
|
||||
##### RUN --network=none
|
||||
|
||||
The command is run with no network access (`lo` is still available, but is
|
||||
isolated to this process).
|
||||
|
||||
##### Example: isolating external effects
|
||||
|
||||
```dockerfile
|
||||
FROM python:3.6
|
||||
ADD mypackage.tgz wheels/
|
||||
RUN --network=none pip install --find-links wheels mypackage
|
||||
```
|
||||
|
||||
`pip` will only be able to install the packages provided in the tarfile, which
|
||||
can be controlled by an earlier build stage.
|
||||
|
||||
##### RUN --network=host
|
||||
|
||||
The command is run in the host's network environment (similar to
|
||||
`buildah build --network=host`, but on a per-instruction basis)
|
||||
|
||||
|
||||
**RUN Secrets**
|
||||
|
||||
|
||||
@ -30,7 +30,9 @@ Policy requirements can be defined for:
|
||||
|
||||
Usually, a scope can be defined to match a single image, and various prefixes of
|
||||
such a most specific scope define namespaces of matching images.
|
||||
|
||||
- A default policy for a single transport, expressed using an empty string as a scope
|
||||
|
||||
- A global default policy.
|
||||
|
||||
If multiple policy requirements match a given image, only the requirements from the most specific match apply,
|
||||
@ -245,12 +247,37 @@ This requirement requires an image to be signed using a sigstore signature with
|
||||
```js
|
||||
{
|
||||
"type": "sigstoreSigned",
|
||||
"keyPath": "/path/to/local/keyring/file",
|
||||
"keyData": "base64-encoded-keyring-data",
|
||||
"keyPath": "/path/to/local/public/key/file",
|
||||
"keyData": "base64-encoded-public-key-data",
|
||||
"fulcio": {
|
||||
"caPath": "/path/to/local/CA/file",
|
||||
"caData": "base64-encoded-CA-data",
|
||||
"oidcIssuer": "https://expected.OIDC.issuer/",
|
||||
"subjectEmail", "expected-signing-user@example.com",
|
||||
},
|
||||
"rekorPublicKeyPath": "/path/to/local/public/key/file",
|
||||
"rekorPublicKeyData": "base64-encoded-public-key-data",
|
||||
"signedIdentity": identity_requirement
|
||||
}
|
||||
```
|
||||
Exactly one of `keyPath` and `keyData` must be present, containing a sigstore public key. Only signatures made by this key is accepted.
|
||||
Exactly one of `keyPath`, `keyData` and `fulcio` must be present.
|
||||
|
||||
If `keyPath` or `keyData` is present, it contains a sigstore public key.
|
||||
Only signatures made by this key are accepted.
|
||||
|
||||
If `fulcio` is present, the signature must be based on a Fulcio-issued certificate.
|
||||
One of `caPath` and `caData` must be specified, containing the public key of the Fulcio instance.
|
||||
Both `oidcIssuer` and `subjectEmail` are mandatory,
|
||||
exactly specifying the expected identity provider,
|
||||
and the identity of the user obtaining the Fulcio certificate.
|
||||
|
||||
At most one of `rekorPublicKeyPath` and `rekorPublicKeyData` can be present;
|
||||
it is mandatory if `fulcio` is specified.
|
||||
If a Rekor public key is specified,
|
||||
the signature must have been uploaded to a Rekor server
|
||||
and the signature must contain an (offline-verifiable) “signed entry timestamp”
|
||||
proving the existence of the Rekor log record,
|
||||
signed by the provided public key.
|
||||
|
||||
The `signedIdentity` field has the same semantics as in the `signedBy` requirement described above.
|
||||
Note that `cosign`-created signatures only contain a repository, so only `matchRepository` and `exactRepository` can be used to accept them (and that does not protect against substitution of a signed image with an unexpected tag).
|
||||
@ -286,6 +313,21 @@ selectively allow individual transports and scopes as desired.
|
||||
"keyPath": "/path/to/sigstore-pubkey.pub"
|
||||
}
|
||||
],
|
||||
/* A sigstore-signed repository using the community Fulcio+Rekor servers.
|
||||
|
||||
The community servers’ public keys can be obtained from
|
||||
https://github.com/sigstore/sigstore/tree/main/pkg/tuf/repository/targets . */
|
||||
"hostname:5000/myns/sigstore-signed-fulcio-rekor": [
|
||||
{
|
||||
"type": "sigstoreSigned",
|
||||
"fulcio": {
|
||||
"caPath": "/path/to/fulcio_v1.crt.pem",
|
||||
"oidcIssuer": "https://github.com/login/oauth",
|
||||
"subjectEmail": "test-user@example.com"
|
||||
},
|
||||
"rekorPublicKeyPath": "/path/to/rekor.pub",
|
||||
}
|
||||
],
|
||||
/* A sigstore-signed repository, accepts signatures by /usr/bin/cosign */
|
||||
"hostname:5000/myns/sigstore-signed-allows-malicious-tag-substitution": [
|
||||
{
|
||||
@ -293,8 +335,25 @@ selectively allow individual transports and scopes as desired.
|
||||
"keyPath": "/path/to/sigstore-pubkey.pub",
|
||||
"signedIdentity": {"type": "matchRepository"}
|
||||
}
|
||||
],
|
||||
/* A sigstore-signed repository using the community Fulcio+Rekor servers,
|
||||
accepts signatures by /usr/bin/cosign.
|
||||
|
||||
The community servers’ public keys can be obtained from
|
||||
https://github.com/sigstore/sigstore/tree/main/pkg/tuf/repository/targets . */
|
||||
"hostname:5000/myns/sigstore-signed-fulcio-rekor- allows-malicious-tag-substitution": [
|
||||
{
|
||||
"type": "sigstoreSigned",
|
||||
"fulcio": {
|
||||
"caPath": "/path/to/fulcio_v1.crt.pem",
|
||||
"oidcIssuer": "https://github.com/login/oauth",
|
||||
"subjectEmail": "test-user@example.com"
|
||||
},
|
||||
"rekorPublicKeyPath": "/path/to/rekor.pub",
|
||||
"signedIdentity": { "type": "matchRepository" }
|
||||
}
|
||||
]
|
||||
/* Other docker: images use the global default policy and are rejected */
|
||||
/* Other docker: images use the global default policy and are rejected */
|
||||
},
|
||||
"dir": {
|
||||
"": [{"type": "insecureAcceptAnything"}] /* Allow any images originating in local directories */
|
||||
|
||||
@ -210,7 +210,8 @@ Consumers still SHOULD reject any signature where a member of an `optional` obje
|
||||
|
||||
### `optional.creator`
|
||||
|
||||
If present, this MUST be a JSON string, identifying the name and version of the software which has created the signature.
|
||||
If present, this MUST be a JSON string, identifying the name and version of the software which has created the signature
|
||||
(identifying the low-level software implementation; not the top-level caller).
|
||||
|
||||
The contents of this string is not defined in detail; however each implementation creating container signatures:
|
||||
|
||||
|
||||
@ -27,45 +27,42 @@ No bare options are used. The format of TOML can be simplified to:
|
||||
The `storage` table supports the following options:
|
||||
|
||||
**driver**=""
|
||||
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.
|
||||
This field is required to guarantee proper operation.
|
||||
Valid rootless drivers are "btrfs", "overlay", and "vfs".
|
||||
Rootless users default to the driver defined in the system configuration when possible.
|
||||
When the system configuration uses an unsupported rootless driver, rootless users default to "overlay" if available, otherwise "vfs".
|
||||
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 required to guarantee proper operation.
|
||||
Valid rootless drivers are "btrfs", "overlay", and "vfs".
|
||||
Rootless users default to the driver defined in the system configuration when possible.
|
||||
When the system configuration uses an unsupported rootless driver, rootless users default to "overlay" if available, otherwise "vfs".
|
||||
|
||||
**graphroot**=""
|
||||
container storage graph dir (default: "/var/lib/containers/storage")
|
||||
Default directory to store all writable content created by container storage programs.
|
||||
The rootless graphroot path supports environment variable substitutions (ie. `$HOME/containers/storage`)
|
||||
When changing the graphroot location on an SELINUX system, ensure
|
||||
the labeling matches the default locations labels with the
|
||||
following commands:
|
||||
Default directory to store all writable content created by container storage programs.
|
||||
The rootless graphroot path supports environment variable substitutions (ie. `$HOME/containers/storage`).
|
||||
When changing the graphroot location on an SELINUX system, ensure the labeling matches the default locations labels with the following commands:
|
||||
|
||||
```
|
||||
# semanage fcontext -a -e /var/lib/containers/storage /NEWSTORAGEPATH
|
||||
# restorecon -R -v /NEWSTORAGEPATH
|
||||
```
|
||||
|
||||
In Rootless Mode you would set
|
||||
In rootless mode you would set
|
||||
|
||||
```
|
||||
# semanage fcontext -a -e $HOME/.local/share/containers NEWSTORAGEPATH
|
||||
$ restorecon -R -v /NEWSTORAGEPATH
|
||||
```
|
||||
**rootless_storage_path**="$HOME/.local/share/containers/storage"
|
||||
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.
|
||||
Otherwise `$HOME/.local/share/containers/storage` is used. This field can
|
||||
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`)
|
||||
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. Otherwise `$HOME/.local/share/containers/storage` is used. This field can 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`)
|
||||
|
||||
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**=""
|
||||
container storage run dir (default: "/run/containers/storage")
|
||||
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`)
|
||||
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`)
|
||||
|
||||
**driver_priority**=[]
|
||||
Priority list for the storage drivers that will be tested one after the other to pick the storage driver if it is not defined. The first storage driver in this list that can be used, will be picked as the new one and all subsequent ones will not be tried. If all drivers in this list are not viable, then **all** known drivers will be tried and the first working one will be picked.
|
||||
By default, the storage driver is set via the `driver` option. If it is not defined, then the best driver will be picked according to the current platform. This option allows you to override this internal priority list with a custom one to prefer certain drivers.
|
||||
Setting this option only has an effect if the local storage has not been initialized yet and the driver name is not set.
|
||||
|
||||
### STORAGE OPTIONS TABLE
|
||||
|
||||
@ -216,21 +213,20 @@ The `storage.options.overlay` table supports the following options:
|
||||
|
||||
**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
|
||||
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
|
||||
- ``: 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
|
||||
- `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
|
||||
- `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.
|
||||
@ -244,7 +240,7 @@ 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
|
||||
attribute permissions to processes within containers rather than the
|
||||
"force_mask" permissions.
|
||||
|
||||
**mount_program**=""
|
||||
@ -340,7 +336,7 @@ This is a way to prevent xfs_quota management from conflicting with containers/s
|
||||
|
||||
Distributions often provide a `/usr/share/containers/storage.conf` file to define default storage configuration. Administrators can override this file by creating `/etc/containers/storage.conf` to specify their own configuration. Likewise rootless users can create a storage.conf file to override the system storage.conf files. Files should be stored in the `$XDG_CONFIG_HOME/containers/storage.conf` file. If `$XDG_CONFIG_HOME` is not set then the file `$HOME/.config/containers/storage.conf` is used.
|
||||
|
||||
Note: The storage.conf file overrides all other strorage.conf files. Container
|
||||
Note: The storage.conf file overrides all other storage.conf files. Container
|
||||
engines run by users with a storage.conf file in their home directory do not
|
||||
use options in the system storage.conf files.
|
||||
|
||||
|
||||
@ -11,6 +11,11 @@ containers-transports - description of supported transports for copying and stor
|
||||
Tools which use the containers/image library, including skopeo(1), buildah(1), podman(1), all share a common syntax for referring to container images in various locations.
|
||||
The general form of the syntax is _transport:details_, where details are dependent on the specified transport, which are documented below.
|
||||
|
||||
The semantics of the image names ultimately depend on the environment where
|
||||
they are evaluated. For example: if evaluated on a remote server, image names
|
||||
might refer to paths on that server; relative paths are relative to the current
|
||||
directory of the image consumer.
|
||||
|
||||
### **containers-storage**:[**[**storage-specifier**]**]{image-id|docker-reference[@image-id]}
|
||||
|
||||
An image located in a local containers storage.
|
||||
|
||||
@ -52,19 +52,18 @@
|
||||
# List of default capabilities for containers. If it is empty or commented out,
|
||||
# the default capabilities defined in the container engine will be added.
|
||||
#
|
||||
default_capabilities = [
|
||||
"CHOWN",
|
||||
"DAC_OVERRIDE",
|
||||
"FOWNER",
|
||||
"FSETID",
|
||||
"KILL",
|
||||
"NET_BIND_SERVICE",
|
||||
"SETFCAP",
|
||||
"SETGID",
|
||||
"SETPCAP",
|
||||
"SETUID",
|
||||
"SYS_CHROOT"
|
||||
]
|
||||
#default_capabilities = [
|
||||
# "CHOWN",
|
||||
# "DAC_OVERRIDE",
|
||||
# "FOWNER",
|
||||
# "FSETID",
|
||||
# "KILL",
|
||||
# "NET_BIND_SERVICE",
|
||||
# "SETFCAP",
|
||||
# "SETGID",
|
||||
# "SETPCAP",
|
||||
# "SETUID",
|
||||
#]
|
||||
|
||||
# A list of sysctls to be set in containers by default,
|
||||
# specified as "name=value",
|
||||
@ -216,6 +215,10 @@ default_sysctls = [
|
||||
#
|
||||
#prepare_volume_on_create = false
|
||||
|
||||
# Run all containers with root file system mounted read-only
|
||||
#
|
||||
# read_only = false
|
||||
|
||||
# Path to the seccomp.json profile which is used as the default seccomp profile
|
||||
# for the runtime.
|
||||
#
|
||||
@ -244,12 +247,6 @@ default_sysctls = [
|
||||
#
|
||||
#userns = "host"
|
||||
|
||||
# Number of UIDs to allocate for the automatic container creation.
|
||||
# UIDs are allocated from the "container" UIDs listed in
|
||||
# /etc/subuid & /etc/subgid
|
||||
#
|
||||
#userns_size = 65536
|
||||
|
||||
# Default way to to create a UTS namespace for the container
|
||||
# Options are:
|
||||
# `private` Create private UTS Namespace for the container.
|
||||
@ -263,6 +260,11 @@ default_sysctls = [
|
||||
# If it is empty or commented out, no volumes will be added
|
||||
#
|
||||
#volumes = []
|
||||
#
|
||||
#[engine.platform_to_oci_runtime]
|
||||
#"wasi/wasm" = ["crun-wasm"]
|
||||
#"wasi/wasm32" = ["crun-wasm"]
|
||||
#"wasi/wasm64" = ["crun-wasm"]
|
||||
|
||||
[secrets]
|
||||
#driver = "file"
|
||||
@ -411,6 +413,10 @@ default_sysctls = [
|
||||
#
|
||||
#events_logger = "journald"
|
||||
|
||||
# Creates a more verbose container-create event which includes a JSON payload
|
||||
# with detailed information about the container.
|
||||
#events_container_create_inspect_data = false
|
||||
|
||||
# A is a list of directories which are used to search for helper binaries.
|
||||
#
|
||||
#helper_binaries_dir = [
|
||||
@ -544,7 +550,7 @@ runtime = "crun"
|
||||
# List of the OCI runtimes that support --format=json. When json is supported
|
||||
# engine will use it for reporting nicer errors.
|
||||
#
|
||||
#runtime_supports_json = ["crun", "runc", "kata", "runsc", "krun"]
|
||||
#runtime_supports_json = ["crun", "runc", "kata", "runsc", "youki", "krun"]
|
||||
|
||||
# List of the OCI runtimes that supports running containers with KVM Separation.
|
||||
#
|
||||
@ -582,7 +588,7 @@ runtime = "crun"
|
||||
|
||||
# map of service destinations
|
||||
#
|
||||
#[service_destinations]
|
||||
# [service_destinations]
|
||||
# [service_destinations.production]
|
||||
# URI to access the Podman service
|
||||
# Examples:
|
||||
@ -606,6 +612,12 @@ runtime = "crun"
|
||||
#
|
||||
#volume_path = "/var/lib/containers/storage/volumes"
|
||||
|
||||
# Default timeout (in seconds) for volume plugin operations.
|
||||
# Plugins are external programs accessed via a REST API; this sets a timeout
|
||||
# for requests to that API.
|
||||
# A value of 0 is treated as no timeout.
|
||||
#volume_plugin_timeout = 5
|
||||
|
||||
# Paths to look for a valid OCI runtime (crun, runc, kata, runsc, krun, etc)
|
||||
[engine.runtimes]
|
||||
#crun = [
|
||||
@ -649,6 +661,13 @@ runtime = "crun"
|
||||
# "/run/current-system/sw/bin/runsc",
|
||||
#]
|
||||
|
||||
#youki = [
|
||||
# "/usr/local/bin/youki",
|
||||
# "/usr/bin/youki",
|
||||
# "/bin/youki",
|
||||
# "/run/current-system/sw/bin/youki",
|
||||
#]
|
||||
|
||||
#krun = [
|
||||
# "/usr/bin/krun",
|
||||
# "/usr/local/bin/krun",
|
||||
@ -666,9 +685,16 @@ runtime = "crun"
|
||||
#
|
||||
#disk_size=10
|
||||
|
||||
# The image used when creating a podman-machine VM.
|
||||
# Default image URI when creating a new VM using `podman machine init`.
|
||||
# Options: On Linux/Mac, `testing`, `stable`, `next`. On Windows, the major
|
||||
# version of the OS (e.g `36`) for Fedora 36. For all platforms you can
|
||||
# alternatively specify a custom download URL to an image. Container engines
|
||||
# translate URIs $OS and $ARCH to the native OS and ARCH. URI
|
||||
# "https://example.com/$OS/$ARCH/foobar.ami" becomes
|
||||
# "https://example.com/linux/amd64/foobar.ami" on a Linux AMD machine.
|
||||
# The default value is `testing`.
|
||||
#
|
||||
#image = "testing"
|
||||
# image = "testing"
|
||||
|
||||
# Memory in MB a machine is created with.
|
||||
#
|
||||
|
||||
@ -88,22 +88,24 @@ List of default capabilities for containers.
|
||||
The default list is:
|
||||
```
|
||||
default_capabilities = [
|
||||
"AUDIT_WRITE",
|
||||
"CHOWN",
|
||||
"DAC_OVERRIDE",
|
||||
"FOWNER",
|
||||
"FSETID",
|
||||
"KILL",
|
||||
"MKNOD",
|
||||
"NET_BIND_SERVICE",
|
||||
"NET_RAW",
|
||||
"SETFCAP",
|
||||
"SETGID",
|
||||
"SETPCAP",
|
||||
"SETUID",
|
||||
"SYS_CHROOT",
|
||||
]
|
||||
```
|
||||
|
||||
Note, by default container engines using containers.conf, run with less
|
||||
capabilities than Docker. Docker runs additionally with "AUDIT_WRITE", "MKNOD",
|
||||
"NET_RAW", "CHROOT". If you need to add one of these capabilities for a
|
||||
particular container, you can use the --cap-add option or edit your system's containers.conf.
|
||||
|
||||
**default_sysctls**=[]
|
||||
|
||||
A list of sysctls to be set in containers by default,
|
||||
@ -197,9 +199,9 @@ the container.
|
||||
|
||||
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**=""
|
||||
|
||||
Logging driver for the container. Available options: `k8s-file` and `journald`.
|
||||
Logging driver for the container. Currently available options are k8s-file, journald, none and passthrough, with json-file aliased to k8s-file for scripting compatibility. The journald driver is used by default if the systemd journal is readable and writable. Otherwise, the k8s-file driver is used.
|
||||
|
||||
**log_size_max**=-1
|
||||
|
||||
@ -241,6 +243,10 @@ is imposed.
|
||||
|
||||
Copy the content from the underlying image into the newly created volume when the container is created instead of when it is started. If `false`, the container engine will not copy the content until the container is started. Setting it to `true` may have negative performance implications.
|
||||
|
||||
**read_only**=true|false
|
||||
|
||||
Run all containers with root file system mounted read-only. Set to false by default.
|
||||
|
||||
**seccomp_profile**="/usr/share/containers/seccomp.json"
|
||||
|
||||
Path to the seccomp.json profile which is used as the default seccomp profile
|
||||
@ -275,11 +281,6 @@ Options are:
|
||||
`private` Create private USER Namespace for the container.
|
||||
`host` Share host USER Namespace with the container.
|
||||
|
||||
**userns_size**=65536
|
||||
|
||||
Number of UIDs to allocate for the automatic container creation. UIDs are
|
||||
allocated from the “container” UIDs listed in /etc/subuid & /etc/subgid.
|
||||
|
||||
**utsns**="private"
|
||||
|
||||
Default way to to create a UTS namespace for the container.
|
||||
@ -441,7 +442,7 @@ and the logfile will not be rotated.
|
||||
|
||||
**events_logger**="journald"
|
||||
|
||||
The default method to use when logging events.
|
||||
The default method to use when logging events.
|
||||
|
||||
The default method is different based on the platform that
|
||||
Podman is being run upon. To determine the current value,
|
||||
@ -451,6 +452,11 @@ use this command:
|
||||
|
||||
Valid values are: `file`, `journald`, and `none`.
|
||||
|
||||
**events_container_create_inspect_data**=true|false
|
||||
|
||||
Creates a more verbose container-create event which includes a JSON payload
|
||||
with detailed information about the container. Set to false by default.
|
||||
|
||||
**helper_binaries_dir**=["/usr/libexec/podman", ...]
|
||||
|
||||
A is a list of directories which are used to search for helper binaries.
|
||||
@ -598,7 +604,7 @@ 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", "runsc", "krun"]
|
||||
**runtime_supports_json**=["crun", "runc", "kata", "runsc", "youki", "krun"]
|
||||
|
||||
The list of the OCI runtimes that support `--format=json`.
|
||||
|
||||
@ -684,6 +690,10 @@ 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).
|
||||
|
||||
**[engine.platform_to_oci_runtime]**
|
||||
|
||||
Allows end users to switch the OCI runtime on the bases of container image's platform string.
|
||||
Following config field contains a map of `platform/string = oci_runtime`.
|
||||
|
||||
## SECRET TABLE
|
||||
The `secret` table contains settings for the configuration of the secret subsystem.
|
||||
@ -711,11 +721,13 @@ The size of the disk in GB created when init-ing a podman-machine VM
|
||||
|
||||
**image**=""
|
||||
|
||||
Default image used when creating a new VM using `podman machine init`.
|
||||
Default image URI when creating a new VM using `podman machine init`.
|
||||
Options: On Linux/Mac, `testing`, `stable`, `next`. On Windows, the major
|
||||
version of the OS (e.g `35`). For all platforms you can alternatively specify
|
||||
a custom path or download URL to an image. The default is `testing` on
|
||||
Linux/Mac, and `35` on Windows.
|
||||
version of the OS (e.g `36`) for Fedora 36. For all platforms you can
|
||||
alternatively specify a custom download URL to an image. Container engines
|
||||
translate URIs $OS and $ARCH to the native OS and ARCH. URI "https://example.com/$OS/$ARCH/foobar.ami" would become "https://example.com/linux/amd64/foobar.ami" on a Linux AMD machine.
|
||||
The default value
|
||||
is `testing` on Linux/Mac, and on Windows.
|
||||
|
||||
**memory**=2048
|
||||
|
||||
@ -733,6 +745,8 @@ Environment variables like $HOME as well as complete paths are supported for
|
||||
the source and destination. An optional third field `:ro` can be used to
|
||||
tell the container engines to mount the volume readonly.
|
||||
|
||||
On Mac, the default volumes are: `"/Users:/Users", "/private:/private", "/var/folders:/var/folders"`
|
||||
|
||||
# FILES
|
||||
|
||||
**containers.conf**
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
#!/bin/bash
|
||||
#set -e
|
||||
set -e
|
||||
rm -f /tmp/pyxis*.json
|
||||
TOTAL=`curl -s --negotiate -u: -H 'Content-Type: application/json' -H 'Accept: application/json' -X GET "https://pyxis.engineering.redhat.com/v1/repositories?page_size=1" | jq .total`
|
||||
if [ "$TOTAL" == "null" ]; then
|
||||
@ -11,53 +11,37 @@ for P in `seq 0 $PAGES`; do
|
||||
curl -s --negotiate -u: -H 'Content-Type: application/json' -H 'Accept: application/json' -X GET "https://pyxis.engineering.redhat.com/v1/repositories?page_size=500&page=$P" > /tmp/pyxis$P.json
|
||||
done
|
||||
cat /tmp/pyxis*.json > /tmp/pyx.json
|
||||
rm -f /tmp/pyx_debug
|
||||
rm -f /tmp/rhel-shortnames.conf
|
||||
while read -r LINE; do
|
||||
if [[ "$LINE" == *\"_id\":* ]] || [[ "$LINE" == *\"total\":* ]]; then
|
||||
if [ -z $REGISTRY ] ||
|
||||
[ -z $PUBLISHED ] ||
|
||||
[ -z $REPOSITORY ] ||
|
||||
[ $REPOSITORY == \"\" ] ||
|
||||
[ "$AVAILABLE" != "Generally Available" ] ||
|
||||
[[ $REPOSITORY == *[@:]* ]] ||
|
||||
[[ $REPOSITORY == *[* ]] ||
|
||||
[[ "$REGISTRY" == *non_registry* ]] ||
|
||||
[[ $REGISTRY != *.* ]]
|
||||
then
|
||||
continue
|
||||
fi
|
||||
jq '.data[]|.published,.requires_terms,.repository,.registry,.release_categories[0]' < /tmp/pyx.json >/tmp/pyx
|
||||
readarray -t lines < /tmp/pyx
|
||||
IDX=0
|
||||
while [ $IDX -lt ${#lines[@]} ]; do
|
||||
PUBLISHED=${lines[$IDX]}
|
||||
REQ_TERMS=${lines[$IDX+1]}
|
||||
REPOSITORY=`echo ${lines[$IDX+2]} | tr -d '"'`
|
||||
REGISTRY=`echo ${lines[$IDX+3]} | tr -d '"'`
|
||||
RELEASE=`echo ${lines[$IDX+4]} | tr -d '"'`
|
||||
if [ "$PUBLISHED" == "true" ] &&
|
||||
[ "$RELEASE" == "Generally Available" ] &&
|
||||
[ ! -z "$REPOSITORY" ] &&
|
||||
[ "$REPOSITORY" != \"\" ] &&
|
||||
[[ $REPOSITORY != *[@:]* ]] &&
|
||||
[[ $REPOSITORY != *[* ]] &&
|
||||
[[ $REGISTRY == *.* ]] &&
|
||||
[ "$REGISTRY" != "non_registry" ]; then
|
||||
if [[ $REGISTRY == *quay.io* ]] ||
|
||||
[[ $REGISTRY == *redhat.com* ]]; then
|
||||
if [ "$REQUIRES_TERMS" == "1" ]; then
|
||||
if [ "$REQ_TERMS" == "true" ]; then
|
||||
REGISTRY=registry.redhat.io
|
||||
fi
|
||||
echo "\"$REPOSITORY\" = \"$REGISTRY/$REPOSITORY\""
|
||||
echo "\"$REPOSITORY\" = \"$REGISTRY/$REPOSITORY\"" >> /tmp/rhel-shortnames.conf
|
||||
fi
|
||||
REGISTRY=""
|
||||
PUBLISHED=""
|
||||
AVAILABLE=""
|
||||
REPOSITORY=""
|
||||
REQUIRES_TERMS=""
|
||||
continue
|
||||
echo "\"$REPOSITORY\" = \"$REGISTRY/$REPOSITORY\""
|
||||
echo $PUBLISHED,$REQ_TERMS,$REPOSITORY,$REGISTRY,$RELEASE >> /tmp/pyx_debug
|
||||
echo "\"$REPOSITORY\" = \"$REGISTRY/$REPOSITORY\"" >> /tmp/rhel-shortnames.conf
|
||||
fi
|
||||
if [[ "$LINE" == *\"published\":\ true,* ]]; then
|
||||
PUBLISHED=1
|
||||
fi
|
||||
if [[ "$LINE" == *\"requires_terms\":\ true,* ]]; then
|
||||
REQUIRES_TERMS=1
|
||||
fi
|
||||
if [[ "$LINE" == *\"repository\":\ * ]]; then
|
||||
REPOSITORY=`echo $LINE | sed 's,^.* ",,' | sed 's;",$;;'`
|
||||
fi
|
||||
if [[ "$LINE" == *\"registry\":\ * ]]; then
|
||||
REGISTRY=`echo $LINE | sed -e 's,^.*:\ ",,' -e 's,".*,,'`
|
||||
fi
|
||||
if [[ "$LINE" == *\"release_categories\":\ * ]]; then
|
||||
read -r LINE
|
||||
AVAILABLE=`echo $LINE | sed 's,",,g'`
|
||||
fi
|
||||
done < /tmp/pyx.json
|
||||
IDX=$(($IDX+5))
|
||||
done
|
||||
|
||||
cp /tmp/rhel-shortnames.conf /tmp/r.conf
|
||||
for D in `cut -d\ -f1 /tmp/r.conf | sort | uniq -d`; do
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
# This file is is the configuration file for all tools
|
||||
# This file is the configuration file for all tools
|
||||
# that use the containers/storage library. The storage.conf file
|
||||
# overrides all other storage.conf files. Container engines using the
|
||||
# container/storage library do not inherit fields from other storage.conf
|
||||
@ -32,6 +32,10 @@ graphroot = "/var/lib/containers/storage"
|
||||
#
|
||||
# rootless_storage_path = "$HOME/.local/share/containers/storage"
|
||||
|
||||
# Transient store mode makes all container metadata be saved in temporary storage
|
||||
# (i.e. runroot above). This is faster, but doesn't persist across reboots.
|
||||
# transient_store = true
|
||||
|
||||
[storage.options]
|
||||
# Storage options to be passed to underlying storage drivers
|
||||
|
||||
@ -150,7 +154,7 @@ mountopt = "nodev,metacopy=on"
|
||||
# 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
|
||||
# extended attribute permissions to processes within containers rather than the
|
||||
# "force_mask" permissions.
|
||||
#
|
||||
# force_mask = ""
|
||||
|
||||
@ -21,9 +21,9 @@ for P in podman skopeo buildah; do
|
||||
pkg --release rhel-8 prep
|
||||
fi
|
||||
DIR=`ls -d -- */ | grep -v ^tests | head -n1`
|
||||
grep github.com/containers/image $DIR/go.mod | grep -v - | cut -d\ -f2 >> /tmp/ver_image
|
||||
grep github.com/containers/common $DIR/go.mod | grep -v - | cut -d\ -f2 >> /tmp/ver_common
|
||||
grep github.com/containers/storage $DIR/go.mod | grep -v - | cut -d\ -f2 >> /tmp/ver_storage
|
||||
grep github.com/containers/image $DIR/go.mod | cut -d\ -f2 | sed 's,-.*,,'>> /tmp/ver_image
|
||||
grep github.com/containers/common $DIR/go.mod | cut -d\ -f2 | sed 's,-.*,,' >> /tmp/ver_common
|
||||
grep github.com/containers/storage $DIR/go.mod | cut -d\ -f2 | sed 's,-.*,,' >> /tmp/ver_storage
|
||||
cd -
|
||||
done
|
||||
IMAGE_VER=`sort -n /tmp/ver_image | head -n1`
|
||||
|
||||
@ -13,7 +13,7 @@ ensure() {
|
||||
sed -i "/^#.*$2[[:blank:]].*=/a \
|
||||
$2 = $3" $1
|
||||
else
|
||||
echo "$2 = \"$3\"" >> $1
|
||||
echo "$2 = $3" >> $1
|
||||
fi
|
||||
fi
|
||||
}
|
||||
@ -21,10 +21,18 @@ $2 = $3" $1
|
||||
#./pyxis.sh
|
||||
#./update-vendored.sh
|
||||
spectool -f -g containers-common.spec
|
||||
for FILE in *; do
|
||||
[ -s "$FILE" ]
|
||||
if [ $? == 1 ] && [ "$FILE" != "sources" ]; then
|
||||
echo "empty file: $FILE"
|
||||
exit 1
|
||||
fi
|
||||
done
|
||||
ensure storage.conf driver \"overlay\"
|
||||
ensure storage.conf mountopt \"nodev,metacopy=on\"
|
||||
if pwd | grep rhel-8 > /dev/null
|
||||
then
|
||||
awk -i inplace '/#default_capabilities/,/#\]/{gsub("#","",$0)}1' containers.conf
|
||||
ensure registries.conf unqualified-search-registries [\"registry.access.redhat.com\",\ \"registry.redhat.io\",\ \"docker.io\"]
|
||||
ensure registries.conf short-name-mode \"permissive\"
|
||||
ensure containers.conf runtime \"runc\"
|
||||
@ -34,14 +42,19 @@ ensure containers.conf network_backend \"cni\"
|
||||
if ! grep \"NET_RAW\" containers.conf > /dev/null
|
||||
then
|
||||
sed -i '/^default_capabilities/a \
|
||||
"NET_RAW",' containers.conf
|
||||
"NET_RAW",' containers.conf
|
||||
fi
|
||||
if ! grep \"SYS_CHROOT\" containers.conf > /dev/null
|
||||
then
|
||||
sed -i '/^default_capabilities/a \
|
||||
"SYS_CHROOT",' containers.conf
|
||||
fi
|
||||
else
|
||||
ensure registries.conf unqualified-search-registries [\"registry.access.redhat.com\",\ \"registry.redhat.io\",\ \"docker.io\"]
|
||||
ensure registries.conf short-name-mode \"enforcing\"
|
||||
ensure containers.conf runtime \"crun\"
|
||||
fi
|
||||
[ `grep "keyctl" seccomp.json | wc -l` == 0 ] && sed -i '/\"kill\",/i \
|
||||
[ `grep \"keyctl\", seccomp.json | wc -l` == 0 ] && sed -i '/\"kill\",/i \
|
||||
"keyctl",' seccomp.json
|
||||
sed -i '/\"socketcall\",/i \
|
||||
[ `grep \"socket\", seccomp.json | wc -l` == 0 ] && sed -i '/\"socketcall\",/i \
|
||||
"socket",' seccomp.json
|
||||
|
||||
@ -4,15 +4,15 @@
|
||||
# pick the oldest version on c/image, c/common, c/storage vendored in
|
||||
# podman/skopeo/podman.
|
||||
%global skopeo_branch main
|
||||
%global image_branch v5.22.1
|
||||
%global common_branch v0.49.1
|
||||
%global storage_branch v1.42.0
|
||||
%global image_branch v5.24.1
|
||||
%global common_branch v0.51.0
|
||||
%global storage_branch v1.45.3
|
||||
%global shortnames_branch main
|
||||
|
||||
Epoch: 2
|
||||
Name: containers-common
|
||||
Version: 1
|
||||
Release: 49%{?dist}
|
||||
Release: 52%{?dist}
|
||||
Summary: Common configuration and documentation for containers
|
||||
License: ASL 2.0
|
||||
ExclusiveArch: %{go_arches}
|
||||
@ -80,7 +80,8 @@ separately.
|
||||
%build
|
||||
|
||||
%install
|
||||
install -dp %{buildroot}%{_sysconfdir}/containers/{certs.d,oci/hooks.d,registries.d,registries.conf.d}
|
||||
install -dp %{buildroot}%{_sysconfdir}/containers/{certs.d,oci/hooks.d,systemd,registries.d,registries.conf.d}
|
||||
install -dp %{buildroot}%{_datadir}/containers/systemd
|
||||
install -m0644 %{SOURCE1} %{buildroot}%{_sysconfdir}/containers/storage.conf
|
||||
install -m0644 %{SOURCE5} %{buildroot}%{_sysconfdir}/containers/registries.conf
|
||||
install -m0644 %{SOURCE17} %{buildroot}%{_sysconfdir}/containers/registries.conf.d/000-shortnames.conf
|
||||
@ -148,6 +149,8 @@ EOF
|
||||
%dir %{_sysconfdir}/containers/oci
|
||||
%dir %{_sysconfdir}/containers/oci/hooks.d
|
||||
%dir %{_sysconfdir}/containers/registries.conf.d
|
||||
%dir %{_sysconfdir}/containers/systemd
|
||||
%dir %{_datadir}/containers/systemd
|
||||
%if !0%{?rhel} || 0%{?centos}
|
||||
%{_sysconfdir}/pki/rpm-gpg/RPM-GPG-KEY-redhat-release
|
||||
%{_sysconfdir}/pki/rpm-gpg/RPM-GPG-KEY-redhat-beta
|
||||
@ -170,25 +173,37 @@ EOF
|
||||
%{_datadir}/rhel/secrets/*
|
||||
|
||||
%changelog
|
||||
* Sun Jan 08 2023 Jindrich Novy <jnovy@redhat.com> - 2:1-49
|
||||
* Wed Apr 05 2023 Jindrich Novy <jnovy@redhat.com> - 2:1-52
|
||||
- fix shortnames contained UBI9 links pointing to auth-only registries
|
||||
- Resolves: #2182314
|
||||
|
||||
* Fri Mar 31 2023 Jindrich Novy <jnovy@redhat.com> - 2:1-51
|
||||
- update vendored components and configuration files
|
||||
- Resolves: #2182492
|
||||
|
||||
* Wed Feb 22 2023 Jindrich Novy <jnovy@redhat.com> - 2:1-50
|
||||
- improve shortnames generation
|
||||
- Related: #2124478
|
||||
|
||||
* Tue Jan 31 2023 Jindrich Novy <jnovy@redhat.com> - 2:1-49
|
||||
- add missing systemd directories
|
||||
- Related: #2124478
|
||||
|
||||
* Mon Jan 30 2023 Jindrich Novy <jnovy@redhat.com> - 2:1-48
|
||||
- update vendored components and configuration files
|
||||
- Related: #2124478
|
||||
|
||||
* Thu Jan 05 2023 Jindrich Novy <jnovy@redhat.com> - 2:1-47
|
||||
- update vendored components, regenerate pyxis
|
||||
- Resolves: #2158512
|
||||
- Related: #2124478
|
||||
|
||||
* Thu Dec 01 2022 Jindrich Novy <jnovy@redhat.com> - 2:1-48
|
||||
- update vendored components and configuration files
|
||||
- Resolves: #2149776
|
||||
* Thu Nov 10 2022 Jindrich Novy <jnovy@redhat.com> - 2:1-46
|
||||
- The NET_RAW capability was required in RHEL8 but no longer required in RHEL9
|
||||
- Resolves: #2141531
|
||||
|
||||
* Wed Oct 26 2022 Jindrich Novy <jnovy@redhat.com> - 2:1-47
|
||||
- update vendored components and configuration files
|
||||
- Resolves: #2136847
|
||||
|
||||
* Wed Oct 26 2022 Jindrich Novy <jnovy@redhat.com> - 2:1-46
|
||||
- update vendored components and configuration files
|
||||
- Resolves: #2136845
|
||||
|
||||
* Thu Oct 13 2022 Jindrich Novy <jnovy@redhat.com> - 2:1-45
|
||||
* Fri Oct 21 2022 Jindrich Novy <jnovy@redhat.com> - 2:1-45
|
||||
- add beta GPG key
|
||||
- Resolves: #2123611
|
||||
- Related: #2124478
|
||||
|
||||
* Tue Aug 23 2022 Jindrich Novy <jnovy@redhat.com> - 2:1-44
|
||||
- exclude non-go arches because of go-md2man
|
||||
|
||||
Loading…
Reference in New Issue
Block a user