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 :
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, dan1000. Untuk menentukan [Tingkat dinamis][dynamic-tier], tetapkan nilai ini ke0dan 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, dan1000. Untuk menentukan [Tingkat dinamis][dynamic-tier], tetapkan nilai ini ke0dan 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 kunciyear. - END_DATE: Tanggal berakhir periode pengecualian pemeliharaan dalam
format kamus (misalnya,
{day=08,month=06,year=2026}). Agar berulang setiap tahun, hapus kunciyear. - 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 danEND_YEARuntuk 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 danSTART_YEARuntuk 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, peristiwaLustreOngoingNotificationlain akan dicatat, kali ini denganis_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:
Di Google Cloud konsol, buka halaman Cloud Logging > Logs Explorer:
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.