Add docs
This commit is contained in:
+15
-1
@@ -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"]}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user