PowerShell を使って、事前設定されたクラスター サービス オブジェクトと DNS レコードを使って Azure Kubernetes Service ホストをデプロイする

この攻略ガイドでは、クラスター サービス オブジェクトと DNS レコードを事前設定している場合に、PowerShell を使用して AKS ホストのデプロイを構成する方法について説明します。

開始する前に

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

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

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

AKS on Azure Stack HCI and Windows Server デプロイでは、デプロイに進む前に、指定された clusterRoleName を Active Directory 内で見つけようとします。

注意

AKS on Azure Stack HCI and Windows Server がデプロイされた後、これらの情報を変更することはできません。

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

すべての物理ノードでチェックを実行して、Azure Kubernetes Service on Azure Stack HCI and Windows Server をインストールするためのすべての要件が満たされているかどうかを確認します。 管理者として 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 コマンドを使用して Azure Kubernetes Service ホスト用の構成設定を設定します。 workingDircloudServiceCidrcloudConfigLocationclusterRoleName のパラメーターを指定する必要があります。 構成の詳細をリセットする場合は、このコマンドを新しいパラメーターで再び実行します。

次のコマンドを使用して、デプロイを構成します。

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>"

手順 5: 新しいデプロイを開始する

デプロイを構成したら、開始する必要があります。 デプロイを開始すると、Azure Kubernetes Service on Azure Stack HCI and Windows Server エージェントまたはサービスと Azure Kubernetes Service ホストがインストールされます。 デプロイを開始するには、次のコマンドを実行します。

Install-AksHci

警告

Azure Kubernetes Service ホストのインストール中に、登録中に設定されるリソース グループ内に Kubernetes - Azure Arc というリソースの種類が作成されます。 このリソースは Azure Kubernetes Service ホストを表すため、削除しないでください。 このリソースは、そのディストリビューション フィールドに aks_management の値がないかどうかを確認することによって識別できます。 このリソースを削除すると、ポリシー違反のデプロイになります。

このハウツー ガイドでは、クラスター サービス オブジェクトと DNS レコードを事前設定している場合に、PowerShell を使用して Azure Kubernetes Service ホストを設定する方法について説明します。

次の手順