diff --git a/content/manuals/desktop/use-desktop/kubernetes.md b/content/manuals/desktop/use-desktop/kubernetes.md index ece85d88a8a3..7f1c8a940c3f 100644 --- a/content/manuals/desktop/use-desktop/kubernetes.md +++ b/content/manuals/desktop/use-desktop/kubernetes.md @@ -136,21 +136,26 @@ docker.io/docker/desktop-containerd-registry-mirror: In `kubeadm` mode it requires the following images: ```console -docker.io/registry.k8s.io/kube-controller-manager: -docker.io/registry.k8s.io/kube-apiserver: -docker.io/registry.k8s.io/kube-scheduler: -docker.io/registry.k8s.io/kube-proxy -docker.io/registry.k8s.io/etcd: -docker.io/registry.k8s.io/pause: -docker.io/registry.k8s.io/coredns/coredns: +docker.io/docker/desktop-kubernetes: docker.io/docker/desktop-storage-provisioner: docker.io/docker/desktop-vpnkit-controller: -docker.io/docker/desktop-kubernetes: +docker.io/docker/desktop-kubernetes-etcd: +docker.io/docker/desktop-kubernetes-coredns: +docker.io/docker/desktop-kubernetes-pause: +docker.io/docker/desktop-kubernetes-apiserver: +docker.io/docker/desktop-kubernetes-controller-manager: +docker.io/docker/desktop-kubernetes-scheduler: +docker.io/docker/desktop-kubernetes-proxy: ``` The image tags are automatically selected by Docker Desktop based on several 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. +> [!NOTE] +> +> 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. +> See the [docker desktop](/reference/cli/docker/desktop/kubernetes/images) CLI reference for more details. + To accommodate scenarios where access to Docker Hub is not allowed, admins can configure Docker Desktop to pull the above listed images from a different registry (e.g., a mirror) 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. The recommended approach to set this up is the following: 1. Start Kubernetes using the desired cluster provisioning method: `kubeadm` or `kind`. -2. Once Kubernetes has started, use `docker ps` to view the container images used by Docker Desktop for the Kubernetes control plane. +2. After Kubernetes has started, use either: + - (Docker Desktop v4.44 or later) `docker desktop kubernetes images list` to list the image tags that will be pulled by the current Docker Desktop installation + - `docker ps` to view the container images used by Docker Desktop for the Kubernetes control plane 3. Clone or mirror those images (with matching tags) to your custom registry. 4. Stop the Kubernetes cluster. 5. Configure the `KubernetesImagesRepository` setting to point to your custom registry.