共用方式為


存取 Azure Kubernetes Fleet Manager 中樞叢集的 Kubernetes API

如果您的 Azure Kubernetes Fleet Manager (Kubernetes Fleet) 資源是使用中樞叢集建立的,您可以使用它集中控制 Kubernetes 資源傳播等案例。 在本文中,您將瞭解如何存取 Kubernetes Fleet 中樞叢集的 Kubernetes API。

必要條件

  • 如果您沒有 Azure 訂用帳戶,請在開始之前先建立 Azure 免費帳戶
  • 您需要具有中樞叢集和成員叢集的 Kubernetes Fleet 資源。 如果您沒有資源,請參閱 使用 Azure CLI 建立 Azure Kubernetes Fleet Manager 資源和加入成員叢集。
  • 您所使用的身分識別(使用者或服務主體)必須具有 Kubernetes Fleet 資源的 Microsoft.ContainerService/fleets/listCredentials/action 許可權。

存取 Kubernetes API

  1. 為您的訂用帳戶標識碼、資源群組和 Kubernetes Fleet 資源設定下列環境變數:

    export SUBSCRIPTION_ID=<subscription-id>
    export GROUP=<resource-group-name>
    export FLEET=<fleet-name>
    
  2. 使用 命令設定預設的 Azure 訂用 az account set 帳戶:

    az account set --subscription ${SUBSCRIPTION_ID}
    
  3. 使用 az fleet get-credentials 命令取得 Kubernetes Fleet 中樞叢集的 kubeconfig 檔案:

    az fleet get-credentials --resource-group ${GROUP} --name ${FLEET}
    

    您的輸出訊息看起來應類似下列範例:

    Merged "hub" as current context in /home/fleet/.kube/config
    
  4. 針對 FLEET_ID 中樞叢集 Kubernetes Fleet 資源的值設定下列環境變數:

    export FLEET_ID=/subscriptions/${SUBSCRIPTION_ID}/resourceGroups/${GROUP}/providers/Microsoft.ContainerService/fleets/${FLEET}
    
  5. 使用下列命令授權您的身分識別以存取 Kubernetes Fleet 中樞叢集。

    ROLE針對環境變數,您可以使用下列四個內建角色定義之一做為值:

    • Azure Kubernetes 機群管理員 RBAC 讀取者
    • Azure Kubernetes 機群管理員 RBAC 編寫器
    • Azure Kubernetes 機群管理員 RBAC 管理員
    • Azure Kubernetes 機群管理員 RBAC Cluster 管理員
    export IDENTITY=$(az ad signed-in-user show --query "id" --output tsv)
    export ROLE="Azure Kubernetes Fleet Manager RBAC Cluster Admin"
    az role assignment create --role "${ROLE}" --assignee ${IDENTITY} --scope ${FLEET_ID}
    

    您的輸出訊息看起來應類似下列範例:

    {
      "canDelegate": null,
      "condition": null,
      "conditionVersion": null,
      "description": null,
      "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/fleets/<FLEET>/providers/Microsoft.Authorization/roleAssignments/<assignment>",
      "name": "<name>",
      "principalId": "<id>",
      "principalType": "User",
      "resourceGroup": "<GROUP>",
      "roleDefinitionId": "/subscriptions/<SUBSCRIPTION_ID>/providers/Microsoft.Authorization/roleDefinitions/18ab4d3d-a1bf-4477-8ad9-8359bc988f69",
      "scope": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/fleets/<FLEET>",
      "type": "Microsoft.Authorization/roleAssignments"
    }
    
  6. 使用 kubectl get memberclusters 命令確認您可以存取 API 伺服器:

    kubectl get memberclusters
    

    如果命令成功,您的輸出看起來應該類似下列範例:

    NAME           JOINED   AGE
    aks-member-1   True     2m
    aks-member-2   True     2m
    aks-member-3   True     2m