为 AKS Arc 运算符启用 Kubernetes 扩展 (预览版)

适用于：VMware 上的 Azure Arc 启用的 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 扩展 (预览版) 部署，则必须注册预览功能。

1. 准备 Azure 帐户：

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

2. 执行一次性功能注册：

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

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

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

1. 为 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'
   

2. 指定 $resource_group 和 $appliance_name：

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

3. 安装适用于 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 资源网桥部署期间创建的。

1. 获取用于配置自定义位置的 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)
   

2. 指定在 $customLocationResourceGroupName Arc 资源网桥部署期间创建的 和 $customLocationName：

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

3. 修补自定义位置： 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
   

4. 验证自定义位置预配状态是否成功： ProvisioningState: "Succeeded"：

   az customlocation show -g $customLocationResourceGroupName -n $customLocationName 
   

成功启用适用于 AKS Arc 运算符的 Kubernetes 扩展 (预览版) 后，可以继续执行后续步骤来创建 Kubernetes 群集。

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

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

1. 删除 AKS 群集。 若要删除工作负载群集，请使用 az aksarc delete 命令，或转到Azure 门户：

   az aksarc delete -n '<cluster name>' -g $applianceResourceGroupName
   

2. 卸载 Kubernetes 扩展。 可以使用 az extension remove 命令卸载适用于 AKS Arc 运算符的 Kubernetes 扩展：

   az extension remove -n aksarc
   az extension remove -n connectedk8s
   

后续步骤

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