Amostra da versão de origem com AWS CodeBuild

Esse exemplo demonstra como especificar uma versão de sua origem usando um formato diferente de um ID de confirmação (também conhecido como um SHA de confirmação). Você pode especificar a versão da sua fonte das seguintes maneiras:

• Para um provedor de origem do Amazon S3, use o ID da versão do objeto que representa o arquivo ZIP de entrada da compilação.

• Para CodeCommit Bitbucket e GitHub Enterprise Server, use um dos seguintes: GitHub

  • Solicitação pull como uma referência de solicitação pull (por exemplo, refs/pull/1/head).

  • Ramificação como um nome de ramificação.

  • ID de confirmação

  • Tag.

  • Referência e um ID de confirmação. A referência pode ser uma das seguintes:

    • Uma tag (por exemplo, refs/tags/mytagv1.0^{full-commit-SHA}).

    • Uma ramificação (por exemplo, refs/heads/mydevbranch^{full-commit-SHA}).

    • Uma solicitação pull (por exemplo, refs/pull/1/head^{full-commit-SHA}).

• Para GitLab e GitLab autogerenciado, use um dos seguintes:

  • Ramificação como um nome de ramificação.

  • ID de confirmação

  • Tag.

nota

Você pode especificar a versão de uma fonte de pull request somente se seu repositório for GitHub ou GitHub Enterprise Server.

Se você usar uma referência e um ID de confirmação para especificar uma versão, a fase DOWNLOAD_SOURCE da sua compilação será mais rápida do que se você fornecer somente a versão. Isso ocorre porque quando você adiciona uma referência, CodeBuild não é necessário baixar o repositório inteiro para encontrar o commit.

• Você pode especificar uma versão de origem com apenas um ID de confirmação, como 12345678901234567890123467890123456789. Se você fizer isso, CodeBuild deverá baixar o repositório inteiro para encontrar a versão.

• Você pode especificar uma versão de origem com uma referência e um ID de confirmação neste formato: refs/heads/branchname^{full-commit-SHA} (por exemplo, refs/heads/main^{12345678901234567890123467890123456789}). Se você fizer isso, CodeBuild baixará somente a ramificação especificada para encontrar a versão.

nota

Para acelerar a DOWNLOAD_SOURCE fase da sua compilação, você também pode definir a profundidade do clone do Git para um número baixo. CodeBuild baixa menos versões do seu repositório.

Para especificar uma versão GitHub do repositório com um ID de confirmação

1. Abra o AWS CodeBuild console em https://console.aws.amazon.com/codesuite/codebuild/home.

2. Crie um projeto de compilação. Para obter informações, consulte Criar um projeto de compilação (console) e Executar uma compilação (console). Deixe todas as configurações em seus valores padrão, exceto estas configurações:

   • Em Source (Origem):

     • Em Source provider, escolha GitHub. Se você não estiver conectado GitHub, siga as instruções para se conectar.

     • Em Repository (Repositório), escolha Public repository (Repositório público).

     • Em Repository URL (URL do repositório), insira https://github.com/aws/aws-sdk-ruby.git.

   • Em Environment (Ambiente):

     • Em Environment image (Imagem do ambiente), escolha Managed image (Imagem gerenciada).

     • Em Operating system (Sistema operacional), escolha Amazon Linux 2.

     • Em Runtime(s) (Tempos de execução), selecione Standard (Padrão).

     • Em Imagem, selecione aws/codebuild/amazonlinux2-x86_64-standard:4.0.

3. Em Build specifications (Especificações de compilação), escolha Insert build commands (Inserir comandos de compilação) e selecione Switch to editor (Alternar para editor).

4. Em Build commands (Comandos de compilação), substitua o texto de espaço reservado pelo seguinte:

   version: 0.2
   
   phases:
     install:
       runtime-versions:
         ruby: 2.6
     build:
       commands:
          - echo $CODEBUILD_RESOLVED_SOURCE_VERSION

   A seção runtime-versions é necessária quando você usa a imagem padrão do Ubuntu 2.0. Aqui, o tempo de execução da versão 2.6 do Ruby é especificado, mas você pode usar qualquer tempo de execução. O comando echo exibe a versão do código-fonte armazenada na variável de ambiente CODEBUILD_RESOLVED_SOURCE_VERSION.

5. Aceite os padrões em Build configuration (Configuração de compilação) e escolha Start build (Iniciar compilação).

6. Para Source version (Versão de origem), insira 046e8b67481d53bdc86c3f6affdd5d1afae6d369. Esse é o SHA de uma confirmação no repositório https://github.com/aws/aws-sdk-ruby.git.

7. Selecione Start build.

8. Quando a compilação for concluída, você provavelmente verá o seguinte:

   • Na guia Build logs (Logs de compilação), qual versão do projeto de origem foi usada. Aqui está um exemplo.

     [Container] Date Time Running command echo $CODEBUILD_RESOLVED_SOURCE_VERSION 
     046e8b67481d53bdc86c3f6affdd5d1afae6d369
      
     [Container] Date Time Phase complete: BUILD State: SUCCEEDED 

   • Na guia Environment variables (Variáveis de ambiente), a Resolved source version (Versão de origem resolvida) corresponde ao ID de confirmação usado para criar a compilação.

   • Na guia Phase details (Detalhes da fase), a duração da fase DOWNLOAD_SOURCE.

Essas etapas mostram como criar uma compilação usando a mesma versão da origem. Dessa vez, a versão da origem é especificada usando uma referência com o ID de confirmação.

Para especificar uma versão GitHub do repositório com um ID de confirmação e referência

1. No painel de navegação esquerdo, escolha Build projects (Projetos de compilação) e depois escolha o projeto criado anteriormente.

2. Selecione Start build.

3. Na Source version (Versão de origem), insira refs/heads/main^{046e8b67481d53bdc86c3f6affdd5d1afae6d369}. Trata-se do mesmo ID de confirmação e de uma referência para uma ramificação no formato refs/heads/branchname^{full-commit-SHA}.

4. Selecione Start build.

5. Quando a compilação for concluída, você provavelmente verá o seguinte:

   • Na guia Build logs (Logs de compilação), qual versão do projeto de origem foi usada. Aqui está um exemplo.

     [Container] Date Time Running command echo $CODEBUILD_RESOLVED_SOURCE_VERSION 
     046e8b67481d53bdc86c3f6affdd5d1afae6d369
      
     [Container] Date Time Phase complete: BUILD State: SUCCEEDED 

   • Na guia Environment variables (Variáveis de ambiente), a Resolved source version (Versão de origem resolvida) corresponde ao ID de confirmação usado para criar a compilação.

   • Na guia Phase details (Detalhes da fase), a duração da fase DOWNLOAD_SOURCE deve ser menor que a duração em que você usou apenas o ID de confirmação para especificar a versão de sua origem.