Skaffold 버전 관리

Cloud Deploy는 Skaffold를 사용하고 Cloud Build를 통해 매니페스트를 렌더링 및 배포하여 애플리케이션을 배포합니다.

이 페이지에서는 Cloud Deploy에서 사용할 Skaffold 버전을 선택하는 방법을 설명합니다. 이 페이지에는 다음에 대한 정보도 포함되어 있습니다.

Cloud Deploy에서 사용되는 Skaffold 버전은 무엇인가요?

Cloud Deploy는 Skaffold LTS 버전이 포함된 맞춤 이미지를 사용하여 작업을 실행합니다. 지원되는 각 Skaffold 버전은 모든 Cloud Deploy 이미지 저장소 링크가 걸린 이 문서의 표에 나열되어 있습니다. 각 Cloud Deploy 이미지의 버전 번호가 Skaffold 버전 번호에 해당합니다.

2022년 8월 30일 이전에는 Cloud Deploy에서 가장 최근에 일반에 공개된 Skaffold 이미지의 LTS 버전을 사용했습니다.

지원되는 버전

Skaffold 버전 최대 스키마 버전 기준 날짜 기본값 여부
2.13.x(출시 노트) v4beta11 2024년 8월 1일 ✓
2.11.x(출시 노트) v4beta10 2024년 5월 6일
2.10.x(출시 노트) v4beta9 2024년 2월 2일
2.8.x(출시 노트) v4beta7 2023년 10월 27일

이 표의 각 버전은 Artifact Registry의 저장소에 연결됩니다. 해당 저장소에서 최신 버전 또는 원하는 버전의 최신 날짜를 찾습니다. 연결된 저장소는 us-central1 리전에 있지만 이러한 이미지는 Cloud Deploy를 사용할 수 있는 각 리전에서 사용할 수 있습니다. 사용되는 이미지는 배포 파이프라인이 생성된 리전에 있습니다.

Cloud Deploy는 지원되는 각 Skaffold 버전에 최신 패치 버전을 사용합니다. 출시 노트를 통해 특정 Skaffold 버전 패치를 포함한 새 버전에 대한 지원을 발표합니다.

미리보기 버전

미리보기 기능이 포함된 Cloud Deploy 미리보기 이미지를 사용할 수 있습니다.

미리보기 이미지의 Skaffold 버전은 언제든지 업데이트할 수 있으며 정기 출시 일정을 따르지 않습니다. 프로덕션 워크로드에는 미리보기 버전을 사용하지 않는 것이 좋습니다.

미리보기 버전은 지원되는 버전과 동일한 저장소에 있습니다. skaffold_preview로 시작하는 태그가 있는 이미지를 찾습니다.

일부 미리보기 기능에는 Cloud Deploy 미리보기 이미지가 필요합니다. 이러한 기능을 위해 Cloud Deploy는 사용자가 별도의 조치를 취하지 않아도 미리보기 버전을 사용합니다. 미리보기 기능을 사용하여 출시 버전을 만들 때 다른 Skaffold 버전을 선택하려고 하면 명령어가 실패합니다.

출시 버전과 연결된 Skaffold 버전 찾기

다음 명령어를 실행해서 특정 시점에 Cloud Deploy에 사용되는 버전을 찾을 수 있습니다.

gcloud deploy releases describe RELEASE \
       --delivery-pipeline=DELIVERY_PIPELINE \
       --region=REGION

버전은 출력에서 skaffoldVersion 속성에 표시됩니다.

사용할 Skaffold 버전 선택

지원되는 모든 Skaffold 버전을 사용할 수 있습니다. 사용할 버전을 선택하려면 gcloud deploy releases create 명령어에 --skaffold-version 플래그를 포함합니다.

gcloud deploy releases create RELEASE_NAME \
       --delivery-pipeline=PIPELINE_NAME \
       --skaffold-version=SKAFFOLD_VERSION \
       --region=REGION

여기서 'SKAFFOLD_VERSION'은 이 출시 버전에 사용할 Skaffold의 (지원되는) 버전입니다. 이 버전에서는 번호가 지정된 버전의 경우 n.nn 형식을 사용하고 미리보기 버전을 사용하려면 skaffold_preview 형식이어야 합니다.

예를 들어 다음 명령어는 Skaffold 버전 2.8를 선택합니다.

gcloud deploy releases create release-001 \
                              --delivery-pipeline=my-pipeline \
                              --skaffold-version=2.8 \
                              --region=us-central1

다음 명령어는 Skaffold 미리보기 버전을 선택합니다.

gcloud deploy releases create release-001 \
                       --delivery-pipeline=my-pipeline \
                       --skaffold-version=skaffold_preview \
                       --region=us-central1

Cloud Deploy의 새 버전 선택 방법

Skaffold의 새 버전은 90일 마다 선택됩니다. 90일 주기가 끝나면 Google Cloud가 새 Skaffold 버전에 대한 지원을 추가합니다. 이제 Cloud Deploy에서 이 버전을 사용할 수 있습니다. 다음 90일 주기 동안 모든 출시를 만들고 관리하는 데 사용되는 기본 버전이 됩니다.

Cloud Deploy 출시 노트가 업데이트되어 새로 지원되는 각 출시 버전이 표시됩니다.

Skaffold 버전 지원 중단 및 유지보수 정책

Skaffold 버전은 12개월 동안 지원되고 60일 유지보수 기간이 포함됩니다. 이러한 유지보수 기간에 따라 특정 버전에 연결된 출시 버전은 해당 버전이 만료된 후에도 60일 동안 계속 지원됩니다. 이러한 출시 버전으로부터 출시를 계속 만들 수 있지만 유지보수 기간에 있는 Skaffold 버전을 사용하여 출시 버전을 만들 수는 없습니다.

60일 유지보수 기간이 지나면 Skaffold 버전이 더 이상 지원되지 않습니다. 지원되지 않는 버전을 사용하는 출시 버전에서는 더 이상 출시를 만들 수 없습니다. 하지만 출시 버전과 연결된 모든 데이터가 보존됩니다.

Skaffold 버전 기준 날짜 유지보수 시작 만료
2.13.x(출시 노트) 2024년 8월 1일 2025년 8월 14일 2025년 10월 13일
2.11.x(출시 노트) 2024년 5월 6일 2025년 5월 6일 2025년 7월 5일
2.10.x(출시 노트) 2024년 2월 2일 2025년 2월 2일 2025년 4월 3일
2.8.x(출시 노트) 2023년 10월 26일 2024년 10월 26일 2024년 12월 25일

다음 단계