Compartilhar via


HelmDeploy@1 – Empacotar e implantar a tarefa de gráficos do Helm v1

Implante, configure e atualize um cluster do Kubernetes no Serviço de Contêiner do Azure executando comandos helm.

Sintaxe

# Package and deploy Helm charts v1
# Deploy, configure, update a Kubernetes cluster in Azure Container Service by running helm commands.
- task: HelmDeploy@1
  inputs:
  # Kubernetes Cluster
    #connectionType: 'Azure Resource Manager' # 'Azure Resource Manager' | 'Kubernetes Service Connection' | 'None'. Required when command != logout && command != package. Connection Type. Default: Azure Resource Manager.
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Required when connectionType = Azure Resource Manager && command != logout && command != package. Azure subscription. 
    #azureResourceGroup: # string. Required when connectionType = Azure Resource Manager && command != logout && command != package. Resource group. 
    #kubernetesCluster: # string. Required when connectionType = Azure Resource Manager && command != logout && command != package. Kubernetes cluster. 
    #useClusterAdmin: false # boolean. Optional. Use when connectionType = Azure Resource Manager && command != logout && command != package. Use cluster admin credentials. Default: false.
    #kubernetesServiceConnection: # string. Alias: kubernetesServiceEndpoint. Required when connectionType = Kubernetes Service Connection && command != logout && command != package. Kubernetes Service Connection. 
    #namespace: # string. Optional. Use when command != logout && command != package. Namespace. 
  # Azure Container Registry
    #azureSubscriptionForACR: # string. Alias: azureSubscriptionEndpointForACR. Required when command == login || command == package || command == push. Azure subscription for Container Registry. 
    #azureResourceGroupForACR: # string. Required when command == login || command == package || command == push. Resource group. 
    #azureContainerRegistry: # string. Required when command == login || command == package || command == push. Azure Container Registry. 
  # Commands
    command: 'ls' # 'create' | 'delete' | 'expose' | 'get' | 'init' | 'install' | 'login' | 'logout' | 'ls' | 'push' | 'package' | 'rollback' | 'upgrade' | 'uninstall'. Required. Command. Default: ls.
    #chartType: 'Name' # 'Name' | 'FilePath'. Required when command == install || command == upgrade. Chart Type. Default: Name.
    #chartName: # string. Required when chartType == Name || command == create. Chart Name. 
    #chartPath: # string. Required when chartType == FilePath || command == package || command == push. Chart Path. 
    #remoteRepo: # string. Required when command == push. Remote Repo. 
    #chartVersion: # string. Alias: version. Optional. Use when command == package || command == install || command == upgrade. Version. 
    #releaseName: # string. Optional. Use when command == install || command == upgrade || command == rollback || command == uninstall || command == delete. Release Name. 
    #overrideValues: # string. Optional. Use when command == install || command == upgrade. Set Values. 
    #valueFile: # string. Optional. Use when command == install || command == upgrade. Value File. 
    #destination: '$(Build.ArtifactStagingDirectory)' # string. Optional. Use when command == package. Destination. Default: $(Build.ArtifactStagingDirectory).
    #canaryimage: false # boolean. Optional. Use when command == init. Use canary image version. Default: false.
    #upgradetiller: true # boolean. Optional. Use when command == init. Upgrade Tiller. Default: true.
    #updatedependency: false # boolean. Optional. Use when command == install || command == package. Update Dependency. Default: false.
    #save: true # boolean. Optional. Use when command == package. Save. Default: true.
    #install: true # boolean. Optional. Use when command == upgrade. Install if release not present. Default: true.
    #recreate: false # boolean. Optional. Use when command == upgrade. Recreate Pods. Default: false.
    #resetValues: false # boolean. Optional. Use when command == upgrade. Reset Values. Default: false.
    #force: false # boolean. Optional. Use when command == upgrade. Force. Default: false.
    #waitForExecution: true # boolean. Optional. Use when command == init || command == install || command == upgrade. Wait. Default: true.
    #arguments: # string. Optional. Use when command != login && command != logout. Arguments. 
    #chartNameForACR: # string. Required when command == package || command == push. Chart Name For Azure Container Registry. 
    #chartPathForACR: # string. Required when command == package || command == push. Chart Path for Azure Container Registry. 
  # TLS
    #enableTls: false # boolean. Optional. Use when command != login && command != logout && command != package. Enable TLS. Default: false.
    #caCert: # string. Required when enableTls == true && command != login && command != logout && command != package. CA certificate. 
    #certificate: # string. Required when enableTls == true && command != login && command != logout && command != package. Certificate. 
    #privatekey: # string. Required when enableTls == true && command != login && command != logout && command != package. Key. 
  # Advanced
    #tillernamespace: # string. Optional. Use when command != login && command != logout && command != package. Tiller namespace. 
    #failOnStderr: false # boolean. Optional. Use when command != login && command != logout && command != package. Fail on Standard Error. Default: false.
    #publishPipelineMetadata: true # boolean. Optional. Use when command != login && command != logout && command != package. Publish pipeline metadata. Default: true.

Entradas

connectionType - tipo de conexão
string. Necessário quando command != logout && command != package. Valores permitidos: Azure Resource Manager, Kubernetes Service Connection, None. Valor padrão: Azure Resource Manager.

Selecione 'Azure Resource Manager' para se conectar a um Serviço de Kubernetes do Azure usando a Conexão de Serviço do Azure. Selecione "Conexão de Serviço do Kubernetes" para se conectar a qualquer cluster do Kubernetes usando kubeconfig ou conta de serviço.


azureSubscription - assinatura do Azure
Alias de entrada: azureSubscriptionEndpoint. string. Necessário quando connectionType = Azure Resource Manager && command != logout && command != package.

Selecione uma assinatura do Azure, que tem o Registro de Contêiner do Azure.


azureResourceGroup - grupo de recursos
string. Necessário quando connectionType = Azure Resource Manager && command != logout && command != package.

Selecione um Grupo de Recursos do Azure.


kubernetesCluster - cluster do Kubernetes
string. Necessário quando connectionType = Azure Resource Manager && command != logout && command != package.

Selecione um Cluster Gerenciado do Azure.


useClusterAdmin - Usar credenciais de administrador de cluster
boolean. Opcional. Use quando connectionType = Azure Resource Manager && command != logout && command != package. Valor padrão: false.

Use credenciais de administrador de cluster em vez de credenciais de usuário de cluster padrão.


kubernetesServiceConnection - de conexão do serviço Kubernetes
Alias de entrada: kubernetesServiceEndpoint. string. Necessário quando connectionType = Kubernetes Service Connection && command != logout && command != package.

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


namespace - namespace
string. Opcional. Use quando command != logout && command != package.

Especifique o namespace K8 a ser usado. Use o namespace Tiller pode ser especificado na seção avançada da tarefa ou passando a opção --tiller-namespace como argumento.


azureSubscriptionForACR - assinatura do Azure para o Registro de Contêiner
Alias de entrada: azureSubscriptionEndpointForACR. string. Necessário quando command == login || command == package || command == push.

Selecione uma assinatura do Azure, que tem o Registro de Contêiner do Azure.


azureResourceGroupForACR - grupo de recursos
string. Necessário quando command == login || command == package || command == push.

Selecione um Grupo de Recursos do Azure, que tem o Registro de Contêiner.


azureContainerRegistry - do Registro de Contêiner do Azure
string. Necessário quando command == login || command == package || command == push.

Selecione um Registro de Contêiner do Azure que será usado para gráficos helm.


comando command -
string. Necessário. Valores permitidos: create, delete, expose, get, init, install, login, logout, ls, push, package, rollback, upgrade, uninstall. Valor padrão: ls.

Selecione um comando helm.


chartType - tipo de gráfico
string. Necessário quando command == install || command == upgrade. Valores permitidos: Name, FilePath (Caminho do Arquivo). Valor padrão: Name.

Selecione como você deseja inserir informações do gráfico. Você pode fornecer o nome do gráfico ou pasta/caminho de arquivo para o gráfico.


de nome do gráfico
string. Necessário quando chartType == Name || command == create.

Referência de gráfico para instalar, isso pode ser uma URL ou um nome de gráfico. Por exemplo, se o nome do gráfico for 'stable/mysql', a tarefa executará 'helm install stable/mysql'.


chartPath - caminho do gráfico
string. Necessário quando chartType == FilePath || command == package || command == push.

Caminho para o gráfico a ser instalado. Esse pode ser um caminho para um gráfico empacotado ou um caminho para um diretório de gráfico descompactado. Por exemplo, se './redis' for especificado, a tarefa executará 'helm install ./redis'.


remoteRepo - Repositório Remoto
string. Necessário quando command == push.

O repositório remoto onde o gráfico será enviado.


chartVersion - versão
Alias de entrada: version. string. Opcional. Use quando command == package || command == install || command == upgrade.

Especifique a versão exata do gráfico a ser instalada. Se isso não for especificado, a versão mais recente será instalada. Defina a versão no gráfico para esta versão semver.


releaseName - nome da versão
string. Opcional. Use quando command == install || command == upgrade || command == rollback || command == uninstall || command == delete.

Nome da versão. Se não for especificado, ele gerará automaticamente um para você.


overrideValues - definir valores
string. Opcional. Use quando command == install || command == upgrade.

Defina valores na linha de comando (pode especificar valores múltiplos ou separados com vírgulas ou novas linhas: key1=val1,key2=val2 ou
chave1=val1
chave2=val2
). A tarefa construirá o comando helm usando esses valores definidos. Por exemplo, helm install --set key1=val1 ./redis.


de arquivo de valor
string. Opcional. Use quando command == install || command == upgrade.

Especifique valores em um arquivo YAML ou em uma URL. Por exemplo, especificar myvalues.yaml resultará em 'helm install --values=myvals.yaml'.


de Destino
string. Opcional. Use quando command == package. Valor padrão: $(Build.ArtifactStagingDirectory).

Especifique valores em um arquivo YAML ou em uma URL.


canaryimage - Usar a versão de imagem canário.
boolean. Opcional. Use quando command == init. Valor padrão: false.

Use a imagem do Tiller canário, a versão de pré-lançamento mais recente do Tiller.


upgradetiller - de Tiller de Atualização
boolean. Opcional. Use quando command == init. Valor padrão: true.

Atualize se Tiller já estiver instalado.


updatedependency - atualizar de dependência
boolean. Opcional. Use quando command == install || command == package. Valor padrão: false.

Execute a atualização de dependência do Helm antes de instalar o gráfico. Atualize as dependências de 'requirements.yaml' para dir 'charts/' antes do empacotamento.


save - Salvar
boolean. Opcional. Use quando command == package. Valor padrão: true.

Salve o gráfico empacotado no repositório de gráfico local (true padrão).


install - Instalar se a versão não estiver presente.
boolean. Opcional. Use quando command == upgrade. Valor padrão: true.

Se uma versão com esse nome ainda não existir, execute uma instalação.


recreate - recriar pods.
boolean. Opcional. Use quando command == upgrade. Valor padrão: false.

Executa a reinicialização de pods para o recurso, se aplicável.


resetValues - redefinir valores.
boolean. Opcional. Use quando command == upgrade. Valor padrão: false.

Redefina os valores para os internos no gráfico.


force - Força
boolean. Opcional. Use quando command == upgrade. Valor padrão: false.

Force a atualização de recursos por meio da exclusão/recriação, se necessário.


waitForExecution - de espera
boolean. Opcional. Use quando command == init || command == install || command == upgrade. Valor padrão: true.

Bloqueie até que a execução do comando seja concluída.


argumentos arguments -
string. Opcional. Use quando command != login && command != logout.

Opções de comando do Helm.


enableTls - habilitar do TLS
boolean. Opcional. Use quando command != login && command != logout && command != package. Valor padrão: false.

Habilita o uso de SSL entre Helm e Tiller.


caCert - de certificado de autoridade de certificação
string. Necessário quando enableTls == true && command != login && command != logout && command != package.

Certificado de autoridade de certificação usado para emitir certificado para o cliente de leme e helm.


de Certificado
string. Necessário quando enableTls == true && command != login && command != logout && command != package.

Especifique o certificado Tiller ou o certificado do cliente Helm.


privatekey - key
string. Necessário quando enableTls == true && command != login && command != logout && command != package.

Especifique a chave tiller ou a chave do cliente Helm.


tillernamespace - namespace tiller
string. Opcional. Use quando command != login && command != logout && command != package.

Especifique o namespace K8 do tiller.


failOnStderr - falha no de erro padrão
boolean. Opcional. Use quando command != login && command != logout && command != package. Valor padrão: false.

Se isso for verdadeiro, essa tarefa falhará se algum erro for gravado no pipeline de erros ou se algum dado for gravado no fluxo de Erro Padrão. Caso contrário, a tarefa dependerá do código de saída para determinar a falha.


publishPipelineMetadata - Publicar de metadados de pipeline
boolean. Opcional. Use quando command != login && command != logout && command != package. Valor padrão: true.

Se isso for verdadeiro, a tarefa coletará e publicará metadados de implantação.


chartNameForACR - nome do gráfico para o Registro de Contêiner do Azure
string. Necessário quando command == package || command == push.

Nome do gráfico com o qual o gráfico será armazenado no Registro de Contêiner do Azure.


chartPathForACR - caminho do gráfico para o Registro de Contêiner do Azure
string. Necessário quando command == package || command == push.

Caminho para o diretório do gráfico.


Opções de controle de tarefa

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

Variáveis de saída

Essa tarefa define as seguintes variáveis de saída , que você pode consumir em etapas downstream, trabalhos e estágios.

helmExitCode
código de saída emitido da execução do comando Helm especificado

helmOutput
Saída emitida da execução do comando Helm especificado

Observações

Uma grande alteração para HelmDeploy@1 tarefa é que os comandos do gráfico do helm são removidos:

  • O subcomando helm chart foi removido
  • helm chart remove foi removido
  • helm chart save foi substituído por helm package
  • helm save foi removido

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente Todas as versões de agente com suporte.
Categoria de tarefa Implantar