使用 PowerShell 部署具有預先暫存叢集服務物件和 DNS 記錄的 Azure Kubernetes Service 主機
適用於：Azure Stack HCI 22H2 上的 AKS、Windows Server 上的 AKS
本操作指南說明如果您在 Azure Arc 啟用的 AKS 中預先設置叢集服務物件和 DNS 記錄，如何使用 PowerShell 來設定 AKS 主機部署。
開始之前
- 請確定您符合系統需求中的所有必要條件。
- 下載並安裝 AksHci PowerShell 模組。
步驟 1：準備 Active Directory 和 DNS 伺服器以進行部署
如果您無法在 DNS 環境中啟用動態 DNS 更新，以允許 Arc 啟用的 AKS 在 Active Directory 和 DNS 系統中註冊雲端代理程式泛型叢集名稱以進行探索，您必須在 Active Directory 和 DNS 中預先建立個別記錄。
在 Active Directory 中建立具有名稱 ca-cloudagent 的一般叢集服務（或您選擇的名稱不超過 32 個字元）。 此外，建立相關聯的 DNS 記錄，以指向具有所提供 cloudservicecidr 位址之一般叢集服務的 FQDN。 如需此程式步驟的詳細資訊，請參閱 故障轉移叢集檔。
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 識別值。 刪除此資源會導致原則外部署。