인스턴스 클론

이 페이지에서는 클론에 대해 설명하고 인스턴스를 클론하는 방법을 안내합니다.

개요

Cloud SQL 인스턴스를 클론하면 소스 인스턴스의 복사본인 새 인스턴스가 생성됩니다. 새 인스턴스는 소스 인스턴스와 완전히 독립적입니다.

자주 묻는 질문(FAQ)

질문 답변
클론이 성능에 영향을 주나요? 아니요. 클론은 소스 인스턴스의 성능에는 영향을 미치지 않습니다.
백업이 새 인스턴스에 복사되나요? 아니요. 새 인스턴스는 새 자동 백업을 만듭니다. 수동 백업은 소스 인스턴스에서 복사되지 않습니다.
새 인스턴스의 IP 주소 또는 주소는 동일한가요? 아니요. 새 인스턴스에는 새로운 IP 주소 또는 주소가 지정됩니다.
새 인스턴스의 구성 설정은 동일한가요? 예. 데이터베이스 플래그, 연결 옵션, 머신 유형, 스토리지, 메모리 설정 등의 동일한 설정이 새 인스턴스에 적용됩니다.
복제본이 새 인스턴스에 복사되나요? 아니요. 새 인스턴스의 새 복제본을 만들어야 합니다.
복제본을 클론할 수 있나요? 아니요. 복제본은 클론할 수 없습니다.
이전 시점에서 클론을 만들 수 있나요? 예. point-in-time recovery는 클론하여 이전 시점의 인스턴스를 복원합니다. 이를 통해 손상이 발생한 경우 데이터베이스를 복구할 수 있습니다.
소스 인스턴스의 유지보수 설정이 클론 인스턴스에 자동으로 복사되나요? 아니요. 클론 인스턴스의 유지보수 설정을 구성해야 합니다.
클론이었던 인스턴스를 클론할 수 있나요? 예. 다른 인스턴스에서 클론된 인스턴스는 클론할 수 있습니다.
데이터베이스 사용자가 새 인스턴스에 복사되나요? 예. 하지만 데이터베이스 사용자 비밀번호는 복사되지 않으므로 다시 만들어야 합니다.

인스턴스 클론

Google Cloud 콘솔, gcloud CLI, Terraform 또는 API를 사용하여 Cloud SQL 인스턴스를 클론할 수 있습니다.

콘솔

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

    Cloud SQL 인스턴스로 이동

  2. 클론할 인스턴스의 행을 찾습니다.
  3. 작업 열에서 추가 작업 메뉴를 클릭합니다.
  4. 클론 만들기를 클릭합니다.
  5. 클론 만들기 페이지에서 필요한 경우 인스턴스 ID를 업데이트한 후 인스턴스의 현재 상태 클론을 선택한 상태로 두고 클론 만들기를 클릭합니다.

    클론이 초기화되는 동안 인스턴스 등록 페이지로 돌아옵니다.

gcloud

인스턴스를 클론하려면 gcloud sql instances clone 명령어를 사용합니다.

gcloud sql instances clone SOURCE_INSTANCE_NAME DESTINATION_INSTANCE_NAME \
--project PROJECT_ID \
--preferred-zone ZONE_NAME \
--preferred-secondary-zone SECONDARY_ZONE_NAME

다음을 바꿉니다.

  • SOURCE_INSTANCE_NAME: 클론할 Cloud SQL 인스턴스의 이름
  • DESTINATION_INSTANCE_NAME: 클론된 인스턴스의 이름
  • PROJECT_ID: 소스 및 대상 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
  • ZONE_NAME: (선택사항) 대상 인스턴스의 기본 영역 이름입니다. 대상 인스턴스가 클론하는 Cloud SQL 인스턴스와 다른 기본 영역에 있도록 하려면 이 이름을 사용하세요. 리전 인스턴스의 경우 이 영역이 기본 영역을 대체하지만 보조 영역이 소스 인스턴스와 동일하게 유지됩니다.
  • SECONDARY_ZONE_NAME: (선택사항) 대상 인스턴스의 보조 영역 이름입니다. 클론할 리전 Cloud SQL 인스턴스에 다른 보조 영역을 지정할 때 사용합니다.

--preferred-zone--preferred-secondary-zone 파라미터를 사용하는 경우 다음 조건이 적용됩니다.

  • 기본 영역과 보조 영역 모두 유효한 영역이어야 합니다.
  • 두 영역 모두 소스 인스턴스와 동일한 리전에 속해야 합니다.
  • 기본 영역과 보조 영역은 서로 달라야 합니다.
  • 영역 인스턴스의 경우 --preferred-secondary-zone 파라미터를 사용할 수 없습니다. 이렇게 하면 인스턴스 클론 프로세스가 실패합니다.
  • --preferred-zone 또는 --preferred-secondary-zone 파라미터 값을 지정하지 않으면 클론된 인스턴스에는 소스 인스턴스와 동일한 기본 영역과 보조 영역이 포함됩니다.

gcloud sql instances clone 명령어를 실행하려면 cloudsql.instances.clone 권한이 있어야 합니다. gcloud CLI 명령어를 실행하는 데 필요한 권한에 대한 자세한 내용은 Cloud SQL 권한을 참조하세요.

Terraform

인스턴스를 클론하려면 Terraform 리소스를 사용합니다.

resource "google_sql_database_instance" "clone" {
  name             = "mysql-instance-clone-name"
  region           = "us-central1"
  database_version = "MYSQL_8_0"
  clone {
    source_instance_name = google_sql_database_instance.source.id
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

변경사항 적용

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이 리소스를 만들었거나 업데이트했는지 확인합니다.

변경사항 삭제

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

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

    terraform destroy

REST v1

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

  • PROJECT_ID: 소스 및 대상 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
  • SOURCE_INSTANCE_NAME: 클론할 Cloud SQL 인스턴스의 이름
  • DESTINATION_INSTANCE_NAME: 클론된 인스턴스의 이름
  • ZONE_NAME: (선택사항) 대상 인스턴스의 기본 영역 이름입니다. 대상 인스턴스가 클론하는 Cloud SQL 인스턴스와 다른 기본 영역에 있도록 하려면 이 이름을 사용하세요. 리전 인스턴스의 경우 이 영역이 기본 영역을 대체하지만 보조 영역이 소스 인스턴스와 동일하게 유지됩니다.
  • SECONDARY_ZONE_NAME: (선택사항) 대상 인스턴스의 보조 영역 이름입니다. 클론할 리전 Cloud SQL 인스턴스에 다른 보조 영역을 지정할 때 사용합니다.

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone

JSON 요청 본문:

{
  "cloneContext":
  {
    "destinationInstanceName": "DESTINATION_INSTANCE_NAME",
    "preferredZone": "ZONE_NAME",
    "preferredSecondaryZone": "SECONDARY_ZONE_NAME"
  }
}

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

다음과 비슷한 JSON 응답이 표시됩니다.

preferredZonepreferredSecondaryZone 파라미터를 사용하는 경우 다음 조건이 적용됩니다.

  • 기본 영역과 보조 영역 모두 유효한 영역이어야 합니다.
  • 두 영역 모두 소스 인스턴스와 동일한 리전에 속해야 합니다.
  • 기본 영역과 보조 영역은 서로 달라야 합니다.
  • 영역 인스턴스의 경우 preferredSecondaryZone 파라미터를 사용할 수 없습니다. 이렇게 하면 인스턴스 클론 프로세스가 실패합니다.
  • preferredZone 또는 preferredSecondaryZone 파라미터 값을 지정하지 않으면 클론된 인스턴스에는 소스 인스턴스와 동일한 기본 영역과 보조 영역이 포함됩니다.

instances.clone API 메서드를 사용하려면 cloudsql.instances.clone 권한이 있어야 합니다. API 메서드를 사용하는 데 필요한 권한에 대한 자세한 내용은 Cloud SQL 권한을 참조하세요.

REST v1beta4

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

  • PROJECT_ID: 소스 및 대상 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
  • SOURCE_INSTANCE_NAME: 클론할 Cloud SQL 인스턴스의 이름
  • DESTINATION_INSTANCE_NAME: 클론된 인스턴스의 이름
  • ZONE_NAME: (선택사항) 대상 인스턴스의 기본 영역 이름입니다. 대상 인스턴스가 클론하는 Cloud SQL 인스턴스와 다른 기본 영역에 있도록 하려면 이 이름을 사용하세요. 리전 인스턴스의 경우 이 영역이 기본 영역을 대체하지만 보조 영역이 소스 인스턴스와 동일하게 유지됩니다.
  • SECONDARY_ZONE_NAME: (선택사항) 대상 인스턴스의 보조 영역 이름입니다. 클론할 리전 Cloud SQL 인스턴스에 다른 보조 영역을 지정할 때 사용합니다.

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone

JSON 요청 본문:

{
  "cloneContext":
  {
    "destinationInstanceName": "DESTINATION_INSTANCE_NAME",
    "preferredZone": "ZONE_NAME",
    "preferredSecondaryZone": "SECONDARY_ZONE_NAME"
  }
}

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

다음과 비슷한 JSON 응답이 표시됩니다.

preferredZonepreferredSecondaryZone 파라미터를 사용하는 경우 다음 조건이 적용됩니다.

  • 기본 영역과 보조 영역 모두 유효한 영역이어야 합니다.
  • 두 영역 모두 소스 인스턴스와 동일한 리전에 속해야 합니다.
  • 기본 영역과 보조 영역은 서로 달라야 합니다.
  • 영역 인스턴스의 경우 preferredSecondaryZone 파라미터를 사용할 수 없습니다. 이렇게 하면 인스턴스 클론 프로세스가 실패합니다.
  • preferredZone 또는 preferredSecondaryZone 파라미터 값을 지정하지 않으면 클론된 인스턴스에는 소스 인스턴스와 동일한 기본 영역과 보조 영역이 포함됩니다.

instances.clone API 메서드를 사용하려면 cloudsql.instances.clone 권한이 있어야 합니다. API 메서드를 사용하는 데 필요한 권한에 대한 자세한 내용은 Cloud SQL 권한을 참조하세요.

내부 IP 주소를 사용하는 인스턴스 클론

Cloud SQL 인스턴스가 내부 IP 주소를 사용하는 경우 선택적으로 클론의 새 IP 주소에 할당된 IP 범위를 지정할 수 있습니다. 예를 들면 google-managed-services-default입니다.

gcloud

인스턴스를 클론하되, 선택적으로 사용할 할당된 IP 범위를 지정합니다.

gcloud sql instances clone SOURCE_INSTANCE_NAME TARGET_INSTANCE_NAME \
--allocated-ip-range-name ALLOCATED_IP_RANGE_NAME

gcloud sql instances clone 명령어를 실행하는 사용자 또는 서비스 계정에 cloudsql.instances.clone 권한이 있어야 합니다. gcloud CLI 명령어를 실행하는 데 필요한 권한에 대한 자세한 내용은 Cloud SQL 권한을 참조하세요.

REST v1

인스턴스를 클론하되, 선택적으로 사용할 할당된 IP 범위를 지정합니다.

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

  • project-id: 프로젝트 ID입니다.
  • source-instance-id: 소스 인스턴스 ID
  • target-instance-id: 대상 인스턴스 ID
  • allocated-ip-range-name: 할당된 IP 범위 이름

HTTP 메서드 및 URL:

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

JSON 요청 본문:

{
  "cloneContext":
  {
    "destinationInstanceName": "target-instance-id",
    "allocatedIpRange": "allocated-ip-range-name"
  }
}

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

다음과 비슷한 JSON 응답이 표시됩니다.

instances.clone API 메서드를 사용하는 사용자 또는 서비스 계정에는 cloudsql.instances.clone 권한이 있어야 합니다. API 메서드를 사용하는 데 필요한 권한에 대한 자세한 내용은 Cloud SQL 권한을 참조하세요.

REST v1beta4

인스턴스를 클론하되, 선택적으로 사용할 할당된 IP 범위를 지정합니다.

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

  • project-id: 프로젝트 ID입니다.
  • source-instance-id: 소스 인스턴스 ID
  • target-instance-id: 대상 인스턴스 ID
  • allocated-ip-range-name: 할당된 IP 범위 이름

HTTP 메서드 및 URL:

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

JSON 요청 본문:

{
  "cloneContext":
  {
    "destinationInstanceName": "target-instance-id",
    "allocatedIpRange": "allocated-ip-range-name"
  }
}

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

다음과 비슷한 JSON 응답이 표시됩니다.

instances.clone API 메서드를 사용하는 사용자 또는 서비스 계정에는 cloudsql.instances.clone 권한이 있어야 합니다. API 메서드를 사용하는 데 필요한 권한에 대한 자세한 내용은 Cloud SQL 권한을 참조하세요.

할당된 IP 범위를 지정하지 않으면 다음 동작이 적용됩니다.

  • 소스 인스턴스가 지정된 범위로 생성되면 클론된 인스턴스가 동일한 범위로 생성됩니다.
  • 소스 인스턴스가 지정된 범위로 생성되지 않으면 클론된 인스턴스는 무작위 범위로 생성됩니다.

문제 해결

문제 문제 해결
constraints/sql.restrictAuthorizedNetworks 오류와 함께 클론이 실패합니다. 클론 작업이 Authorized Networks 구성에 의해 차단되었습니다. Google Cloud 콘솔의 연결 섹션에서 공개 IP 주소에 Authorized Networks가 구성되어 있으며 보안 고려사항으로 인해 클론이 허용되지 않습니다.

가능하면 Cloud SQL 인스턴스에서 모든 Authorized Networks 항목을 삭제합니다. 그렇지 않으면 Authorized Networks 항목 없이 복제본을 만듭니다.

오류 메시지: Failed to create subnetwork. Couldn't find free blocks in allocated IP ranges. Please allocate new ranges for this service provider. Help Token: [help-token-id].

Google Cloud 콘솔을 사용하여 비공개 IP 주소로 인스턴스를 클론하려고 하지만 사용할 할당된 IP 범위를 지정하지 않았고 소스 인스턴스가 지정된 범위로 생성되지 않습니다. 따라서 클론된 인스턴스는 무작위 범위로 생성됩니다.

gcloud를 사용하여 인스턴스를 클론하고
--allocated-ip-range-name 매개변수의 값을 제공합니다. 자세한 내용은 비공개 IP로 인스턴스 클론을 참조하세요.