Halaman ini menjelaskan cara menentukan masa pemeliharaan untuk instance Cloud Data Fusion.
Masa pemeliharaan didukung untuk instance Cloud Data Fusion dalam versi 6.8.0 dan yang lebih baru.
Tentang masa pemeliharaan
Masa pemeliharaan di Cloud Data Fusion adalah jangka waktu saat Anda mengizinkannya untuk melakukan operasi pemeliharaan, sehingga mengurangi risiko gangguan layanan selama waktu penggunaan puncak. Menjadwalkan masa pemeliharaan di luar jam sibuk, atau saat aktivitas Anda lebih rendah, akan meminimalkan dampaknya pada instance Cloud Data Fusion dan eksekusi pipeline Anda.
Mengonfigurasi masa pemeliharaan memungkinkan Anda mengontrol waktu terjadinya operasi pemeliharaan di instance Anda:
- Jika masa pemeliharaan ditentukan, operasi pemeliharaan akan dilakukan oleh Cloud Data Fusion dalam periode yang ditentukan.
- Jika masa pemeliharaan tidak ditentukan, pemeliharaan dapat dilakukan kapan saja.
Tentang operasi pemeliharaan
Untuk memastikan keamanan dan kepatuhan sistem, Cloud Data Fusion melakukan operasi pemeliharaan rutin. Operasi ini mencakup penerapan update penting dan patch keamanan untuk mengurangi kerentanan dan melindungi data pengguna. Masa pemeliharaan terjadwal memastikan bahwa update diterapkan secara efisien, menjaga integritas sistem, dan meminimalkan gangguan pada instance dan eksekusi pipeline.
- Saat mengonfigurasi masa pemeliharaan, Anda harus mengalokasikan setidaknya 12 jam per minggu untuk operasi pemeliharaan. Setiap masa pemeliharaan harus antara 4 dan 12 jam.
Selama jam masa pemeliharaan, operasi tertentu mungkin terpengaruh. Sebaiknya jadwalkan masa pemeliharaan selama waktu penggunaan non-puncak. Operasi pemeliharaan dapat memengaruhi Cloud Data Fusion dengan cara berikut:
- Antarmuka Cloud Data Fusion Studio mungkin tidak tersedia untuk sementara.
- Eksekusi pipeline mungkin terpengaruh, sehingga menyebabkan kegagalan.
- Layanan Cloud Data Fusion mungkin tidak berfungsi untuk sementara, sehingga menyebabkan panggilan API gagal.
- Instance mungkin tidak berfungsi sepenuhnya hingga satu jam selama jam masa pemeliharaan. Sebaiknya siapkan masa pemeliharaan saat pipeline Anda tidak berjalan atau tidak dijadwalkan untuk berjalan.
Menentukan masa pemeliharaan saat membuat instance
Konsol
Untuk menetapkan masa pemeliharaan saat membuat instance, ikuti langkah-langkah berikut:
- Buka halaman Instances Cloud Data Fusion, lalu klik Create instance.
- Masukkan Instance name dan Edition. Untuk mengetahui informasi selengkapnya tentang setiap kolom, lihat Membuat instance.
- Luaskan bagian Advanced options.
- Luaskan bagian Maintenance dan ikuti langkah-langkah berikut:
- Centang kotak Enable maintenance window.
- Di kolom Start time, masukkan waktu dalam format yang didukung.
- Di daftar TimeZone, pilih zona waktu.
- Di daftar Days dan Length, pilih hari dalam seminggu dan durasi masa pemeliharaan. Untuk mengetahui informasi selengkapnya tentang setelan ini, lihat Tentang operasi pemeliharaan.
- Klik Create.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE).
REST API
- Tetapkan konfigurasi
Instancemenggunakaninstance.createAPI:
{
"name": string,
"description": string,
…
…
"maintenancePolicy": {
"maintenanceWindow": {
"recurringTimeWindow": {
"window": {
"startTime": "START_TIME",
"endTime": "END_TIME"
},
"recurrence": "MAINTENANCE_RECURRENCE"
}
},
}
}
Ganti kode berikut:
START_TIME: waktu mulai masa pemeliharaan, dalam format RFC 3339.END_TIME: waktu berakhir masa pemeliharaan, dalam format RFC 3339.MAINTENANCE_RECURRENCE: RRULE untuk pengulangan masa pemeliharaan. Cloud Data Fusion hanya mendukung format berikut:FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SAatauBYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Hal ini menentukan pengulangan mingguan masa pemeliharaan pada hari yang dipilih, dimulai padastartTime, dan untuk durasi yang ditentukan.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE).
Contoh berikut membuat instance dengan masa pemeliharaan enam jam antara pukul 10.00 hingga 16.00 (UTC) pada hari Sabtu dan Minggu setiap minggu. Untuk mengetahui informasi selengkapnya, lihat dokumentasi API instance.
// POST https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances?instanceID=example-instance
{
"maintenancePolicy": {
"maintenanceWindow": {
"recurringTimeWindow": {
"window": {
"startTime": "2024-01-01T10:00:00Z",
"endTime": "2024-01-01T16:00:00Z",
},
"recurrence": "FREQ=WEEKLY;BYDAY=SA,SU"
}
},
}
}
gcloud
Anda dapat menentukan masa pemeliharaan saat membuat instance menggunakan perintah gcloud beta data-fusion instances create.
Parameter berikut harus ditentukan untuk masa pemeliharaan:
--maintenance-window-startmenetapkan waktu mulai masa pemeliharaan.--maintenance-window-endmenetapkan waktu berakhir masa pemeliharaan.--maintenance-window-recurrencemenetapkan RRULE untuk pengulangan masa pemeliharaan.
gcloud beta data-fusion instances create INSTANCE_NAME \
--project=PROJECT_NAME \
--location=LOCATION \
--maintenance-window-start=START_TIME \
--maintenance-window-end=END_TIME \
--maintenance-window-recurrence=MAINTENANCE_RECURRENCE
Ganti kode berikut:
INSTANCE_NAME: nama instance.PROJECT_NAME: nama project.LOCATION: nama region instance.START_TIME: waktu mulai masa pemeliharaan dalam format input tanggal/waktu. Hanya waktu yang ditentukan dalam sehari yang digunakan, tanggal yang ditentukan akan diabaikan.END_TIME: waktu berakhir masa pemeliharaan dalam format input tanggal/waktu . Hanya waktu yang ditentukan dalam sehari yang digunakan, tanggal yang ditentukan akan diabaikan. Tanggal dan waktu yang ditentukan harus setelah waktu mulai.MAINTENANCE_RECURRENCE: RRULE untuk pengulangan masa pemeliharaan. Cloud Data Fusion hanya mendukung format berikut:FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SAatauBYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Hal ini menentukan pengulangan mingguan masa pemeliharaan pada hari yang dipilih, dimulai pada waktu--maintenance-window-start, dan untuk durasi yang ditentukan.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE).
Perintah berikut membuat instance dengan masa pemeliharaan enam jam antara pukul 12.00 hingga 18.00 (UTC) pada hari Sabtu dan Minggu setiap minggu.
gcloud beta data-fusion instances create example-instance \
--project='example-project' \
--location='us-east1' \
--maintenance-window-start='2024-01-01T12:00:00Z' \
--maintenance-window-end='2024-01-01T18:00:00Z' \
--maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'
Memperbarui masa pemeliharaan untuk instance
Konsol
Untuk memperbarui masa pemeliharaan di instance yang ada di Google Cloud konsol, ikuti langkah-langkah berikut:
Buka halaman Instances Cloud Data Fusion.
Klik nama instance untuk melihat detail instance.
Di halaman Instance details , buka kolom Maintenance window , lalu klik Edit.
Kolom masa pemeliharaan akan terbuka dalam mode edit. Perbarui nilai, jika diperlukan:
- Centang kotak Enable maintenance window.
- Di kolom Start time, masukkan waktu dalam format yang didukung.
- Di daftar TimeZone, pilih zona waktu.
- Di daftar Days dan Length, pilih hari dalam seminggu dan durasi masa pemeliharaan. Untuk mengetahui informasi selengkapnya tentang setelan ini, lihat Tentang operasi pemeliharaan.
Klik Save.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE).
REST API
Untuk instance yang ada, perbarui masa pemeliharaan menggunakan permintaan
instances.patch
API. Tindakan ini akan mengganti konfigurasi masa pemeliharaan yang ada, jika ada. Jika tidak, konfigurasi baru akan ditetapkan, seperti yang disebutkan dalam isi permintaan.
Buat permintaan API sebagai berikut:
- Di parameter
updateMask, tentukan maskmaintenance_policy. - Di isi permintaan, tentukan masa pemeliharaan dalam konfigurasi kebijakan pemeliharaan:
{
"maintenancePolicy": {
"maintenanceWindow": {
"recurringTimeWindow": {
"window": {
"startTime": "START_TIME",
"endTime": "END_TIME"
},
"recurrence": "MAINTENANCE_RECURRENCE"
}
},
}
}
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE).
Contoh berikut memperbarui konfigurasi kebijakan pemeliharaan instance dengan masa pemeliharaan empat jam antara pukul 11.00 hingga 15.00 (UTC) pada hari Jumat, Sabtu, dan Minggu setiap minggu.
// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy
{
"maintenancePolicy": {
"maintenanceWindow": {
"recurringTimeWindow": {
"window": {
"startTime": "2024-01-01T11:00:00Z",
"endTime": "2024-01-01T15:00:00Z",
},
"recurrence": "FREQ=WEEKLY;BYDAY=FR,SA,SU"
}
},
}
}
gcloud
Anda dapat memperbarui masa pemeliharaan instance menggunakan perintah gcloud beta data-fusion instances update.
Parameter berikut harus ditentukan untuk masa pemeliharaan:
--maintenance-window-startmenetapkan waktu mulai masa pemeliharaan.--maintenance-window-endmenetapkan waktu berakhir masa pemeliharaan.--maintenance-window-recurrencemenetapkan RRULE untuk pengulangan masa pemeliharaan.
gcloud beta data-fusion instances update INSTANCE_NAME \
--project=PROJECT_NAME \
--location=LOCATION \
--maintenance-window-start=START_TIME \
--maintenance-window-end=END_TIME \
--maintenance-window-recurrence=MAINTENANCE_RECURRENCE
Ganti kode berikut:
INSTANCE_NAME: nama instance.PROJECT_NAME: nama project.LOCATION: nama region instance.START_TIME: waktu mulai masa pemeliharaan dalam format input tanggal/waktu. Hanya waktu yang ditentukan dalam sehari yang digunakan, tanggal yang ditentukan akan diabaikan.END_TIME: waktu berakhir masa pemeliharaan dalam format input tanggal/waktu . Hanya waktu yang ditentukan dalam sehari yang digunakan, tanggal yang ditentukan akan diabaikan. Tanggal dan waktu yang ditentukan harus setelah waktu mulai.MAINTENANCE_RECURRENCE: RRULE untuk pengulangan masa pemeliharaan. Cloud Data Fusion hanya mendukung format berikut:FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SAatauBYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Hal ini menentukan pengulangan mingguan masa pemeliharaan pada hari yang dipilih, dimulai pada waktu--maintenance-window-start, dan untuk durasi yang ditentukan.
Perintah berikut memperbarui instance example-instance dengan masa pemeliharaan enam jam antara pukul 12.00 hingga 18.00 (UTC) pada hari Sabtu dan Minggu setiap minggu.
gcloud beta data-fusion instances update example-instance \
--project='example-project' \
--location='us-east1' \
--maintenance-window-start='2024-01-01T12:00:00Z' \
--maintenance-window-end='2024-01-01T18:00:00Z' \
--maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'
Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE)
Saat Anda mengonfigurasi waktu mulai dan berakhir untuk masa pemeliharaan, komponen tanggal stempel waktu yang diberikan akan diabaikan. Hanya waktu dalam sehari dan durasi antara waktu mulai dan berakhir yang dipertimbangkan. Waktu disimpan dalam UTC, tetapi Anda dapat menggunakan UTC atau offset zona waktu saat menjadwalkan masa pemeliharaan menggunakan REST API atau gcloud CLI.
Saat mengonfigurasi pengulangan, perlu diingat bahwa RRULE mengikuti hari UTC, jadi sesuaikan jika zona waktu Anda berbeda. Misalnya, jika zona waktu Anda adalah PDT (UTC-7) dan Anda ingin masa pemeliharaan dimulai pukul 21.00 pada hari Rabu di zona waktu Anda (yang sesuai dengan pukul 04.00 UTC pada hari Kamis), tentukan TH dan bukan WE di opsi BYDAY RRULE.
Menghapus masa pemeliharaan untuk instance
Konsol
Untuk menghapus masa pemeliharaan di instance yang ada di Google Cloud konsol, ikuti langkah-langkah berikut:
Buka halaman Instances Cloud Data Fusion.
Klik nama instance untuk melihat detail instance.
Di halaman Instance details , buka kolom Maintenance window , lalu klik Edit.
Untuk menghapus masa pemeliharaan dari instance, hapus centang pada kotak Enable maintenance window.
Klik Save.
REST API
Untuk menghapus masa pemeliharaan dari instance, teruskan objek kebijakan pemeliharaan kosong di isi permintaan.
// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy
{
"maintenancePolicy": {}
}
gcloud
Untuk menghapus masa pemeliharaan dari instance, gunakan gcloud beta data-fusion instances update
perintah dengan flag --clear-maintenance-window.
gcloud beta data-fusion instances update INSTANCE_NAME \
--project=PROJECT_NAME \
--location=LOCATION \
--clear-maintenance-window
Ganti kode berikut:
INSTANCE_NAME: nama instance.PROJECT_NAME: nama project.LOCATION: nama region instance.