Skip to content

Commit 054be23

Browse files
committed
Update notes about Docker deprecation
1 parent d874d32 commit 054be23

File tree

3 files changed

+12
-6
lines changed

3 files changed

+12
-6
lines changed

articles/aks/cluster-configuration.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ AKS supports Ubuntu 18.04 as the default node operating system (OS) in general a
1818

1919
## Container runtime configuration
2020

21-
A container runtime is software that executes containers and manages container images on a node. The runtime helps abstract away sys-calls or operating system (OS) specific functionality to run containers on Linux or Windows. For Linux node pools, `containerd` is used for node pools using Kubernetes version 1.19 and greater. For Windows Server 2019 node pools, `containerd` is generally available and can be used in node pools using Kubernetes 1.20 and greater, but Docker is still used by default.
21+
A container runtime is software that executes containers and manages container images on a node. The runtime helps abstract away sys-calls or operating system (OS) specific functionality to run containers on Linux or Windows. For Linux node pools, `containerd` is used for node pools using Kubernetes version 1.19 and greater. For Windows Server 2019 node pools, `containerd` is generally available and is used by default in Kubernetes 1.23 and greater. Docker is no longer supported as of September 2022. For more information about this deprecation, see the [AKS release notes][aks-release-notes].
2222

2323
[`Containerd`](https://containerd.io/) is an [OCI](https://opencontainers.org/) (Open Container Initiative) compliant core container runtime that provides the minimum set of required functionality to execute containers and manage images on a node. It was [donated](https://www.cncf.io/announcement/2017/03/29/containerd-joins-cloud-native-computing-foundation/) to the Cloud Native Compute Foundation (CNCF) in March of 2017. The current Moby (upstream Docker) version that AKS uses already leverages and is built on top of `containerd`, as shown above.
2424

@@ -31,9 +31,9 @@ By using `containerd` for AKS nodes, pod startup latency improves and node resou
3131
`Containerd` works on every GA version of Kubernetes in AKS, and in every upstream kubernetes version above v1.19, and supports all Kubernetes and AKS features.
3232

3333
> [!IMPORTANT]
34-
> Clusters with Linux node pools created on Kubernetes v1.19 or greater default to `containerd` for its container runtime. Clusters with node pools on a earlier supported Kubernetes versions receive Docker for their container runtime. Linux node pools will be updated to `containerd` once the node pool Kubernetes version is updated to a version that supports `containerd`. You can still use Docker node pools and clusters on older supported versions until those fall off support.
34+
> Clusters with Linux node pools created on Kubernetes v1.19 or greater default to `containerd` for its container runtime. Clusters with node pools on a earlier supported Kubernetes versions receive Docker for their container runtime. Linux node pools will be updated to `containerd` once the node pool Kubernetes version is updated to a version that supports `containerd`. You can still use Docker node pools and clusters on versions below 1.23, but Docker is no longer supported as of September 2022.
3535
>
36-
> Using `containerd` with Windows Server 2019 node pools is generally available, although the default for node pools created on Kubernetes v1.22 and earlier is still Docker. For more details, see [Add a Windows Server node pool with `containerd`][/learn/aks-add-np-containerd].
36+
> Using `containerd` with Windows Server 2019 node pools is generally available, and is used by default in Kubernetes 1.23 and greater. For more details, see [Add a Windows Server node pool with `containerd`][/learn/aks-add-np-containerd].
3737
>
3838
> It is highly recommended to test your workloads on AKS node pools with `containerd` prior to using clusters with a Kubernetes version that supports `containerd` for your node pools.
3939
@@ -219,6 +219,9 @@ az aks show -n aks -g myResourceGroup --query "oidcIssuerProfile.issuerUrl" -ots
219219
- Read more about [Ephemeral OS disks](../virtual-machines/ephemeral-os-disks.md).
220220

221221

222+
<!-- LINKS - external -->
223+
[aks-release-notes]: https://github.com/Azure/AKS/releases
224+
222225
<!-- LINKS - internal -->
223226
[azure-cli-install]: /cli/azure/install-azure-cli
224227
[az-feature-register]: /cli/azure/feature#az_feature_register

articles/aks/learn/quick-windows-container-deploy-cli.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -192,7 +192,7 @@ Beginning in Kubernetes version 1.20 and greater, you can specify `containerd` a
192192
Use the `az aks nodepool add` command to add a node pool that can run Windows Server containers with the `containerd` runtime.
193193

194194
> [!NOTE]
195-
> If you do not specify the *WindowsContainerRuntime=containerd* custom header, the node pool will use Docker as the container runtime.
195+
> If you do not specify the *WindowsContainerRuntime=containerd* custom header, the node pool will still use `containerd` as the container runtime by default.
196196
197197
```azurecli-interactive
198198
az aks nodepool add \
@@ -236,7 +236,7 @@ az aks upgrade \
236236
The above command upgrades all Windows Server node pools in the *myAKSCluster* to use the `containerd` runtime.
237237

238238
> [!NOTE]
239-
> After upgrading all existing Windows Server node pools to use the `containerd` runtime, Docker will still be the default runtime when adding new Windows Server node pools.
239+
> When running the upgrade command, the `--kubernetes-version` specified must be a higher version than the node pool's current version.
240240
241241
## Connect to the cluster
242242

articles/azure-monitor/containers/container-insights-overview.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Container insights is a feature designed to monitor the performance of container
1717
- Self-managed Kubernetes clusters hosted on [Azure Stack](/azure-stack/user/azure-stack-kubernetes-aks-engine-overview) or on-premises
1818
- [Azure Arc-enabled Kubernetes](../../azure-arc/kubernetes/overview.md)
1919

20-
Container insights supports clusters running the Linux and Windows Server 2019 operating system. The container runtimes it supports are Docker, Moby, and any CRI compatible runtime such as CRI-O and ContainerD.
20+
Container insights supports clusters running the Linux and Windows Server 2019 operating system. The container runtimes it supports are Moby and any CRI compatible runtime such as CRI-O and ContainerD. Docker is no longer supported as a container runtime as of September 2022. For more information about this deprecation, see the [AKS release notes][aks-release-notes].
2121

2222
>[!NOTE]
2323
> Container insights support for Windows Server 2022 operating system in public preview.
@@ -66,3 +66,6 @@ The main differences in monitoring a Windows Server cluster compared to a Linux
6666
## Next steps
6767

6868
To begin monitoring your Kubernetes cluster, review [How to enable Container insights](container-insights-onboard.md) to understand the requirements and available methods to enable monitoring.
69+
70+
<!-- LINKS - external -->
71+
[aks-release-notes]: https://github.com/Azure/AKS/releases

0 commit comments

Comments
 (0)