새 네트워크 아키텍처로 인스턴스 업그레이드

중요: Cloud SQL 인스턴스를 새 네트워크 아키텍처로 업그레이드하는 명령어는 일시적으로 사용 중지됩니다.

이 페이지에서는 Cloud SQL 인스턴스를 이전 네트워크 아키텍처에서 새 네트워크 아키텍처로 업그레이드하는 방법을 설명합니다.

이 Cloud SQL 네트워크 아키텍처 업그레이드 페이지는 일부 Cloud SQL 인스턴스에만 적용됩니다. Cloud SQL 인스턴스가 2021년 8월 이전에 생성된 Virtual Private Cloud(VPC) 네트워크 프로젝트를 사용할 경우 인스턴스의 Cloud SQL 네트워크 아키텍처를 업그레이드해야 합니다.

개요

다음 표에서는 이전 네트워크 아키텍처와 비교한 새 네트워크 아키텍처의 이점을 보여줍니다.

업그레이드 계획하기

Cloud SQL 인스턴스의 네트워크 아키텍처를 업그레이드하기 전에 다음 업그레이드 제약조건에 따라 업그레이드를 계획합니다.

• 네트워크 아키텍처를 업그레이드하면 인스턴스에 평균 최대 4분의 다운타임이 발생할 수 있습니다.

• 진행 중인 데이터 마이그레이션이 있는 경우 데이터 마이그레이션 동안에는 소스 인스턴스를 새 아키텍처로 업그레이드할 수 없습니다.

• 외부 소스에서 인스턴스에 연결하는 경우 커스텀 경로 내보내기를 사용 설정하도록 모든 피어링 연결이 업데이트되었는지 확인합니다.

• 서비스 경계를 사용하는 경우 공유 VPC 호스트 프로젝트가 포함되었는지 확인합니다. 이 프로젝트가 포함되지 않은 경우 마이그레이션이 실패합니다.

• Cloud SQL 인스턴스가 300개를 초과하는 네트워크에서는 인스턴스의 네트워크 아키텍처를 업그레이드할 수 없습니다.

• 네트워크에 동일한 리전에서 비공개 IP 주소를 사용하는 인스턴스가 2개 이상 포함된 경우 인스턴스에 다음 제한사항이 적용됩니다.

  • Cloud SQL은 비공개 서비스 액세스에 할당된 IP 주소 범위에서 /24 범위(또는 여러 범위)를 추가로 사용할 수 있습니다. Cloud SQL은 추가 /24 범위(또는 여러 범위)를 사용하여 새 네트워크 아키텍처에서 인스턴스를 호스팅합니다.
  • 비공개 서비스 액세스에 할당한 IP 주소 범위에 남아 있는 사용 가능한 /24 서브네트워크 범위가 제한되어 있는 경우 Cloud SQL에서 요건을 충족하는 인스턴스에 Google 소유 /24 범위를 사용할 수 있습니다. 업그레이드된 인스턴스를 외부 인스턴스의 복제본으로 다운그레이드할 수는 없습니다.

  이러한 제한사항은 일시적이며 Cloud SQL은 이후 유지보수 이벤트 중에 이를 삭제합니다.

• 장애 조치 복제본이 있는 기존 고가용성(HA) 인스턴스는 업그레이드를 지원하지 않습니다.

• 네트워크 아키텍처를 업그레이드한 후에는 업그레이드된 인스턴스의 기존 HA 장애 조치 복제본을 만들 수 없습니다.

• 비공개 IP 인스턴스를 업그레이드하는 경우 servicenetworking 네트워크와의 피어링 연결에 import-custom-routes 플래그가 사용 설정될 수 있습니다. 업그레이드 후 이 설정을 변경하면 인스턴스의 연결이 끊어질 수 있습니다.

네트워크 프로젝트의 모든 Cloud SQL 인스턴스 업그레이드 계획

Cloud SQL 인스턴스는 VPC 네트워크와 동일한 프로젝트에 있거나 별도의 프로젝트에 상주할 수 있습니다. VPC 네트워크를 호스팅하는 프로젝트가 네트워크 프로젝트입니다.

네트워크 프로젝트는 이중 스택 모드로 작동할 수 있습니다. 즉, 기존 및 신규 네트워크 아키텍처를 사용하여 Cloud SQL 인스턴스를 동시에 호스팅할 수 있습니다. 이는 프로젝트 내에서 최소 하나 이상의 인스턴스가 기존 아키텍처를 사용할 때 발생합니다. 따라서 Cloud SQL이 프로젝트를 새 아키텍처로 업그레이드할 수 없습니다.

프로젝트 내의 모든 인스턴스에 대해 네트워크 아키텍처를 쿼리하려면 gcloud CLI 또는 API를 사용하면 됩니다.

이중 스택 프로젝트의 고려사항

이중 스택 프로젝트를 사용할 때는 다음 항목을 고려하세요.

• 인스턴스를 암시적으로 업그레이드: 인스턴스의 비공개 네트워크를 수정하거나 이중 스택 프로젝트 내에서 비공개 IP 주소를 사용 설정할 때 Cloud SQL은 인스턴스를 새 네트워크 아키텍처로 암시적으로 업그레이드할 수 있습니다.
• 아키텍처 다운그레이드 없음: 네트워크 변경 시 인스턴스의 네트워크 아키텍처가 다운그레이드되지 않습니다.
• 요청 거부: 네트워크 변경을 완료하기 위해 다운그레이드가 필요하면 Cloud SQL이 요청을 거부합니다.
• 새 인스턴스는 이전 네트워크 아키텍처의 IP 범위를 사용할 수 없음: 프로젝트가 이중 스택 모드인 경우 이전 네트워크 아키텍처의 서비스 연결과 연결된 IP 범위를 사용하는 인스턴스를 만들 수 없습니다.

잠재적 충돌을 방지하고 매끄러운 네트워크 업그레이드를 보장하기 위해서는 프로젝트에서 모든 인스턴스를 새 아키텍처로 업그레이드하도록 계획하는 것이 좋습니다.

Cloud SQL 네트워크 아키텍처 업그레이드

Cloud SQL 인스턴스의 네트워크 아키텍처를 업그레이드하려면 다음을 수행합니다.

1. 단일 Cloud SQL 인스턴스 또는 여러 Cloud SQL 인스턴스의 네트워크 아키텍처를 확인합니다.
2. Cloud SQL 인스턴스의 네트워크 아키텍처 업그레이드합니다.

단일 Cloud SQL 인스턴스의 네트워크 아키텍처 확인

단일 인스턴스의 현재 네트워크 아키텍처를 확인하려면 gcloud sql instances describe 명령어 또는 instances.get 메서드를 사용합니다.

   gcloud sql instances describe INSTANCE_NAME
   

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sqlNetworkArchitecture: OLD_NETWORK_ARCHITECTURE
  

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sqlNetworkArchitecture: NEW_NETWORK_ARCHITECTURE
  

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

GET https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

여러 Cloud SQL 인스턴스의 네트워크 아키텍처 확인

프로젝트에 있는 여러 인스턴스의 네트워크 아키텍처를 확인하려면 gcloud sql instances list 명령어 또는 instance.list 메서드를 사용합니다.

gcloud sql instances list --show-sql-network-architecture

NAME        DATABASE_VERSION LOCATION   ...     SQL_NETWORK_ARCHITECTURE
instance_1  POSTGRES_13      asia-northeast1-b  OLD_NETWORK_ARCHITECTURE
instance_2  MYSQL_5_7        europe-west1-d     NEW_NETWORK_ARCHITECTURE
...

LIST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X LIST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

LIST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X LIST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

단일 Cloud SQL 인스턴스의 네트워크 아키텍처 업그레이드

단일 인스턴스의 네트워크 아키텍처를 업그레이드하려면 gcloud sql instances patch 명령어, instance.update 메서드 또는 instance.patch 메서드를 사용합니다.

gcloud sql instances patch INSTANCE_NAME --upgrade-sql-network-architecture

operation_id

operation_id

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

operation_id

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

자주 묻는 질문(FAQ)

이 섹션에서는 Cloud SQL 네트워크 아키텍처 업그레이드에 대해 자주 묻는 질문(FAQ)의 답변을 제공합니다.

• 업그레이드가 Cloud SQL 인스턴스에 어떤 영향을 주나요?
• 업그레이드 후 모든 기능이 동일하게 작동하나요?
• 어떤 인스턴스에서 이전 네트워크 아키텍처를 사용하나요?
• 모든 새 Cloud SQL 인스턴스가 새 네트워크 아키텍처에서 생성되나요?
• 단일 명령어로 프로젝트의 모든 인스턴스를 업데이트할 수 있나요?
• 기본 인스턴스를 업그레이드하면 복제본이 자동으로 업그레이드되나요?
• Cloud SQL 인스턴스의 네트워크 아키텍처가 업그레이드된다는 알림을 받았습니다. 어떤 조치를 취해야 하나요?
• 인스턴스를 업그레이드하려고 하면 '예약된 IP 주소 범위를 벗어남' 오류가 발생합니다. 어떤 조치를 취해야 하나요?

업그레이드가 Cloud SQL 인스턴스에 어떤 영향을 주나요?

네트워크 아키텍처를 업그레이드할 때 Cloud SQL 인스턴스는 MAINTENANCE 상태가 됩니다. 이 상태에서 인스턴스에는 평균적으로 최대 4분의 다운타임이 발생합니다. 인스턴스에 대한 추가 변경사항은 업그레이드가 완료될 때까지 허용되지 않습니다. 프로젝트 또는 네트워크의 다른 인스턴스는 업그레이드에 영향을 받지 않습니다.

업그레이드 후 모든 기능이 동일하게 작동하나요?

Cloud SQL 인스턴스의 모든 기능은 이전 아키텍처에서와 같이 새 아키텍처에서도 동일하게 작동합니다. 새 네트워크 아키텍처를 사용하도록 인스턴스를 업그레이드한 후 해당 인스턴스의 네트워크를 전환하려면 목적지 네트워크의 모든 인스턴스도 새 네트워크 아키텍처로 업그레이드되어야 합니다.

어떤 인스턴스에서 이전 네트워크 아키텍처를 사용하나요?

2021년 8월 이후에 생성된 새 프로젝트는 자동으로 새 네트워크 아키텍처를 사용합니다. 기존 프로젝트에는 2021년 8월 이전에 생성되었으며 여전히 이전 네트워크 아키텍처를 사용하는 Cloud SQL 인스턴스가 포함될 수 있습니다. 따라서 기존 프로젝트 내의 새 인스턴스가 새 네트워크 아키텍처를 사용하려면 먼저 해당 프로젝트 내의 모든 인스턴스를 업그레이드해야 합니다.

모든 새 Cloud SQL 인스턴스가 새 네트워크 아키텍처에서 생성되나요?

기본적으로 2021년 8월 이후에 생성된 프로젝트에서 만든 새 Cloud SQL 인스턴스에는 새 네트워크 아키텍처가 사용됩니다.

2021년 8월 이전에 생성된 프로젝트에 인스턴스를 만들고 새 네트워크 아키텍처를 사용하려면 해당 프로젝트의 모든 기존 인스턴스를 새 네트워크 아키텍처로 업데이트해야 합니다. 공유 VPC를 사용하는 경우 공유 VPC에 참여 중인 프로젝트의 모든 인스턴스를 업데이트해야 합니다.

프로젝트의 모든 기존 인스턴스를 업데이트한 후 몇 시간 정도 기다리고 나서 프로젝트에 인스턴스를 만듭니다. 프로젝트에서 만드는 새 인스턴스에 새 네트워크 아키텍처가 사용됩니다.

기존 네트워크 아키텍처가 사용되는 최근에 삭제한 인스턴스가 있으면 새 네트워크 아키텍처로 새 인스턴스를 만들기 전에 며칠 정도 기다려야 합니다. 이러한 지연 시간 동안 삭제된 인스턴스를 복원할 수 있습니다.

단일 명령어로 프로젝트의 모든 인스턴스를 업데이트할 수 있나요?

아니요. 새 네트워크 아키텍처로의 업그레이드는 각 인스턴스를 기반으로 합니다.

기본 인스턴스를 업그레이드하면 복제본이 자동으로 업그레이드되나요?

아니요. 새 네트워크 아키텍처로의 업그레이드는 각 개별 인스턴스를 기반으로 합니다. 각 복제본은 별도의 인스턴스로 취급되며, 개별적으로 업그레이드해야 합니다. 즉, 기본 인스턴스가 업그레이드되고 복제본에 이전 네트워크 아키텍처가 사용되는 경우 복제본은 영향을 받지 않습니다. 반대의 경우도 마찬가지입니다. 복제본을 업그레이드하는 경우 기본 인스턴스가 영향을 받지 않습니다.

Cloud SQL 인스턴스의 네트워크 아키텍처가 업그레이드된다는 알림을 받았습니다. 어떤 조치를 취해야 하나요?

별도로 취할 조치는 없습니다.

일부 인스턴스의 경우 비공개 네트워크에서 자동 업그레이드가 발생하면 요청이 일시적으로 거부됩니다. 이 문제를 해결하려면 단일 Cloud SQL 인스턴스의 네트워크 아키텍처 업그레이드의 절차에 따라 인스턴스의 네트워크 아키텍처를 직접 업그레이드하면 됩니다.

인스턴스를 업그레이드하려고 하면 '예약된 IP 주소 범위를 벗어남' 오류가 발생합니다. 어떤 조치를 취해야 하나요?

비공개 IP가 있는 VPC 네트워크에서 Cloud SQL 인스턴스를 사용하려면 VPC 네트워크에 비공개 서비스 액세스를 설정할 때 IP 주소 범위를 할당합니다.

예를 들어 IP 할당된 주소 범위가 변경되거나 삭제된 경우 다음과 비슷한 오류가 발생할 수 있습니다.

Network architecture upgrade not allowed for private-ip instance PROJECT_ID:INSTANCE_NAME
whose IP address range 10.0.0.0/24 is outside the reserved IP address range for
private services access. Re-allocate the IP address range for private services access and retry.

이 예시에서 원래 할당된 IP 주소 범위는 이름이 google-managed-services-VPC_NETWORK_NAME이고 원래 할당된 IP 주소 범위는 10.0.0.0/16입니다. 그런 다음 비공개 IP 주소가 10.0.0.1인 인스턴스를 만듭니다. google-managed-services-VPC_NETWORK_NAME의 IP 주소 범위가 삭제되거나 10.1.0.0/16 범위를 참조하도록 업데이트된 경우 이 범위는 인스턴스의 비공개 IP 주소 10.0.0.1을 포함하지 않습니다. 그런 다음 인스턴스의 네트워크 아키텍처를 업그레이드하려고 하면 outside the reserved IP address range 오류가 발생합니다.

이 문제를 해결하려면 Cloud SQL용 비공개 서비스 액세스 구성의 절차를 따르세요. 인스턴스의 IP 주소가 포함된 IP 주소 범위를 비공개 서비스 액세스에 할당된 범위에 다시 할당합니다. 최소한 오류 메시지에 보고된 IP 주소 범위(이전 예시: 10.0.0.0/24)를 할당할 수 있습니다.

그런 다음 네트워크 아키텍처 업그레이드를 다시 시도합니다.

다음 단계

• Private Service Connect 자세히 알아보기
• Assured Workloads 자세히 알아보기
• Cloud SQL용 비공개 서비스 액세스 구성 자세히 알아보기
• PostgreSQL용 AlloyDB를 위한 Database Migration Service 자세히 알아보기