블루-그린 배포 전환 실행

그린 환경을 테스트하고 검증한 후 전환을 시작하여 그린 환경을 새 프로덕션 읽기 및 쓰기 환경으로 변환합니다.

시작하기 전에

전환을 시작하기 전에 필요한 권한이 있고 배포가 전환 준비가 되었는지 확인합니다.

필수 역할 및 권한

전환을 실행하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

  • Cloud SQL 관리자(roles/cloudsql.admin)

맞춤 역할의 경우 다음 권한이 있는지 확인합니다.

  • cloudsql.blueGreenDeployments.switchover
  • cloudsql.blueGreenDeployments.get
  • cloudsql.instances.switchover
  • cloudsql.operations.get

Cloud SQL의 IAM 역할 및 권한에 대한 자세한 내용은 역할 및 권한을 참조하세요.

전환 전 확인

전환을 시작하기 전에 다음 조건을 확인하세요.

  1. 배포 상태: 배포가 SWITCHOVER_READY 상태여야 합니다.
  2. 구성 설정: Google Cloud 콘솔에서 설정 차이를 확인하거나, --show-config-diff 플래그를 사용하여 gcloud sql blue-green-deployments describe 명령어를 실행하거나, view=DETAILED 매개변수를 사용하여 blueGreenDeployments.get 메서드를 호출하여 그린 인스턴스에 예상 구성 설정이 있는지 확인합니다. 자세한 내용은 구성 차이점 보기를 참조하세요.
  3. 워크로드 검증: 그린 스테이징 인스턴스에서 모든 테스트 및 검증을 완료합니다.
  4. 낮은 복제 지연: 블루와 그린 간의 복제 지연을 최소화하여 전환 시간을 줄입니다.

전환 작동 방식

전환을 시작하면 Cloud SQL은 다음 자동화된 시퀀스를 수행합니다.

  1. 전환 전 검증: 전환 작업 전에 Cloud SQL은 복제가 중단되지 않았는지 확인하고 일련의 구성 검사를 수행하여 배포가 준비되었는지 확인합니다.
  2. 전환 워크플로 실행: 워크플로 실행 중에 Cloud SQL은 전환을 위해 인스턴스를 준비합니다. 복제 지연이 너무 높거나 활성 트랜잭션이 전환을 차단하는 경우 전환 작업이 실패하고 프로덕션 블루 환경이 온라인 상태로 유지됩니다.
  3. 트래픽 리디렉션: Cloud SQL은 블루 인스턴스와 그린 인스턴스 간에 연결 엔드포인트를 전환합니다.
  4. 역할 전환: 그린 인스턴스는 활성 프로덕션 읽기 및 쓰기 인스턴스가 되고 블루 인스턴스는 독립형 읽기 및 쓰기 인스턴스가 됩니다.

전환 중에 애플리케이션 연결이 잠시 중단되었다가(일반적으로 몇 초) 업그레이드된 프로덕션 인스턴스에 자동으로 다시 연결됩니다. 전환 다운타임은 Cloud SQL 버전에 따라 다릅니다.

  • Cloud SQL Enterprise Plus 버전: 전환 다운타임은 일반적으로 1초 미만입니다.
  • Cloud SQL Enterprise 버전: 전환 다운타임은 워크로드 및 복제 지연에 따라 일반적으로 60초 미만입니다. 애플리케이션 구성이나 연결 문자열을 변경할 필요가 없습니다.

전환 수명 주기 상태

전환 전, 전환 중, 전환 후에 배포는 state 응답 필드에서 다음 상태로 전환됩니다.

  • SWITCHOVER_READY: 블루에서 그린으로의 논리적 복제가 정상이고 배포가 전환 준비가 되었습니다. SWITCHOVER_READY 상태는 복제가 정상인 경우에만 적용됩니다. Cloud SQL은 이 상태를 설정할 때 복제 지연을 평가하지 않습니다.
  • SWITCHOVER_NOT_READY: 배포가 프로비저닝되었지만 전환을 시작할 수 없습니다. 이는 논리적 복제가 중단, 일시중지 또는 중지되거나 기본 노드 오류가 발생한 경우에 발생합니다. Cloud SQL은 이 상태를 설정할 때 복제 지연을 평가하지 않습니다. errorDetail 필드를 검사하고 오류를 해결한 후 전환을 시도합니다.
  • SWITCHOVER_IN_PROGRESS: 전환 명령어가 실행 중입니다. Cloud SQL이 연결 엔드포인트를 교체하고 그린을 프로덕션 읽기 및 쓰기 인스턴스로 변환하고 있습니다.
  • SWITCHOVER_COMPLETED: 전환이 성공적으로 완료되었습니다. 이제 그린은 읽기 및 쓰기 트래픽을 제공하는 활성 프로덕션 데이터베이스 인스턴스이며 블루 인스턴스는 배포를 삭제할 때까지 독립형 인스턴스로 유지됩니다.

전환 전 권장사항

  • 트래픽이 적은 시간대에 예약: 다운타임은 최소화되지만(일반적으로 몇 초) 쓰기 활동이 적은 기간(예: 초당 쓰기 쿼리 수[QPS] 가 가장 낮은 사용량이 적은 시간대 또는 유지보수 기간)에 전환을 시작합니다. 이렇게 하면 복제 지연이 최소화되고 취소된 트랜잭션의 위험이 줄어듭니다.
  • 복제 지연 확인: 전환을 시작하기 전에 복제 지연이 최소화되었는지 확인합니다. 블루-그린 배포를 설명해도 복제 지연이 표시되지 않으며 Cloud SQL은 전환 작업 전에 복제 지연을 확인하지 않습니다. 하지만 워크플로 실행 중에 복제 지연이 너무 크면 전환이 실패합니다. 복제 지연을 모니터링하려면 Cloud Monitoring 측정항목(예: replica_lag)을 확인하거나 그린 인스턴스에서 직접 복제 상태를 검사합니다. 자세한 내용은 복제 지연을 참조하세요.
  • 활성 트랜잭션 확인: 전환을 시작하기 전에 장기 실행 DDL 작업 또는 일괄 쓰기가 완료되었는지 확인합니다.

전환 시작

Google Cloud 콘솔, gcloud CLI, Terraform 또는 Cloud SQL Admin API를 사용하여 전환 작업을 시작합니다.

콘솔

  1. Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

    Cloud SQL 인스턴스로 이동

  2. 인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
  3. 블루-그린 배포 상태 카드에서 세부정보를 클릭하여 배포 개요 페이지를 엽니다.
  4. 배포 전환을 클릭합니다.
  5. 인스턴스 설정 차이 대화상자에서 소스 인스턴스와 대상 인스턴스 간의 설정 차이를 검토한 후 계속을 클릭하여 전환을 시작합니다.

gcloud

gcloud sql blue-green-deployments switchover 명령어를 실행합니다.

gcloud sql blue-green-deployments switchover DEPLOYMENT_NAME \
  --region=REGION \
  --async

전환 작업을 완료하는 데 몇 분 정도 걸릴 수 있습니다. 작업이 예상보다 오래 걸릴 경우 메시지가 표시될 수 있습니다. 이 메시지를 그냥 무시하거나 gcloud sql operations wait 명령어를 실행해서 메시지를 닫고 작업이 완료될 때까지 기다려도 됩니다.

gcloud sql operations wait OPERATION_ID

전환 작업 상태를 확인하려면 gcloud sql operations describe 명령어를 실행합니다.

gcloud sql operations describe OPERATION_ID

다음을 바꿉니다.

  • DEPLOYMENT_NAME: 블루-그린 배포의 이름입니다.
  • REGION: 배포가 생성된 Google Cloud 리전입니다.
  • OPERATION_ID: 전환 작업의 ID입니다.

Terraform

Terraform을 사용하여 전환을 시작하려면 기본 google_sql_database_instance 리소스 구성을 업데이트하고 단일 작업으로 변경사항을 적용합니다.

  1. blue_green_deployment 코드 블록에서 active_environment 필드를 "SOURCE"에서 "TARGET"로 변경합니다.
  2. 소스 인스턴스와 다른 target_database_version 필드로 배포를 만든 경우 동일한 구성 변경에서 target_database_version 필드와 일치하도록 최상위 database_version 필드를 업데이트합니다. 그린 인스턴스에서 다른 설정을 수정한 경우 Terraform 구성이 그린 인스턴스와 일치하도록 google_sql_database_instance 리소스에서 해당 필드를 동시에 업데이트합니다.
  3. 선택사항: 나중에 정리 중에 blue_green_deployment 코드 블록을 삭제할 때 이전 블루 인스턴스를 자동으로 삭제하려면 blue_green_deployment 코드 블록에서 delete_old_source_on_destroy 필드를 true로 설정합니다.
resource "google_sql_database_instance" "primary" {
  name             = "SOURCE_INSTANCE_ID"
  region           = "REGION"
  database_version = "TARGET_DATABASE_VERSION"

  settings {
    tier              = "MACHINE_TIER"
    edition           = "EDITION"
    availability_type = "REGIONAL"

    backup_configuration {
      enabled            = true
      binary_log_enabled = true
    }
  }

  blue_green_deployment {
    deployment_name              = "DEPLOYMENT_NAME"
    target_database_version      = "TARGET_DATABASE_VERSION"
    active_environment           = "TARGET"
    delete_old_source_on_destroy = true
  }
}

다음을 바꿉니다.

  • SOURCE_INSTANCE_ID: 기본 인스턴스의 이름입니다.
  • REGION: 배포가 생성된 Google Cloud 리전입니다.
  • TARGET_DATABASE_VERSION: 그린 인스턴스의 데이터베이스 버전(예: MYSQL_8_4)
  • MACHINE_TIER: 그린 인스턴스의 머신 유형입니다(예: db-custom-2-7680).
  • EDITION: 그린 인스턴스의 Cloud SQL 버전(ENTERPRISE 또는 ENTERPRISE_PLUS)
  • DEPLOYMENT_NAME: 블루-그린 배포의 이름입니다.

Google Cloud 프로젝트에 Terraform 구성을 적용하려면 다음 섹션의 단계를 완료하세요.

Cloud Shell 준비

  1. Cloud Shell을 실행합니다.
  2. Terraform 구성을 적용할 기본 Google Cloud 프로젝트를 설정합니다.

    이 명령어는 프로젝트당 한 번만 실행하면 되며 어떤 디렉터리에서도 실행할 수 있습니다.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Terraform 구성 파일에서 명시적 값을 설정하면 환경 변수가 재정의됩니다.

디렉터리 준비

각 Terraform 구성 파일에는 자체 디렉터리(루트 모듈이라고도 함)가 있어야 합니다.

  1. Cloud Shell에서 디렉터리를 만들고 해당 디렉터리 내에 새 파일을 만드세요. 파일 이름에는 .tf 확장자가 있어야 합니다(예: main.tf). 이 튜토리얼에서는 파일을 main.tf라고 합니다.
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf
  2. 튜토리얼을 따라 하는 경우 각 섹션이나 단계에서 샘플 코드를 복사할 수 있습니다.

    샘플 코드를 새로 만든 main.tf에 복사합니다.

    필요한 경우 GitHub에서 코드를 복사합니다. 이는 Terraform 스니펫이 엔드 투 엔드 솔루션의 일부인 경우에 권장됩니다.

  3. 환경에 적용할 샘플 파라미터를 검토하고 수정합니다.
  4. 변경사항을 저장합니다.
  5. Terraform을 초기화합니다. 이 작업은 디렉터리당 한 번만 수행하면 됩니다.
    terraform init

    원하는 경우 최신 Google 공급업체 버전을 사용하려면 -upgrade 옵션을 포함합니다.

    terraform init -upgrade

변경사항 적용

  1. 구성을 검토하고 Terraform에서 만들거나 업데이트할 리소스가 예상과 일치하는지 확인합니다.
    terraform plan

    필요에 따라 구성을 수정합니다.

  2. 다음 명령어를 실행하고 프롬프트에 yes를 입력하여 Terraform 구성을 적용합니다.
    terraform apply

    Terraform에 '적용 완료' 메시지가 표시될 때까지 기다립니다.

  3. 결과를 보려면 Google Cloud 프로젝트를 엽니다. Google Cloud 콘솔에서 UI의 리소스로 이동하여 Terraform이 리소스를 만들었거나 업데이트했는지 확인합니다.

REST v1

POST 요청을 blueGreenDeployments.switchover 메서드로 보냅니다.

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME:switchover

다음을 바꿉니다.

  • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
  • REGION: 배포가 생성된 Google Cloud 리전입니다.
  • DEPLOYMENT_NAME: 블루-그린 배포의 이름입니다.

REST v1beta4

POST 요청을 blueGreenDeployments.switchover 메서드로 보냅니다.

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME:switchover

다음을 바꿉니다.

  • PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
  • REGION: 배포가 생성된 Google Cloud 리전입니다.
  • DEPLOYMENT_NAME: 블루-그린 배포의 이름입니다.

전환 후 모니터링

전환이 완료된 후 다음 안내를 따르세요.

  1. 애플리케이션이 성공적으로 다시 연결되고 프로덕션 데이터베이스 작업이 재개되는지 확인합니다.
  2. 새 프로덕션 인스턴스에서 쿼리 처리량, 오류 로그, 복제 상태를 모니터링합니다.
  3. 초기 업그레이드 후 확인 기간 동안 블루 독립형 인스턴스를 그대로 유지합니다. 안정성을 확인한 후 배포를 삭제합니다. 자세한 내용은 블루-그린 배포 삭제를 참조하세요.

다음 단계