GitHub Actions 빌더 구성하기

GitHub Actions 빌더 구성하기 (Configuring your GitHub Actions builder)

Setup Buildx Action을 사용할 때 BuildKit 인스턴스를 구성하는 방법을 다뤄요.

출처: 문서

본문

버전 고정 (Version pinning)

기본적으로 액션은 GitHub Runner(빌드 클라이언트)에서 사용 가능한 최신 Buildx 버전과 최신 BuildKit(빌드 서버) 릴리스를 사용하려고 해요.

version 입력으로 Buildx 버전을 고정할 수 있어요. 예를 들어 Buildx v0.10.0으로 고정하려면:

- name: Set up Docker Buildx
  uses: docker/setup-buildx-action@v4
  with:
    version: v0.10.0

driver-opts의 image 입력으로 BuildKit 버전을 고정할 수 있어요. 예를 들어 BuildKit v0.11.0으로 고정하려면:

- name: Set up Docker Buildx
  uses: docker/setup-buildx-action@v4
  with:
    driver-opts: image=moby/buildkit:v0.11.0

BuildKit 컨테이너 로그 (BuildKit container logs)

Docker Setup Buildx 액션의 buildkitd-flags로 buildkitd 플래그를 전달할 수 있어요. 예를 들어 디버그 로그를 켜려면:

name: ci

on:
  push:

jobs:
  buildx:
    runs-on: ubuntu-latest
    steps:
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v4
        with:
          buildkitd-flags: --debug
      
      - name: Build
        uses: docker/build-push-action@v7

로그는 job이 끝날 때 확인할 수 있어요.

BuildKit 데몬 구성 (BuildKit Daemon configuration)

config 입력으로 BuildKit 데몬 구성 파일을 넘겨줄 수 있어요. 예를 들어:

레지스트리 미러 (Registry mirror)

config 입력에 buildkitd.toml 내용을 포함해 레지스트리 미러를 구성할 수 있어요. 자세한 내용은 BuildKit 구성 문서를 참고해요.

GitHub Actions 빌더 구성하기