Развертывание расширения кластера Kubernetes с поддержкой Azure Arc и управление ими

Расширение можно использовать в кластере Kubernetes с поддержкой Azure Arc для доступа к службам и сценариям Azure. В этой статье описывается создание экземпляров расширений и установка обязательных и необязательных параметров, включая параметры обновлений и конфигураций. Вы также узнаете, как просматривать, перечислять, обновлять и удалять экземпляры расширения.

Перед началом работы ознакомьтесь с общими сведениями о расширениях кластера Kubernetes с поддержкой Azure Arc и просмотрите список доступных в настоящее время расширений.

Предварительные условия

• Последняя версия Azure CLI.

• Последние версии расширений connectedk8sk8s-extension Azure CLI. Чтобы установить эти расширения, выполните следующие команды:

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

  connectedk8s k8s-extension Если расширения уже установлены, убедитесь, что они обновлены до последней версии с помощью следующих команд:

  az extension update --name connectedk8s
  az extension update --name k8s-extension
  

• Существующий подключенный кластер Kubernetes с поддержкой Azure Arc, с как минимум одним узлом типа операционной системы и архитектуры linux/amd64. При развертывании Flux (GitOps) можно использовать кластер на основе ARM64 без использования linux/amd64 узла.

  • Если вы еще не подключили кластер, воспользуйтесь нашим кратким руководством по подключению к нему.
  • Обновите агент до последней версии.

Создание экземпляра расширения

Чтобы создать экземпляр расширения, используйте k8s-extension create команду. Используйте значения из сценария для обязательных заполнителей параметров.

В этом примере создается экземпляр расширения Обзор контейнеров в Azure Monitor на кластере Kubernetes с поддержкой Azure Arc:

az k8s-extension create --name azuremonitor-containers  --extension-type Microsoft.AzureMonitor.Containers --scope cluster --cluster-name <clusterName> --resource-group <resourceGroupName> --cluster-type connectedClusters

Проверьте выходные данные, которые выглядят следующим образом:

{
  "autoUpgradeMinorVersion": true,
  "configurationProtectedSettings": null,
  "configurationSettings": {
    "logAnalyticsWorkspaceResourceID": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/defaultresourcegroup-eus/providers/microsoft.operationalinsights/workspaces/defaultworkspace-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx-eus"
  },
  "creationTime": "2021-04-02T12:13:06.7534628+00:00",
  "errorInfo": {
    "code": null,
    "message": null
  },
  "extensionType": "microsoft.azuremonitor.containers",
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/demo/providers/Microsoft.Kubernetes/connectedClusters/demo/providers/Microsoft.KubernetesConfiguration/extensions/azuremonitor-containers",
  "identity": null,
  "installState": "Pending",
  "lastModifiedTime": "2021-04-02T12:13:06.753463+00:00",
  "lastStatusTime": null,
  "name": "azuremonitor-containers",
  "releaseTrain": "Stable",
  "resourceGroup": "demo",
  "scope": {
    "cluster": {
      "releaseNamespace": "azuremonitor-containers"
    },
    "namespace": null
  },
  "statuses": [],
  "systemData": null,
  "type": "Microsoft.KubernetesConfiguration/extensions",
  "version": "2.8.2"
}

Обязательные параметры

В следующей таблице описаны параметры, которые требуются при использовании az k8s-extension create для создания экземпляра расширения:

Необязательные параметры

Вы можете использовать один или несколько из этих необязательных параметров с необходимыми параметрами для вашего сценария.

Отображение сведений о расширении

Чтобы просмотреть сведения о экземпляре расширения, установленного в данный момент, используйте k8s-extension show команду. В коде используйте значения из сценария для обязательных заполнителей параметров.

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

Проверьте выходные данные, которые выглядят следующим образом:

{
  "autoUpgradeMinorVersion": true,
  "configurationProtectedSettings": null,
  "configurationSettings": {
    "logAnalyticsWorkspaceResourceID": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/defaultresourcegroup-eus/providers/microsoft.operationalinsights/workspaces/defaultworkspace-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx-eus"
  },
  "creationTime": "2021-04-02T12:13:06.7534628+00:00",
  "errorInfo": {
    "code": null,
    "message": null
  },
  "extensionType": "microsoft.azuremonitor.containers",
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/demo/providers/Microsoft.Kubernetes/connectedClusters/demo/providers/Microsoft.KubernetesConfiguration/extensions/azuremonitor-containers",
  "identity": null,
  "installState": "Installed",
  "lastModifiedTime": "2021-04-02T12:13:06.753463+00:00",
  "lastStatusTime": "2021-04-02T12:13:49.636+00:00",
  "name": "azuremonitor-containers",
  "releaseTrain": "Stable",
  "resourceGroup": "demo",
  "scope": {
    "cluster": {
      "releaseNamespace": "azuremonitor-containers"
    },
    "namespace": null
  },
  "statuses": [],
  "systemData": null,
  "type": "Microsoft.KubernetesConfiguration/extensions",
  "version": "2.8.2"
}

Список всех расширений, установленных в кластере

Чтобы просмотреть список всех расширений, установленных в кластере, используйте k8s-extension list команду. В коде используйте значения из сценария для обязательных заполнителей параметров.

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

Проверьте выходные данные, которые выглядят следующим образом:

[
  {
    "autoUpgradeMinorVersion": true,
    "creationTime": "2020-09-15T02:26:03.5519523+00:00",
    "errorInfo": {
      "code": null,
      "message": null
    },
    "extensionType": "Microsoft.AzureMonitor.Containers",
    "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myRg/providers/Microsoft.Kubernetes/connectedClusters/myCluster/providers/Microsoft.KubernetesConfiguration/extensions/myExtInstanceName",
    "identity": null,
    "installState": "Pending",
    "lastModifiedTime": "2020-09-15T02:48:45.6469664+00:00",
    "lastStatusTime": null,
    "name": "myExtInstanceName",
    "releaseTrain": "Stable",
    "resourceGroup": "myRG",
    "scope": {
      "cluster": {
        "releaseNamespace": "myExtInstanceName1"
      }
    },
    "statuses": [],
    "type": "Microsoft.KubernetesConfiguration/extensions",
    "version": "0.1.0"
  },
  {
    "autoUpgradeMinorVersion": true,
    "creationTime": "2020-09-02T00:41:16.8005159+00:00",
    "errorInfo": {
      "code": null,
      "message": null
    },
    "extensionType": "microsoft.azuredefender.kubernetes",
    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myRg/providers/Microsoft.Kubernetes/connectedClusters/myCluster/providers/Microsoft.KubernetesConfiguration/extensions/defender",
    "identity": null,
    "installState": "Pending",
    "lastModifiedTime": "2020-09-02T00:41:16.8005162+00:00",
    "lastStatusTime": null,
    "name": "microsoft.azuredefender.kubernetes",
    "releaseTrain": "Stable",
    "resourceGroup": "myRg",
    "scope": {
      "cluster": {
        "releaseNamespace": "myExtInstanceName2"
      }
    },
    "type": "Microsoft.KubernetesConfiguration/extensions",
    "version": "0.1.0"
  }
]

Обновление экземпляра расширения

Чтобы обновить существующий экземпляр расширения, используйте k8s-extension update. Передайте значения обязательных и необязательных параметров. Обязательные и необязательные параметры немного отличаются от параметров, используемых для создания экземпляра расширения.

В этом примере параметр для экземпляра расширения Машинного обучения Azure обновляется на auto-upgrade-minor-versiontrue.

az k8s-extension update --name azureml --extension-type Microsoft.AzureML.Kubernetes --scope cluster --cluster-name <clusterName> --resource-group <resourceGroupName> --auto-upgrade-minor-version true --cluster-type managedClusters

Обязательные параметры для обновления

Необязательные параметры для обновления

Модернизация экземпляра расширения

Как отмечалось ранее, если auto-upgrade-minor-version задано значение true, расширение автоматически обновляется при выпуске новой дополнительной версии. Для большинства сценариев рекомендуется включить автоматическое обновление. Если задано значение auto-upgrade-minor-versionfalse, необходимо вручную обновить расширение, если требуется более новая версия.

Обновления вручную необходимы также для получения новой версии расширения. Вы можете выбрать время обновления, чтобы избежать непредвиденных критических изменений в обновлениях основных версий.

Чтобы вручную обновить экземпляр расширения, используйте k8s-extension update и задайте version параметр.

В этом примере экземпляр расширения машинного обучения Azure обновляется до версии x.y.z:

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

Удалите экземпляр расширения

Чтобы удалить экземпляр расширения в кластере, используйте k8s-extension delete команду. Используйте значения из сценария для обязательных заполнителей параметров.

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

Связанный контент

• Полный список команд и параметров см. в справочнике az k8s-extension CLI.
• Узнайте больше о том, как расширения работают с кластерами Kubernetes с поддержкой Azure Arc.
• Просмотрите расширения кластера, доступные для Kubernetes с поддержкой Azure Arc.
• Получите помощь по устранению проблем с расширением.