Membangun CICD untuk integrasi Anda

Tutorial ini menjelaskan cara mengotomatiskan promosi integrasi antara lingkungan yang berbeda dalam project Google Cloud yang berbeda menggunakan variabel config (pratinjau).

Catatan: Anda tidak dapat menggunakan variabel konfigurasi untuk mengonfigurasi operasi dan tindakan entitas untuk konektor.

Tips: Untuk mempelajari cara menyimpan aset integrasi dan konektor ke repositori kode sumber, mempromosikan perubahan di seluruh lingkungan, dan cara otomatisasi deployment tersebut, lihat blog CICD for Application Integration.

Ringkasan

Dalam tutorial ini, Anda akan mengotomatiskan deployment Application Integration menggunakan variabel config untuk integrasi contoh. Alur integrasi contoh ini memanggil API dan memublikasikan respons dari API ke topik Pub/Sub. Contoh ini dimaksudkan untuk mengilustrasikan penggunaan tugas Call REST Endpoint dan Connectors. Anda dapat menyimpan integrasi contoh di repositori GitHub yang sesuai dengan lingkungan dan project Google Cloud yang berbeda.

Membuat topik Pub/Sub

1. Di konsol Google Cloud , buka halaman Topics Pub/Sub.

   Buka Topik

2. Klik Create topic.

3. Di kolom Topic ID, masukkan ID untuk topik Anda. Untuk mengetahui informasi selengkapnya tentang penamaan topik, lihat Panduan untuk menamai topik, langganan, skema, atau snapshot.

4. Tetapkan opsi Tambahkan langganan default.

5. Jangan pilih opsi lainnya.

6. Klik Create topic.

Mengonfigurasi konektor Pub/Sub

1. Di konsolGoogle Cloud , buka halaman Integration Connectors > Connections lalu pilih atau buat project Google Cloud .

   Buka halaman Koneksi

2. Klik + Buat Baru untuk membuka halaman Buat Koneksi.
3. Di bagian Location, pilih lokasi untuk koneksi.
   1. Region: Pilih lokasi dari menu drop-down.

      Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.

   2. Klik NEXT.
4. Di bagian Detail Koneksi, selesaikan langkah-langkah berikut:
   1. Konektor: Pilih Pub/Sub dari daftar drop-down Konektor yang tersedia.
   2. Versi konektor: Pilih Versi konektor dari menu drop-down daftar versi yang tersedia.
   3. Di kolom Connection Name, masukkan pub-sub-connector.
   4. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
   5. Project ID: Google Cloud project ID tempat instance Pub/Sub berada.
   6. ID topik: Masukkan nama topik Pub/Sub Anda.
   7. Klik Berikutnya.
5. Di bagian Authentication, klik NEXT.
6. Tinjau: Tinjau detail koneksi dan autentikasi Anda.
7. Klik Buat.

Membuat integrasi baru

Setelah Menyiapkan Integrasi Aplikasi, Anda dapat membuat integrasi baru:

1. Di konsol Google Cloud, buka halaman Application Integration.

   Buka Application Integration

2. Klik Integrations dari menu navigasi sebelah kiri untuk membuka halaman Integrations.
3. Klik Buat integrasi dan berikan detail berikut di halaman Buat Integrasi:
   1. Nama integrasi: Masukkan nama untuk integrasi Anda. Contoh, build-cicd.
   2. Deskripsi: Masukkan deskripsi untuk integrasi Anda (opsional). Contoh, Demo integration created for CICD tutorial.
   3. Wilayah: Pilih wilayah us-central1 dari daftar wilayah yang disediakan. Jika region yang ingin Anda pilih tidak disediakan, lihat Menyediakan region baru. Untuk melihat daftar region yang didukung, lihat Lokasi Integrasi Aplikasi.
   4. Akun layanan: Kolom ini muncul jika Anda telah mengaktifkan tata kelola untuk wilayah Anda. Pilih akun layanan untuk integrasi Anda. Untuk mempelajari cara mengaktifkan tata kelola untuk wilayah Anda, lihat Mengedit wilayah.
   5. Klik Buat. Tindakan ini akan membuka halaman editor integrasi tempat Anda dapat menambahkan tugas dan pemicu untuk membuat integrasi.

Membuat alur integrasi

Menambahkan pemicu API dan Call REST Endpoint

Untuk menambahkan pemicu pemicu API, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Integrations.

   Halaman Integrations List akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi build-cicd.

   Tindakan ini akan membuka integrasi di editor integrasi.

4. Di panel navigasi editor integrasi, klik Pemicu > Pemicu API untuk menambahkan pemicu.
5. Di kolom navigasi editor integrasi, klik Tasks > Call REST Endpoint untuk menambahkan tugas.
6. Tambahkan koneksi edge dari elemen Pemicu API ke elemen Panggil Endpoint REST dengan mengarahkan kursor ke titik kontrol pada elemen Pemicu API, lalu mengklik dan menarik garis ke titik kontrol pada elemen tugas Panggil Endpoint REST.

Buat variabel konfigurasi

Untuk membuat variabel konfigurasi, ikuti langkah-langkah berikut:

1. Di panel navigasi editor integrasi, klik (Beralih panel) untuk menampilkan panel Variabel.
2. Klik +Create.
3. Lakukan hal berikut di panel Create Variable:
   1. Untuk Name, masukkan url.

      Integrasi Aplikasi menambahkan awalan `CONFIG_ ke variabel konfigurasi. Jika Anda ingin menambahkan variabel konfigurasi ke integrasi menggunakan API, gunakan format berikut untuk variabel konfigurasi: `CONFIG_CONFIG_VARIABLE_NAME`. Untuk mengetahui informasi tentang cara mendownload dan mengupload integrasi, lihat Mengupload dan mendownload integrasi.

   2. Untuk Jenis variabel, pilih Variabel Konfigurasi.
   3. Untuk Jenis data, pilih String.
   4. Klik Buat.

      Variabel konfigurasi akan muncul di panel Variabel.

4. Ulangi Langkah 2 dan 3 untuk menambahkan variabel konfigurasi berikut:
   • Nama: connection_name
   • Jenis variabel: Config Variable
   • Jenis data: String

Menambahkan dan mengonfigurasi Call REST Endpoint

Untuk membuat variabel config, ikuti langkah-langkah berikut:

1. Di editor integrasi, klik tugas Call REST Endpoint untuk membuka panel konfigurasi tugas. Kemudian, lakukan hal berikut:
   1. Luaskan bagian Input tugas.
   2. Di Endpoint base URL, klik Variable, lalu tambahkan $`CONFIG_url`$.

Menambahkan dan mengonfigurasi tugas Konektor

1. Di panel navigasi editor integrasi, klik Task > Connectors.
2. Klik Configure Connectors.
3. Dari daftar Region, pilih region tempat Anda membuat konektor Pub/Sub.
4. Di kolom Connection, pilih Pub/Sub connector yang Anda buat pada langkah sebelumnya.
5. Di bagian Jenis, pilih Tindakan.
6. Di bagian Setel entitas/tindakan, untuk Tindakan, pilih publishMessage.
7. Di Nilai default, tambahkan nilai default untuk variabel konfigurasi.
8. Klik Buat.
9. Di panel konfigurasi tugas Connectors, perluas bagian Connection details untuk memperbarui kolom berikut:
   1. Di kolom Connection name, klik Variable, lalu pilih $`CONFIG_connection_name`$.

Menambahkan tugas Pemetaan Data

1. Di panel navigasi editor integrasi, klik Tugas > Pemetaan data.
2. Tambahkan koneksi tepi dari elemen Call REST Endpoint ke elemen Data Mapping dengan mengarahkan kursor ke titik kontrol pada elemen Call REST Endpoint, lalu mengklik dan menarik garis ke titik kontrol pada elemen tugas Data Mapping.
3. Tambahkan koneksi tepi lain dari elemen Pemetaan Data ke elemen Konektor dengan mengarahkan kursor ke titik kontrol pada elemen Pemetaan Data, lalu mengklik dan menarik garis ke titik kontrol pada elemen tugas Konektor.
4. Di panel konfigurasi tugas Pemetaan Data, klik Buka Editor Pemetaan Data.
5. Petakan variabel output tugas Call REST Endpoint ke variabel input tugas Connectors.

Memublikasikan integrasi

Untuk memublikasikan integrasi, ikuti langkah-langkah berikut:

1. Untuk memublikasikan integrasi, klik Publikasikan di toolbar editor integrasi.

   Dialog Publish integration akan muncul.

2. Dalam dialog Publish integration, masukkan nilai untuk variabel konfigurasi berikut:
   1. url: Masukkan nama URL endpoint.
   2. connection_name: Masukkan nama konektor Pub/Sub yang Anda buat di langkah sebelumnya.
3. Klik Publikasikan.
4. Setelah berhasil memublikasikan integrasi, Anda dapat melihat dan memeriksa log eksekusi integrasi yang dipublikasikan. Untuk melihat log, klik Log di toolbar editor integrasi.

Mempromosikan integrasi di seluruh lingkungan

Untuk mempromosikan integrasi di seluruh lingkungan, Anda dapat menggunakan alat integrationcli, yang merupakan alat open source yang memungkinkan Anda berinteraksi dengan Application Integration API dan Integration Connectors API. Alat ini memungkinkan Anda mengelola entitas integrasi seperti integrasi, konfigurasi autentikasi, dan sebagainya. Untuk mengetahui informasi tentang cara membuat struktur untuk integrasi dan menerapkan perubahan yang dihasilkan oleh struktur, lihat Pengantar integrationcli di blog komunitas.

Anda juga dapat mempromosikan perubahan di seluruh lingkungan dengan menyiapkan pipeline DevOps, misalnya, dengan menggunakan Jenkins, GitLab, Cloud Build, dan sebagainya. Untuk mengetahui informasi selengkapnya, lihat Integrasi dengan Cloud Build.

Jika tidak ingin menggunakan integrationcli, Anda dapat mendownload dan mengupload integrasi secara manual ke project baru. Anda harus membuat konektor di project baru secara manual karena saat ini konektor tidak dapat didownload. Saat Anda memublikasikan integrasi di lingkungan baru, Application Integration memungkinkan Anda memasukkan nilai untuk variabel konfigurasi.

Langkah berikutnya

• Pelajari integrasi contoh di GitHub.
• Pelajari lebih lanjut variabel konfigurasi.
• Pelajari alat integrationcli lebih lanjut.