Trabalhar com variáveis

Como criar um pipeline com variáveis

1. Faça login no Console de gerenciamento da AWS e abra o console do CodePipeline em http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Selecione Criar pipeline. Insira um nome para o pipeline e escolha Next (Próximo).

3. Em Source (Origem), em Provider (Provedor), escolha CodeCommit. Escolha o repositório e a ramificação do CodeCommit para a ação de origem e escolha Próximo.

4. Em Build (Compilar), em Provider (Provedor), escolha CodeBuild. Escolha um nome de projeto de compilação existente do CodeBuild ou escolha Criar projeto. Em Create build project (Criar projeto de compilação), crie um projeto de compilação e escolha Return do CodePipeline (Retornar ao CodePipeline).

   Em Environment variables (Variáveis de ambiente), escolha Add environment variables (Adicionar variáveis de ambiente). Por exemplo, insira o ID de execução com a sintaxe de variável #{codepipeline.PipelineExecutionId} e o ID de confirmação com a sintaxe da variável #{SourceVariables.CommitId}.

   nota

   Você pode inserir sintaxe variável em qualquer campo de configuração de ação no assistente.

5. Escolha Criar.

6. Depois que o pipeline é criado, você pode visualizar o namespace criado pelo assistente. No pipeline, escolha o ícone do estágio cujo namespace você deseja visualizar. Neste exemplo, o namespace gerado automaticamente da ação de origem, SourceVariables, é exibido.

   

Para editar o namespace de uma ação existente

1. Faça login no Console de gerenciamento da AWS e abra o console do CodePipeline em http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Escolha o pipeline que você deseja editar e escolha Edit (Editar). No estágio de origem, escolha Edit stage (Editar estágio). Adicione a ação do CodeCommit.

3. Em Edit action (Editar ação), visualize o campo Variable namespace (Namespace de variável) . Se a ação existente foi criada anteriormente ou sem usar o assistente, você deverá adicionar um namespace. Em Variable namespace (Namespace de variável), insira um nome de namespace e escolha Save (Salvar).

Como visualizar as variáveis de saída

1. Faça login no Console de gerenciamento da AWS e abra o console do CodePipeline em http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Depois que o pipeline for criado e executado com êxito, você poderá visualizar as variáveis na página Action execution details (Detalhes da execução da ação). Para mais informações, consulte Visualizar variáveis (console).

Como configurar uma ação com um namespace

1. Siga as etapas em Criar um pipeline, estágios e ações para criar um pipeline usando a CLI. Inicie um arquivo de entrada para fornecer o comando create-pipeline com o parâmetro --cli-input-json. Na estrutura do pipeline, adicione o parâmetro namespace e especifique um nome, como SourceVariables.

   . . . 
   {
             "inputArtifacts": [],
             "name": "Source",
             "region": "us-west-2",
             "namespace": "SourceVariables",
             "actionTypeId": {
               "category": "Source",
               "owner": "AWS",
               "version": "1",
               "provider": "CodeCommit"
             },
             "outputArtifacts": [
   
   . . . 

2. Salve o arquivo com um nome como MyPipeline.json.

3. Em um terminal (Linux, macOS ou Unix) ou prompt de comando (Windows), execute o comando create-pipeline e crie o pipeline.

   Invoque o arquivo que você criou quando executou o comando create-pipeline. Por exemplo:

   aws codepipeline create-pipeline --cli-input-json file://MyPipeline.json

Como configurar ações downstream para consumir variáveis

1. Edite um arquivo de entrada para fornecer o comando update-pipeline com o parâmetro --cli-input-json. Na ação downstream, adicione a variável à configuração dessa ação. Uma variável é composta de um namespace e uma chave, separados por um ponto. Por exemplo, para adicionar variáveis para o ID de execução do pipeline e o ID de confirmação de origem, especifique o namespace codepipeline para a variável #{codepipeline.PipelineExecutionId}. Especifique o namespace SourceVariables para a variável #{SourceVariables.CommitId}.

   {
       "name": "Build",
       "actions": [
           {
               "outputArtifacts": [
                   {
                       "name": "BuildArtifacts"
                   }
               ],
               "name": "Build",
               "configuration": {
                   "EnvironmentVariables": "[{\"name\":\"Execution_ID\",\"value\":\"#{codepipeline.PipelineExecutionId}\",\"type\":\"PLAINTEXT\"},{\"name\":\"Commit_ID\",\"value\":\"#{SourceVariables.CommitId}\",\"type\":\"PLAINTEXT\"}]",
                   "ProjectName": "env-var-test"
               },
               "inputArtifacts": [
                   {
                       "name": "SourceArtifact"
                   }
               ],
               "region": "us-west-2",
               "actionTypeId": {
                   "provider": "CodeBuild",
                   "category": "Build",
                   "version": "1",
                   "owner": "AWS"
               },
               "runOrder": 1
           }
       ]
   },

2. Salve o arquivo com um nome como MyPipeline.json.

3. Em um terminal (Linux, macOS ou Unix) ou prompt de comando (Windows), execute o comando create-pipeline e crie o pipeline.

   Invoque o arquivo que você criou quando executou o comando create-pipeline. Por exemplo:

   aws codepipeline create-pipeline --cli-input-json file://MyPipeline.json

1. Faça login no Console de gerenciamento da AWS e abra o console do CodePipeline em http://console.aws.amazon.com/codesuite/codepipeline/home.

   Os nomes de todos os pipelines associados à sua conta da AWS são exibidos.

2. Em Nome, selecione o nome do pipeline.

3. Selecione Visualizar histórico.

4. Depois que o pipeline for executado com êxito, você poderá exibir as variáveis produzidas pela ação de origem. Selecione Visualizar histórico. Escolha Origem na lista de ações da execução do pipeline para visualizar os detalhes da execução da ação do CodeCommit. Na tela de detalhes da ação, exiba as variáveis em Output variables (Variáveis de saída).

   

5. Depois que o pipeline for executado com êxito, você poderá exibir as variáveis consumidas pela ação de compilação. Selecione Visualizar histórico. Na lista de ações da execução do pipeline, escolha Compilar para visualizar os detalhes da execução da ação do CodeBuild. Na página de detalhes da ação, exiba as variáveis em Action configuration (Configuração de ação). O namespace gerado automaticamente é exibido.

   

   Por padrão, a Action configuration (Configuração de ação) exibe a sintaxe da variável. Você pode escolher Show resolved configuration (Mostrar configuração resolvida) para alternar a lista para exibir os valores que foram produzidos durante a execução da ação

   

1. Use o seguinte comando:

   
   aws codepipeline list-action-executions

   A saída mostra o parâmetro outputVariables conforme mostrado aqui.

   "outputVariables": {
                       "BranchName": "main",
                       "CommitMessage": "Updated files for test",
                       "AuthorDate": "2019-11-08T22:24:34Z",
                       "CommitId": "d99b0083cc10EXAMPLE",
                       "CommitterDate": "2019-11-08T22:24:34Z",
                       "RepositoryName": "variables-repo"
                   },
               

2. Use o seguinte comando:

   
   aws codepipeline get-pipeline --name <pipeline-name>

   Na configuração da ação do CodeBuild, você pode visualizar as variáveis:

   {
       "name": "Build",
       "actions": [
           {
               "outputArtifacts": [
                   {
                       "name": "BuildArtifact"
                   }
               ],
               "name": "Build",
               "configuration": {
                   "EnvironmentVariables": "[{\"name\":\"Execution_ID\",\"value\":\"#{codepipeline.PipelineExecutionId}\",\"type\":\"PLAINTEXT\"},{\"name\":\"Commit_ID\",\"value\":\"#{SourceVariables.CommitId}\",\"type\":\"PLAINTEXT\"}]",
                   "ProjectName": "env-var-test"
               },
               "inputArtifacts": [
                   {
                       "name": "SourceArtifact"
                   }
               ],
               "region": "us-west-2",
               "actionTypeId": {
                   "provider": "CodeBuild",
                   "category": "Build",
                   "version": "1",
                   "owner": "AWS"
               },
               "runOrder": 1
           }
       ]
   },

1. Faça login no Console de gerenciamento da AWS e abra o console do CodePipeline em http://console.aws.amazon.com/codesuite/codepipeline/home.

   Os nomes de todos os pipelines associados à sua conta da AWS são exibidos. Escolha o pipeline ao qual deseja adicionar a aprovação.

2. Para editar o pipeline, escolha Edit (Editar). Adicione uma aprovação manual após a ação de origem. Em Action name (Nome da ação), insira o nome da ação de aprovação.

3. Em Action provider (Provedor de ação), escolha Manual approval (Aprovação manual).

4. Em URL para revisar, adicione a sintaxe de variável de CommitId ao URL do CodeCommit. Certifique-se de usar o namespace atribuído à ação de origem. Por exemplo, a sintaxe de variável para uma ação do CodeCommit com o namespace padrão SourceVariables é #{SourceVariables.CommitId}.

   Em Comentários, em CommitMessage, insira a mensagem de confirmação:

   Please approve this change. Commit message: #{SourceVariables.CommitMessage}

5. Depois que o pipeline for executado com êxito, você poderá exibir os valores das variáveis na mensagem de aprovação.

1. Faça login no Console de gerenciamento da AWS e abra o console do CodePipeline em http://console.aws.amazon.com/codesuite/codepipeline/home.

   Os nomes de todos os pipelines associados à sua conta da AWS são exibidos. Escolha o pipeline ao qual deseja adicionar a aprovação.

2. Para editar o pipeline, escolha Edit (Editar). No estágio que contém a ação do CodeBuild, escolha Editar estágio.

3. Escolha o ícone para editar a ação do CodeBuild.

4. Na página Editar ação, em Variáveis de ambiente, insira o seguinte:

   • Em Nome, insira um nome para a variável de ambiente.

   • Em Valor, insira a sintaxe da variável de saída do pipeline, que inclui o namespace atribuído à sua ação de origem. Por exemplo, a sintaxe da variável de saída para uma ação do GitHub com o namespace padrão SourceVariables é #{SourceVariables.BranchName}.

   • Em Tipo, escolha Texto sem formatação.

5. Depois que o pipeline for executado com êxito, você poderá ver como a variável de saída resolvida é o valor na variável de ambiente. Escolha uma das seguintes opções:

   • Console do CodePipeline: escolha seu pipeline e, em seguida, escolha Histórico. Escolha a execução mais recente do pipeline.

     • Em Linha do tempo, escolha o seletor de Origem. Essa é a ação de origem que gera as variáveis de saída do GitHub. Escolha Visualizar detalhes da execução. Em Variáveis de saída, visualize a lista de variáveis de saída geradas por essa ação.

     • Em Linha do tempo, escolha o seletor de Origem. Essa é a ação de compilação que especifica as variáveis de ambiente do CodeBuild para seu projeto de compilação. Escolha Visualizar detalhes da execução. Em Configuração de ação, visualize as variáveis de ambiente do CodeBuild. Escolha Mostrar a configuração resolvida. O valor da variável de ambiente é a variável de saída BranchName resolvida da ação de origem do GitHub. Neste exemplo, esse valor resolvido é main.

       Para obter mais informações, consulte Visualizar variáveis (console).

   • Console do CodeBuild: escolha seu projeto de compilação e escolha o link para sua execução de compilação. Em Variáveis de ambiente, sua variável de saída resolvida é o valor da variável de ambiente do CodeBuild. Neste exemplo, a variável de ambiente Nome é BranchName e o Valor é a variável de saída BranchName resolvida da ação de origem do GitHub. Neste exemplo, o valor resolvido é main.