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

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

  • Статья

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

Эта версия задачи устарела; используйте Kubernetes@1, чтобы воспользоваться новейшими функциями, такими как федерация удостоверений рабочей нагрузки .

Используйте эту задачу для развертывания, настройки или обновления кластера 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.

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

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

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


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

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


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

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


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

Используйте файл конфигурации Kubernetes с командой kubectl. Кроме того, можно указать файлы конфигурации Filename, directory или 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.


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

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


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

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


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

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


имени ConfigMap configMapName -
string.

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


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

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


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

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


файла ConfigMap configMapFile -
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.


рабочего каталога
Псевдоним ввода: cwd. string. Значение по умолчанию: $(System.DefaultWorkingDirectory).

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


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

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


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

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


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

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

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

Нет.

Требования

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