Untuk menjaga agar instance Google Cloud Managed Lustre Anda tetap terbaru, Google Cloud pemeliharaan dilakukan secara berkala. Peristiwa pemeliharaan dapat mencakup update 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. Waktu 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 waktu terjadinya peristiwa pemeliharaan ini. Anda dapat mengonfigurasi kebijakan pemeliharaan untuk setiap instance guna menentukan periode untuk 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 acara pemeliharaan agar dimulai segera, selama periode berikutnya yang tersedia, atau pada waktu tertentu hingga 28 hari kemudian.
Tentang kebijakan pemeliharaan
Anda dapat mengonfigurasi kebijakan pemeliharaan di setiap instance Managed Lustre. Kebijakan pemeliharaan mencakup hal berikut:
- Periode pemeliharaan mingguan: Periode satu jam berulang selama 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 tahun tidak ditentukan dalam tanggal mulai dan akhir, periode pengecualian akan berulang setiap tahun.
Periode pengecualian lebih diutamakan daripada masa pemeliharaan rutin. Jika acara terjadwal terjadi dalam periode ini, Managed Lustre akan menunda acara ke periode berikutnya yang tersedia atau melewatkannya sepenuhnya. Update akan diterapkan selama siklus pemeliharaan berikutnya.
Notifikasi pemeliharaan
Anda dapat berlangganan notifikasi email untuk peristiwa pemeliharaan mendatang guna membantu Anda merencanakan potensi gangguan. Langganan untuk notifikasi pemeliharaan dikelola melalui halaman Komunikasi konsol Google Cloud :
Setelah berlangganan, notifikasi berikut akan dikirim:
- Notifikasi awal: 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 Anda dapat menggunakan Cloud Logging untuk melihat log pemeliharaan.
Mengonfigurasi masa pemeliharaan
Masa pemeliharaan memerlukan hari dalam seminggu dan waktu mulai UTC untuk periode satu jam.
Konsol Google Cloud
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 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 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 jam untuk waktu mulai masa pemeliharaan (misalnya,
0).
Mengonfigurasi jendela 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 pada tanggal mulai dan tanggal berakhir.
Anda dapat menggabungkan masa pemeliharaan mingguan dan masa pengecualian dalam kebijakan yang sama.
Konsol Google Cloud
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 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}). Untuk berulang setiap tahun, hapus kunciyear. - END_DATE: Tanggal berakhir periode pengecualian pemeliharaan dalam format kamus (misalnya,
{day=08,month=06,year=2026}). Untuk 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 jendela 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 pada 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 akhir periode pengecualian
(misalnya,
1). - END_DAY: Hari tanggal akhir periode pengecualian (misalnya,
7). - HOURS: Jam dalam sehari untuk waktu periode pengecualian
(misalnya,
0). - MINUTES: Menit dalam jam untuk waktu periode pengecualian
(misalnya,
0).
Memperbarui kebijakan pemeliharaan
Untuk menambahkan atau mengubah kebijakan pemeliharaan untuk instance yang ada:
Konsol Google Cloud
Untuk memperbarui kebijakan pemeliharaan 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 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 Google Cloud project Anda.
- 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 Menit dalam jam untuk waktu mulai masa pemeliharaan (misalnya,
45).
Menghapus kebijakan pemeliharaan
Untuk menghapus kebijakan pemeliharaan dari instance, hapus semua jendela pemeliharaan mingguan dan jendela pengecualian dari kebijakan.
Konsol Google Cloud
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 Google Cloud project Anda.
- 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 dicatat, kali ini denganis_completed=true.LustreCancelledNotification: Pemeliharaan telah dibatalkan.
Anda dapat melihat log pemeliharaan menggunakan Logs Explorer atau dengan menggunakan Google Cloud CLI.
Logs Explorer
Untuk melihat log pemeliharaan Managed Lustre menggunakan Logs Explorer, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Cloud Logging > Logs Explorer:
Masukkan filter berikut ke editor kueri, lalu klik Run query:
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"Ganti kode berikut:
- INSTANCE_ID: ID instance Managed Lustre Anda.
- LOCATION: Lokasi instance Managed Lustre.
- PROJECT_ID: ID Google Cloud project Anda.
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 project tempat instance berada.
Menjadwalkan ulang pemeliharaan
Jika peristiwa pemeliharaan terjadwal bertentangan dengan kebutuhan Anda, Anda dapat menjadwalkan ulang peristiwa tersebut. Saat menjadwalkan ulang, Anda memiliki opsi berikut:
- Segera: Menjadwalkan ulang peristiwa pemeliharaan agar dimulai sesegera mungkin. Opsi ini mengabaikan semua masa pemeliharaan dan masa pengecualian yang dikonfigurasi pada instance.
- Masa pemeliharaan berikutnya yang tersedia: Menjadwalkan ulang peristiwa pemeliharaan ke masa pemeliharaan berikutnya yang tersedia. Hal ini biasanya menunda pembaruan selama satu minggu.
- Menurut tanggal: Jadwalkan ulang acara pemeliharaan ke tanggal dan waktu tertentu. Anda dapat menunda pemeliharaan hingga maksimal 28 hari dari waktu yang dijadwalkan semula. Opsi ini mengabaikan semua masa pemeliharaan dan periode pengecualian yang dikonfigurasi pada instance.
Untuk menjadwalkan ulang pemeliharaan:
gcloud
Untuk memulai peristiwa pemeliharaan secepat mungkin:
gcloud lustre instances reschedule-maintenance INSTANCE_ID \ --location=LOCATION \ --reschedule-type=immediately
Untuk menjadwalkan ulang pemeliharaan ke masa pemeliharaan 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 semula.
REST API
Gunakan
metode
instances.rescheduleMaintenance.
Contoh curl berikut memulai acara 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 masa pemeliharaan
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 Google Cloud project Anda.
- 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 semula.