기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

자습서: CodeBuild호스팅된 GitHub 작업 러너 구성

이 자습서에서는 GitHub 작업 작업을 실행하도록 CodeBuild 프로젝트를 구성하는 방법을 보여줍니다. GitHub 작업 사용에 대한 자세한 내용은 섹션을 CodeBuild 참조하세요자습서: CodeBuild호스팅된 GitHub 작업 러너 구성.

이 자습서를 완료하려면 먼저 다음을 수행해야 합니다.

1단계: 웹후크를 CodeBuild 사용하여 프로젝트 생성

이 단계에서는 webhook을 사용하여 CodeBuild 프로젝트를 생성하고 GitHub 콘솔에서 검토합니다. 소스 공급자로 GitHub 엔터프라이즈를 선택할 수도 있습니다. GitHub Enterprise 내에서 웹후크를 생성하는 방법에 대한 자세한 내용은 섹션을 참조하세요GitHub 수동 웹후크.

2단계: 작업 워크플로 업데이트 GitHub YAML

이 단계에서는 에서 GitHub 작업 워크플로 YAML 파일을 업데이트GitHub하여 빌드 환경을 구성하고 에서 GitHub 작업 자체 호스팅 러너를 사용합니다 CodeBuild. 자세한 내용은 자체 호스팅 러너 및 에서 레이블 사용을 참조하세요 CodeBuild호스팅된 GitHub 작업 러너에서 지원되는 레이블 재정의.

작업 워크플로 업데이트 GitHub YAML

GitHub 작업 워크플로의 runs-on 설정으로 이동하여 GitHub 업데이트YAML하여 빌드 환경을 구성합니다. 이렇게 하려면 다음 중 하나를 수행할 수 있습니다.

buildspec 명령 실행 INSTALL, PRE_ BUILD및 POST_BUILD 단계

기본적으로 는 자체 호스팅 GitHub 작업 빌드를 실행할 때 모든 buildspec 명령을 CodeBuild 무시합니다. 빌드 중에 buildspec 명령을 실행하려면 를 레이블에 접미사로 추가할 buildspec-override:true 수 있습니다.

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

이 명령을 사용하면 가 컨테이너의 기본 소스 폴더에 actions-runner 라는 폴더를 CodeBuild 생성합니다. BUILD 단계 중에 GitHub 작업 러너가 시작되면 러너가 actions-runner 디렉터리에서 실행됩니다.

자체 호스팅 GitHub 작업 빌드에서 buildspec 재정의를 사용할 때 몇 가지 제한이 있습니다.

3단계: 결과 검토

GitHub 작업 워크플로 실행이 발생할 때마다 CodeBuild 는 웹후크를 통해 워크플로 작업 이벤트를 수신합니다. 워크플로의 각 작업에 대해 는 빌드를 CodeBuild 시작하여 임시 GitHub 작업 러너를 실행합니다. 러너는 단일 워크플로 작업을 실행할 책임이 있습니다. 작업이 완료되면 러너와 관련 빌드 프로세스가 즉시 종료됩니다.

워크플로 작업 로그를 보려면 에서 리포지토리로 이동하여 작업 GitHub을 선택한 다음 원하는 워크플로를 선택한 다음 로그를 검토하려는 특정 작업을 선택합니다.

에서 자체 호스팅된 러너가 작업을 픽업할 때까지 기다리는 동안 로그에서 요청된 레이블을 검토할 수 있습니다 CodeBuild.

작업이 완료되면 작업의 로그를 볼 수 있습니다.

필터 GitHub 작업 웹후크 이벤트(AWS CloudFormation)

템플릿의 AWS CloudFormation 다음 YAML형식 부분은 빌드가 true로 평가될 때 빌드를 트리거하는 필터 그룹을 생성합니다. 다음 필터 그룹은 정규식 과 일치하는 워크플로 이름을 가진 GitHub 작업 워크플로 작업 요청을 지정합니다\[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
      FilterGroups:
        - - Type: EVENT
            Pattern: WORKFLOW_JOB_QUEUED
          - Type: WORKFLOW_NAME
            Pattern: \[CI-CodeBuild\]

필터 GitHub 작업 웹후크 이벤트(AWS CDK)

다음 AWS CDK 템플릿은 빌드가 true로 평가될 때 빌드를 트리거하는 필터 그룹을 생성합니다. 다음 필터 그룹은 GitHub 작업 워크플로 작업 요청을 지정합니다.

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

필터 GitHub 작업 웹후크 이벤트(Terraform)

다음 Terraform 템플릿은 빌드가 true로 평가될 때 빌드를 트리거하는 필터 그룹을 생성합니다. 다음 필터 그룹은 GitHub 작업 워크플로 작업 요청을 지정합니다.

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