PowerShell を使用して、事前にステージングされたクラスター サービス オブジェクトと DNS レコードを含む Azure Kubernetes Service ホストをデプロイする
適用対象: AKS on Azure Stack HCI 22H2、Windows Server 上の AKS
このハウツー ガイドでは、Azure Arc によって有効になっている AKS でクラスター サービス オブジェクトと DNS レコードを事前にステージングした場合に、PowerShell を使用して AKS ホストのデプロイを構成する方法について説明します。
開始する前に
- システム要件のすべての前提条件を満たしていることを確認してください。
- AksHci PowerShell モジュールをダウンロードしてインストールする。
手順 1: デプロイ用に Active Directory と DNS サーバーを準備する
Arc によって有効になっている AKS がクラウド エージェントの汎用クラスター名を Active Directory と DNS システムに登録して検出できるように、DNS 環境で動的 DNS 更新を有効にできない場合は、Active Directory と DNS でそれぞれのレコードを事前に作成する必要があります。
ca-cloudagentという名前 (または 32 文字を超えない任意の名前) を使用して、Active Directory に汎用クラスター サービスを作成します。 また、指定された cloudservicecidr アドレスを持つ汎用クラスター サービスの FQDN を指す関連付けられた DNS レコードを作成します。 このプロセスの手順の詳細については、 failover クラスタリングのドキュメントを参照してください。
AKS デプロイは、展開を続行する前に、Active Directory で指定された clusterRoleName を見つけようとします。
Note
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"
Note
この例のコマンドに示されている値は、環境に合わせてカスタマイズする必要があります。
手順 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"
Note
環境に合わせて、このコマンド例に示す値をカスタマイズします。
手順 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値の分散フィールドをチェックすることで、リソースを識別できます。 このリソースを削除すると、ポリシー外のデプロイが発生します。