Usar o AWS SAM para gerar pipelines iniciais para Jenkins, GitLab CI/CD, GitHub Actions, Pipelines Bitbucket - AWS Serverless Application Model
Etapa 1: Criar recursos de infraestruturaEtapa 2: Conecte seu repositório Git ao seu sistema CI/CDEtapa 3: Criar objetos de credencialEtapa 4: Gerar a configuração do pipelineEtapa 5: Confirme a configuração do pipeline no repositório GitSaiba mais

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á.

Usar o AWS SAM para gerar pipelines iniciais para Jenkins, GitLab CI/CD, GitHub Actions, Pipelines Bitbucket

Para gerar uma configuração inicial de pipeline para Jenkins, GitLab CI/CD, GitHub Actions ou Bitbucket Pipelines, execute as seguintes tarefas nesta ordem:

  1. Criar recursos de infraestrutura

  2. Conecte seu repositório Git ao seu sistema de CI/CD

  3. Crie objetos de credencial

  4. Gere a configuração do pipeline

  5. Confirme a configuração do pipeline no repositório Git

nota

O procedimento a seguir utiliza dois comandos AWS SAM CLI, sam pipeline bootstrap e sam pipeline init. A razão pela qual existem dois comandos é lidar com o caso de uso em que os administradores (ou seja, usuários que precisam de permissão para configurar recursos de infraestrutura AWS, como usuários e funções do IAM) têm mais permissão do que os desenvolvedores (ou seja, usuários que precisam apenas de permissão para configurar pipelines individuais, mas não os recursos de infraestrutura AWS necessários).

Etapa 1: Criar recursos de infraestrutura

Os pipelines que usam AWS SAM exigem determinados recursos AWS, como um usuário e funções do IAM com as permissões necessárias, um bucket do Amazon S3 e, opcionalmente, um repositório Amazon ECR. Você deve ter um conjunto de recursos de infraestrutura para cada estágio de implantação do pipeline.

Você pode executar o seguinte comando para ajudar nesta configuração:

sam pipeline bootstrap
nota

Execute o comando anterior para cada estágio de implantação do seu pipeline.

Você deve capturar as credenciais de AWS (ID da chave e chave secreta) dos usuários do pipeline em cada estágio de implantação do seu pipeline, pois elas são necessárias para as etapas subsequentes.

Etapa 2: Conecte seu repositório Git ao seu sistema CI/CD

É necessário conectar seu repositório Git ao seu sistema de CI/CD para que o sistema de CI/CD possa acessar o código-fonte do seu aplicativo para compilações e implantações.

nota

Você pode ignorar esta etapa se estiver usando uma das combinações a seguir, porque a conexão é feita para você automaticamente:

  1. GitHub Actions com repositório GitHub

  2. GitLab CI/CD com repositório GitLab

  3. Pipelines do Bitbucket com um repositório do Bitbucket

Para conectar o repositório Git ao sistema de CI/CD, siga um destes procedimentos:

Etapa 3: Criar objetos de credencial

Cada sistema de CI/CD tem sua própria maneira de gerenciar as credenciais necessárias para que o sistema de CI/CD acesse seu repositório Git.

Para criar os objetos de credencial necessários, faça o seguinte:

  • Se você estiver usando o Jenkins, crie uma única “credencial” que armazene o ID da chave e a chave secreta. Siga as instruções no blog Como criar um pipeline do Jenkins com AWS SAM, na seção Configurar o Jenkins. Você precisará dessa “ID de credencial” para a próxima etapa.

  • Se você estiver usando o GitLab CI/CD, crie duas “variáveis protegidas”, uma para cada ID de chave e chave secreta. Siga as instruções na documentação do GitLab — você precisará de duas “chaves variáveis” para a próxima etapa.

  • Se você estiver usando o GitHub Actions, crie dois “segredos criptografados”, um para cada chave e chave secreta. Siga as instruções na documentação do GitHub – você precisará de dois “nomes secretos” para a próxima etapa.

  • Se você estiver usando o Bitbucket Pipelines, crie duas “variáveis seguras”, uma para cada ID de chave e chave secreta. Siga as instruções em Variáveis e segredos - você precisará de dois "nomes secretos" para a próxima etapa.

Etapa 4: Gerar a configuração do pipeline

Para gerar a configuração do pipeline, execute o comando a seguir. Você precisará inserir o objeto de credencial criado na etapa anterior:

sam pipeline init

Etapa 5: Confirme a configuração do pipeline no repositório Git

Esta etapa é necessária para garantir que seu sistema CI/CD esteja ciente da configuração do pipeline e será executado quando as alterações forem confirmadas.

Saiba mais

Para obter um exemplo prático de como configurar um pipeline de CI/CD usando o GitHub Actions, consulte CI/CD com GitHub no The Complete AWS SAM Workshop.