diff --git a/docker/variant-cli.md b/docker/variant-cli.md new file mode 100644 index 000000000000..d9c7a73c8fa6 --- /dev/null +++ b/docker/variant-cli.md @@ -0,0 +1,3 @@ +## `%%IMAGE%%:-cli` + +This image contains the Docker client command line interface (CLI) and Docker CLI plugins like `buildx` and `compose`. This is useful if you need to interact with a remote Docker engine but aren't planning to run the Docker engine in the container. diff --git a/docker/variant-dind.md b/docker/variant-dind.md new file mode 100644 index 000000000000..fb089329ba8a --- /dev/null +++ b/docker/variant-dind.md @@ -0,0 +1,3 @@ +## `%%IMAGE%%:`, `%%IMAGE%%:-dind` + +The default variant is the Docker in Docker variant. It contains the Docker engine as well as the Docker CLI and plugins that are included in the `cli` variant. It is useful for running Docker in Docker and for interacting with a Docker engine via the Docker CLI. diff --git a/docker/variant.md b/docker/variant.md new file mode 100644 index 000000000000..3f94c8dd06e9 --- /dev/null +++ b/docker/variant.md @@ -0,0 +1,5 @@ +# Image Variants + +The `%%IMAGE%%` images come in many flavors, each designed for a specific use case. + +**Note:**: The `*stable`, and `*test` tags have been deprecated since June 2020 (see [docker-library/docker#179](https://github.com/docker-library/docker/pull/179)) and were no longer updated in December 2020 when Docker 20.10 was released. The alternative to `stable` is to use `latest` (there was no difference when it was deprecated). You can also use the `cli`, and `dind` tags to get the latest Docker CLI or engine, respectively. The alternative to the `test` tags is to use the `rc` tag or a tag with `-rc` in it. The `rc` tag is only updated when there is an active pre-release and will not point to the same thing as `latest`.