Mengonfigurasi cluster untuk menerima notifikasi melalui email

Autopilot Standard

---

Tutorial ini menunjukkan cara mengonfigurasi Integrasi Aplikasi untuk menerima notifikasi cluster Google Kubernetes Engine (GKE) melalui email.

Anda membuat integrasi dengan pemicu Pub/Sub untuk memproses topik yang ada yang menerima notifikasi dari cluster GKE. Kemudian, Anda dapat menggunakan tugas Pemetaan Data dan Pengubah Data untuk mengubah pesan Pub/Sub dan membuat isi email teks biasa.

Tujuan

• Buat aplikasi Integrasi Aplikasi untuk menerima dan mengubah notifikasi eksternal dari GKE.
• Tulis tugas Kirim Email yang mengirimkan notifikasi Pub/Sub ke email.

Biaya

Dalam dokumen ini, Anda akan menggunakan komponen Google Cloud yang dapat ditagih berikut:

• GKE
• Pub/Sub
• Application Integration

Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda, gunakan kalkulator harga. Pengguna baru Google Cloud mungkin memenuhi syarat untuk mendapatkan uji coba gratis.

Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Pembersihan.

Sebelum memulai

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the GKE, Application Integration and Pub/Sub APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the GKE, Application Integration and Pub/Sub APIs.

   Enable the APIs

8. Aktifkan notifikasi cluster GKE.
9. Jika Anda menggunakan Integrasi Aplikasi dalam project untuk pertama kalinya, pastikan Anda telah menyiapkan Integrasi Aplikasi.

Peran yang diperlukan

Untuk memastikan bahwa [e-mail] memiliki izin yang diperlukan untuk menyiapkan notifikasi email untuk notifikasi cluster, minta administrator Anda untuk memberikan peran IAM berikut kepada [e-mail] di project Anda:

• Editor Pub/Sub (roles/pubsub.editor)
• Application Integration Editor (roles/integrations.editor)

Menyiapkan notifikasi cluster untuk cluster GKE Anda

Untuk menggunakan Pub/Sub guna menerima notifikasi tentang cluster GKE, ikuti Menerima notifikasi cluster.

Membuat integrasi baru

Untuk membuat integrasi baru, lakukan langkah-langkah berikut:

1. Buka halaman Application Integration di konsol Google Cloud.

   Buka Application Integration

2. Di menu navigasi, klik Integrations. Halaman Integrations akan muncul.

3. Klik Create integration.

4. Di Integration name, masukkan nama untuk integrasi yang Anda buat.

5. Jika Anda mengaktifkan beberapa region, opsi drop-down akan ditampilkan agar Anda dapat memilih region untuk integrasi. Jika hanya satu region yang diaktifkan, region tersebut akan menjadi default dan drop-down tidak akan ditampilkan.

   Catatan: Drop-down Region hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan region baru, klik Enable Region yang ditampilkan di bagian bawah kotak.

6. Klik Buat untuk membuka editor integrasi.

Menambahkan dan mengonfigurasi pemicu Pub/Sub

Untuk menambahkan pemicu Pub/Sub ke integrasi, ikuti langkah-langkah berikut:

1. Di editor integrasi, pilih Pemicu untuk menampilkan daftar pemicu yang tersedia.

2. Klik dan tempatkan elemen pemicu Pub/Sub ke desainer.

3. Klik elemen Pemicu Pub/Sub di editor integrasi untuk melihat panel konfigurasi pemicu.

4. Tentukan topik yang harus diproses pemicu di kolom Pub/Sub topic dalam format berikut:

   projects/PROJECT_ID/topics/TOPIC_ID
   

   Ganti kode berikut:

• PROJECT_ID: project Google Cloud tempat topik Anda dibuat.

• TOPIC_ID: ID topik Pub/Sub yang Anda buat di Menyiapkan lingkungan.

  Misalnya, jika project Anda bernama my-project dan Anda memberi nama topik gke-notifications, masukkan:

  projects/my-project/topics/gke-notifications
  

  Untuk melihat semua topik yang tersedia di project Google Cloud Anda, lihat kolom Nama topik di Topik. Panel konfigurasi pemicu Pub/Sub akan otomatis mengisi kolom Output Pemicu dengan variabel untuk menyimpan pesan Pub/Sub.

Menambahkan dan mengonfigurasi tugas Pemetaan Data

Tugas Pemetaan Data membantu mengekstrak variabel yang relevan dari notifikasi Pub/Sub. Fungsi ini menggunakan file JSON pesan Pub/Sub sebagai input dan mengekstrak variabel sebagai output.

Untuk mengonfigurasi tugas Pemetaan Data:

1. Pilih Tugas untuk menampilkan daftar tugas yang tersedia.

2. Klik dan tempatkan elemen Pemetaan Data di editor integrasi.

3. Klik tugas Pemetaan Data di desainer untuk membuka panel konfigurasi untuk tugas tersebut.

4. Untuk menambahkan koneksi edge dari pemicu Pub/Sub ke Pemetaan Data, tahan kursor di atas titik kontrol pada pemicu Pub/Sub, lalu tarik garis ke titik kontrol pada tugas Pemetaan Data. Edge menunjukkan alur kontrol dari pemicu Pub/Sub ke tugas Pemetaan Data.

5. Klik Buka Editor Pemetaan Data. Editor Pemetaan Data memungkinkan Anda memetakan variabel input ke variabel output yang dipilih, menggunakan fungsi transformasi yang tersedia. Output kemudian tersedia sebagai variabel untuk tugas atau pemicu integrasi lainnya. Untuk mengetahui informasi selengkapnya tentang variabel di Integrasi Aplikasi, lihat Variabel.

   Untuk tutorial ini, ikuti langkah-langkah berikut untuk membuat pemetaan menggunakan CloudPubSubMessage sebagai input:

   1. Luaskan variabel JSON CloudPubSubMessage dalam daftar Variables dan tarik variabel CloudPubSubMessage.data ke baris Input pertama.
   2. Untuk membuat variabel output baru guna menyimpan nilai data yang ditransformasi, klik baris pertama di kolom Output. Kemudian, lakukan hal berikut:
      1. Di kolom Name, masukkan message_data.
      2. Dari daftar Variable Type, pilih Output from integration.
      3. Dari daftar Jenis Data, pilih String.
      4. Klik Create. Variabel message_data muncul di Output.
   3. Tarik variabel CloudPubSubMessage.attributes dari daftar Variabel ke baris kedua di kolom Input.

   4. Klik baris kedua di kolom Output untuk membuat variabel output baru untuk menyimpan nilai payload JSON dengan atribut cluster. Lengkapi kolom berikut:

      1. Di kolom Name, masukkan attributes.
      2. Dari daftar Jenis Variabel, pilih Tidak ada.
      3. Dari daftar Jenis Data, pilih JSON.

      4. Pilih Masukkan skema JSON dari Opsi skema JSON, lalu tempelkan payload berikut:

         {
           "$schema": "http://json-schema.org/draft-07/schema#",
           "type": "object",
           "properties": {
             "cluster_name": {
               "type": "string"
             },
             "payload": {
               "type": "string"
             },
             "project_id": {
               "type": "string"
             },
             "cluster_location": {
               "type": "string"
             },
             "type_url": {
               "type": "string"
             }
           }
         }
         

      5. Klik Create. Variabel attributes muncul di Output. Pastikan variabel atribut terlihat mirip dengan berikut ini:

         

   5. Klik baris ketiga di kolom Input, lalu pilih attributes.cluster_name dari panel Variables. Anda mungkin perlu mulai mengetik attributes untuk melihat kelima atribut yang ditentukan dari skema yang dimasukkan di langkah sebelumnya.

   6. Klik baris yang sesuai dari kolom Output untuk membuat variabel output baru yang akan menyimpan nilai atribut nama cluster. Lengkapi kolom berikut:

      1. Di kolom Name, masukkan cluster_name.
      2. Dari daftar Variable Type, pilih Output from integration.
      3. Dari daftar Jenis Data, pilih String.
      4. Klik Create. Variabel cluster_name muncul di Output.

   7. Ulangi langkah e dan f untuk project_id, cluster_location, type_url, dan payload.

   8. Tutup Editor Pemetaan Data setelah pemetaan selesai. Setiap perubahan akan otomatis disimpan.

Menambahkan dan mengonfigurasi tugas Transformer Data (Skrip)

Tugas Pengubah Data mengambil variabel yang diekstrak dari tugas Pemetaan Data sebagai input dan mengubahnya menjadi isi pesan untuk penggunaan pengguna akhir.

Untuk mengonfigurasi tugas Data Transformer:

1. Pilih Tugas untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Data Transformer (Script) di editor integrasi.
3. Klik tugas Data Transformer di desainer untuk membuka panel konfigurasi untuk tugas tersebut.
4. Untuk menambahkan koneksi tepi dari tugas Pemetaan Data ke tugas Pengubah Data, tahan kursor di atas titik kontrol pada Pemetaan Data, lalu tarik garis ke titik kontrol pada tugas Pengubah Data. Tepi menunjukkan alur kontrol dari tugas Pemetaan Data ke tugas Pengubah Data.

5. Klik Buka Editor Pengubah Data. Editor Pengubah Data memungkinkan Anda menulis, mengedit, dan mengevaluasi template Jsonnet kustom untuk melakukan pemetaan data dalam integrasi Anda. Output kemudian tersedia sebagai variabel untuk tugas atau pemicu integrasi lainnya. Untuk mengetahui detail selengkapnya tentang tugas pengubah ini, lihat Tugas Pengubah Data. Untuk memulai cepat ini, ikuti langkah-langkah berikut untuk membuat skrip:

   1. Klik Buat di panel kiri Variabel. Tindakan ini akan membuka panel Buat variabel di sebelah kanan. Lengkapi kolom berikut:

      • Nama: Masukkan full_message.
      • Pilih Output from integration di kotak drop-down Variable Type.
      • Pilih String di kotak drop-down Data Type.
      • Klik Create untuk membuat variabel dan menutup panel. Variabel full_message baru akan muncul di daftar Variabel.

   2. Pilih Skrip.

   3. Gunakan contoh skrip berikut sebagai template untuk isi pesan saat notifikasi dikirim dari cluster Anda:

      local message_data = std.extVar("message_data");
      local cluster_name = std.extVar("cluster_name");
      local project_id = std.extVar("project_id");
      local cluster_location = std.extVar("cluster_location");
      local type_url = std.extVar("type_url");
      local payload = std.extVar("payload");
      
      {full_message: "Project ID: " + project_id + "\n" +
                    "Cluster Name: " + cluster_name + "\n" +
                    "Location: " + cluster_location + "\n" +
                    "Event Type: " + type_url + "\n" +
                    "Message: " + message_data + "\n" +
                    "Payload: " + std.manifestJson(std.parseJson(payload))}
      

   4. Tutup Editor Pemetaan Data setelah pemetaan selesai. Setiap perubahan akan disimpan secara otomatis.

Menambahkan dan mengonfigurasi tugas Kirim Email

Untuk mengonfigurasi tugas Kirim Email:

1. Pilih Tugas di editor integrasi untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Kirim Email di editor integrasi.
3. Untuk menambahkan koneksi tepi dari tugas Data Transformer ke tugas Kirim email, tahan kursor di atas titik kontrol pada tugas Data Transformer, lalu tarik garis ke titik kontrol pada tugas Kirim email. Edge menunjukkan alur kontrol dari tugas Data Transformer ke tugas Kirim email.
4. Klik elemen Kirim Email di desainer untuk membuka panel konfigurasi tugas. Tetapkan properti berikut:
   1. Kepada Penerima: Masukkan alamat email. Anda akan menggunakan email ini untuk mengonfirmasi selesainya integrasi.
   2. Subjek: Masukkan GKE Notifications.
   3. Isi dalam Teks Biasa: Pilih variabel full_message yang dibuat sebelumnya dalam tugas Data Transformer.
   4. Opsi lainnya dapat dibiarkan dalam konfigurasi default.

Perubahan pada properti akan disimpan secara otomatis dan kanvas Anda akan terlihat seperti berikut:

Menguji integrasi

Untuk menguji integrasi baru, buka menu navigasi di bagian atas diagram Integration, lalu klik Test. Tindakan ini akan membuka panel di sisi kanan. Anda dapat menggunakan contoh pesan Pub/Sub berikut di bagian Add a json value:

{
  "data": "Node pool projects/my-project/locations/us-central1-c/clusters/cluster-1/nodePools/default-pool is upgrading to version 1.29.1-gke.1589017.",
  "attributes": {
    "cluster_location": "us-central1-c",
    "cluster_name": "cluster-1",
    "payload": "{\"resourceType\":\"NODE_POOL\",\"operation\":\"operation-upgrade\",\"operationStartTime\":\"2024-05-07T20:09:35.528855756Z\",\"currentVersion\":\"1.28.7-gke.1026000\",\"targetVersion\":\"1.29.1-gke.1589017\",\"resource\":\"projects/my-project/locations/us-central1-c/clusters/cluster-1/nodePools/default-pool\"}",
    "project_id": "my-project",
    "type_url": "type.googleapis.com/google.container.v1beta1.UpgradeEvent"
  }
}

Email akan dikirim ke alamat email yang telah Anda konfigurasikan dalam tugas Kirim Email setelah mengklik tombol Uji Integrasi.

Memublikasikan integrasi

Setelah berhasil menguji integrasi ini, klik Publikasikan agar integrasi Anda mulai memproses pesan.

Anda hanya dapat mengedit versi DRAFT integrasi, dan hanya mengeksekusi versi ACTIVE integrasi. Jika Anda ingin mengedit integrasi, klik Aktifkan Pengeditan di halaman desainer integrasi, lalu buat versi draf. Untuk mengetahui informasi selengkapnya, lihat Kunci edit integrasi.

Pembersihan

Agar tidak perlu membayar biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, hapus project yang berisi resource tersebut, atau simpan project dan hapus setiap resource.

Menghapus project

Perhatian: Menghapus project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
• Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Menghapus resource satu per satu

1. Hapus Integrasi Aplikasi Anda.

2. Hapus topik Pub/Sub Anda.

Langkah selanjutnya

• Pelajari jenis notifikasi cluster.
• Lihat dokumentasi Pub/Sub.