Membuat instance Managed Lustre

Instance Google Cloud Managed Lustre adalah sistem file Lustre lengkap di cloud. Volume ini dapat di-mount ke VM Compute Engine atau ke cluster Kubernetes Engine. Anda mengakses data di instance menggunakan terminologi POSIX standar.

Saat membuat instance Managed Lustre, Anda harus menentukan properti berikut:

  • Nama instance, yang digunakan oleh Google Cloud.
  • Nama sistem file, yang digunakan oleh alat sisi klien seperti lfs.
  • Kapasitas penyimpanan dalam gibibyte (GiB). Kapasitas dapat berkisar dari 9.000 GiB hingga 12.240.000 GiB (11,67 PiB). Ukuran maksimum instance bergantung pada tingkat performanya.
  • Tingkat performa. Managed Lustre menawarkan tingkat performa mulai dari 125 MBps per TiB hingga 1000 MBps per TiB.
  • Lokasi. Untuk mendapatkan performa terbaik, tempatkan instance Anda di zona yang sama dengan VM klien atau cluster GKE Anda.
  • Jaringan VPC untuk instance ini. Jaringan ini harus sama dengan yang digunakan untuk VM atau cluster Anda.
  • Apakah instance ini akan diakses dari cluster Kubernetes Engine (GKE). Karena Lustre dan GKE menggunakan port 988 secara default, setelan ini mengubah port Lustre untuk menghindari konflik.

Tingkatan performa dan kapasitas penyimpanan maksimum

Managed Lustre menawarkan 4 tingkat performa, yang masing-masing memiliki kecepatan throughput maksimum yang berbeda per TiB. Tingkatan performa juga memengaruhi ukuran instance minimum dan maksimum, serta ukuran langkah antara nilai kapasitas yang dapat diterima.

Tingkat Kapasitas Minimum Kapasitas Maksimal Ukuran Langkah
125 MBps per TiB 72.000 GiB 12.240.000 GiB (11,67 PiB) 72.000 GiB
250 MBps per TiB 36.000 GiB 6.120.000 GiB (5,84 PiB) 36.000 GiB
500 MBps per TiB 18.000 GiB 3.060.000 GiB (2,92 PiB) 18.000 GiB
1.000 MBps per TiB 9.000 GiB 1.530.000 GiB (1,46 PiB) 9.000 GiB

Anda tidak dapat mengubah tingkat performa instance setelah dibuat.

Izin yang diperlukan

Untuk membuat instance Managed Lustre baru, Anda harus memiliki izin IAM Managed Lustre Admin (roles/lustre.admin) untuk project Anda.

Lihat Kontrol akses dengan IAM untuk mengetahui detailnya.

Anda juga harus mengaktifkan Managed Lustre API.

Membuat instance

Anda dapat membuat instance Managed Lustre baru dari antarmuka berikut.

gcloud

Untuk membuat instance Managed Lustre baru, gunakan perintah gcloud lustre instances create:

gcloud lustre instances create INSTANCE_ID \
  --per-unit-storage-throughput=PER_UNIT_STORAGE_THROUGHPUT \
  --capacity-gib=CAPACITY_GIB \
  --filesystem=FILESYSTEM \
  --location=LOCATION \
  --network=NETWORK_PATH

Nilai berikut harus ditentukan:

  • INSTANCE_ID adalah nama instance Managed Lustre ini. Aplikasi harus:

    • Hanya berisi huruf kecil, angka, dan tanda hubung.
    • Awali dengan huruf.
    • Berisi antara 1-63 karakter.
    • Diakhiri dengan angka atau huruf.
    • Bersifat unik dalam project dan lokasi.

  • --per-unit-storage-throughput adalah throughput maksimum instance dalam MBps per TiB. Nilai yang valid adalah 125, 250, 500, dan 1000. Pilihan throughput Anda akan memengaruhi kapasitas penyimpanan minimum dan maksimum instance.

  • --capacity-gib adalah kapasitas penyimpanan instance dalam gibibyte (GiB). Nilai yang diizinkan bergantung pada tingkat throughput penyimpanan yang Anda tentukan. Lihat bagian Tingkatan performa dan kapasitas penyimpanan maksimum untuk mengetahui detailnya.

  • --filesystem adalah nama yang akan ditetapkan ke sistem file Lustre ini. Nama ini digunakan oleh perintah sisi klien, termasuk mount dan lfs. Panjangnya harus 8 karakter atau kurang, hanya boleh berisi huruf dan/atau angka, dan peka huruf besar/kecil.

    Sebaiknya pilih nama yang unik di semua instance Managed Lustre di VPC. Hal ini memungkinkan beberapa instance digunakan dari satu node GKE.

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

  • --network adalah jalur lengkap jaringan VPC tempat instance berada, dalam format projects/PROJECT_ID/global/networks/NETWORK. Lihat Mengonfigurasi jaringan VPC.

  • --project adalah Google Cloud project ID Anda.

Flag opsional adalah sebagai berikut:

  • --kms-key-name menentukan kunci enkripsi yang dikelola pelanggan untuk mengenkripsi instance ini. Lihat Kunci enkripsi yang dikelola pelanggan untuk Managed Lustre untuk mengetahui detailnya.

  • --gke-support-enabled membuat instance yang dapat digunakan oleh cluster Google Kubernetes Engine. Tindakan ini menetapkan accept_port LNet Lustre ke 6988.

    Untuk terhubung dari VM Compute Engine saat --gke-support-enabled ditentukan, Anda harus mengupdate file konfigurasi LNet di VM. Lihat Mengonfigurasi LNet untuk instance gke-support-enabled.

  • --async (opsional) menjalankan perintah secara asinkron. Daripada menunggu hingga pembuatan instance selesai, Google Cloud CLI menampilkan ID operasi yang dapat digunakan untuk mengkueri status perintah.

Permintaan yang berhasil akan menampilkan ID operasi:

Create request issued for: [$INSTANCE_ID]
Waiting for operation [projects/$PROJECT_ID/locations/us-central1-a/operations/
operation-1234567890-609d21deae6f0-befaf0bc-867b1aa1] to complete...

Pembuatan instance memerlukan waktu sekitar 15 menit untuk instance dengan kapasitas 9.000 GiB, hingga satu jam untuk instance dengan kapasitas 12.240.000 GiB (11,67 PiB). Lihat Membuat kueri status pembuatan instance untuk mendapatkan petunjuk tentang cara memeriksa status permintaan Anda.

REST

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

POST https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances?instanceId=INSTANCE_ID
Authorization: Bearer AUTH_TOKEN
{
  "filesystem": string,
  "perUnitStorageThroughput": int64,
  "capacityGib": int64,
  "network": string,
  "gkeSupportEnabled": boolean
}

Nilai berikut harus ditentukan:

  • PROJECT_ID adalah Google Cloud project ID Anda.

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

  • INSTANCE_ID adalah nama instance Managed Lustre ini. Aplikasi harus:

    • Hanya berisi huruf kecil, angka, dan tanda hubung.
    • Awali dengan huruf.
    • Berisi antara 1-63 karakter.
    • Diakhiri dengan angka atau huruf.
    • Bersifat unik dalam project dan lokasi.

  • filesystem adalah nama yang akan ditetapkan ke sistem file Lustre ini. Nama ini digunakan oleh perintah sisi klien, termasuk mount dan lfs. Panjangnya harus 8 karakter atau kurang, hanya boleh berisi huruf dan/atau angka, dan peka huruf besar/kecil.

    Sebaiknya pilih nama sistem file yang unik di semua instance Managed Lustre di VPC. Hal ini memungkinkan beberapa instance digunakan dari satu node GKE.

  • perUnitStorageThroughput adalah throughput maksimum instance dalam MBps per TiB. Nilai yang valid adalah 125, 250, 500, dan 1000. Pilihan throughput Anda akan memengaruhi kapasitas penyimpanan minimum dan maksimum instance.

  • capacityGib adalah kapasitas penyimpanan instance dalam gibibyte (GiB). Nilai yang diizinkan bergantung pada tingkat throughput penyimpanan yang Anda tentukan. Lihat bagian Tingkatan performa dan kapasitas penyimpanan maksimum untuk mengetahui detailnya.

  • network adalah jalur lengkap jaringan VPC tempat instance berada, dalam format projects/PROJECT_ID/global/networks/NETWORK. Lihat Mengonfigurasi jaringan VPC.

Kolom berikut bersifat opsional:

API ini mendukung kolom opsional tambahan untuk instance. Lihat dokumentasi referensi resource Instance untuk mengetahui daftar lengkap dan deskripsinya.

Konsol Google Cloud

  1. Buka halaman Managed Lustre di konsol Google Cloud .

    Buka Managed Lustre

  2. Klik Create. Halaman Create an instance akan ditampilkan.

  3. Masukkan Nama instance yang unik dan, secara opsional, deskripsi. Nama instance digunakan oleh Google Cloud untuk mengidentifikasi instance ini.

  4. Masukkan nama Filesystem. Ini adalah nama yang digunakan oleh alat sisi klien seperti lfs. Panjangnya harus 8 karakter atau kurang, hanya boleh berisi huruf dan/atau angka, dan peka huruf besar/kecil.

  5. Pilih region dan zona tempat instance ini akan dibuat. Anda harus menempatkan instance di region dan zona yang sama dengan VM Compute Engine atau cluster Google Kubernetes Engine yang akan terhubung dengannya.

  6. Pilih tingkat performa untuk instance ini.

  7. Tentukan kapasitas penyimpanan dalam gibibyte (GiB) untuk instance Anda. Nilai yang valid bergantung pada tingkat throughput penyimpanan yang Anda pilih. Lihat bagian Tingkatan performa dan kapasitas penyimpanan maksimum untuk mengetahui detailnya.

  8. Dari bagian Encryption, pilih Google-managed encryption key atau Cloud Key Management Service key. Untuk mengetahui informasi tentang opsi kunci Cloud Key Management Service, lihat Kunci enkripsi yang dikelola pelanggan untuk Managed Lustre.

  9. Jika Anda akan terhubung ke instance ini dari cluster GKE, pilih Aktifkan dukungan GKE. Opsi ini menetapkan LNet Lustre accept_port ke 6988.

    Untuk terhubung dari VM Compute Engine saat Aktifkan dukungan GKE ditentukan, Anda harus memperbarui file konfigurasi LNet di VM. Lihat Mengonfigurasi LNet untuk instance gke-support-enabled.

  10. Pilih Network yang Anda buat di Membuat jaringan VPC.

Bagian Ringkasan di halaman akan diperbarui untuk menampilkan perkiraan biaya berdasarkan pilihan Anda.

Klik Kirim untuk melanjutkan. Proses pembuatan instance memerlukan waktu 15 menit hingga satu jam, bergantung pada kapasitas instance.

Status pembuatan instance kueri

Anda dapat mengkueri status permintaan pembuatan dari antarmuka berikut.

gcloud

Untuk mengkueri status operasi pembuatan, Anda bisa mendapatkan operasi atau instance.

Untuk mendapatkan instance:

gcloud lustre instances describe INSTANCE_NAME \
  --location=ZONE

Status pembuatan adalah nilai state.

Untuk mendapatkan operasi, gunakan ID operasi dari respons pembuatan instance. ID operasi memiliki format berikut:

  • operation-1234567890123-6127783ad26ea-88913969-02748053
gcloud lustre operations describe OPERATION_ID \
  --location=LOCATION

Status pembuatan adalah nilai done.

Setelah instance dibuat, hasil permintaan get pada instance akan mirip dengan respons berikut.

Catat alamat IP di kolom mountPoint dan nama sistem file Anda; Anda akan memerlukan nilai ini saat memasang instance.

capacityGib: '27000'
createTime: '2025-03-14T00:07:34.308574307Z'
filesystem: lustre-fs
mountPoint: 10.115.0.3@tcp:/testfs
name: projects/$PROJECT/locations/us-central1-a/instances/$INSTANCE_NAME
network: projects/$PROJECT/global/networks/default
state: ACTIVE
updateTime: '2025-03-14T00:15:37.101024263Z'

REST

Untuk mengkueri status operasi pembuatan, gunakan ID operasi dari respons. ID operasi memiliki format berikut:

  • operation-1234567890123-6127783ad26ea-88913969-02748053

Kirim permintaan ke endpoint berikut:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/operations/OPERATION_ID
Authorization: Bearer

Jika berhasil, isi respons berisi instance Operation.

Konsol Google Cloud

  1. Buka halaman Managed Lustre di konsol Google Cloud .

    Buka Managed Lustre

  2. Klik nama instance dalam daftar. Halaman Instance Details akan muncul, yang mencakup status permintaan pembuatan instance Anda saat ini.

Langkah berikutnya