As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Tutorial: Usar variáveis no nível do pipeline
Neste tutorial, você criará um pipeline em que adicionará uma variável no nível do pipeline e executará uma ação de CodeBuild criação que gera o valor da variável.
Tópicos
Pré-requisitos
Antes de começar, é necessário fazer o seguinte:
-
Crie um CodeCommit repositório.
-
Adicione um arquivo .txt a um repositório.
Etapa 1: Criar seu pipeline e compilar o projeto
Nesta seção, você criará um pipeline com as seguintes ações:
-
Um estágio de origem com uma conexão com seu CodeCommit repositório.
-
Um estágio de construção com uma ação de AWS CodeBuild construção.
Criar um pipeline com o assistente
-
Faça login no CodePipeline console em https://console.aws.amazon.com/codepipeline/
. -
Na página Welcome (Bem-vindo), Getting started (Conceitos básicos) ou Pipelines, selecione Create pipeline (Criar pipeline).
-
Em Step 1: Choose pipeline settings (Etapa 1: selecionar as configurações do pipeline), em Pipeline name (Nome do pipeline), insira
MyVariablesPipeline
. -
Em Tipo de pipeline, mantenha a seleção padrão em V2. Os tipos de pipeline diferem em características e preços. Para ter mais informações, consulte Tipos de pipeline.
-
Em Service role (Função do serviço), selecione New service role (Nova função de serviço).
nota
Se você optar por usar sua função de CodePipeline serviço existente, certifique-se de ter adicionado a permissão do
codeconnections:UseConnection
IAM à sua política de função de serviço. Para obter instruções sobre a função de CodePipeline serviço, consulte Adicionar permissões à função CodePipeline de serviço. -
Em Variáveis, selecione Adicionar variável. Em Nome, insira
timeout
. Em Padrão, insira 1000. Em Descrição, insira a seguinte descrição:Timeout
.Isso criará uma variável na qual você poderá declarar o valor quando a execução do pipeline começar. Os nomes das variáveis devem corresponder a
[A-Za-z0-9@\-_]+
e podem ser qualquer coisa, exceto uma string vazia. -
Em Configurações avançadas mantenha os padrões. Em Artifact store (Armazenamento de artefatos), selecione Default location (Local padrão) para usar o armazenamento de artefatos padrão, como o bucket de artefatos do Amazon S3 designado como padrão, para o pipeline na região que você selecionou.
nota
Este não é o bucket de origem para seu código-fonte. Este é o armazenamento de artefatos para o pipeline. Um armazenamento de artefatos separado, como um bucket do S3, é necessário para cada pipeline.
Selecione Next (Próximo).
-
Na página Step 2: Add source stage (Etapa 2: Adicionar um estágio de origem), adicione um estágio de origem:
-
Em Source provider (Provedor de código-fonte), selecione AWS CodeCommit.
-
Em Nome do repositório e Nome da ramificação, selecione o repositório e a ramificação.
Selecione Next (Próximo).
-
-
Em Add build stage (Adicionar estágio de compilação), adicione um estágio de compilação:
-
Em Build provider (Provedor de compilação), escolha AWS CodeBuild. Permita que Region (Região) seja definida para a região do pipeline.
-
Escolha Criar projeto.
-
Em Project name (Nome do projeto), insira um nome para esse projeto de compilação.
-
Em Environment image (Imagem do ambiente), escolha Managed image (Imagem gerenciada). Para Operating system, selecione Ubuntu.
-
Em Runtime (Tempo de execução), selecione Standard (Padrão). Em Imagem, selecione aws/codebuild/standard:5.0.
-
Em Service role (Função de serviço), selecione New service role (Nova função de serviço).
nota
Anote o nome da sua função CodeBuild de serviço. Você precisará do nome do perfil para a etapa final deste tutorial.
-
Em Buildspec, para Build specifications (Especificações da compilação), escolha Insert build commands (Inserir comandos de compilação). Selecione Alternar para o editor e cole o seguinte em Comandos de compilação. No buildspec, a variável do cliente
$CUSTOM_VAR1
será usada para gerar a variável do pipeline no log de criação. Você criará a variável de saída$CUSTOM_VAR1
como uma variável de ambiente na etapa a seguir.version: 0.2 #env: #variables: # key: "value" # key: "value" #parameter-store: # key: "value" # key: "value" #git-credential-helper: yes phases: install: #If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions. #If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails. runtime-versions: nodejs: 12 #commands: # - command # - command #pre_build: #commands: # - command # - command build: commands: - echo $CUSTOM_VAR1 #post_build: #commands: # - command # - command artifacts: files: - '*' # - location name: $(date +%Y-%m-%d) #discard-paths: yes #base-directory: location #cache: #paths: # - paths
-
Escolha Continuar para CodePipeline. Isso retorna ao CodePipeline console e cria um CodeBuild projeto que usa seus comandos de construção para configuração. O projeto de compilação usa uma função de serviço para gerenciar Serviço da AWS permissões. Essa etapa pode levar alguns minutos.
-
Em Variáveis de ambiente - opcional, para criar uma variável de ambiente como uma variável de entrada para a ação de criação que será resolvida pela variável em nível de pipeline, selecione Adicionar variável de ambiente. Isso criará a variável especificada no buildspec como
$CUSTOM_VAR1
. Em Nome, insiraCUSTOM_VAR1
. Em Valor, informe#{variables.timeout}
. Em Tipo, escolhaPlaintext
.O valor
#{variables.timeout}
da variável de ambiente é baseado no namespace da variável em nível de pipelinevariables
e na variável em nível de pipelinetimeout
criada para o pipeline na etapa 5. -
Selecione Next (Próximo).
-
-
Na página Step 4: Add deploy stage (Etapa 4: adicionar estágio de implantação), escolha Skip deploy stage (Ignorar estágio de implantação) e aceite a mensagem de aviso ao clicar novamente em Skip (Ignorar). Selecione Next (Próximo).
-
Em Step 5: Review (Etapa 5: revisar), escolha Create pipeline (Criar pipeline).
Etapa 2: Lançar alterações e visualizar logs
-
Depois que o pipeline for executado com êxito, no estágio de criação bem-sucedido, selecione Visualizar detalhes.
Na página de detalhes, selecione a guia Logs. Veja a saída da CodeBuild compilação. Os comandos geram o valor da variável inserida.
-
No painel de navegação à esquerda, selecione Histórico.
Escolha a execução recente e, depois, selecione a guia Variáveis. Visualize o valor resolvido para a variável do pipeline.