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, lihat 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 melibatkan 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 mengupgrade ke revisi patch, tinjau catatan rilis untuk mengetahui informasi tentang perbaikan spesifik yang disertakan. Penting untuk memahami bagaimana hal tersebut dapat memengaruhi instance Anda.
  • Siapkan lingkungan Anda:
    • Jadwalkan periode nonaktif untuk revisi patch.
    • Direkomendasikan: Sebelum mengupgrade, hentikan semua pipeline yang sedang berjalan dan nonaktifkan semua pemicu upstream, seperti pemicu Managed Service untuk Apache Airflow. Saat upgrade dimulai, semua pipeline yang sedang berjalan akan berhenti.

Upgrade instance versus revisi patch

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

Mengupgrade ke revisi patch untuk instance Cloud Data Fusion

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

Konsol

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

  2. Klik Instances dan pilih kotak centang di samping nama instance.

    Buka Instances

  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 memverifikasi bahwa upgrade berhasil, di konsol Google Cloud , muat ulang halaman Instance details. Periksa kolom Versi untuk melihat update.

gcloud

  1. Untuk mengupdate 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 flag --enable_stackdriver_logging, --enable_stackdriver_monitoring, dan --labels.

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

    Untuk mengetahui informasi selengkapnya, lihat referensi gcloud CLI.

  2. Pastikan 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. Periksa apakah kolom PATCH_REVISION di detail instance telah diperbarui ke versi yang ditentukan.

REST API

Untuk melakukan revisi patch instance Cloud Data Fusion, panggil metode patch(). Tetapkan kolom opsional patchRevision dalam permintaan. Jika Anda tidak menentukan revisi patch, revisi patch 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
}

Melakukan roll back revisi patch

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

gcloud

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

    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 flag --enable_stackdriver_logging, --enable_stackdriver_monitoring, dan --labels.

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

    Untuk mengetahui informasi selengkapnya, lihat referensi gcloud CLI.

  2. Verifikasi bahwa 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 di detail instance dikembalikan ke versi yang ditentukan.

REST API

Untuk mengembalikan revisi patch di instance Cloud Data Fusion, panggil metode patch(). Tetapkan kolom patchRevision dalam permintaan ke revisi patch yang lebih awal dan stabil.

Contoh

Contoh ini menunjukkan cara mengembalikan 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 akan di-roll back. Lihat revisi patch yang tersedia.

Misalnya, untuk mengembalikan 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 berikutnya