快速入门：部署 Azure Kubernetes 服务 (AKS) Automatic 群集（预览版）

• 要部署 Bicep 文件，需要对创建的资源具有写入访问权限，并有权访问 Microsoft.Resources/deployments 资源类型上的所有操作。 例如，若要创建虚拟机，需要 Microsoft.Compute/virtualMachines/write 和 Microsoft.Resources/deployments/* 权限。 有关角色和权限的列表，请参阅 Azure 内置角色。

创建资源组

Azure 资源组是用于部署和管理 Azure 资源的逻辑组。

以下示例在 chinanorth3 位置创建了一个名为 myResourceGroup 的资源组。

使用 az group create 命令创建资源组。

az group create --name myResourceGroup --location chinanorth3

以下示例输出类似于资源组成功创建：

{
  "id": "/subscriptions/<guid>/resourceGroups/myResourceGroup",
  "location": "chinanorth3",
  "managedBy": null,
  "name": "myResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null
}

创建 AKS Automatic 群集

要创建 AKS Automatic 群集，请使用 az aks create 命令。 以下示例创建一个名为 myAKSAutomaticCluster 且启用了托管 Prometheus 和 Container Insights 集成的群集。

az aks create \
    --resource-group myResourceGroup \
    --name myAKSAutomaticCluster \
    --sku automatic

片刻之后，该命令将会完成，并返回有关群集的 JSON 格式信息。

连接到群集

若要管理 Kubernetes 群集，请使用 Kubernetes 命令行客户端 kubectl。 如果使用的是 Azure Cloud Shell，则 kubectl 已安装。 要在本地安装 kubectl，请运行 az aks install-cli 命令。 AKS Automatic 群集通过用于 Kubernetes 基于角色的访问控制 (RBAC) 的 Microsoft Entra ID 进行配置。 使用 Azure CLI 创建群集时，系统会为用户分配用于 Azure Kubernetes Service RBAC Cluster Admin 的内置角色。

使用 az aks get-credentials 命令将 kubectl 配置为连接到你的 Kubernetes 群集。 此命令将下载凭据，并将 Kubernetes CLI 配置为使用这些凭据。

az aks get-credentials --resource-group myResourceGroup --name myAKSAutomaticCluster

使用 kubectl get 命令验证与群集之间的连接。 此命令将返回群集节点的列表。

kubectl get nodes

以下示例输出显示如何要求你登录。

To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code AAAAAAAAA to authenticate.

登录后，以下示例输出会显示托管系统节点池。 确保节点状态为“就绪”。

NAME                                STATUS   ROLES   AGE     VERSION
aks-nodepool1-13213685-vmss000000   Ready    agent   2m26s   v1.28.5
aks-nodepool1-13213685-vmss000001   Ready    agent   2m26s   v1.28.5
aks-nodepool1-13213685-vmss000002   Ready    agent   2m26s   v1.28.5

创建自动 Kubernetes 群集

1. 要创建 AKS Automatic 群集，请搜索“Kubernetes 服务”，然后从下拉列表选项中选择“自动 Kubernetes 群集”。

   

2. 在“基本信息”选项卡上，填写开始使用所需的所有必填字段：“订阅”、“资源组”、“群集名称”和“区域”

   

   如果未满足先决条件，并且订阅需要注册预览标志，则“订阅”字段下会显示错误：

   

3. 在“监视”选项卡上，从 Azure Monitor、托管 Prometheus、托管 Grafana 和/或配置警报中选择监视配置。 添加标签（可选），并继续创建群集。

   

4. 开始从 GitHub 配置你的第一个应用程序并设置自动化部署管道。

   

连接到群集

若要管理 Kubernetes 群集，请使用 Kubernetes 命令行客户端 kubectl。 如果使用的是 Azure Cloud Shell，则 kubectl 已安装。 要在本地安装 kubectl，请运行 az aks install-cli 命令。 AKS Automatic 群集通过用于 Kubernetes 基于角色的访问控制 (RBAC) 的 Microsoft Entra ID 进行配置。 使用 Azure 门户创建群集时，系统会为用户分配用于 Azure Kubernetes Service RBAC Cluster Admin 的内置角色。

使用 az aks get-credentials 命令将 kubectl 配置为连接到你的 Kubernetes 群集。 此命令将下载凭据，并将 Kubernetes CLI 配置为使用这些凭据。

az aks get-credentials --resource-group myResourceGroup --name myAKSAutomaticCluster

使用 kubectl get 命令验证与群集之间的连接。 此命令将返回群集节点的列表。

kubectl get nodes

以下示例输出显示如何要求你登录。

To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code AAAAAAAAA to authenticate.

登录后，以下示例输出会显示托管系统节点池。 确保节点状态为“就绪”。

NAME                                STATUS   ROLES   AGE     VERSION
aks-nodepool1-13213685-vmss000000   Ready    agent   2m26s   v1.28.5
aks-nodepool1-13213685-vmss000001   Ready    agent   2m26s   v1.28.5
aks-nodepool1-13213685-vmss000002   Ready    agent   2m26s   v1.28.5

创建资源组

Azure 资源组是用于部署和管理 Azure 资源的逻辑组。 创建资源组时，系统会提示你指定一个位置。 此位置是资源组元数据的存储位置，也是资源在 Azure 中运行的位置（如果你在创建资源期间未指定其他区域）。

以下示例在 chinanorth3 位置创建了一个名为 myResourceGroup 的资源组。

使用 az group create 命令创建资源组。

az group create --name myResourceGroup --location chinanorth3

以下示例输出类似于资源组成功创建：

{
  "id": "/subscriptions/<guid>/resourceGroups/myResourceGroup",
  "location": "chinanorth3",
  "managedBy": null,
  "name": "myResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null
}

查阅 Bicep 文件

此 Bicep 文件定义 AKS Automatic 群集。 在预览版中，需要指定系统节点池代理池配置文件。

@description('The name of the managed cluster resource.')
param clusterName string = 'myAKSAutomaticCluster'

@description('The location of the managed cluster resource.')
param location string = resourceGroup().location

resource aks 'Microsoft.ContainerService/managedClusters@2024-03-02-preview' = {
  name: clusterName
  location: location  
  sku: {
	name: 'Automatic'
  }
  properties: {
    agentPoolProfiles: [
      {
        name: 'systempool'
        mode: 'System'
	count: 3
      }
    ]
  }
  identity: {
    type: 'SystemAssigned'
  }
}

有关 Bicep 文件中定义的资源的详细信息，请参阅 Microsoft.ContainerService/managedClusters 参考。

部署 Bicep 文件

1. 将该 Bicep 文件另存为本地计算机上的 main.bicep。

   重要

   Bicep 文件将 clusterName 参数设置为字符串 myAKSAutomaticCluster。 如果要使用其他群集名称，请确保先将字符串更新为首选群集名称，然后再将文件保存到计算机。

2. 使用 Azure CLI 部署 Bicep 文件。

   az deployment group create --resource-group myResourceGroup --template-file main.bicep
   

   创建 AKS 群集需要几分钟时间。 等待群集成功部署，然后转到下一步骤。

连接到群集

若要管理 Kubernetes 群集，请使用 Kubernetes 命令行客户端 kubectl。 如果使用的是 Azure Cloud Shell，则 kubectl 已安装。 要在本地安装 kubectl，请运行 az aks install-cli 命令。 AKS Automatic 群集通过用于 Kubernetes 基于角色的访问控制 (RBAC) 的 Microsoft Entra ID 进行配置。 使用 Bicep 创建群集时，需要分配一个内置角色，例如 Azure Kubernetes Service RBAC Reader、Azure Kubernetes Service RBAC Writer、Azure Kubernetes Service RBAC Admin 或 Azure Kubernetes Service RBAC Cluster Admin，并将其范围限定为群集或特定命名空间。 另请确保用户具有 Azure Kubernetes Service Cluster User 内置角色，以便能够运行 az aks get-credentials，然后使用 az aks get-credentials 命令获取 AKS 群集的 kubeconfig。

使用 az aks get-credentials 命令将 kubectl 配置为连接到你的 Kubernetes 群集。 此命令将下载凭据，并将 Kubernetes CLI 配置为使用这些凭据。

az aks get-credentials --resource-group myResourceGroup --name

使用 kubectl get 命令验证与群集之间的连接。 此命令将返回群集节点的列表。

kubectl get nodes

以下示例输出显示如何要求你登录。

To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code AAAAAAAAA to authenticate.

登录后，以下示例输出会显示托管系统节点池。 确保节点状态为“就绪”。

NAME                                STATUS   ROLES   AGE     VERSION
aks-nodepool1-13213685-vmss000000   Ready    agent   2m26s   v1.28.5
aks-nodepool1-13213685-vmss000001   Ready    agent   2m26s   v1.28.5
aks-nodepool1-13213685-vmss000002   Ready    agent   2m26s   v1.28.5