PowerShell を使用して、事前にステージングされたクラスター サービス オブジェクトと DNS レコードを含むAzure Kubernetes Service ホストをデプロイする

  • [アーティクル]

適用対象: AKS on Azure Stack HCI 22H2、AKS on Windows Server

この攻略ガイドでは、Azure Arc で有効になっている AKS で事前にステージングされたクラスター サービス オブジェクトと DNS レコードがある場合に、PowerShell を使用して AKS ホストのデプロイを構成する方法について説明します。

開始する前に

手順 1: デプロイ用に Active Directory と DNS サーバーを準備する

Arc で AKS を有効にして、検出のためにクラウド エージェントの汎用クラスター名を Active Directory と DNS システムに登録できるように、DNS 環境で動的 DNS 更新を有効にできない場合は、Active Directory と DNS にそれぞれのレコードを事前に作成する必要があります。

名前 (または 32 文字を超えない任意の名前 ca-cloudagent ) を使用して、Active Directory に汎用クラスター サービスを作成します。 また、指定された cloudservicecidr アドレスを使用して、汎用クラスター サービスの FQDN を指す関連付けられた DNS レコードを作成する必要があります。 このプロセスの手順の詳細については、フェールオーバー クラスタリングのドキュメントを参照してください。

AKS デプロイでは、展開を続行する前に、Active Directory で指定された clusterRoleName を見つけようとします。

注意

AKS がデプロイされると、この情報を変更することはできません。

手順 2:デプロイ用にマシンを準備する

すべての物理ノードでチェックを実行して、AKS Arc をインストールするためにすべての要件が満たされているかどうかを確認します。管理者として PowerShell を開き、次の Initialize-AksHciNode コマンドを実行します。

Initialize-AksHciNode

手順 3: 仮想ネットワークを作成する

デプロイで使用するノードの仮想ネットワークを作成するには、PowerShell コマンドを使用して環境変数を New-AksHciNetworkSetting 作成します。 この変数は、後で静的 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 の値がないかどうかを確認することによって識別できます。 このリソースを削除すると、ポリシー外のデプロイが発生します。

この攻略ガイドでは、事前にステージングされたクラスター サービス オブジェクトと DNS レコードがある場合に、PowerShell を使用して AKS ホストを設定する方法について説明しました。

次の手順