Mengelola instance Google Cloud Managed Lustre

Setelah membuat instance, Google Cloud Managed Lustre memungkinkan Anda mencantumkan, mendapatkan, mengupdate, dan menghapus instance.

Status instance

Instance Managed Lustre dapat berada dalam salah satu status berikut:

Negara Bagian Deskripsi
CREATING Instance sedang dibuat dan belum siap digunakan.
ACTIVE Instance tersedia untuk digunakan.
REPAIRING Instance sedang diperbaiki.
MAINTENANCE atau UPGRADING Instance sedang menjalani pemeliharaan. Lihat Peristiwa dan kebijakan pemeliharaan. untuk mengetahui informasi selengkapnya.
SUSPENDED Instance ditangguhkan, biasanya karena masalah dengan. kunci enkripsi yang dikelola pelanggan (CMEK).
DELETING Instance sedang dihapus.

Mencantumkan instance

Untuk mencantumkan semua instance dalam project:

Google Cloud Konsol

  1. Buka halaman Managed Lustre di Google Cloud Konsol.

    Buka Managed Lustre

    Instance project Anda akan dicantumkan.

gcloud CLI

Gunakan perintah gcloud lustre instances list:

gcloud lustre instances list --location=LOCATION

Ganti LOCATION dengan zona tertentu untuk mencantumkan semua instance di lokasi tersebut. Untuk melihat project di semua lokasi, masukkan - sebagai nilainya. Misalnya:

gcloud lustre instances list --location=-

REST

Untuk mencantumkan instance menggunakan REST API, kirim permintaan ke endpoint berikut:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dengan nilai berikut harus ditentukan:

  • PROJECT_ID adalah ID Google Cloud project Anda.

  • ZONE adalah zona yang akan digunakan untuk mencantumkan semua instance. Untuk mencantumkan instance dari semua zona, gunakan - sebagai nilainya.

Lihat referensi API instances.list untuk mengetahui detail selengkapnya.

Mendapatkan instance

Untuk mendapatkan detail instance:

Google Cloud Konsol

  1. Buka halaman Managed Lustre di Google Cloud Konsol.

    Buka Managed Lustre

  2. Klik nama instance untuk melihat detail tentang instance tertentu.

gcloud CLI

Gunakan perintah gcloud lustre instances describe:

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

Untuk mendapatkan detail tentang instance tertentu menggunakan REST API, kirim permintaan ke endpoint berikut:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dengan nilai berikut harus ditentukan:

  • PROJECT_ID adalah ID Google Cloud project Anda.

  • ZONE harus berupa zona valid yang didukung oleh Managed Lustre. Google Cloud Lihat Lokasi yang didukung untuk mengetahui daftar lengkapnya.

  • INSTANCE_NAME adalah nama instance Managed Lustre yang akan ditampilkan.

Lihat referensi API instances.get untuk mengetahui detail selengkapnya.

Memperbarui instance

Anda dapat memperbarui properti instance yang ada berikut:

  • Deskripsi
  • Label
  • Kapasitas penyimpanan
  • Kebijakan pemeliharaan

Untuk mengetahui informasi tentang cara meningkatkan kapasitas penyimpanan instance, lihat Meningkatkan kapasitas instance.

Untuk mengetahui informasi tentang cara mengonfigurasi kebijakan pemeliharaan, lihat Peristiwa dan kebijakan pemeliharaan.

Untuk memperbarui instance:

Google Cloud Konsol

  1. Buka halaman Managed Lustre di Google Cloud Konsol.

    Buka Managed Lustre

  2. Klik Nama instance instance yang akan diupdate. Halaman ringkasan instance akan ditampilkan.

  3. Klik Edit.

  4. Masukkan nilai baru.

  5. Klik Kirim.

gcloud CLI

Gunakan perintah gcloud lustre instances update:

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION \
  --maintenance-policy-weekly-windows=dayOfWeek=DAY,startTime={START_TIME}

Dengan:

  • INSTANCE_NAME adalah instance yang akan diupdate.
  • LOCATION adalah zona tempat instance berada.
  • NEW_CAPACITY adalah kapasitas penyimpanan baru untuk instance ini dalam gibibyte (GiB). Nilai tidak boleh melebihi kapasitas maksimum yang diizinkan dan harus merupakan kelipatan ukuran langkah. Lihat Meningkatkan kapasitas instance untuk mengetahui detail selengkapnya.

  • NEW_DESCRIPTION adalah nilai baru untuk kolom deskripsi, yang akan menimpa deskripsi yang ada.

  • DAY: Hari dalam seminggu untuk masa pemeliharaan (misalnya, TUESDAY).

  • START_TIME: Waktu mulai UTC untuk masa pemeliharaan dalam format kamus (misalnya, {hours=1,minutes=0}).

Untuk memperbarui label, lihat perintah yang tersedia dalam dokumentasi gcloud lustre instances update.

REST

Untuk mengupdate instance menggunakan REST API, kirim permintaan PATCH ke endpoint tertentu:

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": 72000,
  "description": "updated description",
  "labels": {
    "key1": "value1"
  },
  "maintenancePolicy": {
    "weeklyMaintenanceWindows": [
      {
        "dayOfWeek": "DAY",
        "startTime": {
          "hours": HOURS,
          "minutes": MINUTES
        }
      }
    ]
  }
}

Dengan nilai berikut harus ditentukan:

  • PROJECT_ID adalah ID Google Cloud project Anda.
  • ZONE adalah zona instance Google Cloud .
  • INSTANCE_NAME adalah nama instance Managed Lustre yang akan diupdate.
  • UPDATE_MASK adalah daftar kolom yang akan diupdate yang dipisahkan koma. Kolom hanya akan ditimpa jika berada dalam mask.

Isi permintaan harus berisi satu atau beberapa kolom berikut:

  • capacityGiB adalah kapasitas penyimpanan baru untuk instance ini dalam gibibyte (GiB). Nilai tidak boleh melebihi kapasitas maksimum yang diizinkan dan harus merupakan kelipatan ukuran langkah. Lihat Meningkatkan kapasitas instance untuk mengetahui detail selengkapnya.
  • description adalah deskripsi baru untuk instance ini.
  • labels adalah kumpulan label baru untuk instance ini. Nilai labels adalah objek JSON yang berisi satu atau beberapa pasangan kunci:nilai.
  • maintenancePolicy adalah kebijakan pemeliharaan untuk instance. Lihat Peristiwa dan kebijakan pemeliharaan untuk mengetahui detailnya.

Lihat referensi API instances.patch untuk mengetahui detail selengkapnya.

Tidak dapat mengantrekan operasi

Jika Anda melihat error yang mirip dengan berikut saat mencoba mengupdate instance:

ERROR: (gcloud.lustre.instances.update) ABORTED: unable to queue the operation

Error ini terjadi saat Anda mencoba memulai operasi sementara operasi lain dengan jenis yang sama sudah berlangsung di instance yang sama. Managed Lustre hanya mengizinkan satu update aktif per instance dalam satu waktu, dan mengizinkan operasi update tambahan untuk diantrekan.

Untuk mengatasi masalah ini, tunggu hingga operasi saat ini selesai sebelum memulai operasi baru.

Menghapus instance

Untuk menghapus instance:

Google Cloud Konsol

  1. Buka halaman Managed Lustre di Google Cloud Konsol.

    Buka Managed Lustre

  2. Pilih menu tiga titik di samping instance yang akan dihapus.

  3. Pilih Hapus instance. Konfirmasi penghapusan dengan mengklik Hapus lagi.

gcloud CLI

Gunakan perintah gcloud lustre instances delete:

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

Anda akan diminta untuk mengonfirmasi penghapusan. Ketik Y atau tekan enter untuk melanjutkan.

REST

Untuk menghapus instance menggunakan REST API, kirim permintaan ke endpoint berikut:

DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dengan nilai berikut harus ditentukan:

  • PROJECT_ID adalah ID Google Cloud project Anda.

  • ZONE adalah Google Cloud zona tempat instance berada.

  • INSTANCE_NAME adalah nama instance Managed Lustre yang akan dihapus.

Lihat referensi API instances.delete untuk mengetahui detail selengkapnya.

Permintaan penghapusan adalah permintaan yang berjalan lama, dan menampilkan ID operasi yang dapat dikueri untuk status operasi. Lihat referensi operations.get untuk mengetahui detailnya.