部署并管理已启用 Azure Arc 的 Kubernetes 群集扩展

可以在已启用Azure Arc的 Kubernetes 群集中使用扩展来启用Azure服务和方案。 本文介绍如何创建扩展实例并设置必需和可选参数，包括更新和配置选项。 还可以了解如何查看、列出、更新和删除扩展实例。

在开始之前，请阅读启用了 Azure Arc 的 Kubernetes 群集扩展的概述，并查看当前可用扩展的列表。 本文中的步骤适用于任何扩展，但请查看要部署的特定扩展的文档以了解任何特定的配置设置或指南。

先决条件

• 最新版本的 Azure CLI。

• 最新版本的 connectedk8s 和 k8s-extension Azure CLI 扩展。 若要安装或更新这些扩展的最新版本，请运行以下命令：

  az extension add --upgrade --name connectedk8s
  az extension add --upgrade --name k8s-extension
  

• 一个现有的已启用 Azure Arc 的 Kubernetes 连接群集，其中至少包含一个操作系统和体系结构类型为 linux/amd64 的节点。 如果仅部署 Flux （GitOps） 或 Microsoft Defender for Containers 扩展，则可以在不使用节点的情况下 linux/amd64 使用基于 ARM64 的群集。

  • 如果尚未连接群集，请使用我们的快速入门连接一个群集。
  • 将代理升级到最新版本。

创建扩展实例

若要创建新的扩展实例，请使用 k8s-extension create 命令，并为环境提供参数值。

此示例在已启用 Azure Arc 的 Kubernetes 群集上创建 Azure Key Vault 机密提供程序扩展实例：

az k8s-extension create --name akvsecretsprovider  --extension-type Microsoft.AzureKeyVaultSecretsProvider --scope cluster --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type connectedClusters

输出：

{
  "aksAssignedIdentity": null,
  "autoUpgradeMinorVersion": true,
  "configurationProtectedSettings": {},
  "configurationSettings": {},
  "customLocationSettings": null,
  "errorInfo": null,
  "extensionType": "microsoft.azurekeyvaultsecretsprovider",
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/demo/providers/Microsoft.Kubernetes/connectedClusters/chenyeaks/providers/Microsoft.KubernetesConfiguration/extensions/akvsecretsprovider",
  "identity": {
    "principalId": "3f9c9566-1d32-4861-9f36-9739bf853420",
    "tenantId": null,
    "type": "SystemAssigned"
  },
  "installedVersion": null,
  "name": "akvsecretsprovider",
  "packageUri": null,
  "provisioningState": "Succeeded",
  "releaseTrain": "Stable",
  "resourceGroup": "demo",
  "scope": {
    "cluster": {
      "releaseNamespace": "kube-system"
    },
    "namespace": null
  },
  "statuses": [],
  "systemData": {
    "createdAt": "2023-09-13T02:34:19.549739+00:00",
    "createdBy": null,
    "createdByType": null,
    "lastModifiedAt": "2023-09-13T02:34:19.549739+00:00",
    "lastModifiedBy": null,
    "lastModifiedByType": null
  },
  "type": "Microsoft.KubernetesConfiguration/extensions",
  "version": "1.4.2"
}

用于创建扩展所需的参数

下表介绍了用于 az k8s-extension create 创建扩展实例所需的参数：

用于创建扩展的可选参数

将其中一个或多个可选参数与方案所需的参数一起使用。 其中一些参数不能一起使用。 查看每个参数的说明，并使用适用于你的方案的说明。

有关其他可选参数的信息，请参阅 az k8s-extension create 参考文档。

显示扩展详细信息

若要查看当前安装的扩展实例的详细信息，请使用 k8s-extension show 命令。 使用应用场景中的值作为必需的参数占位符。

az k8s-extension show --name akvsecretsprovider --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type connectedClusters

输出：

{
  "aksAssignedIdentity": null,
  "autoUpgradeMinorVersion": true,
  "configurationProtectedSettings": {},
  "configurationSettings": {},
  "customLocationSettings": null,
  "errorInfo": null,
  "extensionType": "microsoft.azurekeyvaultsecretsprovider",
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/demo/providers/Microsoft.Kubernetes/connectedClusters/chenyeaks/providers/Microsoft.KubernetesConfiguration/extensions/akvsecretsprovider",
  "identity": {
    "principalId": "3f9c9566-1d32-4861-9f36-9739bf853420",
    "tenantId": null,
    "type": "SystemAssigned"
  },
  "installedVersion": null,
  "name": "akvsecretsprovider",
  "packageUri": null,
  "provisioningState": "Succeeded",
  "releaseTrain": "Stable",
  "resourceGroup": "demo",
  "scope": {
    "cluster": {
      "releaseNamespace": "kube-system"
    },
    "namespace": null
  },
  "statuses": [],
  "systemData": {
    "createdAt": "2023-09-13T02:34:19.549739+00:00",
    "createdBy": null,
    "createdByType": null,
    "lastModifiedAt": "2023-09-13T02:34:19.549739+00:00",
    "lastModifiedBy": null,
    "lastModifiedByType": null
  },
  "type": "Microsoft.KubernetesConfiguration/extensions",
  "version": "1.4.2"
}

列出群集上安装的所有扩展

若要查看群集上安装的所有扩展的列表，请使用 k8s-extension list 命令。 使用应用场景中的值作为必需的参数占位符。

az k8s-extension list --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type connectedClusters

应会看到与如下示例类似的输出：

[
  {
    "aksAssignedIdentity": null,
    "autoUpgradeMinorVersion": true,
    "configurationProtectedSettings": {},
    "configurationSettings": {},
    "customLocationSettings": null,
    "errorInfo": null,
    "extensionType": "microsoft.azurekeyvaultsecretsprovider",
    "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/demo/providers/Microsoft.Kubernetes/connectedClusters/chenyeaks/providers/Microsoft.KubernetesConfiguration/extensions/akvsecretsprovider",
    "identity": {
      "principalId": "3f9c9566-1d32-4861-9f36-9739bf853420",
      "tenantId": null,
      "type": "SystemAssigned"
    },
    "installedVersion": null,
    "name": "akvsecretsprovider",
    "packageUri": null,
    "provisioningState": "Succeeded",
    "releaseTrain": "Stable",
    "resourceGroup": "demo",
    "scope": {
      "cluster": {
        "releaseNamespace": "kube-system"
      },
      "namespace": null
    },
    "statuses": [],
    "systemData": {
      "createdAt": "2023-09-13T02:34:19.549739+00:00",
      "createdBy": null,
      "createdByType": null,
      "lastModifiedAt": "2023-09-13T02:34:19.549739+00:00",
      "lastModifiedBy": null,
      "lastModifiedByType": null
    },
    "type": "Microsoft.KubernetesConfiguration/extensions",
    "version": "1.4.2"
  }
]

更新扩展实例

若要更新现有的扩展实例，请使用 k8s-extension update。 传入必需参数和可选参数的值。 这些参数与用于创建扩展实例的参数略有不同。

此示例将 Azure 机器学习扩展实例的 auto-upgrade-minor-version 设置更新为 true：

az k8s-extension update --name akvsecretsprovider --cluster-resource-provider Microsoft.AzureKeyvaultSecretsProvider --cluster-name <clusterName> --resource-group <resourceGroupName> --auto-upgrade-minor-version false --cluster-type connectedClusters

扩展更新所需的参数

扩展更新的可选参数

有关其他可选参数的信息，请参阅 az k8s-extension update 参考文档。

升级扩展实例

如前所述，如果将auto-upgrade-minor-version设置为true，该扩展在发布新的次要版本时会自动升级。 对于大多数方案，请启用自动升级。 将 auto-upgrade-minor-version 设置为 false 后，如果需要更新的版本，则必须手动升级扩展。

需要手动升级才能获取扩展的新主版本。 为了避免主版本升级中的意外重大变更，您可以选择何时升级扩展。

若要手动升级扩展实例，请使用 k8s-extension update 并设置 version 参数。

此示例将 Azure Key Vault 机密提供程序实例更新为 x.y.z 版：

az k8s-extension update --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type connectedClusters --name akvsecretsprovider --version x.y.z

删除扩展实例

若要删除群集上的扩展实例，请使用 k8s-extension delete。 使用应用场景中的值作为必需的参数占位符。

az k8s-extension delete --name akvsecretsprovider --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type connectedClusters

相关内容

• 有关命令和参数的综合列表，请参阅 az k8s-extension CLI 参考。
• 了解 扩展如何与启用 Azure Arc 的 Kubernetes 群集协作。
• 查看可用于已启用 Azure Arc 的 Kubernetes 的群集扩展。