Skip to content

Commit a3a0504

Browse files
committed
freshness and content edits
1 parent fe9520b commit a3a0504

17 files changed

Lines changed: 102 additions & 346 deletions

learn-pr/azure/aks-deploy-container-app/1-introduction.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ metadata:
44
title: Introduction
55
description: Introduction
66
ms.published: 07/31/2020
7-
ms.date: 01/31/2025
7+
ms.date: 03/25/2026
88
author: davidsmatlak
99
ms.author: davidsmatlak
1010
ms.topic: unit

learn-pr/azure/aks-deploy-container-app/2-create-aks-cluster.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
uid: learn.aks-deploy-container-app.2-create-aks-cluster
33
metadata:
44
title: Create an Azure Kubernetes Service cluster
5-
description: Explore some of the architectural concepts you need to consider when you configure your first Azure Kubernetes Service cluster. You'll review concepts such as common cluster architecture and application routing.
5+
description: Explore some of the architectural concepts you need to consider when you configure your first Azure Kubernetes Service cluster. You review concepts such as common cluster architecture and application routing.
66
ms.published: 07/31/2020
7-
ms.date: 12/18/2025
7+
ms.date: 03/25/2026
88
author: davidsmatlak
99
ms.author: davidsmatlak
1010
ms.topic: unit
@@ -15,11 +15,11 @@ content: |
1515
quiz:
1616
title: Check your knowledge
1717
questions:
18-
- content: "Which of the following describes a Kubernetes cluster architecture?"
18+
- content: "Which of the following scenarios describe a Kubernetes cluster architecture?"
1919
choices:
2020
- content: "Single control plane, several nodes."
2121
isCorrect: true
22-
explanation: "This is the most common Kubernetes architecture, where you have one control plane and several nodes to support the workloads."
22+
explanation: "This configuration is the most common Kubernetes architecture, where you have one control plane and several nodes to support the workloads."
2323
- content: "Several control planes, single node."
2424
isCorrect: false
2525
explanation: "While it's possible to do so, it isn't recommended, and it doesn't make sense to have one single node in a cluster."

learn-pr/azure/aks-deploy-container-app/3-exercise-create-aks-cluster.yml

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
uid: learn.aks-deploy-container-app.3-exercise-create-aks-cluster
33
metadata:
44
title: Exercise - Create an Azure Kubernetes Service cluster
5-
description: In this exercise, you'll create an Azure Kubernetes Service cluster using Azure CLI and configure access from the Cloud Shell to your new cluster using Kubectl.
5+
description: In this exercise, you create an Azure Kubernetes Service cluster using Azure CLI and configure access from the Cloud Shell to your new cluster using Kubectl.
66
ms.published: 07/31/2020
7-
ms.date: 01/31/2025
7+
ms.date: 03/25/2026
88
author: davidsmatlak
99
ms.author: davidsmatlak
1010
ms.topic: unit
@@ -16,4 +16,3 @@ sandbox: false
1616
durationInMinutes: 10
1717
content: |
1818
[!include[](includes/3-exercise-create-aks-cluster.md)]
19-

learn-pr/azure/aks-deploy-container-app/4-deploy-app.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
uid: learn.aks-deploy-container-app.4-deploy-app
33
metadata:
44
title: Deploy an application on your Azure Kubernetes Service cluster
5-
description: Explore the concepts needed to create and deploy an application to your Azure Kubernetes Service cluster. You'll see how to deploy an application as a container from a container registry by using a declarative manifest file.
5+
description: Explore the concepts needed to create and deploy an application to your Azure Kubernetes Service cluster. You see how to deploy an application as a container from a container registry by using a declarative manifest file.
66
ms.published: 07/31/2020
7-
ms.date: 01/31/2025
7+
ms.date: 03/25/2026
88
author: davidsmatlak
99
ms.author: davidsmatlak
1010
ms.topic: unit
@@ -25,7 +25,7 @@ quiz:
2525
explanation: "Despite being called registries, container registries aren't indexes."
2626
- content: "A version control system for container images that allows us to switch between versions."
2727
isCorrect: false
28-
explanation: "It's possible to store several image versions by using image tags, but this isn't the main purpose of this resource."
28+
explanation: "It's possible to store several image versions by using image tags, but versions and tags aren't the main purpose of this resource."
2929

3030
- content: "What is a manifest file?"
3131
choices:
@@ -34,7 +34,7 @@ quiz:
3434
explanation: "Manifest files aren't related to the intentions of Kubernetes."
3535
- content: "Describes exactly how the cluster can be accessed through contexts."
3636
isCorrect: false
37-
explanation: "This is the .kube/config file."
37+
explanation: "Contexts are stored in the .kube/config file."
3838
- content: "Describes everything needed to create and manage a workload."
3939
isCorrect: true
4040
explanation: "Manifests describe what kind of workloads you want to create."

learn-pr/azure/aks-deploy-container-app/5-exercise-deploy-app.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
uid: learn.aks-deploy-container-app.5-exercise-deploy-app
33
metadata:
44
title: Exercise - Deploy an application on your Azure Kubernetes Service cluster
5-
description: In this exercise, you'll create and push a Kubernetes workload to an Azure Container Registry instance. You'll then deploy the workload from the container registry to an Azure Kubernetes Service cluster by creating a deployment manifest file.
5+
description: In this exercise, you create and push a Kubernetes workload to an Azure Container Registry instance. You then deploy the workload from the container registry to an Azure Kubernetes Service cluster by creating a deployment manifest file.
66
ms.published: 07/31/2020
7-
ms.date: 01/31/2025
7+
ms.date: 03/25/2026
88
author: davidsmatlak
99
ms.author: davidsmatlak
1010
ms.topic: unit

learn-pr/azure/aks-deploy-container-app/6-summary.yml

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,11 @@ metadata:
44
title: Summary
55
description: Summary
66
ms.published: 07/31/2020
7-
ms.date: 01/31/2025
7+
ms.date: 03/25/2026
88
author: davidsmatlak
99
ms.author: davidsmatlak
1010
ms.topic: unit
1111
title: Summary
1212
durationInMinutes: 2
1313
content: |
1414
[!include[](includes/6-summary.md)]
15-

learn-pr/azure/aks-deploy-container-app/includes/1-introduction.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ Imagine you work for a growing video editing company that provides a cloud-based
22

33
You identified Azure Kubernetes Service (AKS) as a business solution for deployment. AKS meets the requirements that allow you to deploy your app and handle the company's increased growth. You want to understand how to deploy your app to an AKS cluster and allow customers access to the app's services.
44

5-
In this module, deploy Kubernetes workloads declaratively to an AKS cluster by using manifest files. You can then create different deployment manifest files to deploy and expose your application to your users.
5+
In this module, you deploy Kubernetes workloads declaratively to an AKS cluster by using manifest files. You can then create different deployment manifest files to deploy and expose your application to your users.
66

77
## Learning objectives
88

@@ -24,4 +24,3 @@ All exercises use [Azure Cloud Shell](/azure/cloud-shell/overview), which alread
2424

2525
- [Azure CLI](/azure/aks/kubernetes-walkthrough)
2626
- [Kubectl](/azure/aks/kubernetes-walkthrough#connect-to-the-cluster)
27-

learn-pr/azure/aks-deploy-container-app/includes/2-create-aks-cluster.md

Lines changed: 18 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,68 +1,69 @@
1-
Your company plans to deploy your cloud-based video rendering service using Azure Kubernetes Service (AKS) as your cloud-native development platform. Before you can deploy any application, you need to create your AKS cluster.
1+
Your company plans to deploy a cloud-based video rendering service using Azure Kubernetes Service (AKS) as the cloud-native development platform. Before you can deploy an application, you need to create your AKS cluster.
22

3-
Let's review a few concepts so that you can deploy a new AKS cluster successfully.
3+
Let's review some concepts so that you can deploy a new AKS cluster.
44

55
## Kubernetes clusters
66

7-
Kubernetes is based on clusters. Instead of having a single virtual machine (VM), it uses several machines working as one. These VMs are called nodes. Kubernetes is a cluster-based orchestrator. It provides your application with several benefits, such as availability, monitoring, scaling, and rolling updates.
7+
Kubernetes is based on clusters. Instead of a single virtual machine (VM), Kubernetes uses several virtual machines that work as one, called nodes. Kubernetes is a cluster-based orchestrator that provides your application with several benefits, like availability, monitoring, scaling, and rolling updates.
88

99
## Cluster nodes
1010

11-
A cluster is node-based. There are two types of nodes in a Kubernetes cluster that provide specific functionality.
11+
A cluster is node-based and there are two types of nodes in a Kubernetes cluster that provide specific functionality.
1212

1313
- **Control plane nodes**: These nodes host the cluster's control plane aspects and are reserved for services that control the cluster. They're responsible for providing the API you and all the other nodes use to communicate. No workloads are deployed or scheduled on these nodes.
14-
1514
- **Nodes**: These nodes are responsible for executing custom workloads and applications, such as components from your cloud-based video rendering service.
1615

1716
## Cluster architectures
1817

1918
Use a cluster architecture to conceptualize the number of control planes and nodes you deploy in your Kubernetes cluster.
2019

21-
For example, the number of nodes in a cluster should always be more than two. When a node becomes unavailable, the Kubernetes scheduler tries to reschedule all the workloads running on this node onto the remaining nodes in the cluster.
20+
For example, the number of nodes in a cluster should always be more than two. When a node becomes unavailable, the Kubernetes scheduler tries to reschedule that node's workloads onto the remaining nodes in the cluster.
2221

2322
There are two popular cluster architectures for Kubernetes-based deployments.
2423

2524
## Single control plane and multiple nodes
2625

2726
:::image type="content" source="../media/2-1-diagram.png" alt-text="A diagram that shows a single control plane and multiple nodes in a cluster configuration.":::
2827

29-
The *single control plane to multiple nodes* per cluster architecture is the most common architectural pattern and is the easiest to deploy, but it doesn't provide high availability to your cluster's core management services.
28+
The _single control plane to multiple nodes_ per cluster architecture is the most common architectural pattern and is the easiest to deploy, but it doesn't provide high availability to your cluster's core management services.
3029

31-
If the control plane node becomes unavailable for any reason, no other interaction can happen with the cluster. This problem occurs even if you're the operator, or by any workloads that use Kubernetes' APIs to communicate until, at least, the API server is back online.
30+
If the control plane node becomes unavailable for any reason, no other interaction can happen with the cluster. This problem occurs even if you're the operator, or by any workloads that use Kubernetes APIs to communicate until, at least, the API server is back online.
3231

33-
Despite being less available than others, this architecture should be enough for most situations. It's less likely that the core management services become unavailable compared to a node going offline. The control plane nodes are subject to fewer modifications than nodes and more resilient.
32+
Despite being less available than others, this architecture should be enough for most situations. It's less likely that the core management services become unavailable compared to a node going offline. The control plane nodes are subject to fewer modifications than nodes and are more resilient.
3433

35-
If you're dealing with a production scenario, this architecture might not be the best solution.
34+
For a production scenario, this architecture might not be the best solution.
3635

3736
## Single control plane and a single node
3837

3938
:::image type="content" source="../media/2-2-single-diagram.png" alt-text="A diagram that depicts a single control plane and single node in a cluster configuration.":::
4039

41-
The *single control plane to single node* architecture is a variant of the previous architecture and is used in development environments. This architecture provides only one node that hosts both the control plane and a worker node. It's useful when testing or experimenting with different Kubernetes concepts. The single control plane and single node architecture limits cluster scaling and makes this architecture unsuitable for production and staging use.
40+
The _single control plane to single node_ architecture is a variant of the previous architecture and is used in development environments. This architecture provides only one node that hosts both the control plane and a worker node. It's useful when testing or experimenting with different Kubernetes concepts. The single control plane and single node architecture limits cluster scaling and makes this architecture unsuitable for production and staging use.
4241

4342
## Configure an AKS cluster
4443

44+
A key difference between native Kubernetes and AKS is that with an AKS cluster, the control plane is Microsoft managed for availability. You don't need to configure the control plane when you create a cluster. You only need to configure the nodes to run your workloads.
45+
4546
When you create a new AKS cluster, you have several different items to configure. Each item affects the final configuration of your cluster for compute resource allocation.
4647

4748
These items include:
4849

49-
- Node pools
50-
- Node count
51-
- Node VM size
50+
- Node pools.
51+
- Node count.
52+
- Node VM size.
5253

5354
## Node pools
5455

55-
You create *node pools* to group nodes in your AKS cluster. When you create a node pool, you specify the VM size and OS type (Linux or Windows) for each node in the node pool based on application requirement. To host user application pods, node pool **Mode** should be **User** otherwise **System**.
56+
You create _node pools_ to group nodes in your AKS cluster. When you create a node pool, you specify the VM size and OS type (Linux or Windows) for each node in the node pool based on application requirement. A node pool with **System Mode** is reserved for critical system services and usually isn't used to run application workloads. To host user application pods, node pool **Mode** should be **User**.
5657

57-
By default, an AKS cluster has a Linux node pool (**System Mode**) whether you create it through the Azure portal or CLI. However, you can configure it to add Windows node pools along with default Linux node pools during the creation wizard in the portal, parameters in CLI, or with ARM templates.
58+
By default, an AKS cluster has a Linux node pool (**System Mode**) whether you create it through the Azure portal or CLI. You can configure it to add Windows node pools along with default Linux node pools when the cluster is created in the portal, CLI parameters, or Azure Resource Manager templates (ARM templates).
5859

5960
Node pools use Virtual Machine Scale Sets as the underlying infrastructure to allow the cluster to scale the number of nodes in a node pool. New nodes created in the node pool are always the same size as you specified when you created the node pool.
6061

6162
:::image type="content" source="../media/2-3-node-pool-diagram.png" alt-text="A diagram that depicts a Kubernetes cluster with two node pools. The first node pool uses NC24s_v2 VMs, and the second node pool uses B2s standard VMs.":::
6263

6364
## Node count
6465

65-
The node count is the number of nodes your cluster has in a node pool. Nodes are Azure VMs. You can change their size and count to match your usage pattern.
66+
The node count is the number of nodes your cluster has in a node pool. Nodes are Azure VMs and you can change their size and count to match your usage pattern.
6667

6768
You can change the node count later in the cluster's configuration panel. It's also a best practice to keep this number as low as possible to avoid unnecessary costs and unused compute power.
6869

0 commit comments

Comments
 (0)