Peristiwa dan kebijakan pemeliharaan

Untuk menjaga instance Google Cloud Managed Lustre Anda tetap terbaru, Google Cloud Google Cloud secara berkala melakukan pemeliharaan pada instance tersebut. Peristiwa pemeliharaan dapat mencakup pembaruan pada software atau infrastruktur yang mendasarinya. Peristiwa ini dapat menyebabkan periode nonaktif sementara, yang selama itu operasi I/O ke instance mungkin berhenti merespons. Operasi I/O yang terpengaruh akan dilanjutkan setelah pemeliharaan selesai. Periode nonaktif biasanya antara 2 hingga 25 menit.

Saat pemeliharaan sedang berlangsung, status instance adalah UPGRADING. Setelah pemeliharaan selesai, instance akan kembali ke status ACTIVE.

Kebijakan pemeliharaan memungkinkan Anda mengontrol kapan peristiwa pemeliharaan ini terjadi. Anda dapat mengonfigurasi kebijakan pemeliharaan untuk setiap instance guna menentukan periode pemeliharaan dan periode saat pemeliharaan harus dikecualikan. Jika tidak ada kebijakan pemeliharaan yang dikonfigurasi pada instance, pemeliharaan dapat terjadi kapan saja.

Anda juga dapat menjadwalkan ulang peristiwa pemeliharaan agar dimulai segera, selama periode berikutnya yang tersedia, atau pada waktu tertentu hingga 28 hari kemudian.

Instance skala ekstrem

Konfigurasi Managed Lustre tertentu yang memberikan performa dan skala ekstrem mungkin memerlukan periode nonaktif terencana hingga 4 jam untuk pemeliharaan host berkala. Google akan mengoordinasikan peristiwa pemeliharaan ini dengan Anda terlebih dahulu.

Tentang kebijakan pemeliharaan

Anda dapat mengonfigurasi kebijakan pemeliharaan pada setiap instance Managed Lustre. Kebijakan pemeliharaan mencakup hal berikut:

  • Periode pemeliharaan mingguan: Periode berulang selama satu jam dalam seminggu saat Managed Lustre dapat memulai peristiwa pemeliharaan.
  • Periode pengecualian pemeliharaan: Periode saat Managed Lustre tidak diizinkan untuk memulai peristiwa pemeliharaan. Anda dapat menentukan satu periode pengecualian per instance, dengan durasi maksimum dua minggu. Jika tidak ada tahun yang ditentukan dalam tanggal mulai dan berakhir, periode pengecualian akan berulang setiap tahun.

Periode pengecualian lebih diutamakan daripada masa pemeliharaan reguler. Jika peristiwa terjadwal terjadi dalam periode ini, Managed Lustre akan menunda peristiwa tersebut ke periode berikutnya yang tersedia atau melewatkannya sepenuhnya. Pembaruan akan diterapkan selama siklus pemeliharaan berikutnya.

Notifikasi pemeliharaan

Anda dapat berlangganan notifikasi email untuk peristiwa pemeliharaan mendatang guna membantu Anda merencanakan potensi gangguan. Langganan notifikasi pemeliharaan dikelola melalui halaman Komunikasi konsol Google Cloud :

Buka halaman Komunikasi

Setelah berlangganan, notifikasi berikut akan dikirimkan:

  • Notifikasi lanjutan: Dikirim 7 hingga 14 hari sebelum peristiwa pemeliharaan terjadwal, atau setelah peristiwa pemeliharaan dijadwalkan ulang oleh pelanggan.
  • Dibatalkan: Dikirim jika peristiwa pemeliharaan terjadwal dibatalkan oleh Google atau dijadwalkan ulang oleh pelanggan.
  • Sedang berlangsung: Dikirim saat peristiwa pemeliharaan dimulai.
  • Selesai: Dikirim saat peristiwa pemeliharaan selesai.

Anda juga dapat melihat jadwal pemeliharaan mendatang di halaman detail instance di konsol Google Cloud atau menggunakan Cloud Logging untuk melihat log pemeliharaan.

Mengonfigurasi masa pemeliharaan

Masa pemeliharaan memerlukan hari dalam seminggu dan waktu mulai UTC untuk periode satu jam.

Google Cloud Konsol

Untuk mengonfigurasi masa pemeliharaan saat membuat instance, lihat Membuat instance.

gcloud

Buat instance dengan masa pemeliharaan dengan menentukan flag --maintenance-policy-weekly-windows:

gcloud lustre instances create INSTANCE_ID \
  --per-unit-storage-throughput=PER_UNIT_STORAGE_THROUGHPUT \
  --capacity-gib=CAPACITY_GIB \
  --filesystem=FS_NAME \
  --location=LOCATION \
  --network=NETWORK_PATH \
  --maintenance-policy-weekly-windows='dayOfWeek=DAY,startTime={START_TIME}'

Ganti kode berikut:

  • INSTANCE_ID: ID instance Managed Lustre Anda.
  • PER_UNIT_STORAGE_THROUGHPUT adalah tingkat performa dalam MBps per TiB. Nilai yang valid adalah 0, 125, 250, 500, dan 1000. Untuk menentukan [Tingkat dinamis][dynamic-tier], tetapkan nilai ini ke 0 dan sertakan flag --dynamic-tier-options-mode=DEFAULT_CACHE.
  • CAPACITY: Kapasitas instance Anda dalam GiB.
  • FS_NAME: Nama sistem file Anda.
  • LOCATION: Lokasi instance Managed Lustre Anda.
  • NETWORK_PATH: Jalur lengkap jaringan VPC tempat instance berada, dalam format projects/PROJECT_ID/global/networks/NETWORK. Lihat Mengonfigurasi jaringan VPC.
  • 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 mengetahui detail selengkapnya tentang cara membuat instance, lihat Membuat instance Managed Lustre.

REST API

Untuk menentukan masa pemeliharaan untuk instance, sertakan objek maintenancePolicy saat membuat instance.

Berikut adalah contoh objek maintenancePolicy:

"maintenancePolicy": {
  "weeklyMaintenanceWindows": [
    {
      "dayOfWeek": "DAY",
      "startTime": {
        "hours": HOURS,
        "minutes": MINUTES
      }
    }
  ]
}

Ganti kode berikut:

  • DAY: Hari dalam seminggu untuk masa pemeliharaan (misalnya, TUESDAY).
  • HOURS: Jam dalam sehari untuk waktu mulai masa pemeliharaan (misalnya, 1).
  • MINUTES: Menit dalam satu jam untuk waktu mulai masa pemeliharaan (misalnya, 0).

Mengonfigurasi periode pengecualian

Untuk mencegah pemeliharaan terjadi selama periode tertentu, seperti hari libur atau acara bisnis, Anda dapat menentukan satu periode pengecualian pemeliharaan dalam kebijakan pemeliharaan. Periode pengecualian dapat berlangsung hingga dua minggu. Untuk membuat periode pengecualian yang berulang setiap tahun, jangan tentukan tahun dalam tanggal mulai dan berakhir.

Anda dapat menggabungkan masa pemeliharaan mingguan dan periode pengecualian dalam kebijakan yang sama.

Google Cloud Konsol

Untuk mengonfigurasi periode pengecualian saat membuat instance, lihat Membuat instance.

gcloud

Buat instance dengan periode pengecualian dengan menentukan flag --maintenance-policy-exclusion-window:

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 \
  --maintenance-policy-exclusion-window='startDate={START_DATE},endDate={END_DATE},time={TIME}'

Ganti kode berikut:

  • INSTANCE_ID: ID instance Managed Lustre Anda.
  • PER_UNIT_STORAGE_THROUGHPUT adalah tingkat performa dalam MBps per TiB. Nilai yang valid adalah 0, 125, 250, 500, dan 1000. Untuk menentukan [Tingkat dinamis][dynamic-tier], tetapkan nilai ini ke 0 dan sertakan flag --dynamic-tier-options-mode=DEFAULT_CACHE.
  • CAPACITY: Kapasitas instance Anda dalam GiB.
  • FS_NAME: Nama sistem file Anda.
  • LOCATION: Lokasi instance Managed Lustre Anda.
  • NETWORK_PATH: Jalur lengkap jaringan VPC tempat instance berada, dalam format projects/PROJECT_ID/global/networks/NETWORK. Lihat Mengonfigurasi jaringan VPC.
  • START_DATE: Tanggal mulai periode pengecualian pemeliharaan dalam format kamus (misalnya, {day=08,month=06,year=2026}). Agar berulang setiap tahun, hapus kunci year.
  • END_DATE: Tanggal berakhir periode pengecualian pemeliharaan dalam format kamus (misalnya, {day=08,month=06,year=2026}). Agar berulang setiap tahun, hapus kunci year.
  • TIME: Waktu mulai dan berakhir UTC untuk periode pengecualian dalam format kamus (misalnya, {hours=1,minutes=0}).

REST API

Berikut adalah contoh objek maintenancePolicy dengan periode pengecualian:

"maintenancePolicy": {
  "maintenanceExclusionWindow": [
    {
      "startDate": {
        "day": START_DAY,
        "month": START_MONTH,
        "year": START_YEAR
      },
      "endDate": {
        "day": END_DAY,
        "month": END_MONTH,
        "year": END_YEAR
      },
      "time": {
        "hours": HOURS,
        "minutes": MINUTES
      }
    }
  ]
}

Ganti kode berikut:

  • START_YEAR: Tahun tanggal mulai periode pengecualian (misalnya, 2026). Hapus kolom ini dan END_YEAR untuk membuat periode yang berulang setiap tahun .
  • START_MONTH: Bulan tanggal mulai periode pengecualian (misalnya, 12).
  • START_DAY: Hari tanggal mulai periode pengecualian (misalnya, 24).
  • END_YEAR: Tahun tanggal berakhir periode pengecualian (misalnya, 2027). Hapus kolom ini dan START_YEAR untuk membuat periode yang berulang setiap tahun .
  • END_MONTH: Bulan tanggal berakhir periode pengecualian (misalnya, 1).
  • END_DAY: Hari tanggal berakhir periode pengecualian (misalnya, 7).
  • HOURS: Jam dalam sehari untuk waktu periode pengecualian (misalnya, 0).
  • MINUTES: Menit dalam satu jam untuk waktu periode pengecualian (misalnya, 0).

Memperbarui kebijakan pemeliharaan

Untuk menambahkan atau mengubah kebijakan pemeliharaan untuk instance yang ada:

Google Cloud Konsol

Untuk memperbarui kebijakan pemeliharaan untuk instance, lihat Mengelola instance.

gcloud

Contoh gcloud berikut memperbarui kebijakan pemeliharaan untuk instance:

gcloud lustre instances update INSTANCE_ID \
--location=LOCATION \
--maintenance-policy-weekly-windows='dayOfWeek=DAY,startTime={START_TIME}'

Ganti kode berikut:

  • INSTANCE_ID: ID instance Managed Lustre Anda.
  • LOCATION: Lokasi instance Managed Lustre Anda.
  • 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}).

REST API

Untuk menentukan masa pemeliharaan untuk instance, sertakan objek maintenancePolicy saat memperbarui instance. Anda juga harus menentukan maintenancePolicy dalam parameter kueri updateMask.

Contoh curl berikut memperbarui kebijakan pemeliharaan untuk instance:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "maintenancePolicy": {
    "weeklyMaintenanceWindows": [
      {
        "dayOfWeek": "DAY",
        "startTime": {
          "hours": HOURS,
          "minutes": MINUTES
        }
      }
    ]
  }
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=maintenancePolicy"

Ganti kode berikut:

  • PROJECT_ID: ID proyek Anda. Google Cloud
  • LOCATION Lokasi instance Managed Lustre.
  • INSTANCE_ID ID instance Managed Lustre.
  • DAY: Hari dalam seminggu untuk masa pemeliharaan (misalnya, TUESDAY).
  • HOURS Jam dalam sehari untuk waktu mulai masa pemeliharaan (misalnya, 3).
  • MINUTES MINUTES Menit dalam satu jam untuk waktu mulai masa pemeliharaan (misalnya, 45).

Menghapus kebijakan pemeliharaan

Untuk menghapus kebijakan pemeliharaan dari instance, hapus semua masa pemeliharaan mingguan dan periode pengecualian dari kebijakan.

Google Cloud Konsol

Untuk menghapus kebijakan pemeliharaan dari instance, edit instance dan hapus kolom kebijakan pemeliharaan. Lihat Mengelola instance.

gcloud

Gunakan perintah gcloud lustre instances update dengan flag --clear-maintenance-policy-weekly-windows dan --clear-maintenance-policy-exclusion-window:

gcloud lustre instances update INSTANCE_ID \
--location=LOCATION \
--clear-maintenance-policy-weekly-windows \
--clear-maintenance-policy-exclusion-window

Ganti kode berikut:

  • INSTANCE_ID: ID instance Managed Lustre Anda.
  • LOCATION: Lokasi instance Managed Lustre Anda.

REST API

Untuk menghapus kebijakan pemeliharaan menggunakan REST API, gunakan metode instances.patch dengan objek maintenancePolicy kosong dan parameter kueri updateMask yang ditetapkan ke maintenancePolicy:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "maintenancePolicy": {}
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=maintenancePolicy"

Ganti kode berikut:

  • PROJECT_ID: ID proyek Anda. Google Cloud
  • LOCATION: Lokasi instance Managed Lustre.
  • INSTANCE_ID: ID instance Managed Lustre.

Melihat log pemeliharaan

Managed Lustre menggunakan Cloud Logging untuk mencatat peristiwa pemeliharaan, termasuk jenis aktivitas berikut:

  • LustreAdvancedNotification: Pemeliharaan telah dijadwalkan untuk instance.
  • LustreOngoingNotification: Pemeliharaan telah dimulai pada instance. Setelah selesai, peristiwa LustreOngoingNotification lain akan dicatat, kali ini dengan is_completed=true.
  • LustreCancelledNotification: Pemeliharaan telah dibatalkan.

Anda dapat melihat log pemeliharaan menggunakan Logs Explorer atau menggunakan Google Cloud CLI.

Logs Explorer

Untuk melihat log pemeliharaan Managed Lustre menggunakan Logs Explorer, lakukan hal berikut:

  1. Di Google Cloud konsol, buka halaman Cloud Logging > Logs Explorer:

    Buka Logs Explorer

  2. Masukkan filter berikut ke editor kueri, lalu klik Jalankan kueri:

    resource.type="lustre.googleapis.com/Instance"
    resource.labels.instance_id="INSTANCE_ID"
    resource.labels.location="LOCATION"
    logName="projects/PROJECT_ID/logs/lustre.googleapis.com%2Fmaintenance"
    

gcloud CLI

Untuk melihat log pemeliharaan dengan Google Cloud CLI, jalankan perintah gcloud logging read:

gcloud logging read 'resource.type="lustre.googleapis.com/Instance" resource.labels.instance_id="INSTANCE_ID" resource.labels.location="LOCATION" logName="projects/PROJECT_ID/logs/lustre.googleapis.com%2Fmaintenance"' --project=PROJECT_ID

Ganti kode berikut:

  • INSTANCE_ID: ID instance Managed Lustre.
  • LOCATION: Zona tempat instance berada.
  • PROJECT_ID: project ID dari project tempat instance berada.

Menjadwalkan ulang pemeliharaan

Jika peristiwa pemeliharaan terjadwal bertentangan dengan kebutuhan Anda, Anda dapat menjadwalkannya ulang. Saat menjadwalkan ulang, Anda memiliki opsi berikut:

  • Segera: Jadwalkan ulang peristiwa pemeliharaan agar dimulai sesegera mungkin. Opsi ini mengabaikan semua masa pemeliharaan dan periode pengecualian yang dikonfigurasi pada instance.
  • Periode berikutnya yang tersedia: Jadwalkan ulang peristiwa pemeliharaan ke masa pemeliharaan berikutnya yang tersedia. Tindakan ini biasanya menggeser pembaruan selama satu minggu.
  • Berdasarkan tanggal: Jadwalkan ulang peristiwa pemeliharaan ke tanggal dan waktu tertentu. Anda dapat menunda pemeliharaan maksimal 28 hari dari waktu yang dijadwalkan sebelumnya. Opsi ini mengabaikan semua masa pemeliharaan dan periode pengecualian yang dikonfigurasi pada instance.

Untuk menjadwalkan ulang pemeliharaan:

gcloud

Untuk memulai peristiwa pemeliharaan sesegera mungkin:

gcloud lustre instances reschedule-maintenance INSTANCE_ID \
--location=LOCATION \
--reschedule-type=immediately

Untuk menjadwalkan ulang pemeliharaan ke periode berikutnya yang tersedia:

gcloud lustre instances reschedule-maintenance INSTANCE_ID \
--location=LOCATION \
--reschedule-type=next-available-window

Untuk menjadwalkan ulang pemeliharaan ke waktu tertentu:

gcloud lustre instances reschedule-maintenance INSTANCE_ID \
--location=LOCATION \
--reschedule-type=by-time \
--reschedule-schedule-time=TIMESTAMP

Ganti kode berikut:

  • INSTANCE_ID: ID instance Managed Lustre Anda.
  • LOCATION: Lokasi instance Managed Lustre Anda.
  • TIMESTAMP: Waktu mulai dalam format RFC 3339 (misalnya, 2026-04-30T10:00:00Z). Waktu ini tidak boleh lebih dari 28 hari dari waktu yang dijadwalkan sebelumnya.

REST API

Gunakan metode.instances.rescheduleMaintenance

Contoh curl berikut memulai peristiwa pemeliharaan sesegera mungkin:

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "reschedule": {
    "rescheduleType": "IMMEDIATELY"
  }
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:rescheduleMaintenance"

Contoh curl berikut menjadwalkan ulang pemeliharaan ke periode berikutnya yang tersedia:

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "reschedule": {
    "rescheduleType": "NEXT_AVAILABLE_WINDOW"
  }
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:rescheduleMaintenance"

Contoh curl berikut menjadwalkan ulang pemeliharaan ke waktu tertentu:

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{
  "reschedule": {
    "rescheduleType": "BY_TIME",
    "scheduleTime": "TIMESTAMP"
  }
}' "https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:rescheduleMaintenance"

Ganti kode berikut:

  • PROJECT_ID: ID proyek Anda. Google Cloud
  • INSTANCE_ID: ID instance Managed Lustre Anda.
  • LOCATION: Lokasi instance Managed Lustre Anda.
  • TIMESTAMP: Waktu mulai dalam format RFC 3339 (misalnya, 2026-04-30T10:00:00Z). Waktu ini tidak boleh lebih dari 28 hari dari waktu yang dijadwalkan sebelumnya.