快速入门：使用 Azure CLI 创建 Azure Kubernetes Fleet Manager 并加入成员群集

适用于： ✔️车队经理 ✔️中心群集的车队经理

通过 Azure CLI 创建 Fleet Manager 并加入 支持的 Kubernetes 群集 作为成员，开始使用 Azure Kubernetes 机队管理器。

Fleet Manager 支持用于智能 Kubernetes 资源放置的可选中心群集，并且需要使用 托管机群命名空间。

有关机群管理器配置的详细信息，请参阅 机群类型的概念性概述。

在您开始之前

如果没有 Azure 试用版订阅，请在开始前创建一个试用版订阅。

• 阅读 机群管理器的概念性概述，其中提供了本文档中引用的机队和成员群集的说明。

• 阅读舰队类型的概念性概述，其中比较了不同的舰队配置选项。

• 一个具有活动订阅的 Azure 帐户。 创建帐户。

• 具有以下权限的标识（用户或服务主体）：

  • 车队经理：
    • Microsoft.ContainerService/fleets/read
    • Microsoft.ContainerService/fleets/write
    • Microsoft.ContainerService/fleets/members/read
    • Microsoft.ContainerService/fleets/members/write
    • Microsoft 容器服务/舰队成员资格/读取
    • Microsoft.ContainerService/fleetMemberships/write
  • AKS 成员群集：
    • Microsoft.ContainerService/managedClusters/read
    • Microsoft.ContainerService/managedClusters/write
    • Microsoft.ContainerService/managedClusters/listClusterUserCredential/action
  • 已启用 Arc 的 Kubernetes 成员群集：
    • Microsoft.Kubernetes/connectedClusters/read
    • Microsoft.KubernetesConfiguration/extensions/read
    • Microsoft.KubernetesConfiguration/extensions/write
    • Microsoft.KubernetesConfiguration/extensions/delete

• 安装 Azure CLI 2.82.0 或更高版本。 若要安装或升级，请参阅安装 Azure CLI。

• 还需要 fleet Azure CLI 扩展版本 1.8.3 或更高版本，可以通过运行以下命令进行安装：

  az extension add --name fleet
  

  运行以下命令以更新到已发布的最新扩展版本：

  az extension update --name fleet
  

• 设置以下环境变量：

  export SUBSCRIPTION_ID=<subscription_id>
  export GROUP=<resource_group_name>
  export FLEET=<fleet_name>
  export LOCATION=<azure_region_name>
  

• 使用kubectl命令安装az aks install-cli。

  az aks install-cli
  

• 成员群集必须运行支持的版本：请参阅 AKS 群集版本支持策略 和 已启用 Azure Arc 的 Kubernetes 验证。

创建资源组

设置 Azure 订阅并使用 az group create 命令创建资源组。

az account set -s ${SUBSCRIPTION_ID}
az group create --name ${GROUP} --location ${LOCATION}

az fleet create \
    --resource-group ${GROUP} \
    --name ${FLEET} \
    --location ${LOCATION} \
    --enable-managed-identity

az fleet create \
    --resource-group ${GROUP} \
    --name ${FLEET} \
    --location ${LOCATION}  \
    --enable-hub \
    --enable-managed-identity

加入成员群集

Fleet Manager 支持将现有的 AKS 群集或已启用 Arc 的 Kubernetes 群集（预览版）加入为成员群集。

1. 为成员群集设置以下环境变量：

   export MEMBER_NAME_1=flt-member-cluster-1
   
   # For an AKS cluster
   export MEMBER_CLUSTER_ID_1=/subscriptions/${SUBSCRIPTION_ID}/resourceGroups/${GROUP}/providers/Microsoft.ContainerService/managedClusters/${MEMBER_NAME_1}
   
   # For an Arc-enabled cluster
   export MEMBER_CLUSTER_ID_1=/subscriptions/${SUBSCRIPTION_ID}/resourceGroups/${GROUP}/providers/Microsoft.Kubernetes/connectedClusters/${MEMBER_NAME_1}
   

2. 使用 az fleet member create 命令将现有群集加入机群管理器。

   az fleet member create \
       --resource-group ${GROUP} \
       --fleet-name ${FLEET} \
       --name ${MEMBER_NAME_1} \
       --member-cluster-id ${MEMBER_CLUSTER_ID_1}
   

   输出应类似于以下示例输出：

   {
     "clusterResourceId": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-x",
     "etag": "...",
     "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/fleets/<FLEET>/members/aks-member-x",
     "name": "aks-member-1",
     "provisioningState": "Succeeded",
     "resourceGroup": "<GROUP>",
     "systemData": {
       "createdAt": "2022-10-04T19:04:56.455813+00:00",
       "createdBy": "<user>",
       "createdByType": "User",
       "lastModifiedAt": "2022-10-04T19:04:56.455813+00:00",
       "lastModifiedBy": "<user>",
       "lastModifiedByType": "User"
     },
     "type": "Microsoft.ContainerService/fleets/members"
   }
   

3. 使用 az fleet member list 命令验证成员群集是否已成功加入机群管理器。

   az fleet member list \
       --resource-group ${GROUP} \
       --fleet-name ${FLEET} \
       -o table
   

   如果成功，输出应类似于以下示例输出：

   ClusterResourceId                                                                                                          Name          ProvisioningState    ResourceGroup
   -------------------------------------------------------------------------------------------------------------------------- ------------  -------------------  ---------------
   /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-1  aks-member-1  Succeeded            <GROUP>
   /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-2  aks-member-2  Succeeded            <GROUP>
   /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-3  aks-member-3  Succeeded            <GROUP>
   

后续步骤

• 访问 Fleet Manager 中心群集 Kubernetes API。
• 跨多个群集部署集群范围的资源。
• 跨多个群集部署命名空间范围内的资源。
• 创建和配置托管机群命名空间。
• 操作说明：使用 Azure Kubernetes 舰队管理器更新运行升级多个群集。