Mengupgrade instance ke arsitektur jaringan baru

Halaman ini menjelaskan cara mengupgrade instance Cloud SQL Anda dari arsitektur jaringan lama ke arsitektur jaringan baru.

Halaman upgrade arsitektur jaringan Cloud SQL ini hanya berlaku untuk beberapa instance Cloud SQL. Jika instance Cloud SQL Anda menggunakan project jaringan Virtual Private Cloud (VPC) yang dibuat sebelum Agustus 2021, Anda harus mengupgrade arsitektur jaringan Cloud SQL untuk instance tersebut.

Ringkasan

Tabel berikut menunjukkan manfaat arsitektur jaringan baru dibandingkan dengan arsitektur jaringan lama:

Merencanakan upgrade

Sebelum mengupgrade arsitektur jaringan instance Cloud SQL, rencanakan upgrade sesuai dengan batasan upgrade berikut:

• Upgrade arsitektur jaringan Anda akan mengakibatkan periode nonaktif database selama sekitar dua menit.

• Jika ada migrasi data yang sedang berlangsung, Anda tidak dapat mengupgrade instance sumber ke arsitektur baru selama migrasi data.

• Jika selama empat hari terakhir atau kurang, ada dua instance atau lebih di jaringan Anda di region yang sama, Anda hanya dapat mengupgrade instance yang memiliki ketersediaan tinggi aktif.

  Catatan: Dalam skenario ini, Cloud SQL menggunakan rentang /24 ekstra untuk sementara guna menghosting instance yang diupgrade pada arsitektur baru. Setelah Cloud SQL mengupgrade semua instance dalam kombinasi jaringan dan region, Cloud SQL akan merilis rentangnya.

  Misalnya, jika jaringan Anda berisi dua instance dan satu di us-east1 dan yang satunya di us-central1, Anda dapat mengupgrade kedua instance, terlepas dari apakah ketersediaan tinggi diaktifkan atau tidak. Namun, jika jaringan Anda berisi tiga instance dan satu instance berada di us-east1 dan dua instance lainnya berada di us-central1, Anda dapat mengupgrade instance di us-central1 yang mengaktifkan ketersediaan tinggi. Karena instance di us-east1 adalah satu-satunya instance di region tersebut, Anda dapat melakukan upgrade, terlepas dari apakah ketersediaan tinggi diaktifkan atau tidak.

• Setelah mengupgrade instance ketersediaan tinggi ke arsitektur jaringan baru, Anda tidak dapat menonaktifkan ketersediaan tinggi pada instance tersebut.

Merencanakan untuk mengupgrade semua instance Cloud SQL di project jaringan

Instance Cloud SQL Anda dapat berada dalam project yang sama dengan jaringan VPC atau dapat dihosting di project terpisah. Project yang menghosting jaringan VPC adalah project jaringan.

Jika setidaknya satu instance Cloud SQL dalam project jaringan menggunakan arsitektur jaringan lama, maka seluruh project akan menggunakan arsitektur jaringan lama. Dalam hal ini, project Anda tidak sepenuhnya diupgrade ke arsitektur jaringan baru.

Anda dapat menggunakan gcloud CLI atau Cloud SQL Admin API untuk mengkueri arsitektur jaringan untuk semua instance Cloud SQL dalam sebuah project.

Saat mengubah jaringan pribadi instance atau mengaktifkan IP pribadi untuk sebuah instance, Anda tidak dapat mengubah arsitektur jaringan dalam permintaan yang sama. Jika Anda melakukannya, permintaan akan ditolak. Untuk menghindari hal ini, sebaiknya Anda mengupgrade semua instance dalam project jaringan sebelum mengubah project jaringan.

Mengupgrade arsitektur jaringan Cloud SQL Anda

Untuk mengupgrade arsitektur jaringan instance Cloud SQL Anda, lakukan langkah berikut:

1. Periksa arsitektur jaringan satu instance Cloud SQL atau beberapa instance Cloud SQL.
2. Mengupgrade arsitektur jaringan instance Cloud SQL.

Memeriksa arsitektur jaringan dari satu instance Cloud SQL

Untuk memeriksa arsitektur jaringan saat ini dari satu instance, gunakan perintah gcloud sql instances describe atau metode instances.get.

   gcloud sql instances describe INSTANCE_NAME
   

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sql_network_architecture: OLD_NETWORK_ARCHITECTURE
  

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sql_network_architecture: 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)
  ...
}

Memeriksa arsitektur jaringan beberapa instance Cloud SQL

Untuk memeriksa arsitektur jaringan beberapa instance dalam sebuah project, gunakan perintah gcloud sql instances list atau metode 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)
  ...
}

Mengupgrade arsitektur jaringan dari instance Cloud SQL tunggal

Untuk mengupgrade arsitektur jaringan untuk satu instance, gunakan perintah gcloud sql instances patch, metode instance.update, atau metode 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/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/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/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
  ...
}

Pertanyaan umum (FAQ)

Bagian ini berisi jawaban atas pertanyaan umum (FAQ) tentang mengupgrade arsitektur jaringan Cloud SQL Anda.

Apa dampak upgrade terhadap instance Cloud SQL saya?

Saat mengupgrade arsitektur jaringan Anda, instance Cloud SQL memiliki status PERAWATAN. Dalam status ini, instance mengalami periode nonaktif hingga tiga menit dan perubahan tambahan pada instance tidak diizinkan hingga upgrade selesai. Instance lain dalam project atau jaringan Anda tidak akan terpengaruh oleh upgrade.

Apakah semua fitur berfungsi sama setelah upgrade?

Semua fitur instance Cloud SQL Anda berfungsi sama pada arsitektur baru seperti pada arsitektur lama. Setelah Anda mengupgrade instance untuk menggunakan arsitektur jaringan baru, jika ingin mengalihkan jaringan dari instance tersebut, pastikan semua instance di jaringan tujuan juga diupgrade ke arsitektur jaringan yang baru.

Instance mana yang menggunakan arsitektur jaringan lama?

Setiap project baru yang dibuat setelah Agustus 2021 akan otomatis menggunakan arsitektur jaringan baru. Project yang sudah ada dapat berisi instance Cloud SQL yang sudah lebih dari dua tahun dan masih menggunakan arsitektur jaringan lama. Oleh karena itu, semua instance dalam project yang ada harus diupgrade sebelum instance baru dalam project tersebut dapat mulai menggunakan arsitektur jaringan baru.

Apakah semua instance Cloud SQL baru dibuat di arsitektur jaringan baru?

Secara default, instance Cloud SQL baru yang dibuat di project yang dibuat setelah Agustus 2021 menggunakan arsitektur jaringan baru. Jika ingin membuat instance dalam project yang dibuat sebelum Agustus 2021, dan menggunakan arsitektur jaringan baru, Anda harus melakukan hal berikut:

1. Update semua instance yang ada dalam project tersebut ke arsitektur jaringan yang baru.

2. Jika Anda memiliki kontrak dukungan Google Cloud, buat permintaan dukungan untuk mengubah arsitektur jaringan default project ke arsitektur baru.

3. Jika Anda tidak memiliki kontrak dukungan, buat instance, lalu upgrade ke arsitektur jaringan baru.

Setelah default project diubah, Anda dapat membuat instance dengan arsitektur jaringan baru dalam project tersebut.

Jika Anda tidak mengubah arsitektur jaringan default project, semua instance baru dalam project tersebut akan menggunakan arsitektur jaringan lama. Kemudian, Anda harus mengupgrade setiap instance ini satu per satu ke arsitektur jaringan yang baru.

Apakah mungkin untuk mengupdate semua instance dalam sebuah project dengan satu perintah?

Tidak, upgrade ke arsitektur jaringan yang baru didasarkan pada setiap instance.

Apakah replika akan otomatis diupgrade jika saya mengupgrade yang utama?

Tidak, upgrade ke arsitektur jaringan baru didasarkan pada setiap instance. Setiap replika diperlakukan sebagai instance terpisah dan harus diupgrade secara terpisah. Artinya, jika jaringan utama diupgrade dan replika menggunakan arsitektur jaringan lama, replika tidak akan terpengaruh. Hal sebaliknya juga berlaku. Jika Anda mengupgrade replika, replika utama tidak akan terpengaruh.

Langkah selanjutnya

• Baca selengkapnya tentang Private Service Connect
• Baca selengkapnya tentang Assured Workloads
• Baca selengkapnya tentang Mengonfigurasi akses layanan pribadi untuk Cloud SQL
• Baca selengkapnya tentang Layanan migrasi database ke AlloyDB untuk PostgreSQL