Memindahkan bucket

Anda dapat merelokasi bucket saat perlu mentransfer data dari satu lokasi Cloud Storage ke lokasi lain. Proses ini membantu Anda memenuhi persyaratan residensi data, mengurangi latensi jaringan untuk workload, atau mengubah jenis lokasi.

Untuk ringkasan cara kerja relokasi bucket, lihat Relokasi bucket.

Sebelum memulai

Sebelum Anda dapat merelokasi bucket, selesaikan langkah-langkah berikut:

1. Konfigurasi Storage Intelligence.

2. Tentukan jenis relokasi bucket untuk memahami apakah periode nonaktif tulis diperlukan.

3. Jika relokasi bucket Anda melibatkan periode nonaktif tulis, aktifkan penghapusan sementara.

4. Periksa kuota dan batas untuk memastikan bahwa lokasi baru memiliki kuota yang cukup untuk menampung data bucket.

5. Tinjau batasan relokasi bucket.

6. Hapus semua tag bucket yang ada.

7. Jika Anda menggunakan laporan inventaris, simpan konfigurasi Anda.

8. Dapatkan peran yang diperlukan, yang dijelaskan di bagian berikut.

Mendapatkan peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk merelokasi bucket, minta administrator untuk memberi Anda peran IAM Storage Admin (roles/storage.admin) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk merelokasi bucket. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk merelokasi bucket:

• Untuk merelokasi bucket: storage.buckets.relocate
• Untuk melihat status operasi relokasi bucket: storage.bucketOperations.get
• Untuk melihat daftar operasi relokasi bucket untuk sebuah project: storage.bucketOperations.list
• Untuk membatalkan operasi relokasi bucket: storage.bucketOperations.cancel
• Untuk melihat metadata bucket selama fase uji coba dan relokasi bucket: storage.buckets.get
• Untuk mendapatkan objek di bucket yang ingin Anda pindahkan: storage.objects.get
• Untuk membuat daftar objek dalam bucket yang ingin Anda pindahkan: storage.objects.list

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Merelokasi bucket

Bagian ini menjelaskan proses merelokasi bucket Cloud Storage dari satu lokasi ke lokasi lain.

Untuk merelokasi bucket, selesaikan langkah-langkah berikut:

1. Menguji relokasi bucket dengan uji coba (Opsional)

2. Memulai proses relokasi bucket

3. Memulai langkah sinkronisasi akhir

Untuk mengetahui informasi selengkapnya tentang langkah-langkah ini, lihat Memahami proses relokasi bucket.

Menguji relokasi bucket dengan uji coba (Opsional)

Untuk meminimalkan potensi masalah selama proses relokasi bucket, sebaiknya lakukan uji coba untuk menguji proses menyeluruh. Uji coba menyimulasikan proses relokasi bucket tanpa memindahkan data, sehingga membantu Anda mendeteksi dan menyelesaikan masalah sejak awal. Uji coba memeriksa ketidaksesuaian berikut:

• Kunci enkripsi yang dikelola pelanggan (CMEK) atau Kunci enkripsi yang disediakan pelanggan (CSEK)
• Kebijakan retensi bucket dan objek
• Objek dengan penangguhan sementara
• Upload multibagian

Meskipun uji coba tidak dapat mengidentifikasi setiap kemungkinan masalah karena beberapa masalah mungkin hanya muncul selama migrasi langsung akibat faktor seperti ketersediaan resource real-time, uji coba ini mengurangi risiko menghadapi masalah yang memakan waktu selama relokasi yang sebenarnya.

Konsol

1. Di konsol Google Cloud , buka halaman Buckets Cloud Storage.
   

   Buka Buckets

2. Dalam daftar bucket, klik nama bucket yang ingin Anda pindahkan.
3. Di halaman Bucket details, klik tab Configuration.
4. Di bagian Overview, klik Edit di samping kolom Location.
5. Di halaman Relocate bucket, masukkan lokasi baru bucket Anda. Setelah menyelesaikan setiap langkah berikut, klik Lanjutkan untuk melanjutkan ke langkah berikutnya:
   1. Di bagian Confirm the bucket you plan to relocate, tinjau bucket dan lokasinya.
   2. Di bagian Sebelum melanjutkan, tinjau konfigurasi yang memblokir relokasi. Jika ada batasan yang berlaku untuk bucket Anda, pertimbangkan Storage Transfer Service sebagai solusi alternatif.

   3. Di bagian Choose where to relocate your bucket, lakukan hal berikut:

      1. Pilih jenis lokasi.

      2. Pilih lokasi tempat data objek dalam bucket Anda akan disimpan.

         Berdasarkan lokasi sumber dan tujuan, Anda akan diberi tahu jika downtime tulis diperlukan. Untuk mengetahui informasi tentang jenis relokasi dan periode nonaktif, lihat Jenis relokasi.

   4. Di bagian Choose how you'd like to proceed, klik Start with an uji coba (recommended). Uji coba menyimulasikan relokasi untuk mengidentifikasi potensi masalah tanpa memindahkan data.
   5. Klik Lanjutkan.
6. Klik Mulai.
7. Pada dialog konfirmasi Mulai dengan uji coba, tinjau pesan yang muncul, lalu klik Mulai uji coba.

Setelah Anda memulai uji coba, operasi yang berjalan lama akan dimulai. Anda dapat memantau progresnya di tab Operations pada halaman bucket details.

Command line

Untuk memulai uji coba, jalankan perintah gcloud storage buckets relocate dengan flag --dry-run:

gcloud storage buckets relocate gs://BUCKET_NAME --location=LOCATION --dry-run

Dengan:

• BUCKET_NAME adalah nama bucket yang ingin Anda relokasi.

• LOCATION adalah lokasi tujuan bucket.

Setelah Anda memulai uji coba, operasi yang berjalan lama akan dimulai. Anda akan menerima ID operasi dan deskripsi operasi. Lacak progres dan penyelesaian uji coba dengan mendapatkan detail operasi yang berjalan lama.

Jika uji coba menunjukkan adanya masalah, selesaikan masalah tersebut sebelum melanjutkan ke langkah relokasi.

JSON API

1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

2. Buat file JSON yang berisi setelan untuk bucket, yang harus menyertakan parameter destinationLocation dan validateOnly. Lihat dokumentasi Buckets: relocate untuk daftar lengkap setelan. Berikut adalah setelan umum yang harus disertakan:

   {
     "destinationLocation": "DESTINATION_LOCATION",
     "destinationCustomPlacementConfig": {
       "dataLocations": [
         LOCATIONS,
           ...
           ]
       },
     "validateOnly": "true"
     }

   Dengan:

   • DESTINATION_LOCATION adalah lokasi tujuan bucket.
   • LOCATIONS adalah daftar kode lokasi yang akan digunakan untuk dual-region yang dapat dikonfigurasi.
   • validateOnly ditetapkan ke true untuk melakukan uji coba.

3. Gunakan cURL untuk memanggil JSON API:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/relocate"

   Dengan:

   • JSON_FILE_NAME adalah nama file JSON yang Anda buat.
   • BUCKET_NAME adalah nama bucket yang ingin Anda relokasi.

   Setelah Anda memulai uji coba, operasi yang berjalan lama akan dimulai. Uji coba berhasil jika kondisi berikut terpenuhi:

   • Uji coba tidak melaporkan error.

   • Resource operations menampilkan nilai kolom done sebesar true.

     {
     "kind": "storage#operation",
     "name": "projects/_/buckets/bucket/operations/operation_id",
     "metadata": {
       "@type": OperationMetadataType*,
       metadata OperationMetadata*
     },
     "done": "true",
     "response": {
           "@type": ResponseResourceType*,
           response ResponseResource*
         }
       }

     Jika uji coba menunjukkan adanya masalah, selesaikan masalah tersebut sebelum melanjutkan ke langkah Memulai relokasi.

Memulai relokasi bucket

Konsol

1. Di konsol Google Cloud , buka halaman Buckets Cloud Storage.
   

   Buka Buckets

2. Dalam daftar bucket, klik nama bucket yang ingin Anda pindahkan.
3. Di halaman Bucket details, klik tab Configuration.
4. Di bagian Overview, klik Edit di samping kolom Location.
5. Di halaman Relocate bucket, masukkan lokasi baru bucket Anda. Setelah menyelesaikan setiap langkah berikut, klik Lanjutkan untuk melanjutkan ke langkah berikutnya:
   1. Di bagian Confirm the bucket you plan to relocate, tinjau bucket dan lokasinya.
   2. Di bagian Sebelum melanjutkan, tinjau konfigurasi yang memblokir relokasi. Jika ada batasan yang berlaku untuk bucket Anda, pertimbangkan Storage Transfer Service sebagai solusi alternatif.

   3. Di bagian Choose where to relocate your bucket, lakukan hal berikut:

      1. Pilih jenis lokasi.

      2. Pilih lokasi tempat data objek dalam bucket Anda akan disimpan.

         Berdasarkan lokasi sumber dan tujuan, Anda akan diberi tahu jika downtime tulis diperlukan. Untuk mengetahui informasi tentang jenis relokasi dan periode nonaktif, lihat Jenis relokasi.

   4. Di bagian Pilih cara Anda ingin melanjutkan, klik Relokasi sekarang.
   5. Klik Lanjutkan.
6. Untuk memulai proses relokasi, klik Mulai.
7. Pada dialog konfirmasi Relocate now, tinjau pesan yang muncul dan klik Start relocate.

Setelah Anda memulai proses relokasi, operasi yang berjalan lama akan dimulai. Anda dapat memantau progresnya di tab Operations pada halaman bucket details.

Command line

Untuk memulai relokasi bucket, jalankan perintah gcloud storage buckets relocate:

gcloud storage buckets relocate gs://BUCKET_NAME --location=LOCATION

Dengan:

• BUCKET_NAME adalah nama bucket yang ingin Anda relokasi.

• LOCATION adalah lokasi tujuan bucket.

  Catatan: Saat membuat dual-region yang dapat dikonfigurasi, Anda harus menetapkan flag --location menjadi kode lokasi yang terkait dengan region yang mendasarinya, dan Anda harus menggunakan flag --placement dengan pasangan region yang valid. Misalnya, --location=US --placement=US-CENTRAL1,US-EAST1

JSON API

1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

2. Buat file JSON yang berisi setelan untuk bucket. Lihat dokumentasi Buckets: relocate untuk daftar lengkap setelan. Berikut adalah setelan umum yang harus disertakan:

   {
     "destinationLocation": "DESTINATION_LOCATION",
     "destinationCustomPlacementConfig": {
     "dataLocations": [
       LOCATIONS,
       ...
       ]
       },
     "validateOnly": "false"
     }

   Dengan:

   • DESTINATION_LOCATION adalah lokasi tujuan bucket.
   • LOCATIONS adalah daftar kode lokasi yang akan digunakan untuk dual-region yang dapat dikonfigurasi.
   • validateOnly ditetapkan ke false untuk memulai relokasi bucket.

3. Gunakan cURL untuk memanggil JSON API:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/relocate"

   Dengan:

   • JSON_FILE_NAME adalah nama file JSON yang Anda buat.
   • BUCKET_NAME adalah nama bucket yang ingin Anda relokasi.

Memantau proses relokasi

Konsol

Untuk memantau progres uji coba atau proses relokasi, selesaikan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Buckets Cloud Storage.
   

   Buka Buckets

2. Dalam daftar bucket, klik nama bucket yang Anda relokasi.

3. Di halaman Bucket details, klik tab Operations.

4. Dalam daftar operasi bucket yang muncul, klik uji coba atau operasi relokasi untuk melihat detailnya.

Halaman detail operasi menampilkan ringkasan relokasi, metrik utama, dan ringkasan error.

Command line

Setelah Anda memulai relokasi bucket, operasi yang berjalan lama akan dimulai. Anda akan menerima ID operasi dan deskripsi operasi. Lacak progres dan penyelesaian proses relokasi dengan mendapatkan detail operasi yang berjalan lama.

JSON API

Relokasi bucket adalah operasi yang berjalan lama yang memerlukan pemantauan. Untuk memeriksa status proses, tinjau detail operasi yang berjalan lama secara rutin. Untuk mengetahui informasi tentang cara memeriksa status proses relokasi, lihat Mendapatkan detail operasi yang berjalan lama.

Contoh berikut menunjukkan output yang dihasilkan oleh operasi relokasi:

  done: false
  kind: storage#operation
  metadata:
  '@type': type.googleapis.com/google.storage.control.v2.RelocateBucketMetadata
  commonMetadata:
    createTime: '2024-10-21T04:26:59.666Z
    endTime: '2024-12-29T23:39:53.340Z'
    progressPercent: 99
    requestedCancellation: false
    type: relocate-bucket
    updateTime: '2024-10-21T04:27:03.2892'
  destinationLocation: US-CENTRAL1
  finalizationState: 'READY'
  progress:
    byteProgressPercent: 100
    discoveredBytes: 200
    remainingBytes: 0
    discoveredObjectCount: 10
    remainingObjectCount: 8
    objectProgressPercent: 100
    discoveredSyncCount: 8
    remainingSyncCount: 0
    syncProgressPercent: 100
  relocationState: SYNCING
  sourceLocation: US
  validateOnly: false
  estimatedWriteDowntimeDuration: '7200s'
  writeDowntimeExpireTime: '2024-12-30T10:34:01.786Z'
  name: projects//buckets/my-bucket1/operations/Bar7-1b0khdew@nhenUQRTF_R-Kk4dQ5V1f8fzezkFcPh3XMvlTqJ6xhnqJ1h_QXFIeAirrEqkjgu4zPKSRD6WSSG5UGXil6w
  response:
    '@type': type.googleapis.com/google.storage.control.v2.RelocateBucketResponse
      selfLink: https://storage.googleusercontent.com/storage/v1_ds/b/my-bucket1/operations/Bar7-1b0khdew@nhenUQRTF_R-Kk4dQ5V1f8fzezkFcPh3XMvlTqJ6xhnqJ1h_QXFIeAirrEqkjgu4zPKSRD6WSSG5UGXil6w

Tabel berikut memberikan informasi tentang kolom kunci dalam output yang dihasilkan oleh operasi relokasi:

Nama kolom	Deskripsi	Nilai yang memungkinkan
done	Menunjukkan penyelesaian operasi relokasi bucket.	true, false
kind	Menunjukkan bahwa resource ini merepresentasikan operasi penyimpanan.
metadata	Memberikan informasi tentang operasi.
metadata.@type	Menunjukkan jenis operasi sebagai relokasi bucket.
metadata.commonMetadata	Metadata yang umum untuk semua operasi.
metadata.commonMetadata.createTime	Waktu pembuatan operasi yang berjalan lama.
metadata.commonMetadata.endTime	Waktu berakhirnya operasi yang berjalan lama.
metadata.commonMetadata.progressPercent	Estimasi progres operasi yang berjalan lama, dalam persentase.	Antara 0 hingga 100%. Nilai -1 berarti progres tidak diketahui atau tidak berlaku.
metadata.commonMetadata.requestedCancellation	Menunjukkan apakah pengguna telah meminta pembatalan operasi yang berjalan lama.	true, false
metadata.commonMetadata.type	Menunjukkan jenis operasi yang berjalan lama.
metadata.commonMetadata.updateTime	Waktu saat operasi yang berjalan lama terakhir diperbarui.
metadata.destinationLocation	Lokasi tujuan bucket.
metadata.finalizationState	Menunjukkan kesiapan untuk memulai langkah sinkronisasi akhir.	READY: Menunjukkan bahwa Anda dapat memulai langkah sinkronisasi akhir. Namun, sebaiknya tunggu hingga nilai kolom progressPercent mencapai 99. WAITING_ON_SYNC: Menunjukkan bahwa Anda tidak dapat memulai langkah sinkronisasi akhir. NOT_REQUIRED: Menunjukkan bahwa langkah sinkronisasi akhir tidak diperlukan untuk bucket ini dan Anda dapat melewati langkah tersebut. BLOCKED_ON_ERRORS: Menunjukkan bahwa langkah finalisasi dijeda sementara karena error. Anda harus mengatasi error untuk melanjutkan langkah ini. RUNNING: Menunjukkan bahwa langkah finalisasi sedang berlangsung. FINALIZED: Menunjukkan bahwa langkah finalisasi telah berhasil diselesaikan.
metadata.progress	Detail progres operasi relokasi.
metadata.progress.byteProgressPercent	Progres byte yang disalin dalam persentase.	Antara 0 hingga 100%. Nilai -1 berarti progres tidak diketahui atau tidak berlaku.
metadata.progress.discoveredBytes	Jumlah byte yang ditemukan di bucket sumber.
metadata.progress.discoveredObjectCount	Jumlah objek yang ditemukan di bucket sumber.
metadata.progress.discoveredSyncCount	Jumlah update metadata objek yang ditemukan di bucket sumber.
metadata.progress.objectProgressPercent	Progres objek yang disalin dalam persentase.	Antara 0 hingga 100%. Nilai -1 berarti progres tidak diketahui atau tidak berlaku.
metadata.progress.remainingBytes	Jumlah byte yang tersisa untuk disalin dari bucket sumber ke bucket tujuan.
metadata.progress.remainingObjectCount	Jumlah objek yang tersisa untuk disalin dari bucket sumber ke bucket tujuan.
metadata.progress.remainingSyncCount	Jumlah update metadata objek yang tersisa untuk disinkronkan.
metadata.progress.syncProgressPercent	Progres pembaruan metadata objek yang akan disinkronkan dalam persentase.	Antara 0 hingga 100%. Nilai -1 berarti progres tidak diketahui atau tidak berlaku.
metadata.relocationState	Status keseluruhan operasi relokasi bucket.	SYNCING: Menunjukkan bahwa langkah relokasi bucket sedang aktif menyalin objek dari bucket sumber ke bucket tujuan. FINALIZING: Menunjukkan bahwa langkah finalisasi telah dimulai. FAILED: Menunjukkan bahwa langkah relokasi bucket mengalami error dan tidak berhasil diselesaikan. SUCCEEDED: Menunjukkan bahwa langkah relokasi bucket telah berhasil diselesaikan. CANCELLED: Menunjukkan bahwa langkah relokasi bucket dibatalkan.
metadata.sourceLocation	Lokasi sumber bucket.
metadata.validateOnly	Menunjukkan apakah uji coba relokasi bucket telah dimulai.	true, false
metadata.estimatedWriteDowntimeDuration	Perkiraan durasi periode nonaktif tulis; diisi setelah finalizationState adalah READY.	Nilai minimum adalah 7200s.
metadata.writeDowntimeExpireTime	Waktu berakhirnya periode nonaktif tulis.
name	ID unik untuk operasi relokasi ini. Format: projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID
response	Respons operasi.
response.@type	Jenis respons.
selfLink	Link ke operasi ini.

Catatan: metadata.commonMetadata.progressPercent menunjukkan penyelesaian keseluruhan operasi yang berjalan lama. Progres akan mencapai 100% setelah semua langkah selesai. Ini adalah satu-satunya indikator keberhasilan yang dapat diandalkan. Indikator progres lainnya menunjukkan pergerakan byte, objek, dan metadata. Perangkat ini mungkin mencapai 100% lebih cepat daripada metadata.commonMetadata.progressPercent. Setelah byte, objek, dan metadata dipindahkan, relokasi bucket akan menyelesaikan langkah terakhir dan setelah itu metadata.commonMetadata.progressPercent diperbarui menjadi 100%.

Catatan: Progres relokasi tidak linear atau dapat diprediksi. Jangan gunakan waktu yang diperlukan untuk relokasi kecil guna memperkirakan durasi relokasi yang lebih besar. Relokasi tanpa periode nonaktif tulis memerlukan waktu setidaknya 7 hari untuk diselesaikan, terlepas dari ukuran total bucket atau jumlah objek.

Jika Anda mengalami masalah saat berinteraksi dengan fitur Cloud Storage lainnya, lihat Batasan.

Memulai langkah sinkronisasi akhir

Untuk relokasi yang memerlukan periode nonaktif tulis, Anda harus memulai sinkronisasi akhir. Langkah sinkronisasi terakhir melibatkan periode saat Anda tidak dapat melakukan operasi tulis pada bucket. Sebaiknya jadwalkan langkah sinkronisasi akhir pada waktu yang meminimalkan gangguan pada aplikasi Anda.

Konsol

Untuk memulai langkah sinkronisasi akhir, selesaikan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Buckets Cloud Storage.
   

   Buka Buckets

2. Dalam daftar bucket, klik nama bucket yang Anda relokasi.

3. Di halaman Bucket details, klik tab Operations.

4. Dalam daftar operasi bucket, klik operasi relokasi untuk melihat halaman detail operasi. Di halaman detail operasi, saat penyalinan data sudah selesai minimal 99%, panel pesan akan muncul yang menunjukkan bahwa ini adalah waktu yang optimal untuk memulai sinkronisasi akhir.

5. Opsional: Untuk menetapkan waktu nonaktif tulis maksimum yang diizinkan, klik Set maximum allowed downtime (TTL) dan tentukan durasi waktu nonaktif maksimum.

6. Klik Mulai sinkronisasi akhir.

7. Pada dialog konfirmasi yang muncul, klik Start untuk memulai sinkronisasi akhir.

Halaman detail operasi menampilkan ringkasan relokasi, metrik utama, dan ringkasan error.

Command line

Sebelum melanjutkan, pastikan bucket telah disiapkan sepenuhnya dengan memeriksa nilai finalizationState dalam output langkah Memulai relokasi bucket.

Jika nilai finalizationState adalah READY, jalankan perintah gcloud storage buckets relocate untuk memulai sinkronisasi akhir:

gcloud storage buckets relocate --finalize --operation=projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID

Dengan:

• BUCKET_NAME adalah nama bucket yang ingin Anda relokasi.
• OPERATION_ID adalah ID operasi yang berjalan lama untuk relokasi bucket, yang ditampilkan dalam respons metode yang Anda panggil. Misalnya, respons berikut ditampilkan dari pemanggilan gcloud storage operations list dan ID operasi yang berjalan lama adalah AbCJYd8jKT1n-Ciw1LCNXIcubwvij_TdqO-ZFjuF2YntK0r74.

 `name: projects/_/buckets/my-bucket/operations/AbCJYd8jKT1n-Ciw1LCNXIcubwvij_TdqO-ZFjuF2YntK0r74` 

Tetapkan flag ttl untuk memiliki kontrol yang lebih besar atas proses relokasi. Contoh:

gcloud storage buckets relocate --finalize --ttl TTL_DURATION --operation=projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID

Dengan:

TTL_DURATION adalah Time to live (TTL) untuk fase downtime tulis selama proses relokasi. Nilai ini dinyatakan sebagai string, seperti 12h untuk 12 jam. TTL_DURATION menentukan durasi maksimum yang diizinkan untuk fase periode nonaktif tulis. Jika periode nonaktif tulis melebihi batas ini, proses relokasi akan otomatis kembali ke langkah relokasi bucket, dan operasi tulis ke bucket akan diaktifkan kembali. Nilai harus berada dalam rentang 6h (6 jam) hingga 48h (48 jam). Jika tidak ditentukan, nilai defaultnya adalah 12h (12 jam).

JSON API

Sebelum melanjutkan, pastikan bucket telah disiapkan sepenuhnya dengan memeriksa nilai finalizationState dalam output langkah relokasi bucket. Nilai finalizationState harus berupa READY untuk melanjutkan.

Jika Anda memulai langkah sinkronisasi akhir sebelum waktunya, perintah akan menampilkan pesan error The relocate bucket operation isn't ready to advance to finalization running state, tetapi proses relokasi akan berlanjut.

Sebaiknya tunggu hingga nilai progressPercent menjadi 99 sebelum memulai langkah sinkronisasi akhir.

1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

2. Buat file JSON yang berisi setelan untuk relokasi bucket. Lihat dokumentasi Buckets: advanceRelocateBucket untuk daftar lengkap setelan. Berikut adalah setelan umum yang harus disertakan:

   {
   "expireTime": "EXPIRE_TIME",
   "ttl": "TTL_DURATION"
   }

   Dengan:

   • EXPIRE_TIME adalah waktu berakhirnya periode nonaktif tulis.
   • TTL_DURATION adalah Time to live (TTL) untuk fase downtime tulis selama proses relokasi. Nilai ini dinyatakan sebagai string, seperti 12h untuk 12 jam. TTL_DURATION menentukan durasi maksimum yang diizinkan untuk fase periode nonaktif tulis. Jika periode nonaktif tulis melebihi batas ini, proses relokasi akan otomatis kembali ke langkah relokasi bucket, dan operasi tulis ke bucket akan diaktifkan kembali. Nilai harus berada dalam rentang 6h (6 jam) hingga 48h (48 jam). Jika tidak ditentukan, nilai defaultnya adalah 12h (12 jam).

3. Gunakan cURL untuk memanggil JSON API:

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
    "https://storage.googleapis.com/storage/v1/b/bucket/BUCKET_NAME/operations/OPERATION_ID/advanceRelocateBucket"

   Dengan:

   • JSON_FILE_NAME adalah nama file JSON yang Anda buat.
   • BUCKET_NAME adalah nama bucket yang ingin Anda relokasi.
   • OPERATION_ID adalah ID operasi yang berjalan lama yang memulai relokasi bucket. Untuk mendapatkan daftar ID operasi yang berjalan lama untuk bucket, lihat Operations: list.

Memvalidasi proses relokasi bucket

Setelah memulai relokasi, verifikasi keberhasilan penyelesaiannya. Bagian ini memberikan panduan tentang cara mengonfirmasi keberhasilan transfer data.

Validasi keberhasilan proses relokasi menggunakan metode berikut:

• Melakukan polling operasi yang berjalan lama: Relokasi bucket adalah operasi yang berjalan lama. Anda dapat melakukan polling pada operasi yang berjalan lama menggunakan operation id untuk memantau progres operasi dan mengonfirmasi keberhasilan penyelesaiannya dengan memverifikasi status success. Hal ini melibatkan kueri status operasi secara berkala hingga mencapai status terminal. Untuk mengetahui informasi tentang cara memantau operasi yang berjalan lama, lihat Menggunakan operasi yang berjalan lama di Cloud Storage.

• Menganalisis entri Cloud Audit Logs: Cloud Audit Logs menyediakan catatan mendetail tentang peristiwa dan operasi di lingkungan Google Cloud Anda. Anda dapat menganalisis entri Cloud Audit Logs yang terkait dengan relokasi untuk memvalidasi keberhasilannya. Analisis log untuk menemukan error, peringatan, atau perilaku tidak terduga yang mungkin mengindikasikan masalah selama transfer. Untuk mengetahui informasi tentang cara melihat log Cloud Audit Logs, lihat Melihat log audit.

  Entri log berikut membantu Anda menentukan apakah pemindahan berhasil atau gagal:

  • Relokasi berhasil: Relocate bucket succeeded. All existing objects are now in the new placement configuration.

  • Relokasi gagal: Relocate bucket has failed. Bucket location remains unchanged.

  Dengan menggunakan notifikasi Pub/Sub, Anda juga dapat menyiapkan pemberitahuan yang memberi tahu saat peristiwa keberhasilan atau kegagalan tertentu muncul di log. Untuk mengetahui informasi tentang cara menyiapkan notifikasi Pub/Sub, lihat Mengonfigurasi notifikasi Pub/Sub untuk Cloud Storage.

Menyelesaikan tugas pasca-relokasi bucket

Setelah berhasil merelokasi bucket, selesaikan langkah-langkah berikut:

1. Opsional: Pulihkan kontrol akses berbasis tag di bucket Anda.
2. Konfigurasi laporan inventaris yang ada tidak dipertahankan selama proses relokasi dan Anda harus membuatnya ulang secara manual. Untuk mengetahui informasi tentang cara membuat konfigurasi laporan inventaris, lihat Membuat konfigurasi laporan inventaris.
3. Perbarui konfigurasi infrastructure as code Anda seperti Terraform dan konektor konfigurasi Google Kubernetes Engine untuk menentukan lokasi baru bucket.
4. Endpoint regional terkait dengan lokasi tertentu, dan Anda harus mengubah kode aplikasi untuk mencerminkan endpoint baru.

Cara menangani operasi relokasi bucket yang gagal

Pertimbangkan faktor-faktor berikut sebelum menangani operasi relokasi bucket yang gagal:

• Relokasi bucket yang gagal dapat meninggalkan resource usang, seperti file sementara atau salinan data yang tidak lengkap, di tujuan. Anda harus menunggu 7 hingga 14 hari sebelum memulai relokasi bucket lain ke tujuan yang sama. Anda dapat segera memulai relokasi bucket ke tujuan yang berbeda.

• Jika lokasi tujuan bukan lokasi yang optimal untuk data Anda, Anda mungkin ingin melakukan roll back relokasi. Namun, Anda tidak dapat langsung memulai relokasi. Periode tunggu selama 7 hingga 14 hari diperlukan sebelum Anda dapat memulai relokasi kembali ke lokasi sumber asli untuk menjaga stabilitas dan menghindari konflik data.

Langkah berikutnya

• Pelajari relokasi bucket.