AKS Arc Operators の Kubernetes 拡張機能を有効にする (プレビュー)

[アーティクル]
11/23/2024

適用対象: Azure Arc on VMware で有効になっている AKS (プレビュー)

VMware プレビューで AKS Arc を使用するには、まず、Arc リソースブリッジを介して vCenter を Azure に接続 Arc 対応 VMware vSphereをオンボードする必要がありますこのプレビューにアクセスするには、次の 2 つのシナリオがあります。

Kubernetes Extension for AKS Arc Operators がインストールされた Arc リソースブリッジをデプロイする場合は、 Step #1: 初めてのユーザーの機能/プロバイダーの登録、 Step #2: aksarc CLI 拡張機能のインストールにのみ従う必要があります。
Kubernetes Extension for AKS Arc Operators をインストールせずに Arc Resource Bridge をデプロイする場合は、この記事のすべての手順に従ってください。

開始する前に

作業を開始する前に、Azure CLI をインストールします。

ステップ 1. 初めてユーザーに機能/プロバイダーを登録する

サブスクリプションで初めて Kubernetes Extension for AKS Arc Operators (プレビュー) をデプロイする場合は、プレビュー機能を登録する必要があります。

Azure アカウントを準備します。

 az login --use-device-code
 az account set -s '<$subscriptionID>'

1 回限り機能の登録を実行します。

### Register your subscription ID with the feature
az feature register --namespace Microsoft.HybridConnectivity --name hiddenPreviewAccess

### Check feature registrationState -o tsv == Registered
az feature show --name hiddenPreviewAccess --namespace Microsoft.HybridConnectivity

1 回限りのプロバイダー登録を実行します。

### Register your subscription ID with the provider
az provider register --namespace "Microsoft.HybridContainerService" 
az provider register --namespace "Microsoft.HybridConnectivity"

### Check provider registrationState -o tsv == Registered
az provider show -n Microsoft.HybridContainerService --query registrationState
az provider show -n Microsoft.HybridConnectivity --query registrationState

ステップ 2. aksarc CLI 拡張機能をインストールする

CLI 拡張機能をインストールします。 az 拡張機能の add コマンドを使用します。

az extension add -n aksarc --version 1.0.0b1
az extension add -n connectedk8s
az extension add -n k8s-extension
az extension add -n arcappliance
az extension add -n customlocation

手順 3. AKS Arc オペレーター用の Kubernetes 拡張機能をインストールする

AKS Arc 演算子の Kubernetes 拡張機能のバージョンを指定します。

$extension_name = 'hybridaksopext'
$extension_version = '0.4.5'
$extension_release_train = 'preview'

export extension_name='hybridaksopext'
export extension_version='0.4.5'
export extension_release_train='preview'

$resource_groupと$appliance_nameを指定します。

$resource_group = '$resourceGroup from Arc Resource Bridge deployment'
$appliance_name = '$applianceName from Arc Resource Bridge deployment'

AKS Arc 演算子用の Kubernetes 拡張機能をインストールします。

az k8s-extension create -g $resource_group -c $appliance_name --cluster-type appliances --name $extension_name --extension-type Microsoft.HybridAKSOperator --version $extension_version --release-train $extension_release_train --config Microsoft.CustomLocation.ServiceAccount="default" --auto-upgrade false

ステップ 4: カスタムの場所を準備する

カスタムの場所は、Arc Resource Bridge のデプロイ中に作成されました。

ID を取得してカスタムの場所を構成します。

### $extension_name = 'hybridaksopext'
$ArcApplianceResourceId = (az arcappliance show -g $resource_group -n $appliance_name --query id -o tsv)
$ClusteraksExtensionId = (az k8s-extension show -g $resource_group -c $appliance_name --cluster-type appliances --name $extension_name --query id -o tsv)

Arc Resource Bridge のデプロイ時に作成した $customLocationResourceGroupName と $customLocationNameを指定します。

$customLocationResourceGroupName = '$resourceGroup from Arc Resource Bridge deployment'
$customLocationName = '$customLocationName from Arc Resource Bridge deployment'

カスタムの場所 ( ProvisioningState: "Patching") にパッチを適用します。

### Use the same custom location information from the Arc Resource Bridge deployment
az customlocation patch -g $customLocationResourceGroupName -n $customLocationName --cluster-extension-ids $clusteraksExtensionId

カスタムの場所のプロビジョニング状態が成功したことを確認します: ProvisioningState: "Succeeded":
```
az customlocation show -g $customLocationResourceGroupName -n $customLocationName 
```

これで、Kubernetes Extension for AKS Arc Operators (プレビュー) が正常に有効になったので、次の手順に進んで Kubernetes クラスターを作成できます。

VMware 上の AKS Arc のデプロイから環境をクリーンアップする

AKS Arc on VMware プレビューの評価が完了したら、次の手順に従って環境をクリーンアップできます。

AKS クラスターを削除します。ワークロードクラスターを削除するには、 az aksarc delete コマンドを使用するか、Azure portal に移動します。
```
az aksarc delete -n '<cluster name>' -g $applianceResourceGroupName
```
Kubernetes 拡張機能をアンインストールします。 kubernetes Extension for AKS Arc Operators をアンインストールするには、 az 拡張機能の remove コマンドを使用します。
```
az extension remove -n aksarc
az extension remove -n connectedk8s
```

次のステップ

AKS Arc on VMware プレビューの評価を開始し、AKS Arc Operators の Kubernetes 拡張機能の有効化が完了した場合は、「 Quickstart: Azure CLI を使用して AKS クラスターをデプロイする」の手順に従って Kubernetes クラスターを作成できます。
VMware 上の AKS Arc の評価を完了した場合は、 GitHub を通じてフィードバックを Microsoft と共有できます。

次の方法で共有