Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tutorial: Mengkonfigurasi pelari CodeBuild-hosted GitHub Actions

Tutorial ini menunjukkan cara mengonfigurasi CodeBuild proyek Anda untuk menjalankan tugas GitHub Actions. Untuk informasi selengkapnya tentang menggunakan GitHub Tindakan dengan CodeBuild lihatTutorial: Mengkonfigurasi pelari CodeBuild-hosted GitHub Actions.

Untuk menyelesaikan tutorial ini, Anda harus terlebih dahulu:

Langkah 1: Buat CodeBuild proyek dengan webhook

Pada langkah ini, Anda akan membuat CodeBuild proyek dengan webhook dan meninjaunya di GitHub konsol. Anda juga dapat memilih GitHub Enterprise sebagai penyedia sumber Anda. Untuk mempelajari selengkapnya tentang membuat webhook dalam GitHub Enterprise, lihatGitHub webhook manual.

Langkah 2: Perbarui alur kerja GitHub Tindakan YAML

Pada langkah ini, Anda akan memperbarui file YAML alur kerja Actions Anda GitHub GitHub untuk mengonfigurasi lingkungan build Anda dan menggunakan Ac GitHub tions self-host runner di. CodeBuild Untuk informasi selengkapnya, lihat Menggunakan label dengan pelari yang di-host sendiri danPenggantian label didukung dengan Ac CodeBuild-hosted GitHub tions runner.

Memperbarui alur kerja GitHub Tindakan YAML

Arahkan ke GitHub dan perbarui runs-on setelan di ALUR KERJA GitHub Tindakan YAML untuk mengonfigurasi lingkungan build Anda. Untuk melakukannya, Anda dapat melakukan salah satu hal berikut:

Jalankan perintah buildspec dalam fase INSTALL, PRE_BUILD, dan POST_BUILD

Secara default, CodeBuild mengabaikan perintah buildspec apa pun saat menjalankan build Actions yang di-host sendiri. GitHub Untuk menjalankan perintah buildspec selama build, buildspec-override:true dapat ditambahkan sebagai akhiran ke label:

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

Dengan menggunakan perintah ini, CodeBuild akan membuat folder yang disebut actions-runner di folder sumber utama container. Ketika Ac GitHub tions runner dimulai selama BUILD fase, pelari akan berjalan di actions-runner direktori.

Ada beberapa batasan saat menggunakan penggantian buildspec di build Actions yang di-host sendiri: GitHub

Langkah 3: Tinjau hasil Anda

Setiap kali al GitHub ur kerja Tindakan dijalankan, CodeBuild akan menerima peristiwa pekerjaan alur kerja melalui webhook. Untuk setiap pekerjaan dalam alur kerja, CodeBuild mulai build untuk menjalankan pelari Ac GitHub tions sementara. Pelari bertanggung jawab untuk menjalankan tugas alur kerja tunggal. Setelah pekerjaan selesai, runner dan proses build terkait akan segera dihentikan.

Untuk melihat log pekerjaan alur kerja Anda, navigasikan ke repositori Anda GitHub, pilih Tindakan, pilih alur kerja yang Anda inginkan, lalu pilih Pekerjaan tertentu yang ingin Anda tinjau lognya.

Anda dapat meninjau label yang diminta di log saat pekerjaan sedang menunggu untuk diambil oleh pelari yang dihosting sendiri. CodeBuild

Setelah pekerjaan selesai, Anda akan dapat melihat log pekerjaan.

GitHub Opsi konfigurasi pelari tindakan

Anda dapat menentukan variabel lingkungan berikut dalam konfigurasi proyek Anda untuk mengubah konfigurasi penyiapan pelari yang dihosting sendiri.

Filter T GitHub indakan acara webhook (CloudFormation)

Bagian CloudFormation template berikut YAML-formatted membuat grup filter yang memicu build ketika dievaluasi menjadi true. Grup filter berikut menentukan permintaan pekerjaan alur kerja Ac GitHub tions dengan nama alur kerja yang cocok dengan ekspresi reguler\[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\]

Filter T GitHub indakan acara webhook (AWS CDK)

AWS CDK Template berikut membuat grup filter yang memicu build saat dievaluasi menjadi true. Grup filter berikut menentukan permintaan pekerjaan al GitHub ur kerja Tindakan.

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

Filter T GitHub indakan acara webhook (Terraform)

Template Terraform berikut membuat grup filter yang memicu build saat dievaluasi menjadi true. Grup filter berikut menentukan permintaan pekerjaan al GitHub ur kerja Tindakan.

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

Filter T GitHub indakan acara webhook (AWS CLI)

Per AWS CLI intah berikut membuat proyek Ac GitHub tions runner yang di-host sendiri dengan GitHub grup filter permintaan pekerjaan alur kerja Actions yang memicu build saat dievaluasi menjadi true.

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