Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Tutorial: Konfigurieren Sie einen CodeBuild-hosted GitHub Actions-Runner

Dieses Tutorial zeigt Ihnen, wie Sie Ihre CodeBuild Projekte für die Ausführung von GitHub Actions-Jobs konfigurieren. Weitere Informationen zur Verwendung von GitHub Actions mit CodeBuild finden Sie unterTutorial: Konfigurieren Sie einen CodeBuild-hosted GitHub Actions-Runner.

Um dieses Tutorial abzuschließen, müssen Sie zunächst:

Schritt 1: Erstellen Sie ein CodeBuild Projekt mit einem Webhook

In diesem Schritt erstellen Sie ein CodeBuild Projekt mit einem Webhook und überprüfen es in der GitHub Konsole. Sie können GitHub Enterprise auch als Ihren Quellanbieter wählen. Weitere Informationen zum Erstellen eines Webhooks in GitHub Enterprise finden Sie unterGitHub manuelle Webhooks.

Schritt 2: Aktualisieren Sie Ihren GitHub Aktionsworkflow YAML

In diesem Schritt aktualisieren Sie Ihre YAML-Datei für den GitHub Aktionsworkflow, um Ihre Build-Umgebung GitHub zu konfigurieren und selbst gehostete GitHub Actions-Runner in zu verwenden. CodeBuild Weitere Informationen finden Sie unter Verwenden von Labels mit selbst gehosteten Runnern und. Labelüberschreibungen werden vom Actions-Runner unterstützt CodeBuild-hosted GitHub

Aktualisieren Sie Ihren GitHub Aktionsworkflow (YAML).

Navigieren Sie zu Ihrem GitHub Aktionsworkflow YAML GitHub und aktualisieren Sie die runs-on Einstellung, um Ihre Build-Umgebung zu konfigurieren. Dazu können Sie einen der folgenden Schritte ausführen:

Führen Sie die Buildspec-Befehle in den Phasen INSTALL, PRE_BUILD und POST_BUILD aus

CodeBuild Ignoriert standardmäßig alle Buildspec-Befehle, wenn ein selbst gehosteter Actions-Build ausgeführt wird. GitHub Um Buildspec-Befehle während des Builds auszuführen, buildspec-override:true können sie dem Label als Suffix hinzugefügt werden:

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

Mit diesem Befehl CodeBuild wird ein Ordner mit dem Namen actions-runner im primären Quellordner des Containers erstellt. Wenn der GitHub Actions-Runner während der BUILD Phase startet, wird der Runner im actions-runner Verzeichnis ausgeführt.

Bei der Verwendung einer Buildspec-Override in einem selbst GitHub gehosteten Actions-Build gibt es mehrere Einschränkungen:

Schritt 3: Überprüfe deine Ergebnisse

Jedes Mal, wenn ein GitHub Aktionsworkflow ausgeführt wird, CodeBuild werden die Workflow-Auftragsereignisse über den Webhook empfangen. CodeBuild Startet für jeden Job im Workflow einen Build, um einen kurzlebigen GitHub Actions-Runner auszuführen. Der Runner ist für die Ausführung eines einzelnen Workflow-Jobs verantwortlich. Sobald der Job abgeschlossen ist, werden der Runner und der zugehörige Build-Prozess sofort beendet.

Um deine Workflow-Jobprotokolle einzusehen, navigiere zu deinem Repository in GitHub, wähle Aktionen, wähle den gewünschten Workflow und wähle dann den spezifischen Job aus, für den du die Logs überprüfen möchtest.

Du kannst die angeforderten Labels im Log überprüfen, während der Job darauf wartet, von einem selbst gehosteten Runner abgeholt zu werden. CodeBuild

Sobald der Job abgeschlossen ist, können Sie das Protokoll des Jobs einsehen.

GitHub Konfigurationsoptionen für den Actions Runner

Du kannst die folgenden Umgebungsvariablen in deiner Projektkonfiguration angeben, um die Setup-Konfiguration deiner selbst gehosteten Läufer zu ändern.

Webhook-Ereignisse für GitHub Aktionen filtern (CloudFormation)

Im folgenden YAML-formatted Teil einer CloudFormation Vorlage wird eine Filtergruppe erstellt, die einen Build auslöst, wenn das Ergebnis „Wahr“ ergibt. Die folgende Filtergruppe spezifiziert eine Workflow-Jobanforderung für GitHub Aktionen mit einem Workflownamen, der dem regulären Ausdruck \[CI-CodeBuild\] entspricht.

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\]

GitHub Webhook-Ereignisse filtern (AWS CDK)

Die folgende AWS CDK Vorlage erstellt eine Filtergruppe, die einen Build auslöst, wenn das Ergebnis „Wahr“ ergibt. Die folgende Filtergruppe spezifiziert eine Workflow-Jobanfrage für GitHub Aktionen.

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)],
    })

Webhook-Ereignisse für GitHub Aktionen filtern (Terraform)

Die folgende Terraform-Vorlage erstellt eine Filtergruppe, die einen Build auslöst, wenn sie als wahr ausgewertet wird. Die folgende Filtergruppe spezifiziert eine Workflow-Jobanfrage für GitHub Aktionen.

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

Webhook-Ereignisse für GitHub Aktionen filtern (AWS CLI)

Mit den folgenden AWS CLI Befehlen wird ein selbst gehostetes GitHub Actions Runner-Projekt mit einer Jobanforderungsfiltergruppe für den GitHub Aktionsworkflow erstellt, die einen Build auslöst, wenn die Auswertung den Wert „Wahr“ ergibt.

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\"}]]"