|
2 | 2 |
|
3 | 3 | # Kubernetes on Microsoft Azure Kubernetes Service (AKS)
|
4 | 4 |
|
5 |
| -You can create a Kubernetes cluster [either through the Azure portal website, or using the Azure command line tools](https://docs.microsoft.com/en-us/azure/aks/). |
| 5 | +You can create a Kubernetes cluster [either through the Azure portal website, or using the Azure command line tools](https://learn.microsoft.com/en-us/azure/aks/). |
6 | 6 |
|
7 | 7 | This page describes the commands required to setup a Kubernetes cluster using the command line.
|
8 |
| -If you prefer to use the Azure portal see the [Azure Kubernetes Service quickstart](https://docs.microsoft.com/en-us/azure/aks/learn/quick-kubernetes-deploy-portal). |
| 8 | +If you prefer to use the Azure portal see the [Azure Kubernetes Service quickstart](https://learn.microsoft.com/en-us/azure/aks/learn/quick-kubernetes-deploy-portal). |
9 | 9 |
|
10 | 10 | 1. Prepare your Azure shell environment. You have two options, one is to use
|
11 | 11 | the Azure interactive shell, the other is to install the Azure command-line
|
@@ -77,7 +77,7 @@ If you prefer to use the Azure portal see the [Azure Kubernetes Service quicksta
|
77 | 77 | `<RESOURCE-GROUP-NAME>` of `ucb_2018sp_data100_hub`.
|
78 | 78 | - `--location` specifies the location of the data center you want your resource to be in.
|
79 | 79 | In this case, we used the `centralus` location. For other options, see the
|
80 |
| - [Azure list of locations that support AKS](https://docs.microsoft.com/en-us/azure/aks/quotas-skus-regions#region-availability). |
| 80 | + [Azure list of locations that support AKS](https://learn.microsoft.com/en-us/azure/aks/quotas-skus-regions#region-availability). |
81 | 81 | Note that not all locations offer all VM sizes. To see a list of recommended locations, go to
|
82 | 82 | [Azure Portal > Virtual Machines](https://portal.azure.com/#view/HubsExtension/BrowseResource/resourceType/Microsoft.Compute%2FVirtualMachines),
|
83 | 83 | click on "create.." and see the list of recommended locations in the drop down list for `Region`.
|
@@ -123,9 +123,9 @@ If you prefer to use the Azure portal see the [Azure Kubernetes Service quicksta
|
123 | 123 | Kubernetes does not by default come with a controller that enforces `networkpolicy` resources.
|
124 | 124 | `networkpolicy` resources are important as they define how Kubernetes pods can securely communicate with one another and the outside sources, for example, the internet.
|
125 | 125 |
|
126 |
| - To enable this in Azure, we must first create a [Virtual Network](https://docs.microsoft.com/en-gb/azure/virtual-network/virtual-networks-overview) with Azure's own network policies enabled. |
| 126 | + To enable this in Azure, we must first create a [Virtual Network](https://learn.microsoft.com/en-gb/azure/virtual-network/virtual-networks-overview) with Azure's own network policies enabled. |
127 | 127 |
|
128 |
| - This section of the documentation is following the Microsoft Azure tutorial on [creating an AKS cluster and enabling network policy](https://docs.microsoft.com/en-us/azure/aks/use-network-policies#create-an-aks-cluster-and-enable-network-policy), which includes information on using [Calico](https://projectcalico.docs.tigera.io/) network policies. |
| 128 | + This section of the documentation is following the Microsoft Azure tutorial on [creating an AKS cluster and enabling network policy](https://learn.microsoft.com/en-us/azure/aks/use-network-policies#create-an-aks-cluster-and-enable-network-policy), which includes information on using [Calico](https://docs.tigera.io/) network policies. |
129 | 129 |
|
130 | 130 | ```
|
131 | 131 | az network vnet create \
|
@@ -160,7 +160,7 @@ If you prefer to use the Azure portal see the [Azure Kubernetes Service quicksta
|
160 | 160 | --output tsv)
|
161 | 161 | ```
|
162 | 162 |
|
163 |
| - We will create an Azure Active Directory (Azure AD) [service principal](https://docs.microsoft.com/en-us/azure/active-directory/develop/app-objects-and-service-principals) for use with the cluster, and assign the [Contributor role](https://docs.microsoft.com/en-us/azure/role-based-access-control/built-in-roles#contributor) for use with the VNet. |
| 163 | + We will create an Azure Active Directory (Azure AD) [service principal](https://learn.microsoft.com/en-us/azure/active-directory/develop/app-objects-and-service-principals) for use with the cluster, and assign the [Contributor role](https://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles#contributor) for use with the VNet. |
164 | 164 | Make sure `SERVICE-PRINCIPAL-NAME` is something recognisable, for example, `binderhub-sp`.
|
165 | 165 |
|
166 | 166 | ```
|
@@ -215,7 +215,7 @@ If you prefer to use the Azure portal see the [Azure Kubernetes Service quicksta
|
215 | 215 | - `--node-count` is the number of nodes you want in your Kubernetes cluster
|
216 | 216 | - `--node-vm-size` is the size of the nodes you want to use, which varies based on
|
217 | 217 | what you are using your cluster for and how much RAM/CPU each of your users need.
|
218 |
| - There is a [list of all possible node sizes](https://docs.microsoft.com/en-us/azure/cloud-services/cloud-services-sizes-specs) |
| 218 | + There is a [list of all possible node sizes](https://learn.microsoft.com/en-us/azure/cloud-services/cloud-services-sizes-specs) |
219 | 219 | for you to choose from, but not all might be available in your location.
|
220 | 220 | If you get an error whilst creating the cluster you can try changing either the region or the node size.
|
221 | 221 | - `--service-principal` is the application ID of the service principal we created
|
@@ -354,4 +354,4 @@ RBAC is enabled by default when using the command line tools.
|
354 | 354 | Congrats. Now that you have your Kubernetes cluster running, it's time to
|
355 | 355 | begin {ref}`setup-helm`.
|
356 | 356 |
|
357 |
| -[azure resource group]: https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview#resource-groups |
| 357 | +[azure resource group]: https://learn.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview#resource-groups |
0 commit comments