자동 배포 설정

Google Kubernetes Engine(GKE)에서 워크로드의 자동 배포를 구성할 수 있습니다.

이 페이지에서는 워크로드에 간단한 지속적 통합/지속적 배포(CI/CD) 파이프라인을 설정하는 방법을 설명합니다. 저장소에 변경사항을 푸시하면 Cloud Build가 GKE 클러스터에 자동으로 컨테이너를 빌드하고 배포합니다.

자동 배포 작동 방식

GKE에서 단일 컨테이너 이미지를 참조하는 워크로드가 있는 경우 자동 배포를 구성하여 코드 변경사항이 저장소에 체크인될 때마다 애플리케이션을 다시 빌드하고 배포할 수 있습니다.

자동 배포의 경우 워크로드를 YAML 파일로 정의하고 이 YAML 파일을 저장소에 저장합니다(권장사항과 일치). GKE는 이 용도로 사용할 수 있는 YAML을 생성합니다.

YAML 파일 사용을 위한 다음과 같은 두 가지 옵션이 있습니다.

  • 워크로드를 정의하는 YAML 파일이 아직 없으면 생성된 YAML 파일을 사용할 수 있습니다. 저장소에 YAML 파일을 저장합니다. Cloud Build는 매번 이를 사용하여 워크로드를 배포합니다.

  • 워크로드를 정의하는 YAML 파일이 이미 있으면 GKE가 저장소에서 해당 위치를 가리키도록 할 수 있습니다. 저장소의 YAML 파일을 권장 YAML 파일과 비교하여 올바른 워크로드를 올바른 방식으로 배포하는지 확인할 수 있습니다.

시작하기 전에

시작하기 전에 다음 태스크를 수행했는지 확인합니다.

  • Google Kubernetes Engine API를 사용 설정합니다.
    • Google Kubernetes Engine API 사용 설정
  • 이 태스크에 Google Cloud CLI를 사용하려면 gcloud CLI를 설치한 후 초기화합니다. 이전에 gcloud CLI를 설치한 경우 gcloud components update를 실행하여 최신 버전을 가져옵니다.

요구사항

자동 배포의 요구사항은 다음과 같습니다.

  • 단일 컨테이너 이미지를 지정하는 Deployment 유형의 워크로드에만 자동 배포를 사용할 수 있습니다. 멀티 컨테이너 워크로드와 기타 워크로드 유형(예: ReplicaSet)는 지원되지 않습니다.

  • 이미지를 빌드하려면 소스 코드 저장소에 Dockerfile이 있어야 합니다.

    다음 제품 중 하나에서 이 저장소를 호스팅할 수 있습니다.

    GitHub 또는 Bitbucket을 사용하는 경우 저장소에 대한 Google Cloud 액세스 권한을 부여해야 합니다.

  • GKE 클러스터와 동일한 Google Cloud 프로젝트의 Artifact Registry에 컨테이너 이미지를 저장합니다. Artifact Registry에 이미지가 있어야 하며, GKE에 워크로드가 있으려면 이미지를 최소 1회 이상 배포했어야 합니다.

자동 배포 만들기

자동 배포를 만들려면 다음 단계를 수행하세요.

  1. Google Cloud Console에서 워크로드 페이지로 이동합니다.

    워크로드로 이동

  2. 워크로드 목록에서 수정하려는 배포의 이름을 클릭합니다.

  3. 작업 > 자동 배포를 클릭합니다.

배포 자동화 창에서 다음 단계를 수행합니다.

  1. 소스 저장소에서 소스 코드 저장소를 선택합니다.

    1. 저장소 제공업체 드롭다운 목록에서 저장소 제공업체를 선택합니다.

      자동 배포는 다음 소스 제어 호스트를 지원합니다.

      • Cloud Source Repositories
      • GitHub

      • Bitbucket

        GitHub 또는 Bitbucket을 사용하는 경우 사용자 이름과 비밀번호로 인증합니다.

    2. 저장소 드롭다운 목록에서 배포의 소스 코드가 포함된 저장소의 이름을 선택합니다.

    3. 계속을 클릭합니다.

  2. 빌드 구성에서 빌드 구성 정보를 지정합니다.

    1. 빌드할 분기의 이름 또는 분기와 일치하는 정규 표현식(RegExp2)을 입력합니다. 기본 분기는 master입니다. 이 분기로 푸시하면 Cloud Build가 애플리케이션을 빌드합니다.
    2. Dockerfile 디렉터리의 상대 경로를 입력합니다.

    3. Dockerfile 이름을 입력합니다.

    4. 계속을 클릭합니다.

  3. 자동 배포 구성에 구성 YAML 파일 위치를 제공합니다.

    시스템에서 저장소에서 YAML 파일을 채우는 데 사용할 수 있는 YAML 파일을 자동으로 생성합니다.

    1. Google 권장 YAML 보기를 클릭하여 생성된 YAML 파일을 확인합니다.

    2. 생성된 YAML 파일을 자체 YAML(있는 경우)과 비교하고 생성된 YAML을 기준으로 자체 YAML을 업데이트합니다.

      그렇지 않으면 새 파일을 만들어 생성된 YAML로 채웁니다. 이렇게 하면 배포되는 워크로드가 현재 실행 중인 워크로드와 일치하는지 확인할 수 있습니다. 파일 이름에는 제한이 없지만 .yaml 또는 .yml 확장자가 있어야 합니다.

    3. YAML 파일이 포함된 디렉터리의 상대 경로를 지정합니다.

      지정된 디렉터리에 YAML 파일이 두 개 이상 있으면 GKE는 이들 파일을 모두 사용합니다.

  4. 설정을 클릭하여 자동 배포 구성을 완료합니다.

    Cloud Build 서비스 계정에 권한을 부여하라는 메시지가 표시될 수 있습니다. 이 권한은 필수 항목입니다.

다음 단계

선택한 워크로드에 자동 배포를 설정하면 컨테이너 이미지를 저장소의 선택된 분기로 푸시한 후 빌드하는 Cloud Build 트리거를 가지게 됩니다. 또한 Cloud Build는 원래 이미지가 배포된 클러스터에 새 버전의 워크로드를 배포합니다.

워크로드에 대한 자세한 내용은 배포 세부정보 페이지(업데이트 기록 탭)를 참조하세요.