通过

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

  • 项目

适用于：VMware 上的 Azure Arc 启用的 AKS (预览版)

若要使用 VMware 上的 AKS Arc 预览版，必须先通过 Arc 资源网桥将 vCenter 连接到 Azure 载入已启用 Arc 的 VMware vSphere。

准备阶段

在开始之前， 请安装 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 与我们分享反馈。