tarefa Kubernetes@0 – Kubectl v0

Use essa tarefa para implantar, configurar ou atualizar um cluster do Kubernetes no Serviço de Contêiner do Azure executando kubectl comandos.

Syntax

# 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.

Entradas

kubernetesServiceConnection - Conexão de serviço do Kubernetes
Alias de entrada: kubernetesServiceEndpoint. string.

Selecione uma conexão de serviço do Kubernetes.

namespace - Namespace
string.

Especifica o namespace do kubectl comando usando o –namespace sinalizador . Se o namespace não for fornecido, os comandos serão executados no namespace padrão.

command - Comando
string. Valores permitidos: apply, create, , execdelete, expose, get, logs, run, , set, top.

Especifica um kubectl comando a ser executado.

useConfigurationFile - Usar arquivos de configuração
boolean. Valor padrão: false.

Use o arquivo de configuração do Kubernetes com o comando kubectl. O nome do arquivo, o diretório ou a URL para arquivos de configuração do Kubernetes também podem ser fornecidos.

configuration - Arquivo de configuração
string. Obrigatório quando useConfigurationFile = true.

Especifica o nome do arquivo, o diretório ou a URL para arquivos de configuração do kubernetes usados com os comandos.

arguments - Argumentos
string.

Especifica os argumentos para o comando especificado kubectl .

secretType - Tipo de segredo
string. Obrigatórios. Valores Permitidos: dockerRegistry e generic. Valor padrão: dockerRegistry.

Cria ou atualiza um genérico ou docker imagepullsecret. Especifique dockerRegistry para criar ou atualizar o imagepullsecret do registro selecionado. Um imagePullSecret é uma maneira de passar um segredo que contém uma senha do registro de contêiner para o Kubelet, para que ele possa efetuar pull de uma imagem privada em nome do pod.

secretArguments - Argumentos
string. Opcional. Use quando secretType = generic.

Especifica chaves e valores literais a serem inseridos em segredo. Por exemplo, --from-literal=key1=value1 ou --from-literal=key2="top secret".

containerRegistryType - Tipo de Registro de Contêiner
string. Obrigatório quando secretType = dockerRegistry. Valores Permitidos: Azure Container Registry e Container Registry. Valor padrão: Azure Container Registry.

Selecione um tipo de Registro de contêiner. A tarefa pode usar detalhes da Assinatura do Azure para trabalhar com um Registro de Contêiner do Azure. Também há suporte para outros registros de contêiner padrão.

dockerRegistryConnection - Conexão de serviço do Registro do Docker
Alias de entrada: dockerRegistryEndpoint. string. Opcional. Use quando secretType = dockerRegistry && containerRegistryType = Container Registry.

Selecione uma conexão de serviço do Registro do Docker. Obrigatório para comandos que precisam ser autenticados com um registro.

azureSubscription - Assinatura do Azure
Alias de entrada: azureSubscriptionEndpoint. string. Opcional. Use quando secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Especifica a assinatura de Resource Manager do Azure, que contém Registro de Contêiner do Azure.

Observação

Para configurar uma nova conexão de serviço, selecione a assinatura do Azure na lista e clique Authorizeem . Se sua assinatura não estiver listada ou se você quiser usar uma entidade de serviço existente, você poderá configurar uma conexão de serviço do Azure usando os Add botões ou Manage .

azureContainerRegistry - Registro de Contêiner do Azure
string. Opcional. Use quando secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Especifica um Registro de Contêiner do Azure que é usado para extrair imagens de contêiner e implantar aplicativos no cluster do Kubernetes. Obrigatório para comandos que precisam ser autenticados com um registro.

secretName - Nome do segredo
string.

Nome do segredo. Você pode usar esse nome de segredo no arquivo de configuração YAML do Kubernetes.

forceUpdate - Forçar segredo de atualização
boolean. Valor padrão: true.

Exclua o segredo se ele existir e crie um novo com valores atualizados.

configMapName - Nome do ConfigMap
string.

Os ConfigMaps permitem que você desacopla artefatos de configuração do conteúdo da imagem para manter os aplicativos em contêineres portáteis.

forceUpdateConfigMap - Forçar o configmap de atualização
boolean. Valor padrão: false.

Exclua o configmap se ele existir e crie um novo com valores atualizados.

useConfigMapFile - Usar arquivo
boolean. Valor padrão: false.

Crie um ConfigMap de um arquivo individual ou de vários arquivos especificando um diretório.

configMapFile - Arquivo ConfigMap
string. Obrigatório quando useConfigMapFile = true.

Especifique um arquivo ou diretório que contenha o configMaps.

configMapArguments - Argumentos
string. Opcional. Use quando useConfigMapFile = false.

Especifica chaves e valores literais a serem inseridos em configMap . Por exemplo, --from-literal=key1=value1 ou --from-literal=key2="top secret".

versionOrLocation - Kubectl
string. Valores permitidos: version, location (Especificar local). Valor padrão: version.

kubectl é uma interface de linha de comando para executar comandos em clusters do Kubernetes.

versionSpec - Especificação de versão
string. Opcional. Use quando versionOrLocation = version. Valor padrão: 1.7.0.

Especifica a Especificação de Versão da versão a ser obtido. Exemplos: 1.7.0, 1.x.0, 4.x.0, 6.10.0, >=6.10.0.

checkLatest - Verificar a versão mais recente
boolean. Opcional. Use quando versionOrLocation = version. Valor padrão: false.

Sempre verifica online a versão mais recente disponível (stable.txt) que satisfaz a especificação de versão. Normalmente, isso é falso, a menos que você tenha um cenário específico para sempre obter o mais recente. Isso fará com que ele incorrerá em custos de download quando potencialmente não for necessário, especialmente com o pool de build hospedado.

specifyLocation - Caminho para Kubectl
string. Obrigatório quando versionOrLocation = location.

Especifica o caminho completo para o kubectl.exe arquivo.

workingDirectory - Diretório de trabalho
Alias de entrada: cwd. string. Valor padrão: $(System.DefaultWorkingDirectory).

Diretório de trabalho para o comando Kubectl.

outputFormat - Formato de saída
string. Valores Permitidos: json e yaml. Valor padrão: json.

Formato de saída.

kubectlOutput - Nome da variável de saída
string.

Nome da variável na qual a saída do comando deve ser salva.

Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Executa em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	Todas as versões do agente com suporte.
Categoria da tarefa	Implantar