Mengonfigurasi masa pemeliharaan

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:

  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 Enable maintenance window.
    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 Enable maintenance window.
    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 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 berikutnya

  • Lihat dokumentasi API instance .