Kubernetes@0 — задача Kubectl v0

Статья
07/02/2024

Используйте эту задачу для развертывания, настройки или обновления кластера Kubernetes в Службе контейнеров Azure с помощью kubectl команд.

Синтаксис

# Kubectl v0
# Deploy, configure, update a Kubernetes cluster in Azure Container Service by running kubectl commands.
- task: Kubernetes@0
  inputs:
    #kubernetesServiceConnection: # string. Alias: kubernetesServiceEndpoint. Kubernetes service connection. 
    #namespace: # string. Namespace. 
  # Commands
    #command: # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'logs' | 'run' | 'set' | 'top'. Command. 
    #useConfigurationFile: false # boolean. Use Configuration files. Default: false.
    #configuration: # string. Required when useConfigurationFile = true. Configuration file. 
    #arguments: # string. Arguments. 
  # Secrets
    secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required. Type of secret. Default: dockerRegistry.
    #secretArguments: # string. Optional. Use when secretType = generic. Arguments. 
    containerRegistryType: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when secretType = dockerRegistry. Container Registry type. Default: Azure Container Registry.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Optional. Use when secretType = dockerRegistry && containerRegistryType = Container Registry. Docker Registry service connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry. Azure Container Registry. 
    #secretName: # string. Secret name. 
    #forceUpdate: true # boolean. Force update secret. Default: true.
  # ConfigMaps
    #configMapName: # string. ConfigMap name. 
    #forceUpdateConfigMap: false # boolean. Force update configmap. Default: false.
    #useConfigMapFile: false # boolean. Use file. Default: false.
    #configMapFile: # string. Required when useConfigMapFile = true. ConfigMap file. 
    #configMapArguments: # string. Optional. Use when useConfigMapFile = false. Arguments. 
  # Advanced
    #versionOrLocation: 'version' # 'version' | 'location'. Kubectl. Default: version.
    #versionSpec: '1.7.0' # string. Optional. Use when versionOrLocation = version. Version spec. Default: 1.7.0.
    #checkLatest: false # boolean. Optional. Use when versionOrLocation = version. Check for latest version. Default: false.
    #specifyLocation: # string. Required when versionOrLocation = location. Path to Kubectl. 
    #workingDirectory: '$(System.DefaultWorkingDirectory)' # string. Alias: cwd. Working directory. Default: $(System.DefaultWorkingDirectory).
  # Output
    #outputFormat: 'json' # 'json' | 'yaml'. Output format. Default: json.
    #kubectlOutput: # string. Output variable name.

# Deploy to Kubernetes v0
# Deploy, configure, update a Kubernetes cluster in Azure Container Service by running kubectl commands.
- task: Kubernetes@0
  inputs:
    #kubernetesServiceConnection: # string. Alias: kubernetesServiceEndpoint. Kubernetes service connection. 
    #namespace: # string. Namespace. 
  # Commands
    #command: # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'logs' | 'run' | 'set' | 'top'. Command. 
    #useConfigurationFile: false # boolean. Use Configuration files. Default: false.
    #configuration: # string. Required when useConfigurationFile = true. Configuration file. 
    #arguments: # string. Arguments. 
  # Secrets
    secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required. Type of secret. Default: dockerRegistry.
    #secretArguments: # string. Optional. Use when secretType = generic. Arguments. 
    containerRegistryType: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when secretType = dockerRegistry. Container Registry type. Default: Azure Container Registry.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Optional. Use when secretType = dockerRegistry && containerRegistryType = Container Registry. Docker Registry service connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry. Azure Container Registry. 
    #secretName: # string. Secret name. 
    #forceUpdate: true # boolean. Force update secret. Default: true.
  # ConfigMaps
    #configMapName: # string. ConfigMap name. 
    #forceUpdateConfigMap: false # boolean. Force update configmap. Default: false.
    #useConfigMapFile: false # boolean. Use file. Default: false.
    #configMapFile: # string. Required when useConfigMapFile = true. ConfigMap file. 
    #configMapArguments: # string. Optional. Use when useConfigMapFile = false. Arguments. 
  # Advanced
    #versionOrLocation: 'version' # 'version' | 'location'. Kubectl. Default: version.
    #versionSpec: '1.7.0' # string. Optional. Use when versionOrLocation = version. Version spec. Default: 1.7.0.
    #checkLatest: false # boolean. Optional. Use when versionOrLocation = version. Check for latest version. Default: false.
    #specifyLocation: # string. Required when versionOrLocation = location. Path to Kubectl. 
    #workingDirectory: '$(System.DefaultWorkingDirectory)' # string. Alias: cwd. Working directory. Default: $(System.DefaultWorkingDirectory).
  # Output
    #outputFormat: 'json' # 'json' | 'yaml'. Output format. Default: json.
    #kubectlOutput: # string. Output variable name.

# Deploy to Kubernetes v0
# Deploy, configure, update your Kubernetes cluster in Azure Container Service by running kubectl commands.
- task: Kubernetes@0
  inputs:
    #kubernetesServiceConnection: # string. Alias: kubernetesServiceEndpoint. Kubernetes service connection. 
    #namespace: # string. Namespace. 
  # Commands
    command: 'apply' # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'logs' | 'run' | 'set' | 'top'. Required. Command. Default: apply.
    #useConfigurationFile: false # boolean. Use Configuration files. Default: false.
    #configuration: # string. Required when useConfigurationFile = true. Configuration file. 
    #arguments: # string. Arguments. 
  # Secrets
    secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required. Type of secret. Default: dockerRegistry.
    #secretArguments: # string. Optional. Use when secretType = generic. Arguments. 
    containerRegistryType: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when secretType = dockerRegistry. Container Registry type. Default: Azure Container Registry.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Optional. Use when secretType = dockerRegistry && containerRegistryType = Container Registry. Docker Registry service connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry. Azure Container Registry. 
    #secretName: # string. Secret name. 
    #forceUpdate: true # boolean. Force update secret. Default: true.
  # ConfigMaps
    #configMapName: # string. ConfigMap name. 
    #forceUpdateConfigMap: false # boolean. Force update configmap. Default: false.
    #useConfigMapFile: false # boolean. Use file. Default: false.
    #configMapFile: # string. Required when useConfigMapFile = true. ConfigMap file. 
    #configMapArguments: # string. Optional. Use when useConfigMapFile = false. Arguments. 
  # Advanced
    #versionOrLocation: 'version' # 'version' | 'location'. Kubectl. Default: version.
    #versionSpec: '1.7.0' # string. Optional. Use when versionOrLocation = version. Version spec. Default: 1.7.0.
    #checkLatest: false # boolean. Optional. Use when versionOrLocation = version. Check for latest version. Default: false.
    #specifyLocation: # string. Required when versionOrLocation = location. Path to Kubectl. 
    #workingDirectory: '$(System.DefaultWorkingDirectory)' # string. Alias: cwd. Working directory. Default: $(System.DefaultWorkingDirectory).
  # Output
    #outputFormat: 'json' # 'json' | 'yaml'. Output format. Default: json.
    #kubectlOutput: # string. Output variable name.

Входные данные

kubernetesServiceConnection - Подключение службы Kubernetes
Входной псевдоним: kubernetesServiceEndpoint. string.

Выберите подключение службы Kubernetes.

namespace - Пространства имен
string.

Задает пространство имен для kubectl команды с помощью флага –namespace . Если пространство имен не указано, команды будут выполняться в пространстве имен по умолчанию.

command - Команды
string. Допустимые значения: apply, create, delete, exposeexec, , get, logs, run, , set, . top

Указывает выполняемую kubectl команду.

command - Команды
string. Обязательный. Допустимые значения: apply, create, delete, exposeexec, , get, logs, run, , set, . top Значение по умолчанию: apply.

Указывает выполняемую kubectl команду.

useConfigurationFile - Использование файлов конфигурации
boolean. Значение по умолчанию: false.

Используйте файл конфигурации Kubernetes с командой kubectl. Также можно указать имя файла, каталог или URL-адрес для файлов конфигурации Kubernetes.

configuration - Файл конфигурации
string. Требуется при .useConfigurationFile = true

Указывает имя файла, каталог или URL-адрес файлов конфигурации Kubernetes, используемых с командами.

arguments - Аргументы
string.

Указывает аргументы указанной kubectl команды.

secretType - Тип секрета
string. Обязательный. Допустимые значения: dockerRegistry, generic. Значение по умолчанию: dockerRegistry.

Создает или обновляет универсальный или docker imagepullsecret. Укажите dockerRegistry для создания или обновления imagepullsecret выбранного реестра. — imagePullSecret это способ передать секрет, содержащий пароль реестра контейнеров, в Kubelet, чтобы он смог извлечь частный образ от имени pod.

secretArguments - Аргументы
string. Необязательный элемент. Используйте при secretType = generic.

Указывает ключи и литеральные значения для вставки в секрет. Например, --from-literal=key1=value1 или --from-literal=key2="top secret".

containerRegistryType - Тип реестра контейнеров
string. Требуется при .secretType = dockerRegistry Допустимые значения: Azure Container Registry, Container Registry. Значение по умолчанию: Azure Container Registry.

Выберите тип реестра контейнеров. Задача может использовать сведения о подписке Azure для работы с реестром контейнеров Azure. Поддерживаются и другие стандартные реестры контейнеров.

dockerRegistryConnection - Подключение службы реестра Docker
Входной псевдоним: dockerRegistryEndpoint. string. Необязательный элемент. Используйте при secretType = dockerRegistry && containerRegistryType = Container Registry.

Выберите подключение к службе реестра Docker. Требуется для команд, которым требуется пройти проверку подлинности в реестре.

azureSubscription - Подписка Azure
Входной псевдоним: azureSubscriptionEndpoint. string. Необязательный элемент. Используйте при secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Указывает подписку Azure Resource Manager, содержащую Реестр контейнеров Azure.

Примечание

Чтобы настроить новое подключение к службе, выберите подписку Azure в списке и щелкните Authorize. Если ваша подписка отсутствует в списке или вы хотите использовать существующий субъект-службу, можно настроить подключение к службе Azure с помощью Add кнопок или Manage .

azureContainerRegistry - Реестр контейнеров Azure
string. Необязательный элемент. Используйте при secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Задает Реестр контейнеров Azure, который используется для извлечения образов контейнеров и развертывания приложений в кластере Kubernetes. Требуется для команд, которым требуется пройти проверку подлинности в реестре.

secretName - Имя секрета
string.

Имя секрета. Это имя секрета можно использовать в файле конфигурации YamL Kubernetes.

forceUpdate - Принудительное обновление секрета
boolean. Значение по умолчанию: true.

Удалите секрет, если он существует, и создайте новый с обновленными значениями.

configMapName - Имя ConfigMap
string.

ConfigMaps позволяет отделить артефакты конфигурации от содержимого изображения, чтобы обеспечить переносимость контейнерных приложений.

forceUpdateConfigMap - Карта конфигурации принудительного обновления
boolean. Значение по умолчанию: false.

Удалите карту конфигурации, если она существует, и создайте новую с обновленными значениями.

useConfigMapFile - Использовать файл
boolean. Значение по умолчанию: false.

Создайте ConfigMap из отдельного файла или из нескольких файлов, указав каталог.

configMapFile - Файл ConfigMap
string. Требуется при .useConfigMapFile = true

Укажите файл или каталог, содержащий configMaps.

configMapArguments - Аргументы
string. Необязательный элемент. Используйте при useConfigMapFile = false.

Указывает ключи и литеральные значения для вставки в configMap . Например, --from-literal=key1=value1 или --from-literal=key2="top secret".

versionOrLocation - Kubectl
string. Допустимые значения: version, location (укажите расположение). Значение по умолчанию: version.

kubectl — это интерфейс командной строки для выполнения команд в кластерах Kubernetes.

versionSpec - Спецификация версии
string. Необязательный элемент. Используйте при versionOrLocation = version. Значение по умолчанию: 1.7.0.

Указывает спецификацию версии для получаемой версии. Примеры: 1.7.0, 1.x.0, 4.x.0, 6.10.0, . >=6.10.0

checkLatest - Проверка наличия последней версии
boolean. Необязательный элемент. Используйте при versionOrLocation = version. Значение по умолчанию: false.

Всегда проверяет в сети последнюю доступную версию (stable.txt), удовлетворяющую спецификации версии. Обычно это значение false, если у вас нет определенного сценария, чтобы всегда получать последние данные. Это приведет к затратам на скачивание, когда это потенциально не требуется, особенно для размещенного пула сборки.

specifyLocation - Путь к Kubectl
string. Требуется, если versionOrLocation = location.

Указывает полный путь к файлу kubectl.exe .

workingDirectory - Рабочий каталог
Входной псевдоним: cwd. string. Значение по умолчанию: $(System.DefaultWorkingDirectory).

Рабочий каталог для команды Kubectl.

outputFormat - Формат вывода
string. Допустимые значения: json, yaml. Значение по умолчанию: json.

Формат вывода.

kubectlOutput - Имя выходной переменной
string.

Имя переменной, в которой должны быть сохранены выходные данные команды.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
Требования	None
Capabilities	Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд	Любой
Устанавливаемые переменные	Любой
Версия агента	Все поддерживаемые версии агента.
Категория задач	Развертывание

Поделиться через