Mengonfigurasi masa pemeliharaan

Masa pemeliharaan di Cloud Data Fusion memungkinkan Anda mengontrol kapan update otomatis dan pemeliharaan rutin terjadi. Menetapkan jangka waktu yang ditentukan membantu Anda mencegah gangguan layanan selama jam operasional puncak.

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 puncak, atau saat aktivitas Anda lebih rendah, akan meminimalkan dampaknya pada instance Cloud Data Fusion dan eksekusi pipeline Anda.

Mengonfigurasi masa pemeliharaan memungkinkan Anda mengontrol kapan operasi pemeliharaan terjadi 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 di luar waktu penggunaan 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:

  1. Buka halaman Instances Cloud Data Fusion, lalu klik Create instance.

    Membuat instance

  2. Masukkan Instance name dan Edition. Untuk mengetahui informasi selengkapnya tentang setiap kolom, lihat Membuat instance.
  3. Luaskan bagian Advanced options.
  4. Luaskan bagian Maintenance dan ikuti langkah-langkah berikut:
    1. Centang kotak Aktifkan masa pemeliharaan.
    2. Di kolom Start time, masukkan waktu dalam format yang didukung.
    3. Di daftar TimeZone, pilih zona waktu.
    4. Di daftar Days dan Length, pilih hari dalam seminggu dan durasi masa pemeliharaan. Untuk mengetahui informasi selengkapnya tentang setelan ini, lihat Tentang operasi pemeliharaan.
    5. Klik Create.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi waktu dan pengulangan masa pemeliharaan (RRULE).

REST API

  1. Tetapkan konfigurasi Instance menggunakan instance.create API:
{
  "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,SA atau BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Hal ini menentukan pengulangan mingguan masa pemeliharaan pada hari yang dipilih, dimulai pada startTime, 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-start menetapkan waktu mulai masa pemeliharaan.
  • --maintenance-window-end menetapkan waktu berakhir masa pemeliharaan.
  • --maintenance-window-recurrence menetapkan 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,SA atau BYDAY=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:

  1. Buka halaman Instances Cloud Data Fusion.

    Buka Instance

  2. Klik nama instance untuk melihat detail instance.

  3. Di halaman Instance details , buka kolom Maintenance window , lalu klik Edit.

  4. Kolom masa pemeliharaan akan terbuka dalam mode edit. Perbarui nilai, jika diperlukan:

    1. Centang kotak Aktifkan masa pemeliharaan.
    2. Di kolom Start time, masukkan waktu dalam format yang didukung.
    3. Di daftar TimeZone, pilih zona waktu.
    4. Di daftar Days dan Length, pilih hari dalam seminggu dan durasi masa pemeliharaan. Untuk mengetahui informasi selengkapnya tentang setelan ini, lihat Tentang operasi pemeliharaan.

  5. 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:

  1. Di parameter updateMask, tentukan mask maintenance_policy.
  2. 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-start menetapkan waktu mulai masa pemeliharaan.
  • --maintenance-window-end menetapkan waktu berakhir masa pemeliharaan.
  • --maintenance-window-recurrence menetapkan 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,SA atau BYDAY=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:

  1. Buka halaman Instances Cloud Data Fusion.

    Buka Instance

  2. Klik nama instance untuk melihat detail instance.

  3. Di halaman Instance details , buka kolom Maintenance window , lalu klik Edit.

  4. Untuk menghapus masa pemeliharaan dari instance, hapus centang pada kotak Enable maintenance window.

  5. 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 tanda --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.

Melihat peristiwa pemeliharaan dan menerima notifikasi

Cloud Data Fusion melaporkan peristiwa pemeliharaan terjadwal untuk instance Anda melalui Unified Maintenance. Untuk melihat peristiwa ini dan menerima notifikasi tentangnya, Anda harus menyiapkan setiap peristiwa secara terpisah:

Mengaktifkan Unified Maintenance API

Untuk melihat peristiwa pemeliharaan di Google Cloud konsol, aktifkan Unified Maintenance API (maintenance.googleapis.com) di project Anda. Pemeliharaan Terpadu tidak menampilkan peristiwa historis yang dijadwalkan sebelum Anda mengaktifkan API.

Konsol

  1. Di API Library, buka halaman Maintenance API.

    Buka Maintenance API

  2. Klik Enable.

gcloud

Gunakan perintah gcloud services enable:

gcloud services enable maintenance.googleapis.com \
    --project=PROJECT_ID

Ganti PROJECT_ID dengan project ID Anda.

Mengonfigurasi notifikasi

Pemeliharaan Terpadu menulis log peristiwa pemeliharaan dengan ID log maintenance.googleapis.com/maintenance_events ke logging secara otomatis, terlepas dari apakah Unified Maintenance API diaktifkan atau tidak. Untuk menerima notifikasi melalui saluran seperti email, Pub/Sub, Slack, PagerDuty, atau webhook, buat kebijakan pemberitahuan berbasis log yang cocok dengan log ini. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi pemberitahuan dan notifikasi.

Langkah berikutnya