Melakukan pemeliharaan mandiri

Pemeliharaan mandiri memungkinkan Anda menerapkan upgrade pemeliharaan ke instance Managed Lustre sesuai permintaan.

Saat Managed Lustre merilis versi software baru, versi tersebut akan langsung tersedia untuk pemeliharaan mandiri. Hal ini biasanya terjadi beberapa minggu sebelum pemeliharaan otomatis mencapai instance Anda.

Anda dapat melakukan pemeliharaan mandiri kapan saja setelah versi tersedia. Jika instance Anda memiliki kebijakan pemeliharaan, Anda dapat melakukan pemeliharaan mandiri hingga 1 jam sebelum masa pemeliharaan terjadwal.

Untuk mengetahui ringkasan dampak dan kebijakan pemeliharaan, lihat Ringkasan pemeliharaan.

Memeriksa versi pemeliharaan yang tersedia

Instance Managed Lustre melacak rilis pemeliharaan menggunakan bidang versi berikut:

  • effectiveVersion: Khusus output. Versi rilis software yang berjalan di instance Anda. Contoh, Lustre_20260516.00_p00.
  • availableVersion: Khusus output. Versi rilis software yang lebih baru dan memenuhi syarat yang dapat diupgrade oleh instance Anda. Jika kolom ini kosong, instance Anda sudah menjalankan rilis terbaru yang tersedia.
  • targetVersion: Khusus input. Parameter yang ditentukan dalam permintaan update untuk memulai upgrade ke versi kandidat atau ke latest.

Untuk memverifikasi versi instance Anda saat ini dan memeriksa apakah upgrade tersedia:

Konsol Google Cloud

  1. Di konsol Google Cloud , buka halaman Managed Lustre:

    Buka Managed Lustre

  2. Dalam daftar instance, temukan instance Anda. Jika versi pemeliharaan yang lebih baru tersedia, badge Update available akan muncul di samping status ACTIVE.

  3. Klik nama instance untuk membuka halaman Instance details guna melihat string versi yang tersedia.

gcloud CLI

Jalankan perintah gcloud lustre instances describe dengan filter format:

gcloud lustre instances describe INSTANCE_ID \
  --location=LOCATION \
  --format="yaml(effectiveVersion, availableVersion, state)"

Ganti kode berikut:

  • INSTANCE_ID: ID instance Managed Lustre Anda.
  • LOCATION: Zona tempat instance Anda berada.

Jika versi yang lebih baru tersedia, outputnya akan terlihat seperti berikut:

availableVersion: Lustre_20260716.01_p00
effectiveVersion: Lustre_20260516.00_p00
state: ACTIVE

Jika availableVersion kosong, instance Anda sudah menjalankan rilis terbaru yang tersedia.

REST

Untuk memeriksa detail versi instance, kirim permintaan GET ke endpoint instance:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID
Authorization: Bearer ACCESS_TOKEN

Dengan:

  • PROJECT_ID adalah project ID Google Cloud Anda.
  • LOCATION adalah zona tempat instance berada.
  • INSTANCE_ID adalah ID instance Managed Lustre.

Jika versi yang lebih baru tersedia, respons akan berisi effectiveVersion dan availableVersion:

{
  "name": "projects/my-project/locations/us-central1-a/instances/my-instance",
  "state": "ACTIVE",
  "effectiveVersion": "Lustre_20260516.00_p00",
  "availableVersion": "Lustre_20260716.01_p00"
}

Jika availableVersion dihilangkan atau kosong, instance Anda sudah menjalankan rilis terbaru yang tersedia.

Lihat referensi API instances.get untuk mengetahui detail selengkapnya.

Melakukan upgrade mandiri

Untuk mengupgrade instance ke versi software yang tersedia:

gcloud CLI

Jalankan perintah gcloud lustre instances update dengan flag --target-version:

gcloud lustre instances update INSTANCE_ID \
  --location=LOCATION \
  --target-version=latest

Ganti kode berikut:

  • INSTANCE_ID: ID instance Managed Lustre Anda.
  • LOCATION: Zona tempat instance Anda berada.

Untuk mengupgrade ke versi rilis tertentu yang memenuhi syarat, bukan latest, teruskan string versi:

gcloud lustre instances update INSTANCE_ID \
  --location=LOCATION \
  --target-version=TARGET_VERSION

Ganti TARGET_VERSION dengan string versi dari availableVersion. Misalnya, Lustre_20260716.01_p00.

REST

Untuk mengupgrade instance menggunakan REST API, kirim permintaan PATCH ke endpoint instance, dengan menentukan targetVersion dalam parameter kueri updateMask:

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=targetVersion
Authorization: Bearer ACCESS_TOKEN

{
  "targetVersion": "latest"
}

Dengan:

  • PROJECT_ID adalah project ID Google Cloud Anda.
  • LOCATION adalah zona tempat instance berada.
  • INSTANCE_ID adalah ID instance Managed Lustre.

Untuk mengupgrade ke versi rilis tertentu yang memenuhi syarat, bukan latest, tentukan string versi dalam isi permintaan, seperti "targetVersion": "Lustre_20260716.01_p00".

Lihat referensi API instances.patch untuk mengetahui detail selengkapnya.

Memantau progres pemeliharaan

Upgrade dijalankan sebagai operasi asinkron yang berjalan lama. Pemeliharaan mandiri tidak memicu email notifikasi otomatis.

Untuk melacak progres secara real time:

gcloud CLI

Polling status operasi menggunakan perintah gcloud lustre operations describe:

gcloud lustre operations describe OPERATION_ID \
  --location=LOCATION

Ganti kode berikut:

  • OPERATION_ID: ID operasi yang ditampilkan oleh perintah update.
  • LOCATION: Zona tempat instance Anda berada.

Status instance menampilkan UPGRADING saat upgrade sedang berlangsung dan kembali ke ACTIVE setelah selesai.

REST

Kirim permintaan GET ke endpoint operations.get:

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

Dengan:

  • PROJECT_ID adalah project ID Google Cloud Anda.
  • LOCATION adalah zona tempat instance berada.
  • OPERATION_ID adalah ID operasi yang ditampilkan oleh permintaan update.

Lihat referensi API operations.get untuk mengetahui detail selengkapnya.

Jika upgrade berhasil:

  1. Instance kembali ke status ACTIVE.
  2. effectiveVersion mencerminkan string versi yang baru diterapkan.
  3. availableVersion dihapus dan dihilangkan dari respons API.

Interaksi dengan pemeliharaan terjadwal

Jika instance Anda memiliki pemeliharaan terjadwal mendatang, berhasil menyelesaikan upgrade mandiri akan otomatis membatalkan pemeliharaan terjadwal mendatang tersebut. Jika Anda berlangganan notifikasi pemeliharaan, Anda akan menerima notifikasi email otomatis Pemeliharaan dibatalkan.

Jika upgrade mandiri gagal, masa pemeliharaan terjadwal yang tertunda tidak akan dibatalkan. Instance akan kembali ke status ACTIVE pada versi saat ini, dan masa pemeliharaan terjadwal akan dipertahankan.

Anda tidak dapat memicu upgrade mandiri dalam waktu 1 jam sebelum masa pemeliharaan terjadwal mendatang. Upaya untuk memulai upgrade selama periode ini akan menampilkan error 409 CONFLICT untuk menghindari tumpang-tindih dengan pemeliharaan terjadwal mendatang.

Pesan error

Kemungkinan error pemeliharaan mandiri meliputi:

  • Instance is already running version "<CURRENT>": Terjadi jika Anda mencoba mengupgrade ke versi software yang sudah berjalan di instance.
  • Downgrading to a lower version is not supported.: Terjadi jika Anda mencoba mendowngrade ke versi software yang lebih lama.
  • Version "<TARGET>" is not a valid update version.: Terjadi jika versi yang ditentukan tidak cocok dengan string availableVersion atau latest instance.
  • Instance must be in ACTIVE state to update version: Terjadi jika upgrade dimulai saat instance tidak dalam status ACTIVE.
  • Cannot trigger self-service update within 1 hour of a scheduled maintenance window: Terjadi jika upgrade mandiri dimulai kurang dari 1 jam sebelum masa pemeliharaan terjadwal yang akan datang.