Mengonfigurasi masa pemeliharaan

Halaman ini menjelaskan cara menentukan periode pemeliharaan untuk instance Cloud Data Fusion.

Periode pemeliharaan didukung untuk instance Cloud Data Fusion dalam versi 6.8.0 dan yang lebih baru.

Tentang masa pemeliharaan

Periode 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 periode pemeliharaan selama jam non-puncak, atau saat aktivitas Anda lebih rendah, akan meminimalkan dampaknya terhadap instance Cloud Data Fusion dan eksekusi pipeline Anda.

Dengan mengonfigurasi masa pemeliharaan, Anda dapat mengontrol kapan operasi pemeliharaan terjadi di instance:

  • Jika periode 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 reguler. Operasi ini mencakup penerapan update penting dan patch keamanan untuk mengurangi kerentanan dan melindungi data pengguna. Periode pemeliharaan terjadwal memastikan bahwa update diterapkan secara efisien, mempertahankan integritas sistem, dan meminimalkan gangguan pada instance dan eksekusi pipeline.

  • Saat mengonfigurasi periode pemeliharaan, Anda harus mengalokasikan setidaknya 12 jam per minggu untuk operasi pemeliharaan. Setiap periode harus antara 4 dan 12 jam.

  • Selama jam periode pemeliharaan, operasi tertentu mungkin terpengaruh. Sebaiknya tetapkan 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 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 periode pemeliharaan. Sebaiknya siapkan periode pemeliharaan saat pipeline tidak berjalan atau tidak dijadwalkan untuk berjalan.

Menentukan periode pemeliharaan saat membuat instance

Konsol

Untuk menetapkan periode pemeliharaan saat membuat instance, ikuti langkah-langkah berikut:

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

    Membuat instance

  2. Masukkan Nama instance dan Edisi. 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 Enable maintenance window.
    2. Di kolom Start time, masukkan waktu dalam format yang didukung.
    3. Di daftar TimeZone, pilih zona waktu.
    4. Dalam daftar Days dan Length, pilih hari dan durasi periode. Untuk mengetahui informasi selengkapnya tentang setelan ini, lihat Tentang operasi pemeliharaan.
    5. Klik Create.

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

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 periode waktu, dalam format RFC 3339.
  • END_TIME: waktu akhir periode waktu, dalam format RFC 3339.

  • MAINTENANCE_RECURRENCE: RRULE untuk pengulangan periode 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. Ini menentukan pengulangan mingguan periode pada hari yang dipilih, dimulai pada startTime, dan untuk durasi yang ditentukan.

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

Contoh berikut membuat instance dengan periode pemeliharaan enam jam antara pukul 10.00 hingga 16.00 (UTC) pada hari Sabtu dan Minggu setiap minggu. Untuk 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 periode pemeliharaan saat membuat instance menggunakan perintah gcloud beta data-fusion instances create.

Parameter berikut harus ditentukan untuk periode pemeliharaan:

  • --maintenance-window-start menetapkan waktu mulai periode.
  • --maintenance-window-end menetapkan waktu akhir periode.
  • --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 periode dalam format input tanggal/waktu. Hanya waktu yang ditentukan yang digunakan, tanggal yang ditentukan akan diabaikan.
  • END_TIME: waktu akhir periode dalam format input tanggal/waktu. Hanya waktu yang ditentukan yang digunakan, tanggal yang ditentukan akan diabaikan. Tanggal dan waktu yang ditentukan harus setelah waktu mulai.

  • MAINTENANCE_RECURRENCE: RRULE untuk pengulangan periode 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. Ini menentukan pengulangan mingguan periode pada hari yang dipilih, dimulai pada waktu --maintenance-window-start, dan untuk durasi yang ditentukan.

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

Perintah berikut membuat instance dengan periode 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 periode pemeliharaan untuk instance

Konsol

Untuk memperbarui periode pemeliharaan di instance yang ada di konsol Google Cloud, ikuti langkah-langkah berikut:

  1. Buka halaman Instance Cloud Data Fusion.

    Buka Instance

  2. Klik nama instance untuk melihat detail instance.

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

  4. Kolom periode pemeliharaan dibuka dalam mode edit. Perbarui nilai, sesuai kebutuhan:

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

  5. Klik Simpan.

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

REST API

Untuk instance yang ada, perbarui periode pemeliharaan menggunakan permintaan API instances.patch. Tindakan ini akan menggantikan konfigurasi periode 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. Dalam isi permintaan, tentukan periode pemeliharaan dalam konfigurasi kebijakan pemeliharaan:
{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

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

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 periode pemeliharaan instance menggunakan perintah gcloud beta data-fusion instances update.

Parameter berikut harus ditentukan untuk periode pemeliharaan:

  • --maintenance-window-start menetapkan waktu mulai periode.
  • --maintenance-window-end menetapkan waktu akhir periode.
  • --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 periode dalam format input tanggal/waktu. Hanya waktu yang ditentukan yang digunakan, tanggal yang ditentukan akan diabaikan.
  • END_TIME: waktu akhir periode dalam format input tanggal/waktu. Hanya waktu yang ditentukan yang digunakan, tanggal yang ditentukan akan diabaikan. Tanggal dan waktu yang ditentukan harus setelah waktu mulai.

  • MAINTENANCE_RECURRENCE: RRULE untuk pengulangan periode 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. Ini menentukan pengulangan mingguan periode pada hari yang dipilih, dimulai pada waktu --maintenance-window-start, dan untuk durasi yang ditentukan.

Perintah berikut akan memperbarui instance example-instance dengan periode 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 (RRULE) masa pemeliharaan

Saat Anda mengonfigurasi waktu mulai dan waktu berakhir untuk periode pemeliharaan, komponen tanggal stempel waktu yang diberikan akan diabaikan. Hanya waktu dan durasi antara waktu mulai dan waktu akhir yang dipertimbangkan. Waktu disimpan dalam UTC, tetapi Anda dapat menggunakan UTC atau offset zona waktu saat menjadwalkan periode pemeliharaan menggunakan REST API atau gcloud CLI.

Saat Anda 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 periode pemeliharaan dimulai pukul 21.00 pada hari Rabu di zona waktu Anda (yang sesuai dengan pukul 04.00 UTC pada hari Kamis), tentukan TH, bukan WE, di opsi BYDAY RRULE.

Menghapus periode pemeliharaan untuk instance

Konsol

Untuk menghapus periode pemeliharaan di instance yang ada di konsol Google Cloud, ikuti langkah-langkah berikut:

  1. Buka halaman Instance Cloud Data Fusion.

    Buka Instance

  2. Klik nama instance untuk melihat detail instance.

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

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

  5. Klik Simpan.

REST API

Untuk menghapus periode pemeliharaan dari instance, teruskan objek kebijakan pemeliharaan kosong dalam isi permintaan.

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
    "maintenancePolicy": {}
}

gcloud

Untuk menghapus periode pemeliharaan dari instance, gunakan perintah gcloud beta data-fusion instances update 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.

Langkah selanjutnya