Menambahkan persistent disk ke VM


Anda dapat membuat persistent disk kosong atau membuat disk dari sumber data. Anda dapat menggunakan persistent disk sebagai boot disk untuk instance mesin virtual (VM), atau sebagai disk data yang dipasang ke VM.

Dokumen ini menjelaskan cara:

  • Membuat persistent disk zona non-boot kosong, lalu memasangnya ke VM.

Jika Anda ingin membuat boot disk yang nantinya dapat digunakan untuk membuat VM, lihat Membuat boot disk yang disesuaikan.

Jika ingin menambahkan disk Google Cloud Hyperdisk ke VM, lihat Menambahkan penyimpanan Hyperdisk ke VM.

Jika Anda perlu memformat atau memasang persistent disk di VM, lihat:

Untuk mengetahui informasi umum tentang Persistent Disk dan jenis disk yang tersedia, baca ringkasan Persistent Disk.

Sebelum memulai

  • Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

      gcloud init
    2. Menetapkan region dan zona default.

    Terraform

    Untuk menggunakan contoh Terraform di halaman ini dari lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

    1. Menginstal Google Cloud CLI.
    2. Untuk initialize gcloud CLI, jalankan perintah berikut:

      gcloud init
    3. Buat kredensial autentikasi lokal untuk Akun Google Anda:

      gcloud auth application-default login

    Untuk informasi selengkapnya, lihat Siapkan 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, lalu initialize dengan menjalankan perintah berikut:

      gcloud init

Pembatasan

  • Selama pembuatan VM, Anda dapat memasang hingga 127 persistent disk zona non-boot sekunder.
  • Anda dapat memiliki total kapasitas terpasang sebesar 257 TB per VM. Untuk informasi tentang cara memastikan performa maksimum dengan volume besar, lihat Ukuran volume logis.

Menambahkan disk non-boot ke VM Anda

Buat dan pasang disk zona non-booting menggunakan Google Cloud Console, Google Cloud CLI, atau REST.

Jika Anda membuat disk di Konsol Google Cloud, jenis disk default-nya adalah pd-balanced. Jika Anda membuat disk menggunakan gcloud CLI atau REST, jenis disk default-nya adalah pd-standard.

Anda harus menentukan nama perangkat kustom saat memasang disk ke VM. Nama yang Anda tentukan akan digunakan untuk membuat symlink untuk disk di OS tamu, sehingga mempermudah identifikasi.

Konsol

  1. Buka halaman VM instances.

    Buka halaman VM instances

  2. Klik nama VM tempat Anda ingin menambahkan disk.

  3. Di halaman detail, klik Edit.

  4. Di bagian Additional disks, klik Add new disk.

  5. Tentukan nama untuk disk, konfigurasikan properti disk, dan pilih Blank sebagai Jenis sumber.

  6. Opsional: Di bawah judul Device name, pilih opsi Use a custom device name. Nama yang Anda masukkan akan digunakan untuk membuat symlink untuk {i>disk<i}, sehingga identifikasi {i>disk<i} menjadi lebih mudah.

  7. Klik Done untuk menyelesaikan konfigurasi disk.

  8. Klik Save untuk menerapkan perubahan pada VM dan menambahkan disk baru.

gcloud

  1. Di konsol Google Cloud, aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

  2. Gunakan perintah gcloud compute disks create untuk membuat persistent disk zonal.

    gcloud compute disks create DISK_NAME \
      --size DISK_SIZE \
      --type DISK_TYPE
    

    Ganti kode berikut:

    • DISK_NAME: nama disk baru.
    • DISK_SIZE: ukuran disk baru, dalam gigabyte. Rentang ukuran yang dapat diterima, dalam peningkatan 1 GB, dari 10 GB hingga 65.536 GB inklusif.
    • DISK_TYPE: URL lengkap atau sebagian untuk jenis persistent disk. Misalnya, https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd.
  3. Setelah membuat disk, pasang ke VM yang sedang berjalan atau dihentikan. Gunakan perintah gcloud compute instances attach-disk:

    gcloud compute instances attach-disk VM_NAME \
      --disk DISK_NAME --device-name=DEVICE_NAME
    

    Ganti kode berikut:

    • VM_NAME: nama VM tempat Anda menambahkan persistent disk zona baru
    • DISK_NAME: nama disk baru yang Anda pasang ke VM.
    • DEVICE_NAME: Opsional: nama yang digunakan OS tamu untuk mengidentifikasi disk.
  4. Gunakan perintah gcloud compute disks describe untuk melihat deskripsi disk Anda.

Terraform

Untuk membuat disk, gunakan resource google_compute_disk.

# Using pd-standard because it's the default for Compute Engine

resource "google_compute_disk" "default" {
  name = "disk-data"
  type = "pd-standard"
  zone = "us-west1-a"
  size = "5"
}

Untuk memasang disk ke VM, gunakan resource google_compute_instance.

resource "google_compute_instance" "test_node" {
  name         = "test-node"
  machine_type = "f1-micro"
  zone         = "us-west1-a"

  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  attached_disk {
    source      = google_compute_disk.default.id
    device_name = google_compute_disk.default.name
  }

  network_interface {
    network = "default"
    access_config {
      # Ephemeral IP
    }
  }

  # Ignore changes for persistent disk attachments
  lifecycle {
    ignore_changes = [attached_disk]
  }

}

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

REST

  1. Buat permintaan POST untuk membuat Persistent Disk zona menggunakan metode disks.insert. Sertakan properti name, sizeGb, dan type. Untuk membuat disk ini sebagai disk non-booting kosong dan tidak berformat, jangan tentukan image sumber atau snapshot sumber.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks
    
    {
     "name": "DISK_NAME",
     "sizeGb": "DISK_SIZE",
     "type": "DISK_TYPE"
    }
    

    Ganti kode berikut:

    • PROJECT_ID: project ID Anda.
    • ZONE: zona tempat VM dan disk baru Anda berada.
    • DISK_NAME: nama disk baru.
    • DISK_SIZE: ukuran disk baru, dalam gigabyte. Rentang ukuran yang dapat diterima, dalam peningkatan 1 GB, dari 10 GB hingga 65.536 GB inklusif.
    • DISK_TYPE: URL lengkap atau sebagian untuk jenis persistent disk. Contohnya, https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/diskTypes/pd-ssd.
  2. Buat permintaan POST ke metode compute.instances.attachDisk, dan sertakan URL ke persistent disk zona yang baru saja Anda buat:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/attachDisk
    
    {
     "source": "/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME",
     "deviceName": DEVICE_NAME
    }
    

    Ganti kode berikut:

    • PROJECT_ID: project ID Anda
    • ZONE: zona tempat VM dan disk baru Anda berada
    • VM_NAME: nama VM tempat Anda menambahkan persistent disk baru
    • DISK_NAME: nama disk baru
    • DEVICE_NAME: Opsional: nama yang digunakan OS tamu untuk mengidentifikasi disk.

Setelah membuat disk baru dan memasangnya ke VM, Anda harus memformat dan memasang disk, sehingga sistem operasi dapat menggunakan ruang penyimpanan yang tersedia.

Langkah selanjutnya