You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
kubernetes: add section comparing kubeadm and kind provisioners (#22104)
<!--Delete sections as needed -->
## Description
In the Kubernetes docs, add a section comparing the `kubeadm` and `kind`
provisioners.
Why? because the existing text was insufficient and did not provide a
proper comparison to our users.
## Reviews
<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->
- [ ] Technical review
- [X] Editorial review
- [ ] Product review
---------
Signed-off-by: Cesar Talledo <[email protected]>
Co-authored-by: Allie Sadler <[email protected]>
Copy file name to clipboardExpand all lines: content/manuals/desktop/features/kubernetes.md
+33-3Lines changed: 33 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -34,10 +34,10 @@ Turning the Kubernetes server on or off in Docker Desktop does not affect your o
34
34
1. Open the Docker Desktop Dashboard and navigate to **Settings**.
35
35
2. Select the **Kubernetes** tab.
36
36
3. Toggle on **Enable Kubernetes**.
37
-
4. Choose your cluster provisioning method. You can choose either **Kubeadm** or **kind** if you are signed in and are using Docker Desktop version 4.38 or later.
37
+
4. Choose your [cluster provisioning method](#cluster-provisioning-method).
38
+
5. Select **Apply & Restart** to save the settings.
38
39
39
-
If you select **kind** you can also choose the Kubernetes version and the number of nodes.
40
-
5. Select **Apply & Restart** to save the settings. This sets up the images required to run the Kubernetes server as containers, and installs the `kubectl` command-line tool on your system at `/usr/local/bin/kubectl` (Mac) or `C:\Program Files\Docker\Docker\Resources\bin\kubectl.exe` (Windows).
40
+
This sets up the images required to run the Kubernetes server as containers, and installs the `kubectl` command-line tool on your system at `/usr/local/bin/kubectl` (Mac) or `C:\Program Files\Docker\Docker\Resources\bin\kubectl.exe` (Windows).
41
41
42
42
> [!NOTE]
43
43
>
@@ -51,6 +51,36 @@ You can check which version of Kubernetes you're on with:
51
51
$ kubectl version
52
52
```
53
53
54
+
### Cluster provisioning method
55
+
56
+
Docker Desktop Kubernetes can be provisioned with either the `kubeadm` or `kind`
57
+
provisioners.
58
+
59
+
`kubeadm` is the older provisioner. It supports a single-node cluster, you can't select the kubernetes
60
+
version, it's slower to provision than `kind`, and it's not supported by [Enhanced Container Isolation](/manuals/security/for-admins/hardened-desktop/enhanced-container-isolation/index.md) (ECI),
61
+
meaning that if ECI is enabled the cluster works but it's not protected by ECI.
62
+
63
+
`kind` is the newer provisioner, and it's available if you are signed in and are
64
+
using Docker Desktop version 4.38 or later. It supports multi-node clusters (for
65
+
a more realistic Kubernetes setup), you can choose the Kubernetes version, it's
66
+
faster to provision than `kubeadm`, and it's supported by ECI (i.e., when ECI is
67
+
enabled, the Kubernetes cluster runs in unprivileged Docker containers, thus
68
+
making it more secure). Note however that `kind` requires that Docker Desktop be
69
+
configured to use the [containerd image store](containerd.md) (the default image
0 commit comments