Anda juga dapat mengizinkan instance yang berbeda untuk mengakses disk Hyperdisk Balanced High Availability secara bersamaan dengan menyetel mode akses disk. Disk regional hanya dapat dipasang ke instance di zona yang sama dengan replika disk. Untuk mengetahui informasi selengkapnya, lihat bagian Membagikan disk antar-instance.
Dokumen ini menjelaskan cara melakukan tugas-tugas berikut untuk disk regional:
- Buat disk regional.
- Pasang disk regional ke instance Compute Engine Anda.
- Mengubah disk zona menjadi disk regional.
- Buat instance baru dengan boot disk regional.
- Buat instance baru dengan disk regional tambahan.
- Memasang boot disk regional ke instance.
- Buat daftar dan deskripsi disk regional Anda.
- Mengubah ukuran disk regional.
Sebelum memulai
- Tinjau dasar-dasar replikasi disk sinkron.
- Baca tentang failover disk regional.
- Jika menggunakan mode multi-penulis untuk disk Hyperdisk Balanced High Availability, tinjau persyaratan dan batasan di Membagikan disk antar-instance.
-
Siapkan autentikasi jika Anda belum melakukannya.
Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan
kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke
Compute Engine dengan memilih salah satu opsi berikut:
Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
Konsol
Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.
gcloud
-
Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud initJika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
-
- Tetapkan region dan zona default.
-
Instal Google Cloud CLI.
-
Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
-
Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda:
gcloud auth application-default login
Anda tidak perlu melakukan langkah ini jika menggunakan Cloud Shell.
Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa Anda telah login ke gcloud CLI dengan identitas gabungan Anda.
Terraform
Untuk menggunakan contoh Terraform di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.
Instal Google Cloud CLI.
Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .
Peran dan izin yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk membuat disk regional, minta administrator untuk memberi Anda peran IAM berikut pada project:
- Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1) -
Untuk terhubung ke instance yang dapat dijalankan sebagai akun layanan:
Service Account User (v1) (
roles/iam.serviceAccountUser)
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk membuat disk regional. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat disk regional:
-
compute.disks.create -
compute.instances.attachDisk -
compute.disks.use -
Buat snapshot disk:
compute.disks.createSnapshot -
Buat disk regional dari image:
compute.images.useReadOnlypada image -
Lihat detail untuk disk:
compute.disks.get -
Mendapatkan daftar disk:
compute.disks.list -
Mengubah ukuran disk:
compute.disks.update
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Batasan
- Anda dapat memasang Persistent Disk regional hanya ke VM yang menggunakan jenis mesin E2, N1, N2, dan N2D.
- Anda hanya dapat melampirkan Hyperdisk Balanced High Availability ke jenis mesin yang didukung.
- Anda tidak dapat membuat disk regional dengan meng-clone disk Hyperdisk ML atau Hyperdisk Throughput. Anda harus membuat snapshot disk sumber, lalu membuat disk Hyperdisk Balanced High Availability dari snapshot tersebut. Untuk mengetahui informasi selengkapnya, lihat Mengubah disk zonal menjadi disk Hyperdisk Balanced High Availability.
- Saat menggunakan mode hanya baca, Anda dapat memasang Persistent Disk Seimbang regional ke maksimum 10 instance VM.
- Ukuran minimum Persistent Disk Standar regional adalah 200 GiB.
- Anda hanya dapat meningkatkan ukuran Persistent Disk regional atau volume Hyperdisk Balanced High Availability; Anda tidak dapat mengurangi ukurannya.
- Volume Persistent Disk Regional dan Hyperdisk Balanced High Availability memiliki karakteristik performa yang berbeda dengan disk zona yang sesuai. Untuk mengetahui informasi selengkapnya, lihat Tentang performa Persistent Disk dan Batas performa Ketersediaan Tinggi Hyperdisk Seimbang.
- Anda tidak dapat menggunakan volume Hyperdisk Balanced High Availability yang berada dalam mode multi-penulis sebagai boot disk.
- Jika Anda membuat disk yang direplikasi dengan meng-clone disk zona, kedua replika zona tidak sepenuhnya disinkronkan pada saat pembuatan. Setelah pembuatan, Anda dapat menggunakan clone disk regional rata-rata dalam waktu 3 menit. Namun, Anda mungkin perlu menunggu puluhan menit sebelum disk mencapai status replikasi sepenuhnya dan toleransi durasi kehilangan data (RPO) mendekati nol. Pelajari cara memeriksa apakah disk yang direplikasi telah direplikasi sepenuhnya.
- Anda tidak dapat membuat disk regional di zona AI.
- Membuat disk regional dari image memiliki batasan berikut:
- Saat membuat disk regional dari image, Anda dapat membuat satu disk dalam project setiap 5 menit. Anda dapat mengirimkan hingga 5 permintaan sekaligus, tetapi Anda tidak dapat membuat lebih dari 5 disk dalam jangka waktu 25 menit.
- Membuat disk regional dari image berada dalam tahap Pratinjau, dan lebih lambat daripada membuat disk zona dari image.
Tentang penggunaan disk regional sebagai boot disk untuk instance
Anda dapat melampirkan Persistent Disk regional atau disk Hyperdisk Balanced High Availability sebagai boot disk untuk workload stateful yang disediakan sebelumnya, sebelum Anda menyediakan workload produksi. Boot disk regional tidak ditujukan untuk hot standby, karena Anda tidak dapat memasang satu boot disk ke dua instance secara bersamaan.
Dalam penyiapan ketersediaan tinggi, jika perangkat booting adalah disk regional,
Google merekomendasikan agar Anda tidak membuat dan memulai instance standby sebelumnya.
Sebagai gantinya, pada tahap failover, pasang disk regional yang ada saat membuat instance standby menggunakan opsi forceAttach.
Anda dapat membuat disk boot regional dari image (Pratinjau), snapshot standar, atau snapshot instan.
Untuk menggunakan disk regional sebagai boot disk untuk instance, gunakan salah satu metode berikut.
- Buat instance dan boot disk secara bersamaan.
Buat disk booting regional, lalu hubungkan ke instance:
Sebaiknya buat boot disk regional dari snapshot, bukan dari clone disk zona.
Untuk melakukan failover boot disk regional ke instance standby yang berjalan di zona replika, ikuti langkah-langkah yang dijelaskan di Memasang boot disk regional ke instance.
Batas ukuran dan nama referensi untuk disk regional
Ukuran yang Anda tentukan untuk disk regional harus berada dalam rentang yang tercantum dalam tabel berikut.
Jika Anda membuat disk regional dengan Google Cloud CLI, REST, atau library klien Cloud untuk Compute Engine, tunjukkan jenis disk yang akan dibuat dengan memberikan nilai di kolom Nama referensi dalam tabel berikut.
| Jenis disk | Nama referensi | Ukuran minimum | Ukuran maksimum | Ukuran default |
|---|---|---|---|---|
| Hyperdisk Balanced High Availability | hyperdisk-balanced-high-availability |
4 GiB | 64 TiB | 100 GiB |
| Persistent Disk Seimbang | pd-balanced |
Zona: 10 GiB Regional: 10 GiB |
64 TiB | 100 GiB |
| Persistent Disk Performa (SSD) | pd-ssd |
Zona: 10 GiB Regional: 10 GiB |
64 TiB | 100 GiB |
| Standard Persistent Disk | pd-standard |
Zona: 10 GiB Regional: 200 GiB |
64 TiB | 500 GiB |
Membuat disk regional dari image atau snapshot
Buat volume Persistent Disk regional atau Hyperdisk Balanced High Availability. Disk harus berada di region yang sama dengan instance komputasi yang akan Anda pasang.
Jika membuat volume Hyperdisk Balanced High Availability, Anda juga dapat mengizinkan instance yang berbeda untuk mengakses disk secara serentak dengan menetapkan mode akses disk. Untuk mengetahui informasi selengkapnya, lihat Berbagi disk antar-instance.
Untuk Persistent Disk regional, jika Anda membuat disk di konsol Google Cloud , jenis disk default-nya adalahpd-balanced. Jika Anda membuat disk menggunakan gcloud CLI atau REST, jenis disk default-nya adalah pd-standard.
Konsol
Di konsol Google Cloud , buka halaman Disks.
Pilih project yang diperlukan.
Klik Buat disk.
Tentukan Nama untuk disk Anda.
Untuk Lokasi, pilih Regional.
Pilih Region dan Zona. Anda harus memilih region yang sama saat membuat instance.
Pilih Zona replika di region yang sama. Catat zona yang Anda pilih karena Anda harus memasang disk ke instance Anda di salah satu zona tersebut.
Di bagian Disk source type, pilih sumber data untuk disk:
- Untuk membuat disk kosong, pilih Disk kosong.
- Untuk membuat disk dari image:
- Pilih Gambar.
- Di bagian Source image, pilih image sumber untuk disk.
- Untuk membuat disk dari snapshot yang ada:
- Pilih Snapshot, Snapshot instan, atau Snapshot arsip, bergantung pada apakah snapshot sumber adalah snapshot standar, snapshot instan, atau snapshot arsip.
- Di bagian Source snapshot, pilih snapshot sumber atau snapshot instan dari daftar. Hanya snapshot yang ada di lokasi yang Anda pilih yang tercantum.
- Untuk membuat disk dari disk tertentu yang ada dalam image mesin (Pratinjau):
- Pilih Machine Image.
- Di menu drop-down Source machine image, pilih image mesin yang ingin Anda gunakan.
- Di menu drop-down Source disk, pilih nama perangkat disk tertentu dalam image mesin yang dipilih yang ingin Anda gunakan sebagai sumber untuk disk baru.
- Jika image mesin yang dipilih dilindungi oleh Kunci enkripsi yang disediakan pelanggan (CSEK) (Tidak digunakan lagi), bagian Enkripsi akan muncul. Masukkan kunci dekripsi yang diperlukan di kolom yang disediakan.
- Konfigurasikan properti disk lainnya seperti Name, Type, Size, dan aturan Deletion sesuai kebutuhan.
Di bagian Setelan disk, pilih Jenis disk dan Ukuran. Untuk volume Hyperdisk Balanced High Availability, Anda juga dapat mengubah setelan default Provisioned IOPS dan Throughput yang Disediakan.
Opsional: Untuk volume Hyperdisk Balanced High Availability, Anda dapat mengaktifkan pemasangan disk ke beberapa instance dengan membuat disk dalam mode multi-penulis. Di Access mode, pilih Multiple VMs read write.
Klik Buat untuk menyelesaikan pembuatan disk.
gcloud
Buat disk regional menggunakan
perintah compute disks create.
Anda dapat membuat disk kosong, atau membuat disk dari image (Pratinjau), snapshot instan, atau snapshot standar.
Blank disk
gcloud compute disks create DISK_NAME \ --size=DISK_SIZE \ --type=DISK_TYPE \ --region=REGION \ --replica-zones=ZONE1,ZONE2 \ --access-mode=DISK_ACCESS_MODE
Ganti kode berikut:
DISK_NAME: nama disk baruDISK_SIZE: ukuran disk baru, dalam GiB. Harus berada dalam batas ukuran untuk jenis disk.DISK_TYPE: Untuk Persistent Disk regional, ini adalah jenis disk regional. Nilai defaultnya adalahpd-standard. Untuk Hyperdisk, tentukan nilaihyperdisk-balanced-high-availability.REGION: region tempat disk regional berada, misalnya:europe-west1ZONE1,ZONE2: zona dalam region tempat dua replika disk berada, misalnya:europe-west1-b,europe-west1-cDISK_ACCESS_MODE: opsional: Untuk disk Hyperdisk Balanced High Availability, tentukan cara instance dapat mengakses data di disk. Nilai berikut didukung:READ_WRITE_SINGLE, untuk akses baca-tulis dari satu instance. Ini adalah setelan default.READ_WRITE_MANY, untuk akses baca-tulis dari beberapa instance.
Snapshot
Untuk membuat disk dari snapshot standar atau arsip, gunakan
flag --source-snapshot untuk menentukan nama snapshot.
gcloud compute disks create DISK_NAME \ --size=DISK_SIZE \ --type=DISK_TYPE \ --region=REGION \ --replica-zones=ZONE1,ZONE2 \ --access-mode=DISK_ACCESS_MODE \ --source-snapshot=SNAPSHOT_NAME \ [ --source-snapshot-region=SOURCE_REGION ]
Ganti kode berikut:
DISK_NAME: nama disk baruDISK_SIZE: ukuran disk baru, dalam GiB. Harus berada dalam batas ukuran untuk jenis disk.DISK_TYPE: Untuk Persistent Disk regional, ini adalah jenis disk regional. Nilai defaultnya adalahpd-standard. Untuk Hyperdisk, tentukan nilaihyperdisk-balanced-high-availability.REGION: region tempat disk regional berada, misalnya:europe-west1ZONE1,ZONE2: zona dalam region tempat dua replika disk berada, misalnya:europe-west1-b,europe-west1-cDISK_ACCESS_MODE: opsional: Untuk disk Hyperdisk Balanced High Availability, tentukan cara instance dapat mengakses data di disk. Nilai berikut didukung:READ_WRITE_SINGLE, untuk akses baca-tulis dari satu instance. Ini adalah setelan default.READ_WRITE_MANY, untuk akses baca-tulis dari beberapa instance.
-
SNAPSHOT_NAMEdengan nama snapshot. SOURCE_REGION: optional. Jika snapshot adalah snapshot cakupan regional, tentukan region yang menjadi cakupan snapshot.
Untuk membuat disk dari snapshot instan, gunakan
flag --source-instant-snapshot untuk menentukan nama snapshot instan.
gcloud compute disks create DISK_NAME \
--source-instant-snapshot=INSTANT_SNAPSHOT_NAME
Ganti INSTANT_SNAPSHOT_NAME dengan nama snapshot instan.
Gambar
Untuk membuat disk dari versi tertentu image publik atau dari
image kustom, gunakan versi beta perintah. Tentukan nama image dengan tanda --image:
gcloud beta compute disks create DISK_NAME \
--size=DISK_SIZE \
--type=DISK_TYPE \
--region=REGION \
--replica-zones=ZONE1,ZONE2 \
--access-mode=DISK_ACCESS_MODE \
--image=IMAGE_NAME
Ganti kode berikut:
DISK_NAME: nama disk baruDISK_SIZE: ukuran disk baru, dalam GiB. Harus berada dalam batas ukuran untuk jenis disk.DISK_TYPE: Untuk Persistent Disk regional, ini adalah jenis disk regional. Nilai defaultnya adalahpd-standard. Untuk Hyperdisk, tentukan nilaihyperdisk-balanced-high-availability.REGION: region tempat disk regional berada, misalnya:europe-west1ZONE1,ZONE2: zona dalam region tempat dua replika disk berada, misalnya:europe-west1-b,europe-west1-cDISK_ACCESS_MODE: opsional: Untuk disk Hyperdisk Balanced High Availability, tentukan cara instance dapat mengakses data di disk. Nilai berikut didukung:READ_WRITE_SINGLE, untuk akses baca-tulis dari satu instance. Ini adalah setelan default.READ_WRITE_MANY, untuk akses baca-tulis dari beberapa instance.
IMAGE_NAMEdengan nama image, misalnya:debian-13-trixie-v20260902.
Untuk membuat disk menggunakan versi terbaru kelompok image, gunakan perintah versi beta. Tentukan nama kelompok image dengan flag --image-family:
gcloud beta compute disks create DISK_NAME \
--size=DISK_SIZE \
--type=DISK_TYPE --region=REGION \
--replica-zones=ZONE1,ZONE2 \
--image-family=IMAGE_FAMILY_NAME
Ganti IMAGE_FAMILY_NAME dengan nama kelompok image, misalnya, debian-13.
Terraform
Untuk membuat volume Persistent Disk atau Hyperdisk Balanced High Availability regional, gunakan
resource google_compute_region_disk.
Untuk menentukan jenis disk, tetapkan argumen type ke nilai yang sesuai dari daftar berikut.
- Hyperdisk Balanced High Availability:
hyperdisk-balanced-high-availability - Persistent Disk SSD:
pd-ssd - Persistent Disk Seimbang:
pd-balanced - Persistent Disk Standar:
pd-standard
Untuk membuat disk dari image (Pratinjau),
ganti argumen snapshot dalam contoh berikut dengan
argumen image.
Contoh berikut membuat disk regional dari snapshot.
Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.
REST
Untuk membuat volume
Persistent Disk regional atau Hyperdisk Balanced High Availability,
buat permintaan POST ke
metode compute.regionDisks.insert.
Anda dapat membuat disk kosong, atau membuat disk dari image (Pratinjau) atau snapshot standar atau instan.
Blank disk
Untuk membuat disk kosong, buat permintaan POST dengan isi permintaan
berikut:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/disks
{
"name": "DISK_NAME",
"region": "projects/PROJECT_ID/regions/REGION",
"replicaZones": [
"projects/PROJECT_ID/zones/ZONE1",
"projects/PROJECT_ID/zones/ZONE2"
],
"sizeGb": "DISK_SIZE",
"type": "projects/PROJECT_ID/regions/REGION/diskTypes/DISK_TYPE",
"accessMode": "DISK_ACCESS_MODE"
}
Ganti kode berikut:
PROJECT_ID: project ID AndaREGION: region tempat disk regional berada, misalnya:europe-west1DISK_NAME: nama disk baruZONE1,ZONE2: zona tempat replika disk baru seharusnya beradaDISK_SIZE: ukuran disk baru, dalam GiB. Harus berada dalam batas ukuran untuk jenis disk.DISK_TYPE: Untuk Persistent Disk regional, ini adalah jenis Persistent Disk. Untuk Hyperdisk, tentukan nilaihyperdisk-balanced-high-availabilityDISK_ACCESS_MODE: Opsional: untuk disk Hyperdisk Balanced High Availability, tentukan cara instance dapat mengakses data di disk Hyperdisk Balanced High Availability. Nilai berikut didukung:READ_WRITE_SINGLE, untuk akses baca-tulis dari satu instance. Ini adalah setelan default.READ_WRITE_MANY, untuk akses baca-tulis dari beberapa instance.
Snapshot
Untuk membuat disk dari snapshot standar atau arsip, gunakan kolom sourceSnapshot untuk menentukan URL snapshot.
Jika snapshot adalah snapshot global:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/ REGION/disks { "name": "DISK_NAME", "region": "projects/PROJECT_ID/regions/REGION", "replicaZones": [ "projects/PROJECT_ID/zones/ZONE1", "projects/PROJECT_ID/zones/ZONE2" ], "sizeGb": "DISK_SIZE", "type": "projects/PROJECT_ID/regions/REGION/diskTypes/DISK_TYPE", "accessMode": "DISK_ACCESS_MODE", "sourceSnapshot": "SNAPSHOT_NAME" }Ganti kode berikut:
PROJECT_ID: project ID AndaREGION: region tempat disk regional berada, misalnya:europe-west1DISK_NAME: nama disk baruZONE1,ZONE2: zona tempat replika disk baru seharusnya beradaDISK_SIZE: ukuran disk baru, dalam GiB. Harus berada dalam batas ukuran untuk jenis disk.DISK_TYPE: Untuk Persistent Disk regional, ini adalah jenis Persistent Disk. Untuk Hyperdisk, tentukan nilaihyperdisk-balanced-high-availabilityDISK_ACCESS_MODE: Opsional: untuk disk Hyperdisk Balanced High Availability, tentukan cara instance dapat mengakses data di disk Hyperdisk Balanced High Availability. Nilai berikut didukung:READ_WRITE_SINGLE, untuk akses baca-tulis dari satu instance. Ini adalah setelan default.READ_WRITE_MANY, untuk akses baca-tulis dari beberapa instance.
SNAPSHOT_NAME: nama snapshot standar atau arsip.
Jika snapshot adalah snapshot cakupan regional (Pratinjau), gunakan endpoint versi beta:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/disks { "name": "DISK_NAME", "sourceSnapshot": "projects/PROJECT_ID/regions/SOURCE_REGION/snapshots/SNAPSHOT_NAME" }Ganti kode berikut:
REGION: region yang akan ditempati disk regional, misalnya:europe-west1SOURCE_REGION: region tempat snapshot sumber dicakupSNAPSHOT_NAME: snapshot sumber untuk disk
Untuk membuat disk dari snapshot instan, gunakan kolom sourceInstantSnapshot, bukan sourceSnapshot, untuk menentukan URL snapshot instan.
POST https://compute.googleapis.com/compute/v1/projects/ PROJECT_ID/regions/REGION/disks
{
"name": "DISK_NAME",
"sourceInstantSnapshot": "projects/PROJECT/regions/SOURCE_REGION/instantSnapshots/ SOURCE_INSTANT_SNAPSHOT_NAME"
}
Ganti SOURCE_INSTANT_SNAPSHOT_NAME dengan nama snapshot instan.
Gambar
Untuk membuat disk dari image kustom atau publik, gunakan endpoint versi beta dan tentukan URL image dengan kolom sourceImage.
Untuk menggunakan image kustom atau versi terbaru dari kelompok image kustom:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/disks { "name": "DISK_NAME", "region": "projects/PROJECT_ID/regions/REGION", "replicaZones": [ "projects/PROJECT_ID/zones/ZONE1", "projects/PROJECT_ID/zones/ZONE2" ], "sizeGb": "DISK_SIZE", "type": "projects/PROJECT_ID/regions/REGION/diskTypes/DISK_TYPE", "accessMode": "DISK_ACCESS_MODE", "sourceImage": "global/images/IMAGE_NAME_OR_PATH" }Ganti kode berikut:
PROJECT_ID: project ID AndaREGION: region tempat disk regional berada, misalnya:europe-west1DISK_NAME: nama disk baruZONE1,ZONE2: zona tempat replika disk baru seharusnya beradaDISK_SIZE: ukuran disk baru, dalam GiB. Harus berada dalam batas ukuran untuk jenis disk.DISK_TYPE: Untuk Persistent Disk regional, ini adalah jenis Persistent Disk. Untuk Hyperdisk, tentukan nilaihyperdisk-balanced-high-availabilityDISK_ACCESS_MODE: Opsional: untuk disk Hyperdisk Balanced High Availability, tentukan cara instance dapat mengakses data di disk Hyperdisk Balanced High Availability. Nilai berikut didukung:READ_WRITE_SINGLE, untuk akses baca-tulis dari satu instance. Ini adalah setelan default.READ_WRITE_MANY, untuk akses baca-tulis dari beberapa instance.
-
IMAGE_NAME_OR_PATH: Untuk menggunakan image tertentu, gantiIMAGE_NAME_OR_PATHdengan nama image, misalnya:custom-debug-image. Untuk menggunakan image dari kelompok image, tentukanfamily/IMAGE_FAMILY_NAME, denganIMAGE_FAMILY_NAMEadalah nama kelompok image. Misalnya,family/debug-image-family.
Untuk menggunakan image publik tertentu atau versi terbaru dari kelompok image publik:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/disks { "name": "DISK_NAME", "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE_NAME_OR_PATH" }Ganti kode berikut:
IMAGE_PROJECT: project yang berisi image publik. Misalnya, untuk menggunakan image Debian, tentukandebian-cloud.IMAGE_NAME_OR_PATH: nama atau jalur ke gambar. Untuk menggunakan versi image tertentu, tentukan nama image, misalnya:debian-13-trixie-v20260902. Untuk menggunakan versi terbaru dari OS image publik, tentukan nama kelompok image, misalnya:family/debian-13.
Setelah membuat disk, Anda dapat menggunakannya sebagai boot disk untuk instance atau melampirkannya sebagai disk data ke instance.
Memasang disk regional ke instance Anda
Untuk disk yang bukan boot disk, setelah membuat volume Persistent Disk regionalatau volume Hyperdisk Balanced High Availability , Anda dapat menghubungkannya ke instance. Instance harus berada di region yang sama dengan disk.
Untuk memasang boot disk regional ke instance, lihat Memasang boot disk regional ke instance.
Untuk melampirkan disk Hyperdisk Balanced High Availability ke beberapa instance, ulangi prosedur di bagian ini untuk setiap instance. Anda hanya dapat memasang disk Hyperdisk Balanced High Availability dalam mode baca-tulis.
Konsol
Untuk memasang disk ke instance, buka halaman Instance VM.
Di kolom Name, klik nama instance.
Klik Edit .
Klik +Pasang disk yang ada.
Pilih disk regional yang dibuat sebelumnya untuk ditambahkan ke instance Anda.
Jika Anda melihat peringatan yang menunjukkan bahwa disk yang dipilih telah terpasang ke instance lain, pilih kotak Force-attach disk untuk memasang disk secara paksa ke instance yang sedang Anda edit.
Tinjau kasus penggunaan untuk pemasangan paksa disk regional di Failover disk regional.
Opsional: Jika memasang disk Hyperdisk Balanced High Availability ke beberapa instance, untuk Disk attachment mode, pilih Read/write.
Klik Simpan.
Di halaman Edit VM, klik Simpan.
gcloud
Untuk melampirkan disk regional ke instance yang sedang berjalan atau dihentikan, gunakan
perintah compute instances attach-disk
dengan flag --disk-scope yang ditetapkan ke regional.
Jika memasang disk Hyperdisk Balanced High Availability dalam mode multi-penulis ke beberapa instance,
satu-satunya mode lampiran yang didukung adalah rw, yang merupakan mode akses
default. Anda tidak perlu menyertakan tanda --mode.
gcloud compute instances attach-disk INSTANCE_NAME \
--disk=DISK_NAME \
--disk-scope=regional \
--device-name=DEVICE_NAME
Ganti kode berikut:
INSTANCE_NAME: nama instance tempat Anda menambahkan disk regionalDISK_NAME: nama disk baru yang Anda pasang ke instanceDEVICE_NAME: Opsional: nama yang digunakan OS tamu untuk membuat symlink, yang membantu mengidentifikasi disk di level OS.
Terraform
Untuk melampirkan volume Ketersediaan Tinggi Seimbang Hyperdisk atau Persistent Disk regional ke instance, Anda dapat menggunakan resource google_compute_attached_disk.
Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.
REST
Untuk memasang disk regional ke instance yang sedang berjalan atau dihentikan,
buat permintaan POST ke
metode compute.instances.attachDisk
dan sertakan URL ke disk regional yang Anda buat.
Jika memasang disk Hyperdisk Balanced High Availability dalam mode multi-penulis ke beberapa instance,
satu-satunya mode lampiran yang didukung adalah READ-WRITE, yang merupakan mode akses
default. Anda tidak perlu menyertakan properti mode.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk
{
"source": "/projects/PROJECT_ID/regions/REGION/disks/DISK_NAME",
"deviceName": DEVICE_NAME
}
Ganti kode berikut:
PROJECT_ID: project ID AndaZONE: lokasi instance AndaINSTANCE_NAME: nama instance tempat Anda menambahkan disk regional baruREGION: region tempat disk regional beradaDISK_NAME: nama disk regional (seperti yang ditampilkan di konsol Google Cloud ).DEVICE_NAME: Opsional: nama yang digunakan OS tamu untuk membuat symlink, yang membantu mengidentifikasi disk di tingkat OS.
Untuk disk non-boot, setelah membuat dan memasang disk regional kosong ke instance, Anda harus memformat dan memasang disk, sehingga sistem operasi dapat menggunakan ruang penyimpanan yang tersedia.
Mengubah disk zona menjadi disk regional
Untuk mengonversi disk zona yang ada dari jenis berikut menjadi disk regional, Buat disk regional dengan meng-clone disk sumber.
- Hyperdisk Balanced
- Ekstrem Hyperdisk
- Persistent Disk Seimbang
- Persistent Disk SSD
- Standard Persistent Disk
Untuk mengonversi volume Hyperdisk ML atau Hyperdisk Throughput menjadi disk regional, buat disk Hyperdisk Balanced High Availability baru dari snapshot disk yang ada, seperti yang dijelaskan dalam Mengubah disk zonal menjadi disk Hyperdisk Balanced High Availability.
Membuat instance dengan disk boot regional baru
Saat menyiapkan instance komputasi dengan tingkat ketersediaan tinggi, Anda dapat membuat instance utama dengan boot disk regional baru. Saat membuat instance secara bersamaan dengan boot disk regionalnya, Anda dapat membuat boot disk dari image (Pratinjau) atau snapshot standar.
Untuk membuat disk regional baru dari disk zona yang ada, Anda harus Mengubah disk zona menjadi disk regional terlebih dahulu, lalu membuat instance dengan disk regional baru.
Bagian ini menjelaskan cara membuat instance dengan disk boot regional baru menggunakan konsol Google Cloud , Google Cloud CLI, atau REST.
Konsol
Di konsol Google Cloud , buka halaman Create an instance.
Jika diminta, pilih project Anda, lalu klik Lanjutkan.
Halaman Create an instance akan muncul dan menampilkan panel Machine configuration.
Di panel Machine configuration, lakukan hal berikut:
- Di kolom Name, tentukan nama untuk instance Anda. Untuk mengetahui informasi selengkapnya, lihat Konvensi penamaan resource.
Opsional: Di kolom Zone, pilih zona untuk instance ini.
Pilihan defaultnya adalah Semua. Jika Anda tidak mengubah pilihan default ini, Google akan otomatis memilih zona untuk Anda berdasarkan jenis dan ketersediaan mesin.
Pilih kelompok mesin untuk instance Anda dari salah satu opsi berikut:
- Tujuan umum
- Dioptimalkan untuk komputasi
- Dioptimalkan untuk memori
- Dioptimalkan untuk penyimpanan
- Dioptimalkan untuk jaringan
- GPU
- TPU
Konsol Google Cloud kemudian menampilkan seri mesin yang tersedia untuk kelompok mesin yang Anda pilih.
Di kolom Series, pilih seri mesin untuk instance Anda.
Jika Anda memilih GPU sebagai kelompok mesin pada langkah sebelumnya, pilih jenis GPU yang Anda inginkan. Seri mesin kemudian dipilih secara otomatis untuk jenis GPU yang dipilih.
Di bagian Machine type, pilih jenis mesin untuk instance Anda.
Di menu navigasi, klik OS and storage. Di panel Sistem operasi dan penyimpanan yang muncul, selesaikan langkah-langkah berikut.
Untuk mempelajari lebih lanjut parameter yang dapat Anda konfigurasi saat menambahkan disk baru, lihat Tentang Persistent Disk dan Tentang Google Cloud Hyperdisk.
- Untuk mulai mengonfigurasi boot disk, klik Change. Panel Boot disk akan muncul dan menampilkan tab Public images.
Konfigurasi sumber data untuk boot disk dengan salah satu cara berikut:
- Untuk memilih image publik sebagai sumber data untuk disk boot Anda,
di tab Public images, tentukan hal berikut:
- Dalam daftar Operating system, pilih jenis OS.
- Dalam daftar Versi, pilih versi OS.
- Pada daftar Boot disk type, pilih jenis boot disk.
- Di kolom Size (GB), tentukan ukuran boot disk.
- Untuk memilih image kustom sebagai sumber data untuk boot disk Anda, klik
Custom images, lalu di tab Custom images yang muncul,
tentukan hal berikut:
- Untuk memilih project image, klik Ubah, lalu pilih project yang berisi image.
- Di daftar Image, pilih image yang ingin Anda impor.
- Pada daftar Boot disk type, pilih jenis boot disk.
- Di kolom Size (GB), tentukan ukuran boot disk.
- Untuk memilih snapshot standar sebagai sumber data untuk boot disk Anda,
klik Snapshot, lalu di tab Snapshot yang muncul,
tentukan hal berikut:
- Dalam daftar Snapshot, pilih snapshot.
- Pada daftar Boot disk type, pilih jenis boot disk.
- Di kolom Size (GB), tentukan ukuran boot disk.
- Untuk memilih snapshot arsip sebagai sumber data untuk boot disk Anda,
klik Archive snapshots, lalu di tab Archive snapshots
yang muncul, tentukan hal berikut:
- Dalam daftar Archive snapshot, pilih snapshot arsip.
- Dalam daftar Boot disk type, pilih jenis boot disk.
- Di kolom Size (GB), tentukan ukuran boot disk.
- Untuk memilih disk yang ada sebagai boot disk, klik Existing disks. Kemudian, di tab Existing disks yang muncul, pilih disk yang ada di daftar Disk. Opsi ini menggunakan disk yang ada sebagai boot disk dan tidak membuat disk baru.
- Untuk memilih image publik sebagai sumber data untuk disk boot Anda,
di tab Public images, tentukan hal berikut:
Opsional: Untuk opsi konfigurasi lanjutan, luaskan bagian Tampilkan konfigurasi lanjutan.
Untuk mengonfirmasi opsi boot disk dan kembali ke panel Operating system and storage, klik Select.
Opsional: Untuk mempelajari cara memasang non-boot disk ke instance, lihat Membuat instance dengan non-boot disk tambahan.
Jika Anda tidak memilih boot disk yang ada, konfigurasikan menjadi disk regional dengan melakukan hal berikut:
Di menu navigasi, klik Perlindungan data. Di panel Data protection yang muncul, lakukan hal berikut:
Guna mengonfigurasi semua disk baru untuk instance agar menggunakan replikasi disk sinkron (Persistent Disk regional atau Hyperdisk Balanced High Availability), centang kotak Regional disks.
(Tidak ada tindakan yang diperlukan secara default.) Hapus centang pada kotak Exclude boot disks.
Opsional: Tentukan opsi konfigurasi lainnya. Untuk mengetahui informasi selengkapnya, lihat Opsi konfigurasi selama pembuatan instance.
Untuk membuat dan memulai instance, klik Create.
gcloud
Gunakan perintah gcloud compute instances create untuk membuat instance,
dan flag --create-disk untuk menentukan disk regional. Saat menentukan
parameter disk, karakter ^:^ menentukan bahwa karakter pemisahan
di antara parameter adalah titik dua (:). Dengan demikian, Anda dapat menggunakan koma
(,) saat menentukan parameter replica-zones.
Untuk membuat instance dan membuat boot disk regionalnya dari image publik atau image kustom (Pratinjau):
gcloud compute instances create PRIMARY_INSTANCE_NAME \ --zone=ZONE --project=PROJECT_ID \ --create-disk=^:^name=REGIONAL_DISK_NAME:boot=true:type=DISK_TYPE:replica-zones=ZONE,REMOTE_ZONE:[IMAGE_NAME_OR_FAMILY]
Ganti kode berikut:
- PRIMARY_INSTANCE_NAME: nama instance
- ZONE: nama zona tempat instance akan dibuat
- PROJECT_ID: nama project tempat instance akan dibuat
- REGIONAL_DISK_NAME: nama untuk disk regional
- DISK_TYPE: jenis disk yang akan dibuat, misalnya,
hyperdisk-balanced-high-availability. Jika menggunakan Persistent Disk, Anda juga harus menentukanscope=regionaldalam flag--create-diskuntuk membuat Persistent Disk Regional. - REMOTE_ZONE: zona alternatif untuk disk regional
IMAGE_NAME_OR_FAMILY: nama atau kelompok image yang akan digunakan.
Untuk menggunakan versi tertentu dari image publik atau kustom, tentukan
image=<var>IMAGE_NAME</var>, dengan<var>IMAGE_NAME</var>adalah nama image. Misalnya,image=debian-13-trixie-v20260902atauimage=my-custom-image.Untuk menggunakan kelompok image, tentukan
image-family=<var>IMAGE_FAMILY</var>:image-family-scope=global. Tindakan ini akan membuat instance yang menggunakan OS image terbaru yang masih digunakan dalam kelompok image.Misalnya, untuk menggunakan versi terbaru OS image dalam kelompok image Debian 13, tentukan
image-family=debian-13:image-family-scope=global.
Untuk membuat instance dan membuat boot disk regional dari snapshot:
gcloud compute instances create PRIMARY_INSTANCE_NAME \ --zone=ZONE --project=PROJECT_ID \ --create-disk=^:^name=REGIONAL_DISK_NAME:boot=true:type=DISK_TYPE:source-snapshot=SNAPSHOT_NAME:replica-zones=ZONE,REMOTE_ZONE
Gunakan parameter yang sama seperti perintah sebelumnya, dan ganti
<var>SNAPSHOT_NAME</var>dengan nama snapshot untuk boot disk, misalnya,dev-snapshot-may2026.
REST
Buat permintaan POST ke metode instances.insert
dan tentukan properti boot: 'true' dan replicaZones. Untuk membuat
instance dari snapshot, tentukan properti sourceSnapshot.
Untuk membuat instance dari gambar, tentukan properti sourceImage.
- Untuk membuat instance dan membuat boot disk regionalnya dari snapshot:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"name": "INSTANCE_NAME",
"disks": [{
"boot": true,
"initializeParams": {
"sourceSnapshot": "global/snapshots/BOOT_SNAPSHOT_NAME",
"replicaZones": [
"projects/PROJECT_ID/zones/ZONE",
"projects/PROJECT_ID/zones/REMOTE_ZONE"
],
"diskType": "projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE"
}
}],
"networkInterfaces": [
{
"network": "global/networks/default"
}
]
}
Ganti kode berikut:
PROJECT_ID: project ID AndaZONE: nama zona tempat Anda ingin membuat instanceINSTANCE_NAME: nama instanceBOOT_SNAPSHOT_NAME: nama snapshot boot diskREMOTE_ZONE: zona jarak jauh untuk disk regionalDISK_TYPE: jenis disk yang akan dibuat, misalnya,hyperdisk-balanced-high-availabilityataupd-balancedUntuk membuat instance dan membuat boot disk regionalnya dari image (Pratinjau):
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"name": "INSTANCE_NAME",
"disks": [{
"boot": true,
"initializeParams": {
"sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE_NAME",
"replicaZones": [
"projects/PROJECT_ID/zones/ZONE",
"projects/PROJECT_ID/zones/REMOTE_ZONE"
],
"diskType": "projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE"
}
}],
"networkInterfaces": [
{
"network": "global/networks/default"
}
]
}
Membuat instance baru dengan disk regional tambahan
Saat membuat instance, Anda dapat menyertakan volume Persistent Disk regional atau Hyperdisk Balanced High Availability sebagai disk tambahan secara opsional.
Untuk membuat dan melampirkan volume Persistent Disk regional atau Hyperdisk Balanced High Availability ke instance selama pembuatan instance, lihat salah satu opsi berikut:
Memasang boot disk regional ke instance
Gunakan langkah-langkah berikut untuk:
- Ganti boot disk instance yang ada dengan boot disk regional.
- Melakukan failover boot disk regional ke instance standby hot yang berjalan di zona cadangan. Anda melakukannya dengan memasang disk regional ke instance sebagai boot disk.
Langkah-langkah ini mengasumsikan bahwa disk dan instance regional sudah ada.
gcloud
- Hentikan instance.
gcloud compute instances stop INSTANCE_NAME --zone=ZONE
- Lepaskan boot disk saat ini dari instance.
gcloud compute instances detach-disk INSTANCE_NAME \ --zone=ZONE --disk=CURRENT_BOOT_DEVICE_NAME
- Pasang boot disk regional ke instance.
gcloud compute instances attach-disk INSTANCE_NAME \ --zone=ZONE \ --disk=REGIONAL_DISK_NAME \ --disk-scope=regional --force-attach \ --boot
Mulai ulang instance.
gcloud compute instances start INSTANCE_NAME
Ganti variabel dalam perintah sebelumnya dengan yang berikut ini:
INSTANCE_NAME: nama instance tempat Anda ingin memasang boot disk regionalZONE: zona tempat instance beradaCURRENT_BOOT_DEVICE_NAME: nama boot disk yang digunakan oleh instance. Nama ini biasanya sama dengan nama instance.REGIONAL_DISK_NAME: nama disk regional yang ingin Anda pasang ke instance sebagai boot disk
Opsional: Jika Anda tidak berhasil melepaskan boot disk regional dari instance utama karena pemadaman atau kegagalan, sertakan flag --force-attach.
REST
Hentikan instance.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop
Lepaskan boot disk saat ini dari instance.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/detachDisk?deviceName=CURRENT_BOOT_DEVICE_NAME
Pasang boot disk regional ke instance.
Buat permintaan
POSTke metodecompute.instances.attachDisk, dan sertakan URL ke disk boot regional:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk { "source": "compute/v1/projects/PROJECT_ID/regions/REGION/disks/REGIONAL_DISK_NAME", "boot": true }Mulai ulang instance.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/start
Ganti variabel dalam perintah sebelumnya dengan yang berikut ini:
PROJECT_ID: project ID AndaINSTANCE_NAME: nama instance tempat Anda ingin memasang disk regionalZONE: zona tempat instance beradaCURRENT_BOOT_DEVICE_NAME: nama boot disk yang digunakan oleh instance. Ini biasanya sama dengan nama instance.REGION: region tempat disk regional beradaREGIONAL_DISK_NAME: nama disk regional yang ingin Anda pasang ke instance sebagai boot disk
Opsional: Jika Anda tidak berhasil melepaskan boot disk regional dari instance tempat awalnya terpasang karena pemadaman atau kegagalan, sertakan "forceAttach": true dalam isi permintaan.
Membuat daftar dan deskripsi disk regional Anda
Anda dapat melihat daftar semua disk regional yang dikonfigurasi, dan informasi tentang propertinya, termasuk yang berikut:
- ID Disk
- Nama disk
- Ukuran
- Jenis disk
- Region
- Replika zona
Untuk melihat informasi mendetail tentang disk regional, gunakan berikut:
- Untuk melihat detail semua disk regional di region dan project tertentu:
- Buat permintaan
GETke metodecompute.regionDisks.list. - Gunakan perintah
gcloud compute disks listdan filter hasilnya menurut wilayah.
- Buat permintaan
- Untuk melihat detail disk regional tertentu:
- Jalankan perintah
gcloud compute disks describedengan flag--region, lalu tentukan nama disk dan region-nya. - Buat permintaan
GETke metodecompute.regionDisks.get.
- Jalankan perintah
Mengubah ukuran disk regional
Jika instance dengan disk regional memerlukan ruang penyimpanan tambahan, Anda dapat mengubah ukuran disk. Anda dapat mengubah ukuran disk kapan saja, terlepas dari apakah disk terpasang ke instance yang sedang berjalan. Jika Anda perlu memisahkan data menjadi volume unik, buat beberapa disk sekunder untuk instance. Untuk Hyperdisk Balanced High Availability, Anda juga dapat meningkatkan batas IOPS dan throughput untuk disk.
Perintah untuk mengubah ukuran disk regional sangat mirip dengan perintah untuk mengubah ukuran disk zona. Namun, Anda harus menentukan region, bukan zona untuk lokasi disk.
Anda hanya dapat menambah, dan tidak mengurangi, ukuran disk. Untuk mengurangi ukuran disk, Anda harus membuat disk baru dengan ukuran yang lebih kecil. Anda akan dikenai biaya untuk kedua disk sampai disk asli yang lebih besar dihapus.
Untuk mengetahui petunjuk cara mengubah disk regional, lihat artikel berikut:
- Persistent Disk Regional: Memperbesar ukuran persistent disk
- Hyperdisk Balanced High Availability: Mengubah volume Hyperdisk
Langkah berikutnya
- Pelajari harga disk.
- Pelajari cara memantau status replika disk regional.
- Pelajari cara menentukan status replikasi disk regional.
- Tinjau Membagikan volume Persistent Disk antar-instance komputasi sebagai alternatif untuk Persistent Disk Regional untuk data hanya baca.
- Buat snapshot disk.
- Pelajari grup instance untuk instance komputasi.
- Pelajari cara membangun aplikasi web yang skalabel dan tangguh di Google Cloud.
- Lihat Google Cloud panduan perencanaan pemulihan dari bencana.