使用 PowerShell 部署具有預先暫存叢集服務物件和 DNS 記錄的 Azure Kubernetes Service 主機

  • 發行項

適用於：Azure Stack HCI 22H2 上的 AKS、Windows Server 上的 AKS

本操作說明指南說明如果您已在 Azure Arc 啟用的 AKS 中預先暫存叢集服務物件和 DNS 記錄，如何使用 PowerShell 來設定 AKS 主機部署。

開始之前

步驟 1：準備 Active Directory 和 DNS 伺服器以進行部署

如果您無法在 DNS 環境中啟用動態 DNS 更新，以允許 Arc 啟用的 AKS 在 Active Directory 和 DNS 系統中註冊雲端代理程式泛型叢集名稱以進行探索，您必須在 Active Directory 和 DNS 中預先建立個別記錄。

在 Active Directory 中建立一般叢集服務，其名稱 ca-cloudagent (或您選擇的名稱不超過 32 個字元) 。 您也必須建立指向具有所提供 cloudservicecidr 位址之泛型叢集服務的 FQDN 的相關聯 DNS 記錄。 如需此程序步驟的詳細資料，請參閱容錯移轉叢集文件。

AKS 部署會先嘗試找出 clusterRoleName Active Directory 中指定的 ，再繼續進行部署。

注意

部署 AKS 之後，就無法變更此資訊。

步驟 2：準備電腦以進行部署

在每個實體節點上執行檢查，以查看是否已滿足所有需求來安裝 AKS Arc。以系統管理員身分開啟 PowerShell，然後執行下列 Initialize-AksHciNode 命令：

Initialize-AksHciNode

步驟 3：建立虛擬網路

若要為部署中要使用的節點建立虛擬網路，請使用 New-AksHciNetworkSetting PowerShell命令建立環境變數。 此變數稍後會用來設定使用靜態IP的部署。 如果您想要使用 DHCP 設定 AKS 部署，請參閱 New-AksHciNetworkSetting 以取得範例。 您也可以檢閱某些網路節點概念。

#static IP
$vnet = New-AksHciNetworkSetting -name mgmt-vnet -vSwitchName "extSwitch" -k8sNodeIpPoolStart "172.16.10.1" -k8sNodeIpPoolEnd "172.16.10.255" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -ipAddressPrefix "172.16.0.0/16" -gateway "172.16.0.1" -dnsServers "172.16.0.1"

注意

您必須為環境自定義此範例命令中指定的值。

步驟 4：使用預先暫存的叢集服務物件和 DNS 記錄來設定部署

使用 Set-AksHciConfig 命令設定 AKS 主機的 組態設定。 您必須指定 workingDir、cloudServiceCidr、cloudConfigLocation 和 clusterRoleName 參數。 如果您想要重設設定詳細資料，請使用新的參數再次執行命令。

使用下列命令來設定部署：

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"

注意

針對您的環境自定義此範例命令中提供的值。

步驟 5：登入 Azure 並設定註冊設定

使用您的訂用帳戶和資源組名來執行下列 Set-AksHciRegistration PowerShell 命令，以登入 Azure。 您必須擁有 Azure 訂用帳戶，以及美國東部、東南亞或西歐 Azure 區域中的現有 Azure 資源群組，才能繼續：

Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"

步驟 6：啟動新的部署

設定好部署之後，您必須開始進行。 啟動部署會安裝 AKS 代理程式/服務和 AKS 主機。 若要開始部署，請執行下列命令：

Install-AksHci

警告

在安裝 AKS 主機期間，會在註冊期間設定的資源群組中建立 Kubernetes - Azure Arc 資源類型。 請不要刪除此資源，因為這代表您的 Azure Kubernetes Service 主機。 您可以檢查資源的發佈欄位是否有 aks_management 值來識別資源。 刪除此資源會導致原則外部署。

在本操作指南中，如果您已預先暫存叢集服務物件和 DNS 記錄，您已瞭解如何使用 PowerShell 設定 AKS 主機。

後續步驟