Tutorial: Configurar um CodeBuild executor de GitHub ações hospedado

Conecte-se com um token de acesso pessoal, um segredo, OAuth aplicativo ou GitHub aplicativo do Secrets Manager. Se quiser se conectar a um OAuth aplicativo, você deve usar o CodeBuild console para fazer isso. Se quiser criar um token de acesso pessoal, você pode usar o CodeBuild console ou usar ImportSourceCredentials APIo. Para obter mais instruções, consulteGitHub e acesso ao GitHub Enterprise Server em CodeBuild.

Conecte-se CodeBuild à sua GitHub conta. Para fazer isso, é possível utilizar uma das seguintes opções:

Você pode especificar o nome do projeto e o ID da execução. Nesse caso, a compilação usará sua configuração de projeto existente para computação, imagem, versão da imagem e tamanho da instância. O nome do projeto é necessário para vincular as configurações AWS relacionadas do seu trabalho de GitHub ações a um CodeBuild projeto específico. Ao incluir o nome do projeto noYAML, CodeBuild é permitido invocar trabalhos com as configurações corretas do projeto. Ao fornecer o ID de execução, CodeBuild mapeará sua compilação para execuções de fluxo de trabalho específicas e interromperá a compilação quando a execução do fluxo de trabalho for cancelada. Para obter mais informações, consulte githubcontexto.

runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}

Veja a seguir um exemplo de um fluxo de trabalho de GitHub açõesYAML:

name: Hello World
on: [push]
jobs:
  Hello-World-Job:
    runs-on: codebuild-myProject-${{ github.run_id }}-${{ github.run_attempt }}
    steps:
      - run: echo "Hello World!"

Você também pode substituir sua imagem e o tipo de computação no rótulo. Consulte Imagens de computação compatíveis com o executor CodeBuild de ações hospedado GitHub para obter uma lista das imagens disponíveis. O tipo de computação e a imagem no rótulo substituirão as configurações do ambiente em seu projeto. Para substituir suas configurações de ambiente para uma compilação EC2 computacional da Amazon, use a seguinte sintaxe:

runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-<image>-<image-version>-<instance-size>

Para substituir suas configurações de ambiente para uma compilação de computação Lambda, use a seguinte sintaxe:

runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-<environment-type>-<runtime-version>-<instance-size>

Veja a seguir um exemplo de um fluxo de trabalho de GitHub açõesYAML:

name: Hello World
on: [push]
jobs:
  Hello-World-Job:
    runs-on: codebuild-myProject-${{ github.run_id }}-${{ github.run_attempt }}-arm-3.0-small
    steps:
      - run: echo "Hello World!"

Você pode substituir a frota usada para sua construção na etiqueta. Isso substituirá as configurações de frota definidas em seu projeto para usar a frota especificada. Para obter mais informações, consulte O Run se baseia em frotas de capacidade reservada. Para substituir as configurações da sua frota para uma compilação EC2 computacional da Amazon, use a seguinte sintaxe:

runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-fleet-<fleet-name>

Para substituir a frota e a imagem usadas para a construção, use a seguinte sintaxe:

runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-<image>-<image-version>-fleet-<fleet-name>

Veja a seguir um exemplo de um fluxo de trabalho de GitHub açõesYAML:

name: Hello World
on: [push]
jobs:
  Hello-World-Job:
    runs-on: codebuild-myProject-${{ github.run_id }}-${{ github.run_attempt }}-arm-3.0-fleet-myFleet
    steps:
      - run: echo "Hello World!"

Opcionalmente, você pode fornecer uma substituição do tamanho da instância sem substituir a imagem. Para EC2 compilações da Amazon, você pode excluir a imagem e a versão da imagem. Para compilações do Lambda, você pode excluir o tipo de ambiente e a versão do tempo de execução.

CodeBuild não executará comandos buildspec durante a BUILD fase, pois o executor auto-hospedado é executado na fase. BUILD

CodeBuild não baixará nenhuma fonte primária ou secundária durante a DOWNLOAD_SOURCE fase. Se você tiver um arquivo buildspec configurado, somente esse arquivo será baixado da fonte primária do projeto.

Se um comando de compilação falhar na INSTALL fase PRE_BUILD ou, o executor auto-hospedado não CodeBuild será iniciado e o trabalho do fluxo de trabalho de GitHub ações precisará ser cancelado manualmente.

CodeBuild busca o token do executor durante a DOWNLOAD_SOURCE fase, que tem um tempo de expiração de uma hora. Se suas INSTALL fases PRE_BUILD ou fases excederem uma hora, o token do corredor poderá expirar antes do início do corredor GitHub auto-hospedado.