This commit is contained in:
Joe Rickerby
2023-05-08 21:47:29 +01:00
parent d7759bf876
commit de419eef44
+15 -1
View File
@@ -1050,7 +1050,7 @@ Auditwheel detects the version of the manylinux / musllinux standard in the imag
### `CIBW_CONTAINER_ENGINE` {: #container-engine} ### `CIBW_CONTAINER_ENGINE` {: #container-engine}
> Specify which container engine to use when building Linux wheels > Specify which container engine to use when building Linux wheels
Options: `docker` `podman` Options: `docker[;create_args: ...]` `podman[;create_args: ...]`
Default: `docker` Default: `docker`
@@ -1059,6 +1059,12 @@ Set the container engine to use. Docker is the default, or you can switch to
running and `docker` available on PATH. To use Podman, it needs to be running and `docker` available on PATH. To use Podman, it needs to be
installed and `podman` available on PATH. installed and `podman` available on PATH.
Arguments can be supplied to the container engine. Currently, the only option
that's customisable is 'create_args'. Parameters to create_args are
space-separated strings, which are passed to the container engine on the
command line when it's creating the container. If you want to include spaces
inside a parameter, use shell-style quoting.
!!! tip !!! tip
While most users will stick with Docker, Podman is available in different While most users will stick with Docker, Podman is available in different
@@ -1073,14 +1079,22 @@ installed and `podman` available on PATH.
!!! tab examples "Environment variables" !!! tab examples "Environment variables"
```yaml ```yaml
# use podman instead of docker
CIBW_CONTAINER_ENGINE: podman CIBW_CONTAINER_ENGINE: podman
# pass command line options to 'docker create'
CIBW_CONTAINER_ENGINE: "docker; create_args: --gpus all"
``` ```
!!! tab examples "pyproject.toml" !!! tab examples "pyproject.toml"
```toml ```toml
[tool.cibuildwheel] [tool.cibuildwheel]
# use podman instead of docker
container-engine = "podman" container-engine = "podman"
# pass command line options to 'docker create'
container-engine = { name = "docker", create_args = ["--gpus", "all"]}
``` ```