Skip to content

Commit f0dee0b

Browse files
security: add k8s setting to reference (#23026)
## Description - Adds a callout to enable K8s setting - Adds "Custom K8s image repository" setting - Adds Admin Console as an option for configuring network settings - Adds min DD version to network settings in reference ## Related issues or tickets - https://docker.atlassian.net/browse/ENGDOCS-2722 - https://docker.atlassian.net/browse/ENGDOCS-2719 - https://docker.atlassian.net/browse/ENGDOCS-2820 ## Reviews - [ ] Editorial review
1 parent f48b544 commit f0dee0b

File tree

3 files changed

+52
-3
lines changed

3 files changed

+52
-3
lines changed

content/manuals/desktop/features/networking.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,8 @@ Depending on your selected network mode, the options available are:
107107
108108
### Using Settings Management
109109

110-
If you're an administrator, you can use [Settings Management](/manuals/security/for-admins/hardened-desktop/settings-management/configure-json-file.md#networking) to enforce this Docker Desktop setting across your developer's machines. Choose from the following code snippets and at it to your `admin-settings.json` file.
110+
If you're an administrator, you can use [Settings Management](/manuals/security/for-admins/hardened-desktop/settings-management/configure-json-file.md#networking) to enforce this Docker Desktop setting across your developer's machines. Choose from the following code snippets and at it to your `admin-settings.json` file,
111+
or configure this setting using the [Admin Console](/manuals/security/for-admins/hardened-desktop/settings-management/configure-admin-console.md)
111112

112113
{{< tabs >}}
113114
{{< tab name="Networking mode" >}}

content/manuals/security/for-admins/hardened-desktop/settings-management/settings-reference.md

Lines changed: 42 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -534,7 +534,8 @@ For more information, see [Networking](/manuals/desktop/features/networking.md#n
534534
|---------------|-----------------|----------|
535535
| `auto` | `ipv4`, `ipv6`, `none` | String |
536536

537-
- **Description:** Filters unsupported DNS record types.
537+
- **Description:** Filters unsupported DNS record types. Requires Docker Desktop
538+
version 4.43 and up.
538539
- **OS:** {{< badge color=blue text="Windows and Mac" >}}
539540
- **Use case:** Control how Docker filters DNS records returned to containers, improving reliability in environments where only IPv4 or IPv6 is supported.
540541
- **Configure this setting with:**
@@ -621,6 +622,12 @@ Builders settings lets you manage Buildx builder instances for advanced image-bu
621622
>
622623
> In hardened environments, disable and lock this setting.
623624
625+
> [!IMPORTANT]
626+
>
627+
> When Kubernetes is enabled through Settings Management policies, only the
628+
`kubeadm` cluster provisioning method is supported. The `kind` provisioning
629+
method is not yet supported by Settings Management.
630+
624631
- **Configure this setting with:**
625632
- **Kubernetes** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
626633
- Settings Management: `kubernetes` setting in the [`admin-settings.json` file](/manuals/security/for-admins/hardened-desktop/settings-management/configure-json-file.md)
@@ -680,6 +687,40 @@ compatibility.
680687
- **Configure this setting with:**
681688
- **Kubernetes** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
682689

690+
### Custom Kubernetes image repository
691+
692+
| Default value | Accepted values | Format |
693+
|---------------|-----------------|----------|
694+
| `""` | Registry URL | String |
695+
696+
- **Description**: Configure a custom image repository for Kubernetes control
697+
plane images. This allows Docker Desktop to pull Kubernetes system
698+
images from a private registry or mirror instead of Docker Hub. This setting
699+
overrides the `[registry[:port]/][namespace]` portion of image names.
700+
- **OS**: {{< badge color=blue text="All" >}}
701+
- **Use case**: Use private registries in air-gapped environments or
702+
when Docker Hub access is restricted.
703+
704+
> [!NOTE]
705+
>
706+
> The images must be cloned/mirrored from Docker Hub with matching tags. The
707+
specific images required depend on the cluster provisioning method (`kubeadm`
708+
or `kind`). See the Kubernetes documentation for the complete list
709+
of required images and detailed setup instructions.
710+
711+
- **Configure this setting with**:
712+
- Settings Management: `KubernetesImagesRepository` settings in the
713+
[`admin-settings.json` file](/manuals/security/for-admins/hardened-desktop/settings-management/configure-json-file.md)
714+
- Settings Management: **Kubernetes Images Repository** setting in the
715+
[Admin Console](/manuals/security/for-admins/hardened-desktop/settings-management/configure-admin-console.md)
716+
717+
> [!IMPORTANT]
718+
>
719+
> When using `KubernetesImagesRepository` with Enhanced Container Isolation (ECI)
720+
enabled, you must add the following images to the ECI Docker socket mount image
721+
list: `[imagesRepository]/desktop-cloud-provider-kind:*` and
722+
`[imagesRepository]/desktop-containerd-registry-mirror:*`.
723+
683724
## Software updates
684725

685726
### Automatically check for updates

hugo_stats.json

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
"classes": [
55
"--mount",
66
"--tmpfs",
7-
"-mr-8",
7+
"-mr-20",
88
"-mt-0.5",
99
"-mt-8",
1010
"-top-10",
@@ -36,12 +36,16 @@
3636
"Debian",
3737
"Debian-GNU/Linux",
3838
"Diff",
39+
"Docker-Build-Cloud",
3940
"Docker-Desktop",
4041
"Docker-Engine",
4142
"Docker-Hub",
43+
"Docker-Scout",
4244
"Docker-Scout-Dashboard",
4345
"Docker-subscription",
4446
"Download",
47+
"Enable-for-a-given-project",
48+
"Enable-globally",
4549
"Entra-ID",
4650
"Entra-ID-OIDC",
4751
"Entra-ID-SAML-2.0",
@@ -116,6 +120,7 @@
116120
"Single-container",
117121
"Specific-version",
118122
"Svelte",
123+
"Testcontainers-Cloud",
119124
"Ubuntu",
120125
"Ubuntu/Debian",
121126
"Unix-pipe",
@@ -195,6 +200,7 @@
195200
"border-transparent",
196201
"border-white",
197202
"bottom-0",
203+
"breadcrumbs",
198204
"build-push-action",
199205
"button",
200206
"card",
@@ -415,6 +421,7 @@
415421
"md:z-auto",
416422
"min-h-screen",
417423
"min-w-0",
424+
"min-w-48",
418425
"min-w-52",
419426
"min-w-fit",
420427
"ml-2",

0 commit comments

Comments
 (0)