Memindahkan instance

Halaman ini menjelaskan cara memindahkan instance di Spanner.

Anda dapat memindahkan instance Spanner dari konfigurasi instance mana pun ke konfigurasi instance lainnya, termasuk antara konfigurasi regional, dual-region, dan multi-region. Memindahkan instance tidak menyebabkan periode nonaktif, dan Spanner terus memberikan jaminan transaksi seperti biasa, termasuk konsistensi yang kuat, selama pemindahan.

Anda juga dapat memindahkan instance dari konfigurasi instance sumbernya ke konfigurasi instance kustom (misalnya, konfigurasi dasar nam3 dengan replika hanya baca us-west2). Karena Anda tidak dapat memperbarui topologi konfigurasi instance yang ada, Anda harus membuat konfigurasi instance kustom baru dengan topologi yang Anda inginkan terlebih dahulu. Setelah membuat konfigurasi instance kustom baru, Anda dapat memindahkan instance dari konfigurasi instance sumber ke konfigurasi instance kustom baru.

Mengapa Anda perlu memindahkan instance Spanner?

Manfaat memindahkan instance Anda meliputi:

• Meningkatkan ketersediaan: Dapatkan ketersediaan 99,999% tanpa periode nonaktif setelah melakukan pemindahan regional ke dual-region atau multi-region.
• Mengurangi latensi: Kurangi latensi dan tingkatkan cakupan geografis dengan replika hanya baca tambahan melalui pemindahan regional ke dual-region atau multi-region atau multi-region ke multi-region.
• Mengurangi biaya: Kurangi biaya per jam dengan beralih dari konfigurasi dual-region atau multi-region ke konfigurasi regional.
• Menempatkan database: Tempatkan database Spanner dengan aplikasi klien dengan memindahkan instance ke lokasi yang lebih dioptimalkan.

Harga

Saat memindahkan instance, konfigurasi instance sumber dan tujuan dikenai biaya komputasi dan penyimpanan per jam. Setelah pemindahan selesai, Anda akan ditagih untuk penyimpanan instance pada konfigurasi tujuan.

Jika Anda memindahkan instance ke konfigurasi instance regional, dual-region, atau multi-region baru, Anda mungkin akan dikenai biaya transfer data keluar. Untuk mengetahui informasi selengkapnya, lihat Harga Spanner.

Batasan

• Untuk memindahkan instance, instance harus memiliki minimal 1 node (1.000 unit pemrosesan).
• Anda tidak dapat memindahkan instance ke project atau akun Google Cloud lain.
• Anda tidak dapat memindahkan instance yang menggunakan edisi Standard langsung dari konfigurasi instance regional ke konfigurasi instance dual-region atau multi-region. Anda harus mengupgrade edisi instance ke edisi Enterprise Plus terlebih dahulu, lalu memindahkan instance.
• Jika Anda memiliki permintaan aktif yang menggunakan endpoint layanan regional di salah satu resource instance, pemindahan instance akan memengaruhi semua permintaan yang menggunakan endpoint regional karena penerapan regional memblokir akses ke instance lintas region. Permintaan yang menggunakan endpoint global tidak akan terpengaruh.
• Cadangan dan jadwal pencadangan Spanner bersifat spesifik untuk konfigurasi instance dan tidak disertakan saat memindahkan instance. Anda harus menghapus semua cadangan dan jadwal pencadangan yang ada di instance sebelum memulai pemindahan. Untuk mengetahui informasi selengkapnya, lihat Pencadangan dan jadwal pencadangan.
• API berikut dinonaktifkan selama pemindahan instance:
  • InstanceAdmin.DeleteInstance
  • InstanceAdmin.UpdateInstance
  • InstanceAdmin.CreateInstancePartition
  • InstanceAdmin.UpdateInstancePartition
  • InstanceAdmin.DeleteInstancePartition
  • DatabaseAdmin.CreateDatabase
  • DatabaseAdmin.UpdateDatabaseDdl (Dinonaktifkan jika default_leader ditentukan dalam permintaan.)
  • DatabaseAdmin.RestoreDatabase
  • DatabaseAdmin.CreateBackup
  • DatabaseAdmin.CreateBackupSchedule
  • DatabaseAdmin.CopyBackup
• Jika database memiliki leader default yang diubah, pilihan akan dipertahankan jika menyebutkan region baca-tulis dalam konfigurasi instance tujuan, dan konfigurasi tersebut adalah multi-region. Jika konfigurasi tujuan bersifat regional, atau tidak menyertakan region baca-tulis yang diberi nama, pemilihan leader default akan dihapus.
• Memindahkan instance akan mengubah atribut konfigurasi instance dari instance Anda. Jika Anda mengelola resource Spanner melalui otomatisasi, pastikan untuk menyiapkan dan mengatasi inkonsistensi yang mungkin muncul.
  • Misalnya, jika Anda menggunakan Terraform untuk mengelola instance dan database Spanner, dan Anda mengaktifkan terraform apply --auto-approve agar resource tetap sinkron, semua instance dan resource turunan akan dihapus saat kami memindahkan instance. Perbarui konfigurasi sebagaimana mestinya untuk menghindari penghapusan dan kehilangan data. Lihat Opsi Penerapan Terraform untuk mengetahui informasi selengkapnya tentang perintah apply.
• Saat instance dipindahkan, metrik dan diagram pemantauan Spanner mungkin menampilkan data dalam konfigurasi instance sumber dan tujuan, atau mungkin hanya mencerminkan performa dalam satu konfigurasi instance.
• Jika telah mengonfigurasi alat Autoscaler open source, Anda tidak perlu menonaktifkannya. Operasi ini gagal karena InstanceAdmin.UpdateInstance (digunakan untuk perubahan node dan unit pemrosesan) dinonaktifkan.
• Anda tidak dapat memindahkan instance jika fitur autoscaler terkelola Spanner diaktifkan di instance tersebut. Sebelum memindahkan instance, alihkan instance dari penskalaan otomatis terkelola ke alokasi manual dengan node atau unit pemrosesan yang cukup untuk mendukung penggunaan CPU puncak Anda (misalnya, dengan menjalankan gcloud spanner instances update INSTANCE_ID --nodes=PEAK_NODES). Setelah pemindahan selesai, Anda dapat mengaktifkan kembali autoscaler terkelola.
• Anda tidak dapat memindahkan instance uji coba gratis Spanner. Anda dapat memindahkan instance setelah mengupgrade ke instance berbayar.
• Jika instance menggunakan partisi geografis, memindahkan instance hanya akan memindahkan partisi instance default, bukan partisi instance tambahan.

Pertimbangan performa

Saat dipindahkan, instance akan mengalami latensi baca-tulis yang lebih tinggi dan tingkat pembatalan transaksi yang lebih tinggi. Pemakaian CPU selama pemindahan mungkin naik hingga 100% karena pemindahan instance dilakukan menggunakan CPU cadangan yang telah Anda sediakan dan menghasilkan traffic produksi. Namun, memindahkan instance tidak menyebabkan periode nonaktif. Waktu yang diperlukan untuk memindahkan instance bergantung pada berbagai faktor, termasuk ukuran database, jumlah node, dan jenis pemindahan (misalnya, regional ke multi-region).

Misalnya, agar pemindahan selesai dalam waktu 24 jam, instance Anda biasanya harus memenuhi persyaratan berikut sebelum dan selama pemindahan:

• Pemakaian CPU prioritas tinggi: Kurang dari 40% dalam konfigurasi instance sumber. Untuk informasi selengkapnya, lihat Pemakaian CPU.
• Penyimpanan per node: Kurang dari 1 Tebibyte (TiB) per node.

Setelah memindahkan instance, performa instance bervariasi bergantung pada detail konfigurasi instance. Misalnya, konfigurasi dual-region dan multi-region umumnya memiliki latensi tulis yang lebih tinggi dan latensi baca yang lebih rendah daripada konfigurasi regional.

Pencadangan dan jadwal pencadangan

Saat Anda memindahkan instance, cadangan dan jadwal pencadangan dalam konfigurasi asli instance tidak akan dipindahkan ke konfigurasi tujuan baru secara otomatis. Pemindahan instance gagal dimulai jika ada pencadangan atau jadwal pencadangan (termasuk jadwal pencadangan default) pada instance saat Anda memulai pemindahan. Salin cadangan Anda dan pertimbangkan rencana pemulihan data sebelum memindahkan instance.

Jika ada cadangan dalam konfigurasi asli instance yang perlu Anda simpan, sebaiknya salin cadangan Anda ke dua instance sementara kecil (100 PU), placeholder-source dan placeholder-dest:

• placeholder-source: instance dengan konfigurasi instance yang sama dengan konfigurasi asli instance yang dipindahkan. Tindakan ini memungkinkan Anda memulihkan cadangan ke konfigurasi asli jika Anda perlu membatalkan pemindahan.

• placeholder-dest: instance dengan konfigurasi instance yang sama dengan konfigurasi instance tujuan. Tindakan ini memastikan Anda memiliki cadangan yang langsung tersedia dalam konfigurasi baru segera setelah pemindahan selesai.

Fitur pemulihan tidak mendukung pemulihan lintas konfigurasi, sehingga instance placeholder ini sangat penting untuk rollback atau pemulihan cepat dalam konfigurasi baru jika diperlukan, sehingga memberikan jaring pengaman jika terjadi masalah dengan instance yang dipindahkan.

Setelah menyalin cadangan ke placeholder-source dan placeholder-dest, Anda harus menghapus semua cadangan dan jadwal pencadangan yang ada pada instance yang dipindahkan sebelum dapat memulai pemindahan (lihat Menyalin cadangan ke instance placeholder dan menghapus cadangan dan jadwal pencadangan yang ada untuk perintah yang tepat). Kemudian, setelah pemindahan instance selesai, Anda sudah memiliki salinan cadangan dalam konfigurasi tujuan, dan Anda dapat membuat ulang jadwal pencadangan dan membuat cadangan baru.

Dengan mengikuti pendekatan ini, Anda dapat mempertahankan kelangsungan bisnis dan meminimalkan potensi periode nonaktif atau kehilangan data selama proses pemindahan instance.

Cara memindahkan instance

Anda dapat memindahkan instance menggunakan konsol Google Cloud atau gcloud CLI. Ikuti empat fase ini untuk menyiapkan, menjalankan, memantau, dan menyelesaikan pemindahan instance Anda:

• Fase 1: Menyiapkan instance untuk pemindahan
• Tahap 2: Memulai pemindahan instance
• Fase 3: Memantau pemindahan instance
• Fase 4: Menyelesaikan tugas pascapemindahan

Fase 1: Menyiapkan instance untuk dipindahkan

Sebelum memindahkan instance, baca bagian Batasan dan Pertimbangan performa, lalu selesaikan setiap langkah dalam checklist pra-pemindahan ini:

1. Verifikasi izin, edisi, dan kuota tujuan:

   • Pastikan operator yang menjalankan pemindahan memiliki izin IAM spanner.instances.update pada instance yang dipindahkan.
   • Pastikan project Anda memiliki kuota node yang memadai dalam konfigurasi instance tujuan untuk mendukung kapasitas puncak. Untuk mengetahui informasi selengkapnya, lihat Kuota & Batas Spanner.
   • Jika Anda memindahkan instance edisi Standard dari konfigurasi regional ke konfigurasi dual-region atau multi-region, upgrade edisi ke edisi Enterprise Plus terlebih dahulu.

2. Memvalidasi kondisi workload, merencanakan penempatan klien, dan menguji di lingkungan non-produksi:

   • Pindahkan instance non-produksi (seperti pengujian atau staging) yang mencerminkan instance produksi Anda terlebih dahulu untuk memperkirakan durasi pemindahan dan mengamati efek performa pada workload Anda.
   • Pastikan tidak ada hotspot di database Anda menggunakan Key Visualizer. Menyelesaikan hotspot sebelum pemindahan membantu mencegah peningkatan latensi dan pembatalan transaksi saat data sedang disalin.
   • Jika konfigurasi tujuan Anda memiliki region leader default yang berbeda dengan sumber, latensi tulis Anda mungkin meningkat setelah pemindahan. Untuk mencegah hal ini, rencanakan untuk men-deploy atau merutekan aplikasi klien yang banyak melakukan penulisan di atau di dekat region leader tujuan.

3. Beralih dari penskalaan otomatis terkelola ke alokasi dan ukuran manual untuk pemindahan:

   • Untuk membantu pemindahan selesai dalam waktu 24 jam dan meminimalkan dampak latensi, sediakan kapasitas komputasi yang cukup sehingga pemanfaatan CPU prioritas tinggi puncak kurang dari 40% dan penyimpanan per node kurang dari 1 TiB selama pemindahan. Periksa diagram CPU utilization dan Total storage di System insights untuk menentukan jumlah node yang diperlukan untuk workload puncak Anda. Karena Spanner menggunakan CPU cadangan untuk memindahkan data, peningkatan kapasitas komputasi akan meningkatkan kecepatan pemindahan instance. Anda dapat mengonfirmasi kapasitas komputasi yang ideal untuk workload dengan menguji perpindahan di lingkungan pra-produksi atau staging.

   • Jika autoscaler terkelola diaktifkan pada instance, Anda harus mengalihkan instance ke alokasi manual sebelum memulai pemindahan, menggunakan jumlah node yang Anda tentukan diperlukan untuk menjaga puncak pemakaian CPU prioritas tinggi di bawah 40%:

     gcloud spanner instances update INSTANCE_ID \
       --nodes=PEAK_NODES
     

4. Menyalin cadangan ke instance placeholder dan menghapus cadangan serta jadwal pencadangan yang ada:

   • Buat instance placeholder-source dan placeholder-dest sementara yang dibahas di bagian Pencadangan dan jadwal pencadangan, lalu salin cadangan penting Anda ke instance tersebut menggunakan perintah gcloud spanner backups copy:

     gcloud spanner backups copy \
       --source-instance=INSTANCE_ID \
       --source-backup=SOURCE_BACKUP_ID \
       --destination-instance=PLACEHOLDER_INSTANCE_ID \
       --destination-backup=DESTINATION_BACKUP_ID \
       --expiration-date=EXPIRATION_DATE
     

   • Pastikan semua operasi salinan cadangan pada instance placeholder telah selesai sebelum menghapus cadangan pada instance yang dipindahkan:

     gcloud spanner operations list \
       --instance=PLACEHOLDER_INSTANCE_ID \
       --type=BACKUP
     

   • Hapus semua cadangan yang ada dan hapus semua jadwal pencadangan di setiap database dalam instance yang dipindahkan:

     gcloud spanner backups delete BACKUP_ID \
       --instance=INSTANCE_ID
     

     gcloud spanner backup-schedules delete SCHEDULE_ID \
       --instance=INSTANCE_ID \
       --database=DATABASE_ID
     

5. Ekspor tag Data Catalog, jeda otomatisasi, serta bekukan perubahan instance dan skema:

   • Memindahkan instance akan menghapus tag instance apa pun yang Anda buat di Data Catalog. Ekspor tag Anda sebelum pemindahan agar Anda dapat mengimpornya setelahnya. Untuk mengetahui informasi selengkapnya, lihat Mengekspor dan mengimpor tag.
   • Periksa alur kerja CI/CD, tugas terjadwal, atau repositori GitOps Anda untuk mengetahui pipeline infrastruktur otomatis (seperti operasi terraform apply --auto-approve terjadwal) yang mengelola resource Spanner Anda, dan jeda pipeline tersebut agar tidak bertentangan dengan pemindahan yang sedang berlangsung.
   • Sampaikan kepada organisasi Anda bahwa perubahan instance dan skema (termasuk update jumlah node, update DDL, pembuatan atau penghapusan database, dan operasi pencadangan) harus dijeda hingga pemindahan selesai.

6. Khusus database yang mengaktifkan CMEK: Verifikasi region tujuan dan kunci Cloud Key Management Service (Cloud KMS):

   • Periksa konfigurasi instance tujuan untuk mengidentifikasi semua region baca-tulis, hanya baca, dan saksi yang ada:

     gcloud spanner instance-configs describe TARGET_CONFIG
     

   • Pastikan Anda telah menyediakan kunci Cloud KMS di setiap region konstituen konfigurasi tujuan dan memberikan peran Identity and Access Management (IAM) roles/cloudkms.cryptoKeyEncrypterDecrypter pada setiap kunci target ke agen layanan Spanner.

Jika instance Anda memenuhi panduan prapemindahan ini, pemindahan biasanya selesai dalam waktu 24 jam. Bergantung pada ukuran database dan workload aplikasi, waktu penyelesaian mungkin lebih lama atau lebih singkat.

Tahap 2: Memulai pemindahan instance

gcloud spanner instances move INSTANCE_ID \
--target-config=TARGET_CONFIG

  gcloud spanner instances move test-instance --target-config=nam3

gcloud spanner instances move INSTANCE_ID \
  --target-config=TARGET_CONFIG \
  --target-database-move-configs=^:^database-id=DATABASE_ID_1:kms-key-names=KMS_KEY_1[, KMS_KEY_2 ... ] \
  [--target-database-move-configs=^:^database-id=DATABASE_ID_2:kms-key-names=KMS_KEY_1 ... ]

gcloud spanner instances move INSTANCE_ID \
  --target-config=TARGET_CONFIG \
  --target-database-move-configs=CONFIG_FILE_PATH

[
  {
    "database-id": "database-1",
    "kms-key-names": "projects/PROJECT_ID/locations/us-east4/keyRings/KEY_RING/cryptoKeys/KEY_NAME,projects/PROJECT_ID/locations/us-east1/keyRings/KEY_RING/cryptoKeys/KEY_NAME,projects/PROJECT_ID/locations/us-central1/keyRings/KEY_RING/cryptoKeys/KEY_NAME"
  },
  {
    "database-id": "database-2",
    "kms-key-names": "projects/PROJECT_ID/locations/us-east4/keyRings/KEY_RING/cryptoKeys/KEY_NAME,projects/PROJECT_ID/locations/us-east1/keyRings/KEY_RING/cryptoKeys/KEY_NAME,projects/PROJECT_ID/locations/us-central1/keyRings/KEY_RING/cryptoKeys/KEY_NAME"
  }
]

Fase 3: Memantau pemindahan instance

Anda dapat menggunakan gcloud spanner operations describe dan dasbor Cloud Monitoring kustom untuk memantau progres pemindahan atau pembatalan instance.

Melihat progres operasi pemindahan dan pembatalan

Untuk melacak progres operasi pemindahan instance atau pembatalan pemindahan instance, gunakan perintah gcloud spanner operations describe. Perintah ini memerlukan ID operasi dari operasi pemindahan instance yang sedang berlangsung.

1. Dapatkan ID operasi untuk operasi pemindahan instance Anda dengan menjalankan:

   gcloud spanner operations list --instance="INSTANCE_ID"
   

   Ganti kode berikut:

   • INSTANCE_ID: ID permanen untuk instance yang ingin Anda pindahkan.

   Output-nya menampilkan daftar operasi yang berjalan lama, termasuk operasi pemindahan instance.

2. Jalankan perintah gcloud spanner operations describe untuk melihat persentase progres dan status:

   gcloud spanner operations describe OPERATION_ID --instance=INSTANCE_ID
   

   Ganti kode berikut:

   • OPERATION_ID: ID operasi dari operasi pemindahan instance yang ingin Anda periksa.
   • INSTANCE_ID: ID instance untuk instance yang ingin Anda periksa.

Memantau operasi pemindahan instance

Anda dapat membuat dasbor Cloud Monitoring kustom untuk menampilkan dan memantau metrik selama pemindahan instance, yang merupakan operasi yang berjalan lama dengan potensi implikasi layanan.

Grafik Total storage dan Total database storage by databases di dasbor berguna untuk memantau progres pemindahan. Anda dapat melihat penyimpanan dalam konfigurasi sumber menurun secara bertahap, sementara penyimpanan dalam konfigurasi tujuan meningkat.

Fase 4: Menyelesaikan tugas pasca-pemindahan

Setelah operasi pemindahan yang berjalan lama selesai (done: true), selesaikan checklist pasca-pemindahan berikut untuk memulihkan konfigurasi operasional Anda:

1. Aktifkan kembali autoscaler terkelola: Jika Anda beralih dari penskalaan otomatis terkelola ke alokasi manual sebelum pemindahan, aktifkan kembali autoscaler terkelola dengan batas kapasitas komputasi minimum dan maksimum (misalnya, dengan menjalankan gcloud spanner instances update INSTANCE_ID dengan flag penskalaan otomatis atau di konsol Google Cloud ).
2. Buat ulang jadwal pencadangan dan buat cadangan: Buat ulang jadwal pencadangan dan buat cadangan baru untuk database Anda dalam konfigurasi instance tujuan.
3. Mengimpor tag Data Catalog: Jika Anda mengekspor tag Data Catalog sebelum pemindahan, impor kembali ke instance yang dipindahkan.
4. Mengupdate konfigurasi otomatisasi, penempatan klien, dan workload downstream:
   • Jika Anda mengelola resource Spanner menggunakan alat otomatisasi seperti Terraform, perbarui file konfigurasi Anda untuk mencerminkan konfigurasi instance tujuan baru sebelum mengaktifkan kembali deployment otomatis.
   • Jika region leader Anda berubah setelah pemindahan, deploy atau rute aplikasi klien Anda di dalam atau di dekat region leader baru (atau ubah region leader default database jika menggunakan konfigurasi dual-region atau multi-region) untuk meminimalkan latensi tulis, dan verifikasi konektivitas dan latensi di seluruh aplikasi dan pipeline downstream.
5. Hapus instance placeholder sementara: Setelah memverifikasi instance yang dipindahkan dan membuat cadangan baru dalam konfigurasi tujuan, hapus instance placeholder-source dan placeholder-dest sementara jika Anda tidak lagi memerlukan cadangan yang disalin.

Cara membatalkan pemindahan instance

Anda hanya dapat membatalkan pemindahan instance yang masih dalam proses. Jika ingin mengembalikan pemindahan instance yang sudah selesai, Anda harus memulai pemindahan baru.

Anda dapat menggunakan gcloud spanner operations cancel untuk membatalkan operasi pemindahan instance. Pembatalan tidak terjadi secara instan dan memerlukan waktu yang kurang lebih sama dengan waktu yang telah berlalu sejak awal pemindahan. Hal ini karena data harus dipindahkan kembali ke konfigurasi instance sumber.

Perintah ini memerlukan ID operasi dari operasi pemindahan instance yang sedang berlangsung.

1. Dapatkan ID operasi dengan menjalankan:

   gcloud spanner operations list --type=INSTANCE --instance="INSTANCE_ID"
   --filter="done:False AND metadata.@type:MoveInstanceMetadata"
   

   Ganti kode berikut:

   • INSTANCE_ID: ID permanen untuk instance yang ingin Anda pindahkan.

   Output akan menampilkan daftar operasi pemindahan instance yang sedang berlangsung.

2. Jalankan perintah gcloud spanner operations cancel untuk membatalkan pemindahan instance:

   gcloud spanner operations cancel OPERATION_ID
   

   Ganti kode berikut:

   • OPERATION_ID: ID operasi dari operasi pemindahan instance yang ingin Anda batalkan.

Langkah berikutnya

• Pelajari lebih lanjut Konfigurasi regional, dual-region, dan multi-region Spanner.
• Pelajari lebih lanjut Google Cloud region dan zona.