Skip to content

Commit 7e4788f

Browse files
Revise Kubernetes images for Docker Desktop (#24086)
<!--Delete sections as needed --> ## Description Update the list of Kuberenetes images pulled for a kubeadm installation. Also add references to the new-ish CLI list images command. <!-- Tell us what you did and why --> The original listed images are not entirely correct: - the `docker.io/registry.k8s.io` registry prefix is redundant, it should just be `registry.k8s.io/*` - the `registry.k8s.io` images are what kubeadm requires for installation, however Docker Desktop will pull mirrored copies from Docker registry + repository (`docker.io/docker`) and internally re-tag the images back to the original images required by kubeadm The `desktop kubernetes images list` CLI command can be used to print out the images and their tags required by the current Docker Desktop installation. Of particular interest might be the programmatic output `desktop kubernetes images list --format=json` which can be used for automation purposes. The tags in the image list output are tied to the Docker Desktop version in which the commands are run, that is to say, it is not possible to find out all possible Kubernetes image tags (past or future? 😆) from one Docker Desktop version (the Release Notes would be a better place to check image tag changes). ## Related issues or tickets <!-- Related issues, pull requests, or Jira tickets --> ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
1 parent 74dba9a commit 7e4788f

1 file changed

Lines changed: 16 additions & 9 deletions

File tree

content/manuals/desktop/use-desktop/kubernetes.md

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -136,21 +136,26 @@ docker.io/docker/desktop-containerd-registry-mirror:<tag>
136136
In `kubeadm` mode it requires the following images:
137137

138138
```console
139-
docker.io/registry.k8s.io/kube-controller-manager:<tag>
140-
docker.io/registry.k8s.io/kube-apiserver:<tag>
141-
docker.io/registry.k8s.io/kube-scheduler:<tag>
142-
docker.io/registry.k8s.io/kube-proxy
143-
docker.io/registry.k8s.io/etcd:<tag>
144-
docker.io/registry.k8s.io/pause:<tag>
145-
docker.io/registry.k8s.io/coredns/coredns:<tag>
139+
docker.io/docker/desktop-kubernetes:<tag>
146140
docker.io/docker/desktop-storage-provisioner:<tag>
147141
docker.io/docker/desktop-vpnkit-controller:<tag>
148-
docker.io/docker/desktop-kubernetes:<tag>
142+
docker.io/docker/desktop-kubernetes-etcd:<tag>
143+
docker.io/docker/desktop-kubernetes-coredns:<tag>
144+
docker.io/docker/desktop-kubernetes-pause:<tag>
145+
docker.io/docker/desktop-kubernetes-apiserver:<tag>
146+
docker.io/docker/desktop-kubernetes-controller-manager:<tag>
147+
docker.io/docker/desktop-kubernetes-scheduler:<tag>
148+
docker.io/docker/desktop-kubernetes-proxy:<tag>
149149
```
150150

151151
The image tags are automatically selected by Docker Desktop based on several
152152
factors, including the version of Kubernetes being used. The tags vary for each image and may change between Docker Desktop releases. To stay informed, monitor the Docker Desktop release notes.
153153

154+
> [!NOTE]
155+
>
156+
> In Docker Desktop versions 4.44 or later you can run `docker desktop kubernetes images list` to list Kubernetes images used by the currently installed version of Docker Desktop.
157+
> For more information, see the [Docker Desktop CLI](/reference/cli/docker/desktop/kubernetes/images).
158+
154159
To accommodate scenarios where access to Docker Hub is not allowed, admins can
155160
configure Docker Desktop to pull the above listed images from a different registry (e.g., a mirror)
156161
using the [KubernetesImagesRepository](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md#kubernetes) setting as follows.
@@ -176,7 +181,9 @@ also match what Docker Desktop expects.
176181
The recommended approach to set this up is the following:
177182

178183
1. Start Kubernetes using the desired cluster provisioning method: `kubeadm` or `kind`.
179-
2. Once Kubernetes has started, use `docker ps` to view the container images used by Docker Desktop for the Kubernetes control plane.
184+
2. After Kubernetes has started, use either:
185+
- (Docker Desktop version 4.44 or later) `docker desktop kubernetes images list` to list the image tags that will be pulled by the current Docker Desktop installation
186+
- `docker ps` to view the container images used by Docker Desktop for the Kubernetes control plane
180187
3. Clone or mirror those images (with matching tags) to your custom registry.
181188
4. Stop the Kubernetes cluster.
182189
5. Configure the `KubernetesImagesRepository` setting to point to your custom registry.

0 commit comments

Comments
 (0)