고가용성 사용 설정 및 사용 중지

이 페이지에서는 고가용성을 위해 인스턴스를 구성하는 방법을 설명합니다.

인스턴스를 만들 때 이를 고가용성으로 구성하거나 레거시 인스턴스에서 고가용성을 사용 설정할 수 있습니다.

고가용성에 대한 자세한 내용은 고가용성 구성 개요를 참조하세요.

기존 구성에는 고가용성을 위해 failover replica 인스턴스를 사용했습니다. 새 구성은 failover replica를 사용하지 않습니다. 대신 한 리전 내 두 영역 간에 블록 수준에서 데이터를 동기식으로 복제하는 Google의 리전 영구 디스크를 사용합니다. 기존 고가용성 구성을 사용하는 기존 MySQL 인스턴스가 있는 경우 구성을 업데이트하여 현재 버전을 사용할 수 있습니다. 기존 고가용성 구성과 관련된 다른 절차는 고가용성을 위한 기존 구성을 참조하세요.

고가용성으로 구성된 새 인스턴스 만들기

인스턴스를 만들고 고가용성으로 구성하면 Cloud SQL이 해당 인스턴스를 리전 인스턴스로 만듭니다.

고가용성으로 구성된 인스턴스를 만들려면 다음과 같이 합니다.

콘솔

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

    Cloud SQL 인스턴스로 이동

  2. 인스턴스 만들기를 선택합니다.
  3. 데이터베이스 엔진을 선택합니다.
  4. 리전 및 영역 가용성 선택 섹션에서 여러 영역(고가용성)을 선택합니다.
  5. 영역 지정을 펼칩니다.
  6. 기본 영역과 보조 영역을 선택합니다. 인스턴스를 만들거나 수정하는 동안 보조 영역이 사용되는 경우에는 다음 조건이 적용됩니다.
    • 기본 영역은 Any로 보조 영역은 Any (different from primary)로 기본 설정됩니다.
    • 기본 영역과 보조 영역을 모두 지정할 경우 서로 다른 영역이어야 합니다.

  7. 저장을 클릭합니다.

    인스턴스가 업데이트되는 동안 기본 인스턴스의 인스턴스 페이지로 돌아옵니다.

gcloud

  1. 리전 인스턴스를 만듭니다.
    gcloud sql instances create REGIONAL_INSTANCE_NAME \
    --availability-type=REGIONAL \
    --database-version=DATABASE_VERSION \
    --tier=MACHINE_TYPE \
    --enable-bin-log
    
    사용 가능한 매개변수의 전체 목록은 gcloud sql 인스턴스 만들기 참조 페이지를 확인하세요.
  2. --zone--secondary-zone 매개변수를 사용하여 기본 영역과 보조 영역을 둘 다 지정할 수 있습니다. 인스턴스를 만들거나 수정하는 동안 보조 영역이 사용되는 경우에는 다음 제한 사항이 적용됩니다.
    • 영역이 유효한 영역이어야 합니다.
    • 보조 영역이 지정된 경우 기본 영역도 지정해야 합니다.
    • 기본 영역과 보조 영역이 지정된 경우 서로 다른 영역이어야 합니다.
    • 기본 영역과 보조 영역이 지정된 경우 두 영역이 같은 리전에 있어야 합니다.
  3. 루트 사용자를 구성합니다.
    gcloud sql users set-password root --host=% \
    --instance=PRIMARY_INSTANCE_NAME \
    --password=PASSWORD
    

Terraform

고가용성 인스턴스를 만들려면 Terraform 리소스를 사용합니다.

resource "google_sql_database_instance" "mysql_instance_ha" {
  name             = "mysql-instance-ha"
  region           = "asia-northeast1"
  database_version = "MYSQL_8_0"
  settings {
    tier              = "db-f1-micro"
    availability_type = "REGIONAL"
    backup_configuration {
      enabled            = true
      binary_log_enabled = true
      start_time         = "20:55"
    }
  }
  deletion_protection =  "true"
}

변경사항 적용

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

  1. Cloud Shell을 실행합니다.
  2. Terraform 구성을 적용할 Google Cloud 프로젝트를 설정합니다.
        export GOOGLE_CLOUD_PROJECT=PROJECT_ID
        
  3. 디렉터리를 만들고 해당 디렉터리에 새 파일을 엽니다. 파일 이름에는 .tf 확장자가 있어야 합니다(예: main.tf).
        mkdir DIRECTORY && cd DIRECTORY && nano main.tf
        
  4. 샘플을 main.tf에 복사합니다.
  5. 환경에 적용할 샘플 매개변수를 검토하고 수정합니다.
  6. Ctrl-x를 누른 후 y를 눌러 변경사항을 저장합니다.
  7. Terraform을 초기화합니다.
    terraform init
  8. 구성을 검토하고 Terraform에서 만들거나 업데이트할 리소스가 예상과 일치하는지 확인합니다.
    terraform plan

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

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

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

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

변경사항 삭제

변경사항을 삭제하려면 다음 단계를 따르세요.

  1. Terraform 구성 파일에서 삭제 보호를 사용 중지하려면 deletion_protection 인수를 false로 설정합니다.
    deletion_protection =  "false"
  2. 다음 명령어를 실행하고 프롬프트에 yes를 입력하여 업데이트된 Terraform 구성을 적용합니다.
    terraform apply
  1. 다음 명령어를 실행하고 프롬프트에 yes를 입력하여 이전에 Terraform 구성에 적용된 리소스를 삭제합니다.

    terraform destroy

REST v1

이 요청에서 사용 가능한 매개변수의 전체 목록은 instances:insert 페이지를 참조하세요.

리전 인스턴스를 만듭니다.

  1. 요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-name: 인스턴스 이름
    • database-version: 데이터베이스 버전 열거형 문자열
    • region: GCP 리전
    • machine-type: 머신 유형

    HTTP 메서드 및 URL:

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances

    JSON 요청 본문:

    {
      "name": "instance-name",
      "region": "region",
      "databaseVersion": "database-version",
       "settings": {
         "tier": "machine-type",
         "backupConfiguration": {
             "binaryLogEnabled": true,
             "enabled": true
          },
          "availabilityType": "REGIONAL"
       }
    }
    

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    다음과 유사한 JSON 응답이 표시됩니다.

  2. 인스턴스 초기화가 완료되면 인스턴스에서 루트 비밀번호를 업데이트합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-id: 인스턴스 ID
    • password: 새 루트 사용자 비밀번호

    HTTP 메서드 및 URL:

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?name=root&host=%25'

    JSON 요청 본문:

    {
       "name": "root",
       "host": "%",
       "password": "password"}
    

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

REST v1beta4

이 요청에서 사용 가능한 매개변수의 전체 목록은 instances:insert 페이지를 참조하세요.

리전 인스턴스를 만듭니다.

  1. 요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-name: 인스턴스 이름
    • database-version: 데이터베이스 버전 열거형 문자열
    • region: GCP 리전
    • machine-type: 머신 유형

    HTTP 메서드 및 URL:

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances

    JSON 요청 본문:

    {
      "name": "instance-name",
      "region": "region",
      "databaseVersion": "database-version",
       "settings": {
         "tier": "machine-type",
         "backupConfiguration": {
             "binaryLogEnabled": true,
             "enabled": true
          },
          "availabilityType": "REGIONAL"
       }
    }
    

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    다음과 유사한 JSON 응답이 표시됩니다.

  2. 인스턴스 초기화가 완료되면 인스턴스에서 루트 비밀번호를 업데이트합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-id: 인스턴스 ID
    • password: 새 루트 사용자 비밀번호

    HTTP 메서드 및 URL:

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=root&host=%25'

    JSON 요청 본문:

    {
       "name": "root",
       "host": "%",
       "password": "password"}
    

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

인스턴스 만들기에 관한 자세한 내용은 인스턴스 만들기를 참조하세요.

기존 인스턴스를 고가용성으로 구성

기존 인스턴스를 고가용성으로 구성하면 인스턴스가 재구성되는 동안 다운타임이 몇 분 정도 발생합니다.

기존 인스턴스를 고가용성으로 구성하려면 다음과 같이 합니다.

콘솔

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

    Cloud SQL 인스턴스로 이동

  2. 인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
  3. 수정을 클릭합니다.
  4. 리전 및 영역 가용성 선택 섹션에서 여러 영역(고가용성)을 선택합니다.
  5. 영역 지정을 펼칩니다.
  6. 기본 영역과 보조 영역을 선택합니다. 인스턴스를 만들거나 수정하는 동안 보조 영역이 사용되는 경우에는 다음 조건이 적용됩니다.
    • 기본 영역은 Any로 보조 영역은 Any (different from primary)로 기본 설정됩니다.
    • 기본 영역과 보조 영역을 모두 지정할 경우 서로 다른 영역이어야 합니다.

  7. 저장을 클릭합니다.

    인스턴스가 업데이트되는 동안 기본 인스턴스의 인스턴스 페이지로 돌아옵니다.

gcloud

인스턴스를 리전 인스턴스로 업데이트합니다.

gcloud sql instances patch INSTANCE_NAME \
--availability-type REGIONAL \
--enable-bin-log \
--backup-start-time=HH:MM

참조 정보는 gcloud sql instances patch를 확인하세요.

REST v1

  1. 기본 인스턴스를 확인하여 자동 백업 및 바이너리 로그가 사용 설정되어 있는지 확인합니다. 고가용성 인스턴스에 필요합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-id: 인스턴스 ID

    HTTP 메서드 및 URL:

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    다음과 유사한 JSON 응답이 표시됩니다.

    {
      "kind": "sql#instance",
      "state": "RUNNABLE",
      "databaseVersion": "MYSQL_8_0"
    }
    

    출력에 다음과 유사한 섹션이 포함됩니다.

      "backupConfiguration": {
        "kind": "sql#backupConfiguration",
        "startTime": "12:00",
        "enabled": true,
        "binaryLogEnabled": true
        }
      
  2. enabled 또는 binaryLogEnabledfalse이면 instances:patch 메서드를 사용하여 둘 다 사용 설정합니다. 백업을 사용 설정하려면 enabledtrue로, startTime을 백업 기간의 시작 값으로 설정합니다. 바이너리 로깅을 사용 설정하려면 binaryLogEnabledtrue로 설정합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-id: 인스턴스 ID(기본 또는 복제본)
    • start-time 'HH:MM' 형식의 시간

    HTTP 메서드 및 URL:

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

    JSON 요청 본문:

    {
      "settings":
      {
        "backupConfiguration":
        {
          "startTime": "start-time",
          "enabled": true,
          "binaryLogEnabled": true
        }
      }
    }
    

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    다음과 유사한 JSON 응답이 표시됩니다.

  3. 인스턴스를 리전 인스턴스로 업데이트합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-name: 인스턴스 이름

    HTTP 메서드 및 URL:

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name

    JSON 요청 본문:

    {
      "settings": {"availabilityType": "REGIONAL" }
    }
    

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

REST v1beta4

  1. 기본 인스턴스를 확인하여 자동 백업 및 바이너리 로그가 사용 설정되어 있는지 확인합니다. 고가용성 인스턴스에 필요합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-id: 인스턴스 ID

    HTTP 메서드 및 URL:

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    다음과 유사한 JSON 응답이 표시됩니다.

    {
      "kind": "sql#instance",
      "state": "RUNNABLE",
      "databaseVersion": "MYSQL_8_0"
    }
    

    출력에 다음과 유사한 섹션이 포함됩니다.

      "backupConfiguration": {
        "kind": "sql#backupConfiguration",
        "startTime": "12:00",
        "enabled": true,
        "binaryLogEnabled": true
        }
      
  2. enabled 또는 binaryLogEnabledfalse이면 instances:patch 메서드를 사용하여 둘 다 사용 설정합니다. 백업을 사용 설정하려면 enabledtrue로, startTime을 백업 기간의 시작 값으로 설정합니다. 바이너리 로깅을 사용 설정하려면 binaryLogEnabledtrue로 설정합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-id: 인스턴스 ID(기본 또는 복제본)
    • start-time 'HH:MM' 형식의 시간

    HTTP 메서드 및 URL:

    PATCH https://sqladmin.googleapis.com/v1beta4/projects/project-id/instances/instance-id

    JSON 요청 본문:

    {
      "settings":
      {
        "backupConfiguration":
        {
          "startTime": "start-time",
          "enabled": true,
          "binaryLogEnabled": true
        }
      }
    }
    

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    다음과 유사한 JSON 응답이 표시됩니다.

  3. 인스턴스를 리전 인스턴스로 업데이트합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-name: 인스턴스 이름

    HTTP 메서드 및 URL:

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name

    JSON 요청 본문:

    {
      "settings": {"availabilityType": "REGIONAL" }
    }
    

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

장애 조치 시작

장애 조치 테스트는 선택사항이지만 장애 조치 발생 시 애플리케이션의 응답 방식을 확인하기 위해 테스트하는 것이 좋습니다.

장애 조치에 대한 자세한 내용은 장애 조치 개요를 참조하세요.

gcloud

다음 명령어를 통해 장애 조치를 시작합니다.

gcloud sql instances failover PRIMARY_INSTANCE_NAME

REST v1

  1. 기본 인스턴스를 기술하여 settingsVersion 필드 값을 가져옵니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-id: 인스턴스 ID

    HTTP 메서드 및 URL:

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    다음과 유사한 JSON 응답이 표시됩니다.

    {
      "kind": "sql#instance",
      "state": "RUNNABLE",
      "databaseVersion": "MYSQL_8_0"
    }
    
  2. 다음 명령어를 통해 장애 조치를 시작합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-name: 인스턴스 이름
    • settings-version: instanceInfo의 settingsVersion

    HTTP 메서드 및 URL:

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name/failover

    JSON 요청 본문:

    {
      "failoverContext":
         {
            "settingsVersion":"settings-version"
         }
    }
    

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    다음과 유사한 JSON 응답이 표시됩니다.

REST v1beta4

  1. 기본 인스턴스를 기술하여 settingsVersion 필드 값을 가져옵니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-id: 인스턴스 ID

    HTTP 메서드 및 URL:

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    다음과 유사한 JSON 응답이 표시됩니다.

    {
      "kind": "sql#instance",
      "state": "RUNNABLE",
      "databaseVersion": "MYSQL_8_0"
    }
    
  2. 다음 명령어를 통해 장애 조치를 시작합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • project-id: 프로젝트 ID
    • instance-name: 인스턴스 이름
    • settings-version: instanceInfo의 settingsVersion

    HTTP 메서드 및 URL:

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name/failover

    JSON 요청 본문:

    {
      "failoverContext":
         {
            "settingsVersion":"settings-version"
         }
    }
    

    요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

    다음과 유사한 JSON 응답이 표시됩니다.

인스턴스가 장애 조치되며 몇 분 동안 데이터를 제공할 수 없게 됩니다.

인스턴스의 고가용성 확인

인스턴스의 고가용성을 확인하려면 다음과 같이 합니다.

콘솔

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

    Cloud SQL 인스턴스로 이동

  2. 인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
  3. 구성 섹션에 고가용성(리전)이 표시됩니다.

gcloud

gcloud sql instances describe INSTANCE_NAME
출력에 따르면 availabilityTypeREGIONAL입니다.

REST v1

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • project-id: 프로젝트 ID
  • instance-id: 인스턴스 ID

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

다음과 유사한 JSON 응답이 표시됩니다.

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0"
}

출력에 따르면 availabilityTypeREGIONAL입니다.

REST v1beta4

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • project-id: 프로젝트 ID
  • instance-id: 인스턴스 ID

HTTP 메서드 및 URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

다음과 유사한 JSON 응답이 표시됩니다.

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0"
}

출력에 따르면 availabilityTypeREGIONAL입니다.

인스턴스에서 고가용성 사용 중지

이 절차를 수행하기 전에 현재 인스턴스에 실행 중인 작업이 없는지 확인합니다.

고가용성을 사용 중지하려면 다음 단계를 따르세요.

콘솔

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

    Cloud SQL 인스턴스로 이동

  2. 인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
  3. 수정을 클릭합니다.
  4. 자동 백업을 엽니다.
  5. 가용성 섹션에서 단일 영역을 클릭합니다.
  6. 저장을 클릭합니다. 수정사항을 적용하려면 인스턴스를 다시 시작해야 합니다.
  7. 메시지 상자가 나타나면 저장 및 다시 시작을 클릭합니다.

gcloud

참조 정보는 gcloud sql instances patch를 확인하세요.
gcloud sql instances patch INSTANCE_NAME \
--availability-type ZONAL

REST v1

다음 요청에서는 instances:patch 메서드를 사용하여 인스턴스의 가용성 유형을 ZONAL로 변경합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • project-id: 프로젝트 ID
  • instance-name: 인스턴스 이름

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name

JSON 요청 본문:

{
  "settings": {"availabilityType": "ZONAL" }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

REST v1beta4

다음 요청에서는 instances:patch 메서드를 사용하여 인스턴스의 가용성 유형을 ZONAL로 변경합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • project-id: 프로젝트 ID
  • instance-name: 인스턴스 이름

HTTP 메서드 및 URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name

JSON 요청 본문:

{
  "settings": {"availabilityType": "ZONAL" }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

문제 해결

문제 문제 해결
수동 장애 조치에 대한 측정항목을 찾을 수 없습니다. 자동 장애 조치만 측정항목에 포함됩니다.
Cloud SQL 인스턴스 리소스(CPU 및 RAM) 사용량이 거의 100%여서 고가용성 인스턴스가 다운됩니다. 인스턴스 머신 크기가 부하에 비해 너무 작습니다.

인스턴스를 수정하여 더 큰 머신 크기로 업그레이드하면 CPU와 메모리가 늘어납니다.

다음 단계