为 AKS Arc 运算符启用 Kubernetes 扩展（预览版）

项目
11/23/2024

适用于：Azure Arc 在 VMware 上启用的 AKS（预览版）

若要在 VMware 预览版上使用 AKS Arc，必须先通过 Arc 资源桥将 vCenter 连接到 Azure 来载入已启用 Arc 的 VMware vSphere，有两种方案可用于访问此预览版：

如果部署安装了 AKS Arc 运算符的 Kubernetes 扩展的 Arc 资源桥，则应该只遵循步骤 #1：首次用户注册功能/提供程序，步骤 2：安装 aksarc CLI 扩展。
如果在未安装 AKS Arc 运算符的 Kubernetes 扩展的情况下部署 Arc 资源桥，请按照本文中的所有步骤操作。

开始之前

在开始之前，请安装 Azure CLI。

步骤 1. 首次注册功能/提供程序

如果订阅首次部署 AKS Arc 运算符的 Kubernetes 扩展（预览版），则必须注册预览功能。

准备 Azure 帐户：

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

执行一次性功能注册：

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

执行一次性提供程序注册：

### 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 extension 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 资源桥部署期间创建的。

获取 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)

$customLocationResourceGroupName指定在 Arc 资源桥部署期间创建的和$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

成功为 AKS Arc 运算符（预览版）启用 Kubernetes 扩展后，可以继续执行后续步骤来创建 Kubernetes 群集。

从 VMware 上的 AKS Arc 部署中清理环境

完成 VMware 预览版 AKS Arc 评估后，可以按照以下步骤清理环境：

删除 AKS 群集。若要删除工作负荷群集，请使用 az aksarc delete 命令，或转到Azure 门户：
```
az aksarc delete -n '<cluster name>' -g $applianceResourceGroupName
```
卸载 Kubernetes 扩展。可以使用 az extension remove 命令卸载 AKS Arc 运算符的 Kubernetes 扩展：
```
az extension remove -n aksarc
az extension remove -n connectedk8s
```

后续步骤

如果开始评估 VMware 预览版上的 AKS Arc 并完成为 AKS Arc 运算符启用 Kubernetes 扩展，则可以按照快速入门中的说明创建 Kubernetes 群集：使用 Azure CLI 部署 AKS 群集。
如果已完成 VMware 上的 AKS Arc 评估，可以通过 GitHub 与我们共享反馈。

通过