共用方式為

快速入門：將現有 Kubernetes 叢集連線至 Azure Arc

  • 發行項

使用 Azure CLI 或 Azure PowerShell 將現有的 Kubernetes 叢集連線至 Azure Arc，開始使用已啟用 Azure Arc 的 Kubernetes。

如需將叢集連線至 Azure Arc 的概念性概觀，請參閱已啟用 Azure Arc 的 Kubernetes 代理程式概觀。 若要嘗試範例/練習體驗中的事項，請造訪 Azure Arc Jumpstart。

必要條件

重要

除了這些必要條件之外，請務必符合已啟用 Azure Arc 的 Kubernetes 的所有網路需求。

  • 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。

  • Kubernetes 核心概念的基本瞭解。

  • 身分識別 (使用者或服務主體)，可用來登入 Azure CLI，並將叢集連線至 Azure Arc。

  • 最新版的 Azure CLI。

  • 最新版的 connectedk8s Azure CLI 延伸模組，請執行下列命令進行安裝：

    az extension add --name connectedk8s

  • 已啟動並執行中的 Kubernetes 叢集。 如果您沒有叢集，則可以使用下列其中一個選項來建立叢集：

  • 將部署在叢集上的 Arc 代理程式至少有 850 MB 可用，以及能使用大約 7% 的單一 CPU。

  • 指向您的叢集的 kubeconfig 檔案 和內容。 若要深入了解 kubeconfig 檔案是什麼，以及如何將內容設定為指向您的叢集，請參閱此文章。

為已啟用 Azure Arc 的 Kubernetes 註冊提供者

  1. 輸入下列命令：

    az provider register --namespace Microsoft.Kubernetes
az provider register --namespace Microsoft.KubernetesConfiguration
az provider register --namespace Microsoft.ExtendedLocation

  2. 監視註冊程序。 註冊最多可能需要 10 分鐘的時間。

    az provider show -n Microsoft.Kubernetes -o table
az provider show -n Microsoft.KubernetesConfiguration -o table
az provider show -n Microsoft.ExtendedLocation -o table

    註冊後，您應會看到這些命名空間的 RegistrationState 狀態變更為 Registered。

建立資源群組

執行以下命令：

az group create --name AzureArcTest --location EastUS --output table

輸出：

Location    Name
----------  ------------
eastus      AzureArcTest

連線現有的 Kubernetes 叢集

執行下列命令以連線您的叢集。 此命令會將 Azure Arc 代理程式部署至叢集並將 Helm3.6.3 版安裝至部署機器的 .azure 資料夾。 此 Helm 3 安裝僅適用於 Azure Arc，而且不會移除或變更機器上任何先前安裝的 Helm 版本。

在此範例中，叢集的名稱是 AzureArcTest1。

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest

輸出：

Helm release deployment succeeded

    {
      "aadProfile": {
        "clientAppId": "",
        "serverAppId": "",
        "tenantId": ""
      },
      "agentPublicKeyCertificate": "xxxxxxxxxxxxxxxxxxx",
      "agentVersion": null,
      "connectivityStatus": "Connecting",
      "distribution": "gke",
      "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/AzureArcTest/providers/Microsoft.Kubernetes/connectedClusters/AzureArcTest1",
      "identity": {
        "principalId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "tenantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "type": "SystemAssigned"
      },
      "infrastructure": "gcp",
      "kubernetesVersion": null,
      "lastConnectivityTime": null,
      "location": "eastus",
      "managedIdentityCertificateExpirationTime": null,
      "name": "AzureArcTest1",
      "offering": null,
      "provisioningState": "Succeeded",
      "resourceGroup": "AzureArcTest",
      "tags": {},
      "totalCoreCount": null,
      "totalNodeCount": null,
      "type": "Microsoft.Kubernetes/connectedClusters"
    }

提示

上述未指定 location 參數的命令會在與資源群組相同的位置建立已啟用 Azure Arc 的 Kubernetes 資源。 若要在不同位置建立已啟用 Azure Arc 的 Kubernetes 資源，請在執行 az connectedk8s connect 命令時指定 --location <region> 或 -l <region>。

重要

如果部署因逾時錯誤而失敗，請參閱疑難排解指南以取得如何解決此問題的詳細資料。

使用輸出 Proxy 伺服器進行連線

如果您的叢集位於輸出 Proxy 伺服器後方，則必須透過輸出 Proxy 伺服器來路由傳送要求。

  1. 在部署機器上，設定 Azure CLI 使用輸出 Proxy 伺服器時所需的環境變數：

    export HTTP_PROXY=<proxy-server-ip-address>:<port>
export HTTPS_PROXY=<proxy-server-ip-address>:<port>
export NO_PROXY=<cluster-apiserver-ip-address>:<port>

  2. 在 Kubernetes 叢集上，使用指定的 proxy-https 和 proxy-http 參數執行 connect 命令。 如果您的 Proxy 伺服器同時設定 HTTP 和 HTTPS，務必針對 HTTP Proxy 使用 --proxy-http，以及針對 HTTPS Proxy 使用 --proxy-https。 如果您的 Proxy 伺服器只使用 HTTP，您可對這兩個參數使用該值。

    az connectedk8s connect --name <cluster-name> --resource-group <resource-group> --proxy-https https://<proxy-server-ip-address>:<port> --proxy-http http://<proxy-server-ip-address>:<port> --proxy-skip-range <excludedIP>,<excludedCIDR> --proxy-cert <path-to-cert-file>

注意

  • 某些網路要求 (例如涉及叢集內服務對服務通訊的網路要求)，必須與透過輸出通訊 Proxy 伺服器路由傳送的流量分開。 --proxy-skip-range 參數可用逗號分隔的方式指定 CIDR 範圍和端點，讓從代理程式到這些端點的任何通訊都不會通過輸出 Proxy。 至少應該將叢集中服務的 CIDR 範圍指定為此參數的值。 例如，假設 kubectl get svc -A 傳回服務清單，其中所有服務都有在範圍 10.0.0.0/16 中的 ClusterIP 值。 然後，要為 --proxy-skip-range 指定的值是 10.0.0.0/16,kubernetes.default.svc,.svc.cluster.local,.svc。
  • 大部分的輸出 Proxy 環境都預期有 --proxy-http、--proxy-https 和 --proxy-skip-range。 「只有」當您需要將 Proxy 預期的受信任憑證插入代理程式 Pod 的受信任憑證存放區時，才需使用 --proxy-cert。
  • 輸出 Proxy 必須設定為允許 Websocket 連線。

對於只需提供信任憑證且不需 Proxy 伺服器端點輸入的輸出 Proxy 伺服器，只要指定 --proxy-cert 輸入即可執行 az connectedk8s connect。 如果預期有多個受信任的憑證，可以使用 --proxy-cert 參數，在單一檔案中提供合併的憑證鏈結。

注意

  • --custom-ca-cert 是 --proxy-cert 的別名。 任一個參數都可以交換使用。 在相同的命令中傳遞這兩個參數，將會接受最後一個傳遞的參數。

執行已指定 --proxy-cert 參數的 connect 命令：

az connectedk8s connect --name <cluster-name> --resource-group <resource-group> --proxy-cert <path-to-cert-file>

驗證叢集連線

執行以下命令：

az connectedk8s list --resource-group AzureArcTest --output table

輸出：

Name           Location    ResourceGroup
-------------  ----------  ---------------
AzureArcTest1  eastus      AzureArcTest

注意

上線至叢集之後，大約需要大約 5 到 10 分鐘的時間，才會在 Azure 入口網站中已啟用 Azure Arc 的 Kubernetes 資源概觀頁面上呈現叢集中繼資料 (叢集版本、代理程式版本、節點數目等)。

提示

如需連線叢集時問題的疑難排解說明，請參閱診斷已啟用 Azure Arc 的 Kubernetes 叢集連線問題。

檢視適用於 Kubernetes 的 Azure Arc 代理程式

已啟用 Azure Arc 的 Kubernetes 會在 azure-arc 命名空間中部署幾個代理程式。

  1. 使用以下方式，檢視這些部署和 Pod：

    kubectl get deployments,pods -n azure-arc

  2. 確認所有 Pod 都處於 Running 狀態。

    輸出：

     NAME                                        READY   UP-TO-DATE   AVAILABLE   AGE
 deployment.apps/cluster-metadata-operator   1/1     1            1           13d
 deployment.apps/clusterconnect-agent        1/1     1            1           13d
 deployment.apps/clusteridentityoperator     1/1     1            1           13d
 deployment.apps/config-agent                1/1     1            1           13d
 deployment.apps/controller-manager          1/1     1            1           13d
 deployment.apps/extension-manager           1/1     1            1           13d
 deployment.apps/flux-logs-agent             1/1     1            1           13d
 deployment.apps/kube-aad-proxy              1/1     1            1           13d
 deployment.apps/metrics-agent               1/1     1            1           13d
 deployment.apps/resource-sync-agent         1/1     1            1           13d

 NAME                                            READY   STATUS    RESTARTS   AGE
 pod/cluster-metadata-operator-9568b899c-2stjn   2/2     Running   0          13d
 pod/clusterconnect-agent-576758886d-vggmv       3/3     Running   0          13d
 pod/clusteridentityoperator-6f59466c87-mm96j    2/2     Running   0          13d
 pod/config-agent-7cbd6cb89f-9fdnt               2/2     Running   0          13d
 pod/controller-manager-df6d56db5-kxmfj          2/2     Running   0          13d
 pod/extension-manager-58c94c5b89-c6q72          2/2     Running   0          13d
 pod/flux-logs-agent-6db9687fcb-rmxww            1/1     Running   0          13d
 pod/kube-aad-proxy-67b87b9f55-bthqv             2/2     Running   0          13d
 pod/metrics-agent-575c565fd9-k5j2t              2/2     Running   0          13d
 pod/resource-sync-agent-6bbd8bcd86-x5bk5        2/2     Running   0          13d

如需這些代理程式的詳細資訊，請參閱 已啟用 Azure Arc 的 Kubernetes 代理程式概觀。

清除資源

您可使用下列命令，刪除已啟用 Azure Arc 的 Kubernetes 資源、任何相關聯的設定資源，以及使用 Azure CLI 在叢集上執行的任何代理程式：

az connectedk8s delete --name AzureArcTest1 --resource-group AzureArcTest

如果刪除程序失敗，請使用下列命令強制刪除 (如果您想要略過確認提示，請新增 -y)：

az connectedk8s delete -n AzureArcTest1 -g AzureArcTest --force

如果您在建立新的叢集部署時遇到問題 (因為先前建立的資源未完全移除)，也可以使用此命令。

注意

使用 Azure 入口網站來刪除已啟用 Azure Arc 的 Kubernetes 資源會移除任何相關聯的設定資源，但不會移除在叢集上執行的任何代理程式。 最佳做法是使用 az connectedk8s delete 刪除已啟用 Azure Arc 的 Kubernetes 資源，而不是在 Azure 入口網站中刪除資源。

下一步