Execute a solicitação GitHub pull e a amostra do filtro de webhook para CodeBuild - AWS CodeBuild

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

Execute a solicitação GitHub pull e a amostra do filtro de webhook para CodeBuild

AWS CodeBuild suporta webhooks quando o repositório de origem está. GitHub Isso significa que, para um projeto de CodeBuild compilação que tem seu código-fonte armazenado em um GitHub repositório, os webhooks podem ser usados para reconstruir o código-fonte toda vez que uma alteração de código é enviada para o repositório. Para obter CodeBuild amostras, consulte AWS CodeBuild Amostras.

nota

Ao usar webhooks, é possível que um usuário acione uma compilação inesperada. Para atenuar esse risco, consulte Práticas recomendadas para usar webhooks.

Etapa 1: criar um projeto de compilação com GitHub webhooks e ativá-los

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

  2. Se uma página de CodeBuild informações for exibida, escolha Criar projeto de construção. Caso contrário, no painel de navegação, expanda Compilar, escolha Projetos de compilação e, depois, Criar projeto de compilação.

  3. Selecione Create build project (Criar projeto de compilação).

  4. Em Configuração de projetos:

    Nome do projeto

    Insira um nome para esse projeto de compilação. Os nomes dos projetos de criação devem ser exclusivos em cada AWS conta. Também é possível incluir uma descrição opcional do projeto de compilação para ajudar outros usuários a entender para que esse projeto é usado.

  5. Em Source (Origem):

    Provedor de origem

    Escolha GitHub. Siga as instruções para se conectar (ou reconectar) GitHub e escolha Autorizar.

    Repositório

    Escolha Repositório em minha GitHub conta.

    GitHub repositório

    Insira o URL para o seu GitHub repositório.

  6. Em Eventos de webhook da origem principal, selecione o seguinte.

    nota

    A seção Eventos de webhook de origem primária só estará visível se você escolher Repositório em minha GitHub conta na etapa anterior.

    1. Selecione Rebuild every time a code change is pushed to this repository (Recompilar toda vez que uma alteração de código for enviada para este repositório) ao criar seu projeto.

    2. Em Event type (Tipo de evento), escolha um ou mais eventos.

    3. Para filtrar quando um evento aciona uma compilação, em Start a build under these conditions (Iniciar uma compilação sob estas condições), adicione um ou mais filtros opcionais.

    4. Para filtrar quando um evento não é acionado, em Don't start a build under these conditions (Não iniciar uma compilação sob estas condições), adicione um ou mais filtros opcionais.

    5. Escolha Adicionar grupo de filtros para adicionar outro grupo de filtros, se necessário.

    Para obter mais informações sobre filtros e tipos de eventos de GitHub webhook, consulteGitHub eventos de webhook.

  7. Em Environment (Ambiente):

    Imagem do ambiente

    Escolha uma das seguintes opções:

    Para usar uma imagem do Docker gerenciada por: AWS CodeBuild

    Selecione Imagem gerenciada e, depois, faça as seleções em Sistema operacional, Runtime(s), Imagem e Versão da imagem. Faça uma seleção em Environment type (Tipo de ambiente) se estiver disponível.

    Para usar outra imagem do Docker:

    Selecione Imagem personalizada. Em Tipo de ambiente ARM, escolha LinuxGPU, Linux ou Windows. Se você escolher Outro registro, em Registro externo URL, insira o nome e a tag da imagem do Docker no Docker Hub, usando o formato. docker repository/docker image name Se você escolher a Amazon ECR, use o ECRrepositório da Amazon e a ECRimagem da Amazon para escolher a imagem do Docker em sua AWS conta.

    Para usar uma imagem privada do Docker:

    Selecione Imagem personalizada. Em Tipo de ambiente ARM, escolha LinuxGPU, Linux ou Windows. Em Registro de imagem, escolha Outro registro e, em seguida, insira as credenciais ARN da sua imagem privada do Docker. As credenciais devem ser criadas pelo Secrets Manager. Para obter mais informações, consulte O que é AWS Secrets Manager? no Guia do AWS Secrets Manager usuário.

    Perfil de serviço

    Escolha uma das seguintes opções:

    • Se você não tiver uma função CodeBuild de serviço, escolha Nova função de serviço. No campo Role name, digite o nome da nova função.

    • Se você tiver uma função CodeBuild de serviço, escolha Função de serviço existente. Em Função ARN, escolha a função de serviço.

    nota

    Ao usar o console para criar ou atualizar um projeto de compilação, você pode criar uma função de CodeBuild serviço ao mesmo tempo. Por padrão, a função funciona somente com esse projeto de build. Se você usar o console para associar essa função de serviço a outro projeto de compilação, a função será atualizada para funcionar com os outros projetos de compilação. Uma função de serviço pode funcionar com até 10 projetos de compilação.

  8. Em Buildspec, siga um destes procedimentos:

    • Escolha Usar um arquivo buildspec para usar o arquivo buildspec.yml no diretório raiz do código-fonte.

    • Selecione Inserir comandos de compilação para usar o console para inserir comandos de compilação.

    Para obter mais informações, consulte Referência de buildspec.

  9. Em Artefatos:

    Tipo

    Escolha uma das seguintes opções:

    • Se você não quiser criar artefatos de saída de compilação, selecione No artifacts (Nenhum artefato).

    • Para armazenar a saída de compilação em um bucket do S3, escolha Amazon S3 e faça o seguinte:

      • Se você quiser usar o nome do seu projeto para o ZIP arquivo ou pasta de saída da compilação, deixe Nome em branco. Caso contrário, insira o nome. Por padrão, o nome do artefato é o nome do projeto. Se você quiser usar um nome diferente, insira-o na caixa de nome do artefato. Se você quiser gerar um ZIP arquivo, inclua a extensão zip.

      • Para Bucket name, selecione o nome do bucket de saída.

      • Se você escolheu Inserir comandos de compilação anteriormente neste procedimento, em Arquivos de saída, insira os locais dos arquivos da compilação que você deseja colocar no ZIP arquivo ou pasta de saída da compilação. Para vários locais, separe-os com uma vírgula (por exemplo, appspec.yml, target/my-app.jar). Para obter mais informações, consulte a descrição de files em Sintaxe de buildspec.

    Configuração adicional

    Expanda Additional configuration (Configuração adicional) e defina as opções conforme apropriado.

  10. Selecione Create build project (Criar projeto de compilação). Na página Review (Revisão), escolha Start build (Iniciar compilação) para executar a compilação.

Etapa 2: verifique se os webhooks estão habilitados

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

  2. No painel de navegação, selecione Build projects.

  3. Execute um destes procedimentos:

    • Selecione o link do projeto de compilação com webhooks que você deseja verificar e selecione Detalhes da compilação.

    • Selecione o botão ao lado do projeto de compilação com webhooks que você deseja verificar, selecione Visualizar detalhes e, depois, Detalhes da compilação.

  4. Em Eventos de webhook de origem primária, escolha o link WebhookURL.

  5. No seu GitHub repositório, na página Configurações, em Webhooks, verifique se Pull Requests e Pushes estão selecionados.

  6. Nas configurações GitHub do seu perfil, em Configurações pessoais, Aplicativos, OAuthAplicativos autorizados, você deve ver que seu aplicativo foi autorizado a acessar a AWS região selecionada.