Kubernetes@0 - Tarefa do Kubectl v0

Utilize esta tarefa para implementar, configurar ou atualizar um cluster do Kubernetes no Azure Container Service ao executar 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 - Ligação do serviço Kubernetes
Alias de entrada: kubernetesServiceEndpoint. string.

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

namespace - Espaço de nomes
string.

Especifica o espaço de nomes para o kubectl comando com o –namespace sinalizador . Se o espaço de nomes não for fornecido, os comandos serão executados no espaço de nomes predefinido.

command - Comando
string. Valores permitidos: apply, , create, deleteexec, expose, get, logs, run, , , . topset

Especifica um kubectl comando a executar.

useConfigurationFile - Utilizar ficheiros de Configuração
boolean. Valor predefinido: false.

Utilize o ficheiro de configuração do Kubernetes com o comando kubectl. Os ficheiros de configuração nome de ficheiro, diretório ou URL para o Kubernetes também podem ser fornecidos.

configuration - Ficheiro de configuração
string. Necessário quando useConfigurationFile = true.

Especifica o nome de ficheiro, diretório ou URL para ficheiros de configuração do kubernetes que são utilizados com os comandos.

arguments - Argumentos
string.

Especifica os argumentos para o comando especificado kubectl .

secretType - Tipo de segredo
string. Obrigatório. Valores permitidos: dockerRegistry, generic. Valor predefinido: dockerRegistry.

Cria ou atualiza um genérico ou docker imagepullsecret. Especifique dockerRegistry para criar ou atualizar o imagepullsecret do registo selecionado. Uma imagePullSecret é uma forma de transmitir um segredo que contém uma palavra-passe de registo de contentor para o Kubelet, para que possa extrair uma imagem privada em nome do seu Pod.

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

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

containerRegistryType - Tipo de Registo de Contentor
string. Necessário quando secretType = dockerRegistry. Valores permitidos: Azure Container Registry, Container Registry. Valor predefinido: Azure Container Registry.

Selecione um Tipo de registo de contentor. A tarefa pode utilizar os detalhes da Subscrição do Azure para trabalhar com um registo de Contentor do Azure. Também são suportados outros registos de Contentor padrão.

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

Selecione uma ligação do serviço de registo do Docker. Necessário para comandos que precisam de ser autenticados com um registo.

azureSubscription - Subscrição do Azure
Alias de entrada: azureSubscriptionEndpoint. string. Opcional. Utilize quando secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Especifica a subscrição do Azure Resource Manager, que contém Azure Container Registry.

Nota

Para configurar uma nova ligação de serviço, selecione a subscrição do Azure na lista e clique em Authorize. Se a sua subscrição não estiver listada ou se quiser utilizar um Principal de Serviço existente, pode configurar uma ligação de serviço do Azure com os Add botões ou Manage .

azureContainerRegistry - Azure Container Registry
string. Opcional. Utilize quando secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Especifica um Azure Container Registry que é utilizado para extrair imagens de contentor e implementar aplicações no cluster do Kubernetes. Necessário para comandos que precisam de ser autenticados com um registo.

secretName - Nome do segredo
string.

Nome do segredo. Pode utilizar este nome de segredo no ficheiro de configuração YAML do Kubernetes.

forceUpdate - Forçar atualização secreta
boolean. Valor predefinido: true.

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

configMapName - Nome configMap
string.

Os ConfigMaps permitem-lhe desassociar artefactos de configuração do conteúdo da imagem para manter as aplicações em contentores portáteis.

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

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

useConfigMapFile - Utilizar ficheiro
boolean. Valor predefinido: false.

Crie um ConfigMap a partir de um ficheiro individual ou de vários ficheiros ao especificar um diretório.

configMapFile - Ficheiro ConfigMap
string. Necessário quando useConfigMapFile = true.

Especifique um ficheiro ou diretório que contenha configMaps.

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

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

versionOrLocation - Kubectl
string. Valores permitidos: version, location (Especificar localização). Valor predefinido: version.

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

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

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

checkLatest - Procurar a versão mais recente
boolean. Opcional. Utilize quando versionOrLocation = version. Valor predefinido: false.

Verifica sempre online a versão mais recente disponível (stable.txt) que satisfaça a especificação da versão. Normalmente, isto é falso, a menos que tenha um cenário específico para obter sempre a versão mais recente. Isto fará com que incorra em custos de transferência quando potencialmente não for necessário, especialmente com o conjunto de compilação alojado.

specifyLocation - Caminho para o Kubectl
string. Necessário quando versionOrLocation = location.

Especifica o caminho completo para o kubectl.exe ficheiro.

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

Diretório de trabalho para o comando kubectl.

outputFormat - Formato de saída
string. Valores permitidos: json, yaml. Valor predefinido: 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 guardada.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agent, DeploymentGroup
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de definição	Qualquer
Versão do agente	Todas as versões de agente suportadas.
Categoria da tarefa	Implementação