Cloud Build 출시 채널

이 문서에서는 빌드 작업자가 기본 운영체제 및 Docker의 새 버전으로 업데이트되는 빈도를 제어하는 방법을 설명합니다. 출시 채널을 선택하면 복원력 있는 빌드 프로세스와 최신 보안 및 기능 간의 균형을 유지할 수 있습니다.

채널 대신 특정 작업자 버전을 선택할 수도 있습니다.

사용 가능한 채널

사용 가능한 출시 채널은 다음과 같습니다.

채널 업데이트 빈도 용도
regular 각 버전을 사용할 수 있게 된 후 4주 이내

기본 채널이자 보안 규정 준수에 권장되는 채널입니다. 잦은 업데이트를 위해서는 CI 프로세스를 새 버전으로 최신 상태로 유지해야 합니다.

rapid 항상 사용 가능한 최신 버전 최신 보안 업데이트와 기능을 사용할 수 있게 되는 즉시 이용하세요. 새 기본 OS 및 Docker 버전은 CI 프로세스를 중단하고 다른 문제를 일으킬 수 있습니다.
stable 1년에 한 번(일반적으로 2월) 이 채널은 새로운 기능보다 안정성을 우선시하므로 CI 프로세스의 복원력을 높일 수 있습니다. 하지만 취약점에 노출될 위험이 더 높습니다. 기본 Docker 버전이 Docker로부터 패치를 받지 못할 수 있습니다.

사용 가능한 버전을 참고하여 각 채널에 어떤 버전이 있는지 확인하세요.

출시 채널 또는 버전 지정

세 가지 출시 채널 중 하나를 선택하면 Docker 버전과 작업자 이미지 운영체제를 업데이트하는 빈도를 선택하는 것입니다. 출시 버전을 선택하면 작업자 이미지의 Docker 및 Debian의 특정 버전이 선택됩니다.

채널 또는 출시 버전을 지정할 수 있습니다. 다음 세 곳에서 지정할 수 있습니다.

  • 비공개 풀

    비공개 풀을 사용하는 경우 비공개 풀 구성을 업데이트하거나 Google Cloud 콘솔에서 풀을 만들거나 업데이트할 때 채널 또는 버전을 선택하여 비공개 풀에서 채널 또는 출시 버전을 지정할 수 있습니다. 이렇게 하면 해당 풀을 사용하는 모든 빌드에 해당 채널 또는 버전이 사용되며 빌드 구성이나 명령줄에서 이를 재정의할 수 없습니다.

  • 빌드 구성

    기본 풀을 사용하는 경우 빌드 구성 파일에서 채널이나 버전을 지정할 수 있습니다. 그러면 해당 채널 또는 버전이 해당 빌드 구성을 사용하여 호출된 모든 빌드에 사용됩니다.

  • 빌드를 호출할 때 명령줄에서

    gcloud builds submit를 사용하여 빌드를 호출할 때 --worker-release 플래그를 포함할 수 있습니다. 이 플래그에 제공하는 값은 빌드 구성 파일에 구성한 값을 재정의합니다. 풀에서 사용할 버전을 결정하므로 비공개 풀에서 빌드를 실행하는 경우 이 플래그를 사용할 수 없습니다.

비공개 풀

비공개 풀의 출시 버전 또는 채널을 지정하려면 다음 단계를 따르세요.

다음 명령어를 사용하여 비공개 풀 구성을 업데이트합니다.

gcloud builds worker-pools update PRIVATEPOOL_ID \
       --worker-release=CHANNEL_OR_VERSION \
       --region=REGION \
       --project=PROJECT_ID

다음을 바꿉니다.

이 채널을 사용하여 빌드를 실행하는 데 사용할 비공개 풀의 ID가 포함된 PRIVATEPOOL_ID

CHANNEL_OR_VERSION을 사용할 채널의 이름(regular, rapid 또는 stable) 또는 특정 버전 번호로 바꿉니다.

REGION을 비공개 풀이 있는 리전으로 바꿉니다.

PROJECT_ID을 비공개 풀이 포함된 프로젝트의 ID로 바꿉니다.

빌드 구성

빌드 구성 파일에서 출시 버전 또는 채널을 지정하려면 다음을 따르세요.

options 스탠자 아래에 다음 속성을 추가합니다.

steps:
  # ...
options:
  workerRelease: CHANNEL_OR_VERSION

CHANNEL_OR_VERSION을 사용할 채널의 이름(regular, rapid, stable) 또는 특정 버전 번호로 바꿉니다.

빌드 호출

빌드 호출에서 출시 채널을 지정하려면 다음을 실행하세요.

gcloud builds submit 명령어에 다음 플래그를 추가합니다.

--worker-release=CHANNEL_OR_VERSION

CHANNEL_OR_VERSION을 사용할 채널(regular, rapid, stable)의 이름이나 특정 버전 번호로 바꿉니다.

사용 가능한 버전

다음 표에는 사용 가능한 작업자 버전, 각 버전을 지원하는 채널, 각 버전의 기본 Docker 및 Debian 버전이 나와 있습니다.

출시 버전 채널 지원 만료일 기본 버전
2026.09 rapid, regular, stable 2029-09-30 Docker Engine 29
Debian 13
legacy 2028-03-31 Docker Engine 20.10
Debian 11

다음 단계