Mengelola revisi patch untuk instance

Halaman ini memberikan informasi dan panduan untuk mengelola revisi patch untuk instance Cloud Data Fusion.

Untuk mengetahui informasi selengkapnya tentang perbedaan revisi patch dengan upgrade lainnya, baca Upgrade instance versus revisi patch.

Revisi patch mencakup update keamanan penting dan perbaikan bug pada instance Anda. Revisi patch hanya menerapkan perbaikan pada platform tanpa mengubah pipeline atau plugin. Proses upgrade meliputi periode nonaktif instance dan pipeline.

Untuk mengetahui informasi selengkapnya tentang pembuatan versi Cloud Data Fusion, lihat Pembuatan versi di Cloud Data Fusion dan upgrade revisi patch yang tersedia.

Sebelum memulai

  • Sebelum Anda mengupgrade ke revisi patch, tinjau catatan rilis untuk mengetahui informasi tentang perbaikan spesifik yang disertakan. Anda harus memahami dampaknya terhadap instance Anda.
  • Menyiapkan lingkungan Anda:
    • Menjadwalkan periode nonaktif untuk revisi patch.
    • Direkomendasikan: Sebelum melakukan upgrade, hentikan pipeline yang sedang berjalan dan nonaktifkan semua pemicu upstream, seperti pemicu Cloud Composer. Saat upgrade dimulai, semua pipeline yang berjalan akan berhenti.

Upgrade instance versus revisi patch

Upgrade instance
Versi ini mencakup fitur terbaru, penyempurnaan fitur, dan peningkatan performa untuk platform ini. Upgrade instance berkaitan dengan perubahan plugin dan memerlukan upgrade pipeline. Untuk mengetahui informasi selengkapnya, lihat Upgrade versi: Instance dan pipeline.
Menambahkan patch revisi
Versi ini hanya menyertakan keamanan penting dan perbaikan bug untuk platform serta tidak mengubah atau mengupdate fitur pipeline dan plugin.

Upgrade ke revisi patch untuk instance Cloud Data Fusion

Guna mengupgrade ke revisi patch untuk instance Cloud Data Fusion Anda, ikuti langkah-langkah berikut di Google Cloud Console, Google Cloud CLI, atau REST API.

Konsol

  1. Di konsol Google Cloud, buka halaman Cloud Data Fusion.

  2. Klik Instances, lalu pilih kotak centang di samping nama instance.

    Buka Instance

  3. Klik Upgrade.

  4. Pilih revisi patch terbaru, lalu klik Upgrade.

  5. Untuk mengakses instance yang diupgrade di antarmuka web Cloud Data Fusion, klik View instance.

  6. Untuk memastikan bahwa upgrade berhasil, di Konsol Google Cloud, muat ulang halaman Instance details. Periksa kolom Version untuk update.

gcloud

  1. Untuk melakukan update ke revisi patch yang tersedia, jalankan perintah gcloud CLI berikut dari sesi Cloud Shell terminal lokal:

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=AVAILABLE_PATCH_REVISION

    Ganti kode berikut:

    • INSTANCE_ID: nama instance.
    • PROJECT_ID: ID project yang berisi instance Cloud Data Fusion.
    • LOCATION_NAME: lokasi instance.
    • CURRENT_INSTANCE_VERSION: versi saat ini.

    • AVAILABLE_PATCH_REVISION: revisi patch yang akan diupgrade.

    • Opsional: jika berlaku untuk instance Anda, tambahkan tanda --enable_stackdriver_logging, --enable_stackdriver_monitoring, dan --labels.

    • Opsional: Anda dapat meneruskan properti CDAP, seperti enable.unrecoverable.reset, sebagai --options.

    Untuk mengetahui informasi selengkapnya, baca referensi gcloud CLI.

  2. Verifikasi bahwa upgrade berhasil dengan mengikuti langkah-langkah berikut:

    1. Dapatkan detail instance dengan menjalankan perintah gcloud CLI berikut dari sesi Cloud Shell terminal lokal:

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. Pastikan kolom PATCH_REVISION dalam detail instance telah diupdate ke versi yang ditentukan.

REST API

Untuk melakukan revisi patch pada instance Cloud Data Fusion, panggil metode patch()-nya. Tetapkan kolom opsional patchRevision dalam permintaan. Jika Anda tidak menentukan revisi patch, revisi terbaru yang tersedia akan digunakan.

Contoh

Contoh berikut menunjukkan cara mengupgrade instance ke revisi patch dengan REST API.

Mengupgrade instance ke versi revisi patch tertentu

Panggil metode patch():

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Ganti kode berikut:

  • PROJECT_ID: ID project yang berisi instance Cloud Data Fusion.
  • LOCATION_NAME: lokasi instance.
  • INSTANCE_ID: nama instance.

Gunakan isi permintaan JSON berikut:

{
  "version": VERSION_NUMBER,
  "patchRevision": PATCH_REVISION_NUMBER
}

Ganti kode berikut:

  • VERSION_NUMBER: versi instance, seperti 6.7.3.
  • PATCH_REVISION_NUMBER: versi revisi patch yang akan diupgrade, seperti 6.7.3.1. Lihat revisi patch yang tersedia.

Misalnya, untuk mengupgrade instance versi 6.7.3 ke revisi patch 6.7.3.1, gunakan isi permintaan JSON berikut:

{
  "version": 6.7.3,
  "patchRevision": 6.7.3.1
}

Mengupgrade instance ke versi revisi patch default

Panggil metode patch():

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Gunakan isi permintaan JSON berikut:

{
  "version": VERSION_NUMBER
}

Ganti VERSION_NUMBER dengan versi instance, seperti 6.7.3:

{
  "version": 6.7.3
}

Me-roll back revisi patch

Jika Anda mengalami masalah yang tidak terduga setelah menggabungkan revisi patch, kembalikan revisi patch ke status sebelumnya yang stabil dengan mengikuti langkah-langkah ini.

gcloud

  1. Untuk melakukan roll back ke revisi patch sebelumnya, jalankan perintah gcloud CLI berikut dari sesi Cloud Shell terminal lokal:

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=STABLE_PATCH_REVISION

    Ganti kode berikut:

    • INSTANCE_ID: nama instance.
    • PROJECT_ID: ID project yang berisi instance Cloud Data Fusion.
    • LOCATION_NAME: lokasi instance.
    • CURRENT_INSTANCE_VERSION: versi saat ini.

    • STABLE_PATCH_REVISION: revisi patch yang akan di-roll back.

    • Opsional: jika berlaku untuk instance Anda, tambahkan tanda --enable_stackdriver_logging, --enable_stackdriver_monitoring, dan --labels.

    • Opsional: Anda dapat meneruskan properti CDAP, seperti enable.unrecoverable.reset, sebagai --options.

    Untuk mengetahui informasi selengkapnya, baca referensi gcloud CLI.

  2. Pastikan rollback berhasil dengan mengikuti langkah-langkah berikut:

    1. Dapatkan detail instance dengan menjalankan perintah gcloud CLI berikut dari sesi Cloud Shell terminal lokal:

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. Pastikan kolom PATCH_REVISION dalam detail instance dikembalikan ke versi yang ditentukan.

REST API

Untuk me-roll back revisi patch dalam instance Cloud Data Fusion, panggil metode patch()-nya. Tetapkan kolom patchRevision dalam permintaan ke revisi patch sebelumnya yang stabil.

Contoh

Contoh ini menunjukkan cara me-roll back instance dari revisi patch 6.7.3.1 ke revisi patch 6.7.3 menggunakan REST API.

Panggil metode patch():

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Ganti kode berikut:

  • PROJECT_ID: ID project yang berisi instance Cloud Data Fusion.
  • LOCATION_NAME: lokasi instance.
  • INSTANCE_ID: nama instance.

Gunakan isi permintaan JSON berikut:

{
  "version": VERSION_NUMBER,
  "patchRevision": STABLE_PATCH_REVISION
}

Ganti kode berikut:

  • VERSION_NUMBER: versi instance, seperti 6.7.3.
  • STABLE_PATCH_REVISION: revisi patch yang menjadi tujuan rollback. Lihat revisi patch yang tersedia.

Misalnya, untuk me-roll back instance dari revisi patch 6.7.3.1 ke revisi patch 6.7.3, gunakan isi permintaan JSON berikut:

{
  "version": 6.7.3,
  "patchRevision": 6.7.3
}

Langkah selanjutnya