快速入門:將現有的 Kubernetes 叢集 連線 至 Azure Arc
使用 Azure CLI 或 Azure PowerShell 開始使用已啟用 Azure Arc 的 Kubernetes,將現有的 Kubernetes 叢集連線至 Azure Arc。
如需將叢集連線至 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 叢集。 如果您沒有叢集,您可以使用下列其中一個選項來建立叢集:
使用 Docker for Mac 或 Windows 建立 Kubernetes 叢集
-
注意
叢集必須至少有一個作業系統節點和架構類型和
linux/amd64
/或linux/arm64
。 如需 ARM64 案例的詳細資訊,請參閱 叢集需求 。
針對將部署在叢集上的 Arc 代理程式,至少有 850 MB 可用,且容量會使用大約 7% 的單一 CPU。
註冊已啟用 Azure Arc 的 Kubernetes 提供者
輸入下列命令:
az provider register --namespace Microsoft.Kubernetes az provider register --namespace Microsoft.KubernetesConfiguration az provider register --namespace Microsoft.ExtendedLocation
監視註冊程序。 註冊最多可能需要 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 代理程式部署至叢集,並將 Helm v. 3.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 伺服器路由要求。
在部署電腦上,將 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>
在 Kubernetes 叢集上,使用
proxy-https
指定的 和proxy-http
參數執行 connect 命令。 如果您的 Proxy 伺服器同時設定 HTTP 和 HTTPS,請務必針對 HTTP Proxy 和--proxy-https
HTTPS Proxy 使用--proxy-http
。 如果您的 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-http
、--proxy-https
、 和--proxy-skip-range
預期適用於大多數輸出 Proxy 環境。--proxy-cert
只有在您需要將 Proxy 預期的受信任憑證插入代理程式 Pod 的受信任證書存儲時,才需要。- 輸出 Proxy 必須設定為允許 Websocket 連線。
若輸出 Proxy 伺服器只需要提供受信任的憑證而不需要 Proxy 伺服器端點輸入, az connectedk8s connect
則可以只 --proxy-cert
使用指定的輸入來執行。 如果預期有多個受信任的憑證,可以使用 參數,在單一檔案中提供合併的憑證鏈結 --proxy-cert
。
注意
--custom-ca-cert
是--proxy-cert
的別名。 任一個參數都可以交替使用。 在相同的命令中傳遞這兩個參數,將會接受最後一個傳遞的參數。
使用指定的 參數執行 connect 命令 --proxy-cert
:
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
部署到 命名空間。
使用下列方式檢視這些部署和 Pod:
kubectl get deployments,pods -n azure-arc
確認所有 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 入口網站 中的資源。
下一步
- 瞭解如何 使用 GitOps 搭配 Flux v2 部署設定。
- 針對已啟用 Azure Arc 的常見 Kubernetes 問題進行疑難解答。
- 使用 Azure Arc Jumpstart 體驗已啟用 Azure Arc 的 Kubernetes 自動化案例。