Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Tutorial: configura un CodeBuild-hosted GitHub Actions runner

Questo tutorial mostra come configurare i tuoi CodeBuild progetti per eseguire lavori GitHub Actions. Per ulteriori informazioni sull'utilizzo di GitHub Actions con, CodeBuild consultaTutorial: configura un CodeBuild-hosted GitHub Actions runner.

Per completare questo tutorial, è necessario innanzitutto:

Passaggio 1: crea un CodeBuild progetto con un webhook

In questo passaggio, creerai un CodeBuild progetto con un webhook e lo esaminerai nella GitHub console. Puoi anche scegliere GitHub Enterprise come fornitore di origine. Per saperne di più sulla creazione di un webhook in GitHub Enterprise, consultaGitHub webhook manuali.

Passaggio 2: aggiorna il tuo flusso di lavoro GitHub Actions YAML

In questo passaggio, aggiornerai il file YAML del flusso di lavoro di GitHub Actions GitHub per configurare l'ambiente di compilazione e utilizzare i runner ospitati autonomamente da GitHub Actions in. CodeBuild Per maggiori informazioni, consulta Usare le etichette con corridori ospitati autonomamente e. Le sostituzioni delle etichette sono supportate da Actions runner CodeBuild-hosted GitHub

Aggiorna il tuo flusso di lavoro GitHub Actions (YAML).

Accedi GitHub e aggiorna l'runs-onimpostazione nel tuo flusso di lavoro GitHub Actions YAML per configurare il tuo ambiente di compilazione. A tale scopo, puoi effettuare una delle seguenti operazioni:

Esegui i comandi buildspec nelle fasi INSTALL, PRE_BUILD e POST_BUILD

Per impostazione predefinita, CodeBuild ignora qualsiasi comando buildspec durante l'esecuzione di una build Actions ospitata autonomamente. GitHub Per eseguire i comandi buildspec durante la compilazione, è buildspec-override:true possibile aggiungere come suffisso all'etichetta:

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

Usando questo comando, CodeBuild creerà una cartella chiamata actions-runner nella cartella di origine principale del contenitore. Quando il runner GitHub Actions si avvia durante la BUILD fase, il runner verrà eseguito nella actions-runner directory.

Esistono diverse limitazioni quando si utilizza un override buildspec in una build Actions ospitata autonomamente: GitHub

Fase 3: Rivedi i risultati

Ogni volta che si verifica l'esecuzione di un workflow GitHub Actions, CodeBuild riceverebbe gli eventi relativi al job del workflow tramite il webhook. Per ogni processo del flusso di lavoro, CodeBuild avvia una build per eseguire un Actions runner temporaneo. GitHub Il runner è responsabile dell'esecuzione di un singolo processo del flusso di lavoro. Una volta completato il lavoro, il corridore e il processo di compilazione associato verranno immediatamente interrotti.

Per visualizzare i registri dei processi del flusso di lavoro, accedi al tuo repository in GitHub, scegli Azioni, scegli il flusso di lavoro desiderato, quindi scegli il lavoro specifico per il quale desideri esaminare i log.

Puoi rivedere le etichette richieste nel registro mentre il lavoro è in attesa di essere ritirato da un runner in hosting autonomo. CodeBuild

Una volta completato il lavoro, sarà possibile visualizzare il registro del lavoro.

GitHub Opzioni di configurazione di Actions Runner

È possibile specificare le seguenti variabili di ambiente nella configurazione del progetto per modificare la configurazione di configurazione dei runner ospitati autonomamente.

GitHub Filtra: azioni, eventi webhook (CloudFormation)

La YAML-formatted parte seguente di un CloudFormation modello crea un gruppo di filtri che attiva una build quando la valutazione è vera. Il seguente gruppo di filtri specifica una richiesta di lavoro del flusso di lavoro GitHub Actions con un nome di flusso di lavoro corrispondente all'espressione regolare. \[CI-CodeBuild\]

CodeBuildProject:
  Type: AWS::CodeBuild::Project
  Properties:
    Name: MyProject
    ServiceRole: service-role
    Artifacts:
      Type: NO_ARTIFACTS
    Environment:
      Type: LINUX_CONTAINER
      ComputeType: BUILD_GENERAL1_SMALL
      Image: aws/codebuild/standard:5.0
    Source:
      Type: GITHUB
      Location: CODEBUILD_DEFAULT_WEBHOOK_SOURCE_LOCATION
    Triggers:
      Webhook: true
      ScopeConfiguration:
        Name: organization-name
        Scope: GITHUB_ORGANIZATION
      FilterGroups:
        - - Type: EVENT
            Pattern: WORKFLOW_JOB_QUEUED
          - Type: WORKFLOW_NAME
            Pattern: \[CI-CodeBuild\]

Filtra gli GitHub eventi webhook di Actions (AWS CDK)

Il AWS CDK modello seguente crea un gruppo di filtri che attiva una build quando la valutazione è vera. Il seguente gruppo di filtri specifica una richiesta di lavoro del flusso di lavoro GitHub Actions.

import { aws_codebuild as codebuild } from 'aws-cdk-lib';
import {EventAction, FilterGroup} from "aws-cdk-lib/aws-codebuild";

const source = codebuild.Source.gitHub({
      owner: 'owner',
      repo: 'repo',
      webhook: true,
      webhookFilters: [FilterGroup.inEventOf(EventAction.WORKFLOW_JOB_QUEUED)],
    })

Filtra gli eventi webhook di GitHub Actions (Terraform)

Il seguente modello Terraform crea un gruppo di filtri che attiva una build quando risulta vera. Il seguente gruppo di filtri specifica una richiesta di lavoro del flusso di lavoro GitHub Actions.

resource "aws_codebuild_webhook" "example" {
  project_name = aws_codebuild_project.example.name
  build_type   = "BUILD"
  filter_group {
    filter {
      type    = "EVENT"
      pattern = "WORKFLOW_JOB_QUEUED"
    }
  }
}

Filtra gli GitHub eventi webhook di Actions (AWS CLI)

AWS CLI I comandi seguenti creano un progetto GitHub Actions runner ospitato autonomamente con un gruppo di filtri per le richieste di lavoro del flusso di lavoro di GitHub Actions che attiva una build quando risulta vera.

aws codebuild create-project \
--name <project name> \
--source "{\"type\":\"GITHUB\",\"location\":\"<repository location>\",\"buildspec\":\"\"}" \
--artifacts {"\"type\":\"NO_ARTIFACTS\""} \
--environment "{\"type\": \"LINUX_CONTAINER\",\"image\": \"aws/codebuild/amazonlinux-x86_64-standard:5.0\",\"computeType\": \"BUILD_GENERAL1_MEDIUM\"}" \
--service-role "<service role ARN>"

aws codebuild create-webhook \
--project-name <project name> \
--filter-groups "[[{\"type\":\"EVENT\",\"pattern\":\"WORKFLOW_JOB_QUEUED\"}]]"