Add info about CE and EE max API mismatch (#5910)

This commit is contained in:
Misty Stanley-Jones 2018-02-02 09:30:16 -08:00 committed by GitHub
parent 28ccac2318
commit 793d43d79b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 15 additions and 0 deletions

View File

@ -125,6 +125,21 @@ You can specify the API version to use, in one of the following ways:
or the
[Python SDK documentation for `client`](https://docker-py.readthedocs.io/en/stable/client.html).
### Docker EE and CE API mismatch
If you use Docker EE in production, we recommend using Docker EE in development
too. If you can't, such as when your developers use Docker for Mac or Docker for
Windows and manually build and push images, then your developers need to configure
their Docker clients to use the same version of the API reported by their Docker
daemon. This prevents the developer from using a feature that is not yet supported
on the daemon where the workload runs in production. You can do this one of two ways:
- Configure the Docker client to connect to an external daemon running Docker EE.
You can use the `-H` flag on the `docker` command or set the `DOCKER_HOST`
environment variable. The client uses the daemon's latest supported API version.
- Configure the Docker client to use a specific API by setting the `DOCKER_API_VERSION`
environment variable to the API version to use, such as `1.30`.
### API version matrix
Docker does not recommend running versions prior to 1.12, which means you