Mengelola revisi patch untuk instance

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

Untuk 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 di platform tanpa mengubah pipeline atau plugin. Proses upgrade melibatkan periode nonaktif instance dan pipeline.

Untuk 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 dampaknya terhadap instance Anda.
  • Siapkan lingkungan Anda:
    • Jadwalkan periode nonaktif untuk revisi patch.
    • Direkomendasikan: Sebelum mengupgrade, hentikan pipeline yang sedang berjalan dan nonaktifkan 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, peningkatan fitur, dan peningkatan performa untuk platform. Upgrade instance dikaitkan 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 Instance, 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 Lihat instance.

  6. Untuk memverifikasi bahwa upgrade berhasil, di konsol Google Cloud, reload halaman Detail instance. Periksa kolom Version untuk 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: project ID 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. Pastikan 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 menerapkan revisi patch, kembalikan revisi patch ke status stabil sebelumnya dengan mengikuti langkah-langkah berikut.

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: project ID 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. Pastikan 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 dalam detail instance diubah kembali 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 stabil sebelumnya.

Contoh

Contoh ini menunjukkan cara melakukan rollback 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 melakukan rollback 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