Memigrasikan workload Redis dan Valkey ke Memorystore for Valkey

Dokumen ini menjelaskan cara mengotomatiskan migrasi workload Redis dan Valkey yang dikelola sendiri ke Memorystore for Valkey. Bermigrasi ke lingkungan yang terkelola sepenuhnya akan menghilangkan beban operasional dalam mengelola infrastruktur Anda sendiri, sehingga Anda tidak perlu menangani patching OS manual, penyiapan replikasi, atau skrip pencadangan kustom. Fitur ini memungkinkan Anda memanfaatkan failover otomatis bawaan, konektivitas VPC yang aman, dan penskalaan tanpa periode nonaktif.

Dengan memigrasikan workload yang dikelola sendiri ke Memorystore untuk Valkey, Anda akan mendapatkan keuntungan berikut yang menghilangkan toil operasional dan memodernisasi infrastruktur database Anda:

• Menghilangkan overhead operasional Anda: mengalihkan tugas manual dan memakan waktu ke Google Cloud, seperti patching OS, pemantauan infrastruktur, skrip pencadangan, dan pengelolaan replikasi. Hasilnya, Anda dapat berfokus pada pengembangan aplikasi, bukan pemeliharaan database.
• Mencapai ketersediaan tinggi tingkat perusahaan: dapatkan manfaat dari SLA 99,99% yang terkelola sepenuhnya. Memorystore untuk Valkey menyediakan failover otomatis serta kemampuan pencadangan dan pemulihan bawaan. Hal ini melindungi aplikasi Anda dari kegagalan node yang tidak terduga dan memastikan pemulihan dari bencana (disaster recovery) yang cepat.
• Menskalakan dengan periode nonaktif yang hampir nol: menskalakan instance Anda secara dinamis untuk menyesuaikan dengan lonjakan traffic yang tidak dapat diprediksi. Anda dapat memperluas hingga ratusan node (hingga 250 shard) tanpa membuat aplikasi Anda offline.
• Tingkatkan keamanan Anda: ganti aturan jaringan yang kompleks dan dikonfigurasi secara manual dengan konektivitas VPC bawaan yang aman dan kontrol akses berbasis Identity and Access Management (IAM) yang terperinci. Hal ini memastikan bahwa batas keamananGoogle Cloudyang ketat melindungi data Anda.
• Konsolidasi dan upgrade instance Anda: gabungkan instance yang tersebar, terpisah, dan dikelola sendiri menjadi satu deployment berperforma tinggi di Memorystore for Valkey. Sebagai bagian dari migrasi ini, Anda juga dapat otomatis mengupgrade versi Redis atau Valkey yang sudah tidak berlaku ke rilis terbaru yang didukung.
• Dapatkan analisis real-time dan AI Generatif tingkat lanjut: beralihlah ke lingkungan yang dioptimalkan yang memberikan latensi mikrodetik untuk caching dan pengelolaan sesi. Untuk mendukung aplikasi AI generatif (GenAI), Anda mendapatkan akses terkelola langsung ke fitur lanjutan seperti Penelusuran Vektor.

Dukungan versi

Tabel di bagian ini mencantumkan informasi berikut tentang instance Redis dan Valkey yang dikelola sendiri di sumber, serta instance target di Memorystore for Valkey:

• Jenis dan versi instance sumber yang didukung migrasi
• Versi instance Memorystore for Valkey target yang dapat Anda gunakan untuk memigrasikan workload

Jenis instance sumber	Versi instance sumber	Versi instance target
Redis	3.2.x - 7.2.x	Valkey 7.2, 8.0, 9.0, dan 9.1
Valkey	7.x, 8.x, dan 9.x	Valkey 7.2, 8.0, 9.0, dan 9.1

Penting: Versi instance target harus sama atau lebih baru daripada versi instance sumber. Anda tidak dapat men-downgrade instance target ke versi sebelumnya.

Sebelum memulai

Sebelum Anda mulai memigrasikan workload, selesaikan prasyarat di bagian ini.

Menggunakan konsol Google Cloud , gcloud CLI, dan API

Untuk menggunakan konsol Google Cloud , Google Cloud CLI (gcloud CLI), dan API, lakukan hal berikut:

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Instal dan lakukan inisialisasi Google Cloud CLI.

   Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update. Untuk mengakses perintah gcloud CLI Memorystore for Valkey, Anda memerlukan setidaknya gcloud CLI versi 489.0.0.

4. Aktifkan Memorystore for Valkey API.
   Memorystore for Valkey API
5. Aktifkan Network Connectivity API.
   Network Connectivity API
6. Mengaktifkan Service Consumer Management API.
   Service Consumer Management API
7. Aktifkan Compute Engine API.
   Compute Engine API

Menetapkan peran dan izin

Untuk memigrasikan workload Redis dan Valkey yang Anda kelola sendiri ke Memorystore for Valkey, minta administrator untuk memberi Anda peran IAM Memorystore Admin (roles/memorystore.admin) di project Google Cloud Anda. Untuk mengetahui informasi selengkapnya tentang peran ini, lihat Peran bawaan.

Untuk membuat dan melihat lampiran jaringan, minta administrator untuk memberi Anda peran IAM Compute Network Admin (roles/compute.networkAdmin) di project Google Cloud Anda. Untuk mengetahui informasi selengkapnya tentang peran ini, lihat peran Compute Engine.

Alur kerja untuk memigrasikan workload Anda

Untuk memigrasikan workload Redis dan Valkey yang dikelola sendiri ke Memorystore for Valkey, lakukan tindakan berikut:

1. Siapkan instance sumber Anda: konfigurasikan instance Redis atau Valkey yang Anda kelola sendiri untuk mengizinkan koneksi aman dan replikasi keluar ke Memorystore for Valkey.
2. Siapkan instance target: tentukan spesifikasi instance yang diperlukan, seperti jumlah shard dan jenis node.
3. Buat instance target: sediakan instance Memorystore for Valkey yang menerima data yang dimigrasikan.
4. Mengonfigurasi lampiran jaringan: menyiapkan lampiran jaringan. Lampiran ini memungkinkan instance target (yang berada di jaringan VPC yang dikelola Google) memulai koneksi ke instance sumber (yang berada di jaringan VPC Anda). Hasilnya, replikasi akan dibuat.
5. Memulai migrasi: memulai proses sinkronisasi. Instance target akan otomatis terhubung ke instance sumber dan terus mereplikasi data Anda sebagai replika baca.
6. Pantau migrasi: verifikasi bahwa migrasi berjalan tanpa masalah dan status migrasi adalah HEALTHY.
7. Selesaikan migrasi: pindahkan traffic aplikasi Anda ke instance target.

Menyiapkan instance sumber

Anda harus menyiapkan instance Redis atau Valkey yang dikelola sendiri agar dapat memigrasikan workload ke instance Memorystore for Valkey target.

Untuk mengizinkan koneksi dari node instance target ke node instance sumber, lakukan hal berikut:

• Jika Anda mengaktifkan protected-mode pada node sumber, nonaktifkan mode tersebut.
• Jika Anda mengonfigurasi node sumber menggunakan perintah bind eksplisit, perbarui node untuk mengizinkan koneksi masuk dari node target. Node target memulai koneksi dari alamat IP di subnet lampiran jaringan.
• Perbarui aturan firewall yang mungkin memblokir koneksi masuk dari node target.
• Jika Anda mengaktifkan autentikasi dan Transport Layer Security (TLS) pada node sumber, nonaktifkan.

Agar node target dapat membuat replikasi dengan node sumber, lakukan hal berikut:

• Jangan ganti nama perintah Valkey atau Redis yang melakukan modifikasi data atau digunakan untuk replikasi (misalnya, PING, PSYNC, dan HSET).
• Jika Anda menggunakan daftar kontrol akses (ACL) untuk instance, izinkan perintah berikut untuk pengguna default agar instance target dapat membuat replikasi:
  • REPLCONF
  • SYNC
  • PSYNC
  • PING
  • INFO
  • CLUSTER | NODES
• Pastikan instance sumber memiliki kapasitas memori dan CPU yang cukup untuk mengelola beban replikasi tambahan dari node target.

Penting: Catat alamat IP dan nomor port instance sumber. Anda memerlukan informasi ini untuk memulai proses migrasi.

Selain itu, Memorystore for Valkey harus dapat berkomunikasi dengan alamat IP dan port ini selama proses migrasi. Memorystore for Valkey menggunakan alamat IP dan port untuk otomatis menemukan node lain dalam topologi instance.

Menyiapkan instance target

Untuk memastikan proses replikasi yang lancar, Anda harus mengukur instance Memorystore for Valkey target dengan tepat untuk menangani workload yang masuk dari instance sumber. Untuk melakukannya, tentukan spesifikasi yang tepat untuk instance target Anda. Spesifikasi ini mencakup kompatibilitas dengan instance sumber, mode cluster, jumlah database, jumlah shard, versi instance, dan jenis node.

Untuk menyiapkan instance target, gunakan panduan berikut:

• Kompatibilitas dengan instance sumber: instance sumber dan instance target harus berada dalam project dan region Google Cloud yang sama.
• Mode cluster: mode cluster instance target harus cocok dengan mode cluster instance sumber. Jika instance sumber adalah Cluster Mode Disabled, instance target juga harus Cluster Mode Disabled. Jika tidak, instance target harus mengaktifkan Mode Cluster.
• Jumlah database: jika instance target adalah Mode Cluster Dinonaktifkan, jumlah database logis pada instance harus sama dengan atau lebih besar dari jumlah database pada instance sumber.
• Jumlah shard: jika instance target adalah Cluster Mode Enabled, jumlah shard pada instance harus cocok dengan jumlah shard pada instance sumber. Namun, jumlah replika pada instance sumber dan instance target dapat berbeda.
• Versi instance: versi instance target harus kompatibel dengan versi instance sumber. Untuk mengetahui informasi selengkapnya, lihat Dukungan versi.
• Versi pemeliharaan: versi pemeliharaan instance target harus MEMORYSTORE_20260313_01_00 atau yang lebih baru. Untuk mengetahui informasi selengkapnya, lihat Tentang pemeliharaan.
• Jenis node: jenis node instance target harus cukup besar untuk menangani data yang diterima dari node sumber. Untuk mengetahui informasi selengkapnya tentang jenis node yang dapat Anda pilih untuk instance target dan kapasitas keyspace yang sesuai untuk setiap jenis node, lihat Spesifikasi jenis node.

Penting: Anda tidak dapat menggunakan instance replikasi lintas region sebagai instance target. Selain itu, pastikan Memorystore for Valkey tidak memblokir perintah apa pun yang Anda gunakan di instance sumber.

Membuat instance target

Jika Anda tidak memiliki instance target yang memenuhi persyaratan untuk menerima data yang dimigrasikan Memorystore untuk Valkey dari instance sumber, Anda harus membuat instance tersebut.

Untuk membuat instance ini, gunakan konsol Google Cloud , gcloud CLI, atau REST API. Untuk mengetahui informasi selengkapnya tentang cara membuat instance, lihat Membuat instance.

Penting: Sebelum membuat instance target, tinjau panduan untuk mengukur dan mengonfigurasinya dengan tepat. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan instance target.

Mengonfigurasi lampiran jaringan

Untuk memigrasikan workload instance sumber ke instance target, node target harus terhubung ke node sumber. Untuk mengaktifkan koneksi ini, Anda harus menggunakan lampiran jaringan. Node target memulai koneksi dari subnet di jaringan VPC instance sumber yang ditautkan ke lampiran jaringan.

Anda dapat menggunakan lampiran jaringan yang memenuhi persyaratan berikut:

• File ini harus berada dalam project dan region Google Cloud yang sama dengan instance target.
• Subnet-nya harus berada dalam jaringan VPC yang sama dengan instance sumber.
• Subnet untuk instance sumber harus memiliki rentang CIDR IP yang memadai yang mendukung minimal N+1 alamat IP yang dapat digunakan (dengan N adalah jumlah node dalam instance target). Misalnya, jika instance target memiliki tiga shard dan satu replika, instance tersebut memiliki enam node: tiga node untuk instance utama dan tiga node untuk replika. Oleh karena itu, Anda memerlukan setidaknya tujuh alamat IP.
• Rentang subnet tidak boleh tumpang-tindih dengan 10.0.0.0/23 karena Memorystore for Valkey mencadangkan rentang ini.

Jika lampiran jaringan Anda tidak memenuhi persyaratan ini atau Anda tidak memiliki lampiran jaringan, Anda harus membuatnya. Untuk mengetahui informasi selengkapnya, lihat Membuat lampiran jaringan.

Memulai migrasi

Dengan memulai migrasi, instance target akan membuat replikasi dengan instance sumber. Instance target secara otomatis mereplikasi data apa pun yang ditulis aplikasi Anda ke instance sumber. Instance target menjadi replika baca dari instance sumber.

Untuk memulai migrasi, gunakan konsol Google Cloud , gcloud CLI, atau REST API.

Penting: Sebelum memulai migrasi, tinjau panduan di Mengonfigurasi lampiran jaringan. Selain itu, setelah Anda memulai migrasi, jangan melakukan operasi migrasi slot pada instance sumber (seperti menyeimbangkan ulang instance atau memindahkan slot hash secara manual di antara shard) hingga setelah Anda menyelesaikan migrasi.

Konsol

1. Di konsol Google Cloud , buka halaman Memorystore for Valkey.

   Memorystore for Valkey

2. Klik ID instance target.

3. Di halaman Instance at a glance, klik Start migration.

4. Di jendela Migrate Self Managed Redis and Valkey Instances, lakukan hal berikut:

5. Di tab Prepare, baca informasi tentang prasyarat untuk instance sumber dan panduan untuk lampiran jaringan. Kemudian, klik Lanjutkan.

6. Di tab Connect, lakukan hal berikut:

   1. Masukkan alamat IP dan Port instance sumber. Anda mencatat informasi ini di Menyiapkan instance sumber.
   2. Pilih lampiran jaringan yang ingin Anda gunakan untuk memigrasikan data.
   3. Klik Lanjutkan.

7. Di tab Review, tinjau informasi yang terkait dengan proses migrasi. Informasi ini mencakup ID instance target, alamat IP dan port instance sumber, serta nama lampiran jaringan. Setelah meninjau informasi ini, klik Mulai migrasi.

8. Di halaman Instance at a glance, pastikan status Migrating muncul.

Jika node target tidak dapat terhubung ke node sumber, atau jika instance sumber tidak dapat mereplikasi data ke instance target, migrasi akan gagal.

Jika hal ini terjadi, Memorystore for Valkey akan me-roll back instance target ke statusnya sebelum Anda memulai proses migrasi. Status instance target akan kembali ke Ready, dan instance akan memiliki kemampuan baca dan tulis lagi.

Setelah menyelesaikan masalah yang menyebabkan kegagalan migrasi, Anda dapat memulai migrasi lagi.

gcloud

Gunakan perintah gcloud memorystore instances start-migration, sebagai berikut:

gcloud memorystore instances start-migration INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--source-ip=SOURCE_IP_ADDRESS \
--source-port=SOURCE_PORT \
--network-attachment=projects/PROJECT_ID/locations/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID

Lakukan penggantian berikut:

• INSTANCE_ID: ID instance target.
• PROJECT_ID: ID atau nomor project dari Google Cloud project yang berisi instance ini.
• REGION_ID: ID region tempat instance berada.
• SOURCE_IP_ADDRESS: alamat IP instance sumber. Anda mencatat alamat IP ini di Menyiapkan instance sumber.
• SOURCE_PORT: nomor port instance sumber. Anda mencatat port ini di bagian Menyiapkan instance sumber.
• NETWORK_ATTACHMENT_ID: ID lampiran jaringan.

Untuk mengonfirmasi bahwa migrasi telah berhasil dimulai, gunakan perintah gcloud memorystore instances describe, sebagai berikut:

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Pastikan status MIGRATING muncul di samping parameter state.

Jika node target tidak dapat terhubung ke node sumber, atau jika instance sumber tidak dapat mereplikasi data ke instance target, migrasi akan gagal.

Jika hal ini terjadi, Memorystore for Valkey akan me-roll back instance target ke statusnya sebelum Anda memulai proses migrasi. Status instance target akan kembali ke ACTIVE, dan instance tersebut akan memiliki kemampuan baca dan tulis lagi.

Setelah menyelesaikan masalah yang menyebabkan kegagalan migrasi, Anda dapat memulai migrasi lagi.

REST

Untuk memulai migrasi, gunakan perintah REST API berikut.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project dari project Google Cloud yang berisi instance target.
• REGION_ID: ID region tempat instance ini berada.
• INSTANCE_ID: ID instance.
• SOURCE_IP_ADDRESS: alamat IP instance sumber. Anda telah mencatat alamat IP ini di bagian Menyiapkan instance sumber.
• SOURCE_PORT: nomor port instance sumber. Anda mencatat port ini di Menyiapkan instance sumber.
• NETWORK_ATTACHMENT_ID: ID lampiran jaringan.

Metode HTTP dan URL:

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:startMigration

Meminta isi JSON:

{
  "selfManagedSource": {
    "ipAddress": "SOURCE_IP_ADDRESS",
    "port": SOURCE_PORT,
    "networkAttachment": "projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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

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

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.memorystore.v1.OperationMetadata",
    "createTime": "2026-10-26T20:00:00.000000000Z",
    "target": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
    "verb": "startMigration",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Memantau migrasi

Untuk memastikan migrasi berjalan tanpa masalah, pantau instance sumber dan instance target.

Memantau instance sumber

Pada instance sumber, pastikan penggunaan buffering output klien tetap rendah pada node sumber. Untuk memeriksa penggunaan buffer, lakukan salah satu hal berikut:

• Menggunakan dasbor pemantauan yang ada
• Hubungkan ke instance sumber dengan klien Redis atau Valkey, lalu jalankan perintah INFO CLIENTS untuk memeriksa metrik buffering output

Penggunaan rendah yang berkelanjutan menunjukkan jeda minimal dan sinkronisasi data yang berhasil dari instance sumber ke instance target.

Memantau instance target

Anda dapat memantau kondisi migrasi dari instance sumber ke Memorystore untuk Valkey. Untuk melakukannya, periksa metrik Migration status (/instance/migration_status) untuk instance target guna memverifikasi bahwa status instance saat ini adalah HEALTHY. Status ini menunjukkan bahwa link replikasi antara shard instance sumber dan instance target aktif dan berfungsi dengan benar selama proses migrasi.

Untuk memeriksa metrik Migration status untuk instance menggunakan konsolGoogle Cloud , lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Metrics explorer.

   Metrics Explorer

2. Dari menu Metric, pilih metrik Migration status. Untuk melakukannya, pilih Memorystore Instance  > Instance  > Migration status, lalu klik Apply.

3. Dari kolom Filter, tambahkan filter berikut: instance_id = (equals) INSTANCE_ID.

   Ganti INSTANCE_ID dengan ID instance target.

4. Di bagian Results, periksa status instance saat ini. Jika status HEALTHY muncul, berarti instance berfungsi, dan Anda dapat menyelesaikan migrasi.

   Jika status HEALTHY tidak muncul, Anda dapat menggunakan metrik Migration status untuk node utama instance target. Dengan memantau node ini, Anda dapat menentukan apakah ada node tertentu yang tidak responsif.

   Untuk menggunakan metrik Migration status untuk node instance, lakukan hal berikut:

   1. Dari menu Metric, pilih metrik Migration status. Untuk melakukannya, pilih Memorystore Instance Node  > Instance  > Migration status, lalu klik Apply.

   2. Dari kolom Filter, tambahkan filter berikut: role = (equals) primary.

   3. Di bagian Results, pastikan status saat ini dari semua node utama adalah HEALTHY. Jika statusnya HEALTHY, berarti node berfungsi dan Anda dapat menyelesaikan migrasi.

Menyelesaikan migrasi

Untuk menyelesaikan migrasi, gunakan konsol Google Cloud , gcloud CLI, atau REST API.

Penting: Secara default, Memorystore for Valkey memastikan bahwa instance target sepenuhnya mengikuti instance sumber hingga saat Anda menyelesaikan migrasi. Setiap penulisan ke instance sumber setelah Anda menyelesaikan migrasi mungkin tidak akan direplikasi.

Jika Anda menginginkan konsistensi data total antara instance sumber dan instance target, serta tidak ada kehilangan data, hentikan semua operasi tulis ke instance sumber sebelum menyelesaikan migrasi.

Konsol

1. Di konsol Google Cloud , buka halaman Memorystore for Valkey.

   Memorystore for Valkey

2. Klik ID instance target.

3. Di halaman Instance sekilas, klik Selesaikan migrasi.

4. Dalam dialog Finish migration, lakukan tindakan berikut:

   1. Jika Anda ingin memastikan bahwa instance target mereplikasi semua data dari instance sumber, pilih Standard.

      Perhatian: Jika Anda ingin segera mengalihkan traffic aplikasi ke instance target, pilih Force (Skip-sync). Namun, jika Anda memilih opsi ini, Memorystore for Valkey mungkin tidak dapat mereplikasi semua data di instance sumber ke instance target.

   2. Di kolom teks Instance ID, masukkan ID instance target.

   3. Klik Selesaikan migrasi.

5. Di halaman Instance at a glance, pastikan status Migrated muncul.

Penting: Setelah Anda menyelesaikan migrasi, perbarui file konfigurasi aplikasi Anda untuk mengarahkan semua traffic ke instance target.

gcloud

Gunakan perintah gcloud memorystore instances finish-migration, sebagai berikut:

gcloud memorystore instances finish-migration INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Lakukan penggantian berikut:

• INSTANCE_ID: ID instance target
• PROJECT_ID: ID atau nomor project dari projectGoogle Cloud yang berisi instance ini
• REGION_ID: ID region tempat instance berada

Perhatian: Jika Anda ingin langsung mengalihkan traffic aplikasi ke instance target, gunakan parameter --force. Namun, dengan menggunakan parameter ini, Memorystore for Valkey mungkin tidak dapat mereplikasi semua data pada instance sumber ke instance target.

Untuk mengonfirmasi bahwa migrasi berhasil diselesaikan, gunakan perintah gcloud memorystore instances describe, sebagai berikut:

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Pastikan status MIGRATED muncul di samping parameter state.

Penting: Setelah menyelesaikan migrasi, perbarui file konfigurasi aplikasi Anda untuk mengarahkan semua traffic ke instance target.

REST

Untuk menyelesaikan migrasi, gunakan perintah REST API berikut.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID project Google Cloud yang berisi instance target.
• REGION_ID: ID region tempat instance ini berada.
• INSTANCE_ID: ID instance.

• FORCE_BOOLEAN: optional. Parameter ini menentukan apakah Memorystore for Valkey memaksa migrasi segera selesai.

  • Jika Anda menetapkan parameter ini ke true, Memorystore for Valkey akan segera menyelesaikan migrasi sehingga Anda dapat mengalihkan traffic aplikasi ke instance target. Namun, Memorystore for Valkey mungkin tidak dapat mereplikasi semua data dari instance sumber ke instance target.
  • Jika Anda menetapkan parameter ini ke false, Memorystore for Valkey akan mereplikasi semua data dari instance sumber ke instance target hingga Anda menyelesaikan migrasi.

Metode HTTP dan URL:

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:finishMigration

Meminta isi JSON:

{
  "force": FORCE_BOOLEAN
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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

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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.memorystore.v1.OperationMetadata",
    "createTime": "2026-10-26T20:00:00.000000000Z",
    "target": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
    "verb": "finishMigration",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}