HelmDeploy@0 - Empacotar e implementar a tarefa helm charts v0

Utilize esta tarefa para implementar, configurar ou atualizar um cluster do Kubernetes no Azure Container Service ao executar comandos helm.

Syntax

# Package and deploy Helm charts v0
# Deploy, configure, update a Kubernetes cluster in Azure Container Service by running helm commands.
- task: HelmDeploy@0
  inputs:
  # Kubernetes Cluster
    #connectionType: 'Azure Resource Manager' # 'Azure Resource Manager' | 'Kubernetes Service Connection' | 'None'. Required when command != logout && command != package && command != save. Connection Type. Default: Azure Resource Manager.
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Required when connectionType = Azure Resource Manager && command != logout && command != package && command != save. Azure subscription. 
    #azureResourceGroup: # string. Required when connectionType = Azure Resource Manager && command != logout && command != package && command != save. Resource group. 
    #kubernetesCluster: # string. Required when connectionType = Azure Resource Manager && command != logout && command != package && command != save. Kubernetes cluster. 
    #useClusterAdmin: false # boolean. Optional. Use when connectionType = Azure Resource Manager && command != logout && command != package && command != save. Use cluster admin credentials. Default: false.
    #kubernetesServiceConnection: # string. Alias: kubernetesServiceEndpoint. Required when connectionType = Kubernetes Service Connection && command != logout && command != package && command != save. Kubernetes Service Connection. 
    #namespace: # string. Optional. Use when command != logout && command != package && command != save. Namespace. 
  # Azure Container Registry
    #azureSubscriptionForACR: # string. Alias: azureSubscriptionEndpointForACR. Required when command == save. Azure subscription for Container Registry. 
    #azureResourceGroupForACR: # string. Required when command == save. Resource group. 
    #azureContainerRegistry: # string. Required when command == save. Azure Container Registry. 
  # Commands
    command: 'ls' # 'create' | 'delete' | 'expose' | 'get' | 'init' | 'install' | 'login' | 'logout' | 'ls' | 'package' | 'rollback' | 'save' | '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. Chart Name. 
    #chartPath: # string. Required when chartType == FilePath || command == package. Chart Path. 
    #chartVersion: # string. Alias: version. Optional. Use when command == package || command == install || command == upgrade. Version. 
    #releaseName: # string. Optional. Use when command == install || command == upgrade. 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 == save. Chart Name For Azure Container Registry. 
    #chartPathForACR: # string. Required when command == save. Chart Path for Azure Container Registry. 
  # TLS
    #enableTls: false # boolean. Optional. Use when command != login && command != logout && command != package && command != save. Enable TLS. Default: false.
    #caCert: # string. Required when enableTls == true && command != login && command != logout && command != package && command != save. CA certificate. 
    #certificate: # string. Required when enableTls == true && command != login && command != logout && command != package && command != save. Certificate. 
    #privatekey: # string. Required when enableTls == true && command != login && command != logout && command != package && command != save. Key. 
  # Advanced
    #tillernamespace: # string. Optional. Use when command != login && command != logout && command != package && command != save. Tiller namespace. 
    #failOnStderr: false # boolean. Optional. Use when command != login && command != logout && command != package && command != save. Fail on Standard Error. Default: false.
    #publishPipelineMetadata: true # boolean. Optional. Use when command != login && command != logout && command != package && command != save. Publish pipeline metadata. Default: true.

Entradas

connectionType - Tipo de Ligação
string. Necessário quando command != logout && command != package && command != save. Valores permitidos: Azure Resource Manager, , Kubernetes Service ConnectionNone. Valor predefinido: Azure Resource Manager.

Especifica o tipo de ligação.

• Kubernetes Service Connection - Especifique Kubernetes Service Connection para ligar a qualquer cluster do Kubernetes com kubeconfig ou a Conta de Serviço do Azure. Permite-lhe fornecer um ficheiro KubeConfig, especificar uma Conta de Serviço ou importar uma instância do AKS com a opção Subscrição do Azure . Importar uma instância do AKS com a opção Subscrição do Azure requer acesso ao cluster do Kubernetes no tempo de configuração da Ligação de Serviço.
• Azure Resource Manager- Especifique Azure Resource Manager para ligar a um Azure Kubernetes Service com a Ligação de Serviço do Azure. Não acede ao cluster do Kubernetes na hora de configuração da Ligação de Serviço.
• None - Utilize uma configuração do Kubernetes pré-criada armazenada localmente.

Para obter mais informações, veja Ligação de serviço na secção Observações seguinte.

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

O nome da Ligação de Serviço do Azure. Especifique uma subscrição do Azure que tenha o seu registo de contentor.

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

O nome do grupo de recursos na subscrição. Especifique um Grupo de Recursos do Azure.

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

O nome do cluster do AKS. Especifique um Cluster Gerido do Azure.

useClusterAdmin - Utilizar credenciais de administrador de cluster
boolean. Opcional. Utilize quando connectionType = Azure Resource Manager && command != logout && command != package && command != save. Valor predefinido: false.

Utiliza credenciais de administrador de cluster em vez de credenciais de utilizador do cluster predefinidas.

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

Especifica uma Ligação de Serviço do Kubernetes.

namespace - Espaço de nomes
string. Opcional. Utilize quando command != logout && command != package && command != save.

O espaço de nomes no qual executa os kubectl comandos. Se não for especificado, a tarefa utiliza o espaço de nomes predefinido. Especifique o espaço de nomes do Kubernetes a utilizar. Pode especificar o espaço de nomes do Tiller na secção avançada da tarefa ou ao transmitir a opção --tiller-namespace como um argumento.

azureSubscriptionForACR - Subscrição do Azure para o Container Registry
Alias de entrada: azureSubscriptionEndpointForACR. string. Necessário quando command == save.

Especifica uma subscrição do Azure que tem a sua Azure Container Registry.

azureResourceGroupForACR - Grupo de recursos
string. Necessário quando command == save.

Especifica um Grupo de Recursos do Azure que tem o Seu Registo de Contentores.

azureContainerRegistry - Azure Container Registry
string. Necessário quando command == save.

Especifica uma Azure Container Registry a ser utilizada para emitir gráficos Helm.

command - Comando
string. Obrigatório. Valores permitidos: create, , delete, getexpose, init, install, login, logout, ls, package, , rollback, , save, , upgrade, uninstall. Valor predefinido: ls.

Especifica um comando helm.

chartType - Tipo de Gráfico
string. Necessário quando command == install || command == upgrade. Valores permitidos: Name, FilePath (Caminho do Ficheiro). Valor predefinido: Name.

Especifica como pretende introduzir informações do gráfico. Pode indicar o nome do gráfico ou caminho da pasta/ficheiro para o gráfico.

chartName - Nome do Gráfico
string. Necessário quando chartType == Name.

O nome da referência do gráfico a instalar. Pode ser um URL ou um nome de gráfico. Por exemplo, se o nome do gráfico for stable/mysql, a tarefa executa helm install stable/mysql.

chartPath - Caminho do Gráfico
string. Necessário quando chartType == FilePath || command == package.

O caminho para o gráfico a instalar. Pode ser um caminho para um gráfico empacotado ou um caminho para um diretório de gráfico desempacotado. Por exemplo, se especificar ./redis, a tarefa executa helm install ./redis. Se estiver a consumir um gráfico publicado como um artefacto, o caminho será $(System.DefaultWorkingDirectory)/ARTIFACT-NAME/Charts/CHART-NAME.

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

Especifica a versão exata do gráfico a instalar. Se não especificar a versão do gráfico, a tarefa instala a versão mais recente. Defina a versão no gráfico para esta versão semver.

releaseName - Nome da Versão
string. Opcional. Utilize quando command == install || command == upgrade.

O nome da versão. Se não especificar o nome da versão, a tarefa gera automaticamente uma para si. A releaseName entrada só é válida para install comandos e upgrade .

overrideValues - Definir Valores
string. Opcional. Utilize quando command == install || command == upgrade.

Especifica valores na linha de comandos. Esta entrada pode especificar vários valores ou valores separados com vírgulas: key1=val1,key2=val2.

Também pode especificar vários valores ao delimitá-los com uma nova linha, da seguinte forma:

• key1=val1
• key2=val2

Se tiver um valor que contenha novas linhas, utilize a opção valueFile . Caso contrário, a tarefa trata a nova linha como delimitador. A tarefa constrói o comando Helm com estes valores definidos. Por exemplo, pode definir o valor com um comando semelhante ao seguinte: helm install --set key1=val1 ./redis.

valueFile - Ficheiro de Valor
string. Opcional. Utilize quando command == install || command == upgrade.

Especifica valores num ficheiro YAML ou num URL. Por exemplo, especificar myvalues.yaml resultados em helm install --values=myvals.yaml.

destination - Destino
string. Opcional. Utilize quando command == package. Valor predefinido: $(Build.ArtifactStagingDirectory).

Especifica valores num ficheiro YAML ou num URL.

canaryimage - Utilizar a versão da imagem canary.
boolean. Opcional. Utilize quando command == init. Valor predefinido: false.

Especifica a imagem canary Tiller. Utilize a versão de pré-lançamento mais recente do Tiller.

upgradetiller - Atualizar o Tiller
boolean. Opcional. Utilize quando command == init. Valor predefinido: true.

Se true, esta entrada atualiza o Tiller se o Tiller já estiver instalado.

updatedependency - Atualizar Dependência
boolean. Opcional. Utilize quando command == install || command == package. Valor predefinido: false.

Se true, esta entrada atualiza uma atualização de dependência do Helm antes de instalar o gráfico. Atualizações dependências do diretório charts/ antes de requirements.yaml empacotar.

save - Guardar
boolean. Opcional. Utilize quando command == package. Valor predefinido: true.

Guarda o gráfico empacotado no repositório de gráficos local quando definido como true​.

install - Instale se a versão não estiver presente.
boolean. Opcional. Utilize quando command == upgrade. Valor predefinido: true.

Se uma versão com este nome ainda não existir, esta entrada executa uma instalação.

recreate - Recriar Pods.
boolean. Opcional. Utilize quando command == upgrade. Valor predefinido: false.

Executa o reinício dos pods para o recurso, se aplicável.

resetValues - Repor Valores.
boolean. Opcional. Utilize quando command == upgrade. Valor predefinido: false.

Repõe os valores para os valores incorporados no gráfico.

force - Forçar
boolean. Opcional. Utilize quando command == upgrade. Valor predefinido: false.

Força uma atualização de recursos através de uma ação de eliminação ou recriação, se necessário.

waitForExecution - Aguarde
boolean. Opcional. Utilize quando command == init || command == install || command == upgrade. Valor predefinido: true.

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

arguments - Argumentos
string. Opcional. Utilize quando command != login && command != logout.

As opções de comandos do Helm.

enableTls - Ativar TLS
boolean. Opcional. Utilize quando command != login && command != logout && command != package && command != save. Valor predefinido: false.

Ativa a utilização de SSL entre o Helm e o Tiller.

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

O certificado de AC utilizado para emitir um certificado para o cliente Tiller e Helm.

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

Especifique o certificado Tiller ou o certificado de cliente Helm.

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

Especifique a chave Tiller ou a chave de cliente Helm.

tillernamespace - Espaço de nomes do Tiller
string. Opcional. Utilize quando command != login && command != logout && command != package && command != save.

Especifique o espaço de nomes do Kubernetes do Tiller.

failOnStderr - Falha no Erro Padrão
boolean. Opcional. Utilize quando command != login && command != logout && command != package && command != save. Valor predefinido: false.

Se esta entrada for true, esta tarefa falhará se forem escritos erros no pipeline de erros ou se forem escritos dados no Fluxo de erros Padrão. Caso contrário, a tarefa depende do código de saída para determinar a falha.

publishPipelineMetadata - Publicar metadados do pipeline
boolean. Opcional. Utilize quando command != login && command != logout && command != package && command != save. Valor predefinido: true.

Se esta entrada for true, a tarefa recolhe e publica metadados de implementação.

chartNameForACR - Nome do Gráfico para Azure Container Registry
string. Necessário quando command == save.

O nome do gráfico na Azure Container Registry.

chartPathForACR - Caminho do Gráfico para Azure Container Registry
string. Necessário quando command == save.

O caminho do ficheiro para o diretório do gráfico no Azure Container Registry.

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

Esta tarefa define as seguintes variáveis de saída, que pode consumir em passos, tarefas e fases a jusante.

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

helmOutput
O resultado emitido a partir da execução do comando Helm especificado.

Observações

Utilize HelmDeploy@0 para implementar, configurar ou atualizar um cluster do Kubernetes no Azure Container Service ao executar comandos helm. O Helm é uma ferramenta que simplifica a implementação e gestão de aplicações do Kubernetes com um formato de empacotamento denominado gráficos.

Pode definir, versão, partilhar, instalar e atualizar até mesmo a aplicação kubernetes mais complexa com o Helm.

• O Helm ajuda-o a combinar vários manifestos do Kubernetes (yaml), tais como serviço, implementações, configmaps e muito mais, numa única unidade chamada Helm Charts. Não precisa de inventar ou utilizar uma tokenização ou uma ferramenta de modelação.
• Os Gráficos Helm ajudam-no a gerir dependências de aplicações e a implementar, bem como a reverter como uma unidade. Também são fáceis de criar, versão, publicar e partilhar com outras equipas de parceiros.

O Azure Pipelines tem suporte incorporado para gráficos Helm:

• A tarefa do instalador da Ferramenta Helm pode ser utilizada para instalar a versão correta do Helm nos agentes.
• O pacote Helm e a tarefa de implementação podem ser utilizados para empacotar a aplicação e implementá-la num cluster do Kubernetes. Pode utilizar a tarefa para instalar ou atualizar o Tiller para um espaço de nomes do Kubernetes, para ligar em segurança ao Tiller através do TLS para implementar gráficos ou para executar qualquer comando Helm, como lint.
• A tarefa Helm suporta a ligação a um Azure Kubernetes Service através de uma ligação de serviço do Azure. Pode ligar a qualquer cluster do Kubernetes com o kubeconfig ou uma conta de serviço.
• As implementações helm podem ser complementadas com a tarefa kubectl ; por exemplo, criar/atualizar, imagepullsecret, entre outros.

Ligação de serviço

HelmDeploy@0 funciona com dois tipos de ligação de serviço: Azure Resource Manager e Kubernetes Service Connection. Veja Exemplos de exemplos sobre como configurar estes dois tipos de ligação.

Nota

Não é necessária uma ligação de serviço se já tiver sido especificado um recurso de ambiente que aponte para um cluster do Kubernetes na fase do pipeline.

Considerações sobre a Ligação de Serviço do Kubernetes ao aceder ao AKS

Pode criar uma ligação de serviço do Kubernetes com qualquer uma das seguintes opções.

• KubeConfig
• Conta de Serviço
• Subscrição do Azure

Ao selecionar a opção Subscrição do Azure , o Kubernetes tem de estar acessível ao Azure DevOps no momento da configuração da ligação de serviço. Podem existir vários motivos pelos quais não é possível criar uma ligação de serviço, por exemplo , criou um cluster privado ou o cluster tem contas locais desativadas. Nestes casos, o Azure DevOps não consegue ligar-se ao cluster no momento da configuração da ligação de serviço e verá um ecrã Desativado a carregar espaços de nomes .

A partir do Kubernetes 1.24, os tokens de longa duração já não são criados por predefinição. O Kubernetes recomenda que não utilize tokens de longa duração. Como resultado, as tarefas que utilizam uma ligação de serviço do Kubernetes criada com a opção Subscrição do Azure não têm acesso ao token permanente necessário para autenticar e não podem aceder ao cluster do Kubernetes. Isto também resulta na caixa de diálogo Carregar espaços de nomes congelados .

Utilizar a Ligação do Serviço Resource Manager do Azure para aceder ao AKS

Para os clientes do AKS, o tipo de ligação de serviço do Azure Resource Manager fornece o melhor método para ligar a um cluster privado ou a um cluster com contas locais desativadas. Este método não depende da conectividade do cluster no momento em que criar uma ligação de serviço. O acesso ao AKS é diferido para o runtime do pipeline, que tem as seguintes vantagens:

• O acesso a um cluster do AKS (privado) pode ser efetuado a partir de um agente autoalojado ou de um conjunto de dimensionamento com linha de visão para o cluster.
• É criado um token para cada tarefa que utiliza uma ligação de serviço do Azure Resource Manager. Isto garante que está a ligar ao Kubernetes com um token de curta duração, que é a recomendação do Kubernetes.
• O AKS pode ser acedido mesmo quando as contas locais estão desativadas.

FAQ da ligação de serviço

Recebo a seguinte mensagem de erro: Não foi possível localizar nenhum segredo associado à conta de serviço. O que está a acontecer?

Está a utilizar a ligação do serviço Kubernetes com a opção Subscrição do Azure. Estamos a atualizar este método para criar tokens de longa duração. Espera-se que esteja disponível em meados de maio. No entanto, é recomendado começar a utilizar o tipo de ligação de serviço do Azure e não utilizar tokens de longa duração de acordo com a documentação de orientação do Kubernetes.

Estou a utilizar o AKS e não quero alterar nada, posso continuar a utilizar tarefas com a ligação do serviço Kubernetes?

Estamos a atualizar este método para criar tokens de longa duração. Espera-se que esteja disponível em meados de maio. No entanto, tenha em atenção que esta abordagem é contra a orientação do Kubernetes.

Estou a utilizar as tarefas do Kubernetes e a ligação do serviço Kubernetes, mas não o AKS. Devo preocupar-me?

As tarefas continuarão a funcionar como anteriormente.

O tipo de ligação do serviço Kubernetes será removido?

As nossas tarefas do Kubernetes funcionam com qualquer cluster do Kubernetes, independentemente do local onde estão a ser executadas. A ligação do serviço Kubernetes continuará a existir.

Sou um cliente do AKS e está tudo a correr bem, devo agir?

Não há necessidade de mudar nada. Se estiver a utilizar a ligação do serviço Kubernetes e tiver selecionado a Subscrição do Azure durante a criação, deve estar ciente da documentação de orientação do Kubernetes sobre a utilização de tokens de longa duração.

Estou a criar um Ambiente do Kubernetes e não tenho opção de utilizar ligações de serviço

Caso não consiga aceder ao AKS durante a hora de criação do ambiente, pode utilizar um ambiente vazio e definir a connectionType entrada para uma ligação de serviço do Azure Resource Manager.

Configurei o AKS com o RBAC do Azure Active Directory e o meu pipeline não funciona. Estas atualizações irão resolver este problema?

Aceder ao Kubernetes quando o RBAC do AAD está ativado não está relacionado com a criação de tokens. Para impedir um pedido interativo, iremos suportar o kubelogin numa atualização futura.

Valores de comando

A entrada do comando aceita um dos seguintes comandos helm: create/delete/expose/get/init/install/login/logout/ls/package/rollback/upgrade. Os exemplos são fornecidos na secção Exemplos .

Cada entrada de comando mapeia para um conjunto de entradas de tarefas. Os comandos que mapeiam para uma entrada de tarefa são designados no bloco de sintaxe YAML e na tabela de entradas de tarefas

Resolução de problemas

A tarefa HelmDeploy lança o erro "sinalizador desconhecido: --wait" enquanto executa "helm init --wait --client-only" na versão do Helm 3.0.2.

Existem algumas alterações interruptivas entre Helm 2 e Helm 3. Um deles inclui a remoção do tiller e, por conseguinte, helm init o comando já não é suportado. Comando remover: init quando utiliza as versões 3.0+ do Helm.

Ao utilizar o Helm 3, se System.debug estiver definido como verdadeiro e a atualização do Helm for o comando que está a ser utilizado, o pipeline falha mesmo que a atualização tenha sido efetuada com êxito.

Este é um problema conhecido com o Helm 3, uma vez que ele escreve alguns registos no stderr. A Tarefa de Implementação do Helm será marcada como “com falhas” se existirem registos no stderr ou se o código de saída não for zero. Defina a entrada da tarefa failOnStderr: false para ignorar os registos impressos no stderr.

Exemplos

Azure Resource Manager

Este exemplo de YAML mostra como o Azure Resource Manager é utilizado para se referir ao cluster do Kubernetes. Isto é utilizado com um dos comandos helm e os valores adequados necessários para o comando:

variables:
  azureSubscriptionEndpoint: Contoso
  azureContainerRegistry: contoso.azurecr.io
  azureResourceGroup: Contoso
  kubernetesCluster: Contoso

- task: HelmDeploy@0
  displayName: Helm deploy
  inputs:
    connectionType: Azure Resource Manager
    azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
    azureResourceGroup: $(azureResourceGroup)
    kubernetesCluster: $(kubernetesCluster)

Ligação de Serviço do Kubernetes

Este exemplo de YAML mostra como a ligação do serviço Kubernetes é utilizada para se referir ao cluster do Kubernetes. Isto é utilizado com um dos comandos helm e os valores adequados necessários para o comando:

- task: HelmDeploy@0
  displayName: Helm deploy
  inputs:
    connectionType: Kubernetes Service Connection
    kubernetesServiceEndpoint: Contoso

Comandos

A entrada do comando aceita um dos seguintes comandos helm: create/delete/expose/get/init/install/login/logout/ls/package/rollback/upgrade.

Este exemplo de YAML demonstra o comando ls :

- task: HelmDeploy@0
  displayName: Helm list
  inputs:
    azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
    azureResourceGroup: $(azureResourceGroup)
    kubernetesCluster: $(kubernetesCluster)
    command: ls
    arguments: --all

comando init

Este exemplo de YAML demonstra o comando init :

- task: HelmDeploy@0
  displayName: Helm init
  inputs:
    azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
    azureResourceGroup: $(azureResourceGroup)
    kubernetesCluster: $(kubernetesCluster)
    command: init
    upgradetiller: true
    waitForExecution: true
    arguments: --client-only

comando install

Este exemplo de YAML demonstra o comando de instalação :

- task: HelmDeploy@0
  displayName: Helm install
  inputs:
    azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
    azureResourceGroup: $(azureResourceGroup)
    kubernetesCluster: $(kubernetesCluster)
    command: install
    chartType: FilePath
    chartPath: Application/charts/sampleapp

comando package

Este exemplo de YAML demonstra o comando do pacote :

- task: HelmDeploy@0
  displayName: Helm package
  inputs:
    command: package
    chartPath: Application/charts/sampleapp
    destination: $(Build.ArtifactStagingDirectory)

comando de atualização

Este exemplo de YAML demonstra o comando de atualização :

- task: HelmDeploy@0
  displayName: Helm upgrade
  inputs:
    azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
    azureResourceGroup: $(azureResourceGroup)
    kubernetesCluster: $(kubernetesCluster)
    command: upgrade
    chartType: filepath
    chartPath: $(Build.ArtifactStagingDirectory)/sampleapp-v0.2.0.tgz
    releaseName: azuredevopsdemo
    install: true
    waitForExecution: false

comando guardar

Este exemplo de YAML demonstra o comando guardar :

- task: HelmDeploy@0
  displayName: Helm save
  inputs:
    command: save
    chartNameForACR: mycontainerregistry.azurecr.io/helm/hello-world:v1
    chartPathForACR: Application/charts/sampleapp
    azureSubscriptionEndpointForACR: $(azureSubscriptionEndpointForACR)
    azureResourceGroupForACR: $(azureResourceGroupForACR)
    azureContainerRegistry: $(azureContainerRegistry)

Compactar e assinar gráficos Helm

Nesta secção, irá aprender a empacotar e assinar gráficos Helm num pipeline.

Gerar um par de chaves públicas privadas para assinar o gráfico helm com GPG

1. Transfira GPG.

2. Inicie a linha de comandos num modo de administrador. Execute o seguinte comando para gerar um par de chaves públicas privadas para assinar o gráfico helm com gpg. Ao criar a chave, ser-lhe-á pedido o nome de utilizador e o endereço de e-mail. O "endereço de e-mail do nome" é mais tarde utilizado para atribuir um nome ao par de chaves públicas privadas que é criado.

   gpg --full-generate-key
   

   

3. Ser-lhe-á pedida a frase de acesso. Dê o valor e clique em OK.

   

4. Depois de criar a chave, pode ver a lista de chaves que contém privadas e públicas com o seguinte comando.

   • Para ver a lista de chaves privadas

     gpg --list-secret-keys
     

     

   • Para ver a lista de chaves públicas

     gpg --list-keys
     

     

5. Armazene as chaves privadas e públicas em 2 ficheiros diferentes com o gpg de extensão, conforme mostrado abaixo.

   • Para uma chave privada

   gpg --export-secret-key 94325E18E53EDD99DD8339C3CFD9DAF0707CB788 contoso@microsoft.com > C:/somepath/privatekeys.gpg
   

   Verá o ficheiro privatekeys.gpg exportado para o caminho mencionado acima.

   • Para uma chave pública

   gpg --export-key 94325E18E53EDD99DD8339C3CFD9DAF0707CB788 contoso@microsoft.com > C:/somepath/publickey.gpg
   

   Verá o ficheiro publickey.gpg exportado para o caminho mencionado acima.

No Azure DevOps, guarde o ficheiro privatekey.gpg na secção ficheiros seguros da biblioteca.

Exemplo

pool:
  name: Hosted Ubuntu 1604

variables:
  # The below variable should be secure
  HelmKeyPassphrase: contoso@123
  keyName: contoso contoso@microsoft.com
  azureSubscriptionEndpoint: contoso
  azureResourceGroup: contoso
  kubernetesCluster: contoso

steps:
- task: DownloadSecureFile@1
  displayName: Download Secure file
  inputs:
    secureFile: privatekey.gpg
  name: privateKeyRing

- task: HelmInstaller@0
  displayName: Install Helm 2.12.0
  inputs:
    helmVersion: 2.12.0

- task: HelmDeploy@0
  displayName: helm init
  inputs:
    azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
    azureResourceGroup: $(azureResourceGroup)
    kubernetesCluster: $(kubernetesCluster)
    command: init
    arguments: --client-only

- task: HelmDeploy@0
  displayName: helm package
  inputs:
    command: package
    chartPath: Application/charts/sampleapp
    arguments: --sign --key "$(keyName)" --keyring $(privateKeyRing.secureFilePath)
  env:
    HelmKeyPassphrase: $(HelmKeyPassphrase)

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