Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Use esta tarefa para implantar, configurar ou atualizar um cluster Kubernetes no Serviço de Contêiner do Azure executando comandos kubectl.
Esta versão da tarefa foi preterida; use o Kubernetes@1 para aproveitar os recursos mais recentes, como federação de identidades de carga de trabalho.
Use esta tarefa para implantar, configurar ou atualizar um cluster Kubernetes no Serviço de Contêiner do Azure executando comandos kubectl.
Sintaxe
# 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.
Insumos
kubernetesServiceConnection
-
de conexão de serviço Kubernetes
Alias de entrada: kubernetesServiceEndpoint.
string.
Selecione uma conexão de serviço Kubernetes.
namespace
-
Espaço de nomes
string.
Especifica o namespace para o comando kubectl usando o sinalizador –namespace. Se o namespace não for fornecido, os comandos serão executados no namespace padrão.
command
-
de comando
string. Valores permitidos: apply, create, delete, exec, expose, get, logs, run, set, top.
Especifica um comando kubectl 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. Nome de arquivo, diretório ou URL para arquivos de configuração do Kubernetes também podem ser fornecidos.
configuration
-
do arquivo de configuração
string. Necessário quando useConfigurationFile = true.
Especifica o nome do arquivo, diretório ou URL para os arquivos de configuração do kubernetes que são usados com os comandos.
arguments
-
Argumentos
string.
Especifica os argumentos para o comando kubectl especificado.
secretType
-
Tipo de secreta
string. Obrigatório. Valores permitidos: dockerRegistry, generic. Valor padrão: dockerRegistry.
Cria ou atualiza um imagepullsecretgenérico ou docker . Especifique dockerRegistry criar ou atualizar o imagepullsecret do registro selecionado. Um imagePullSecret é uma maneira de passar um segredo que contém uma senha de registro de contêiner para o Kubelet, para que ele possa extrair uma imagem privada em nome do seu 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 Registo de Contentor
string. Necessário quando secretType = dockerRegistry. Valores permitidos: Azure Container Registry, Container Registry. Valor padrão: Azure Container Registry.
Selecione um tipo de registro Container. A tarefa pode usar os detalhes da Assinatura do Azure para trabalhar com um registro de Contêiner do Azure. Outros registros de contêiner padrão também são suportados.
dockerRegistryConnection
-
de conexão do serviço Registro do Docker
Alias de entrada: dockerRegistryEndpoint.
string. Opcional. Use quando secretType = dockerRegistry && containerRegistryType = Container Registry.
Selecione uma conexão de serviço de registro do Docker. Necessário para comandos que precisam ser autenticados com um registro.
azureSubscription
-
de assinatura do Azure
Alias de entrada: azureSubscriptionEndpoint.
string. Opcional. Use quando secretType = dockerRegistry && containerRegistryType = Azure Container Registry.
Especifica a assinatura do Azure Resource Manager, que contém o 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 em Authorize. Se a sua subscrição não estiver listada ou se pretender utilizar uma Entidade de Serviço existente, pode configurar uma ligação de serviço do Azure utilizando os botões Add 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. Necessário para comandos que precisam ser autenticados com um registro.
secretName
-
Nome secreto
string.
Nome do segredo. Você pode usar esse nome secreto no arquivo de configuração YAML do Kubernetes.
forceUpdate
-
Force atualiza secretas
boolean. Valor padrão: true.
Exclua o segredo, se ele existir, e crie um novo com valores atualizados.
configMapName
-
nome do ConfigMap
string.
O ConfigMaps permite dissociar artefatos de configuração do conteúdo da imagem para manter os aplicativos em contêineres portáteis.
forceUpdateConfigMap
-
Forçar atualização configmap
boolean. Valor padrão: false.
Exclua o configmap se ele existir e crie um novo com valores atualizados.
useConfigMapFile
-
Usar de arquivo
boolean. Valor padrão: false.
Crie um ConfigMap a partir de um arquivo individual ou de vários arquivos especificando um diretório.
configMapFile
-
arquivo ConfigMap
string. Necessá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 no 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 Kubernetes.
versionSpec
-
Especificações da 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 obtida. Exemplos: 1.7.0, 1.x.0, 4.x.0, 6.10.0, >=6.10.0.
checkLatest
-
Verifique a versão mais recente
boolean. Opcional. Use quando versionOrLocation = version. Valor padrão: false.
Sempre verifica on-line a versão mais recente disponível (stable.txt) que satisfaz as especificações da versão. Isso geralmente é falso, a menos que você tenha um cenário específico para sempre obter o mais recente. Isso fará com que ele incorra em custos de download quando potencialmente não for necessário, especialmente com o pool de compilação hospedado.
specifyLocation
-
caminho para Kubectl
string. Necessário quando versionOrLocation = location.
Especifica o caminho completo para o arquivo kubectl.exe.
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, 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 controlo de tarefas
Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.
Variáveis de saída
Nenhum.
Requerimentos
| Requisito | Descrição |
|---|---|
| Tipos de pipeline | YAML, Construção clássica, Versão clássica |
| Funciona em | Agente, DeploymentGroup |
| Exigências | Nenhum |
| Capacidades | Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho. |
| Restrições de comando | Qualquer |
| Variáveis configuráveis | Qualquer |
| Versão do agente | Todas as versões de agente suportadas. |
| Categoria de tarefa | Desplegar |