Menguji dan memublikasikan integrasi
Anda dapat menguji atau memublikasikan integrasi dari editor integrasi setelah menambahkan dan mengonfigurasi integrasi dengan koneksi pemicu, tugas, dan edge yang diperlukan. Saat Anda menguji integrasi menggunakan konsol Google Cloud , integrasi akan dijalankan dalam mode sinkron.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk menguji atau memublikasikan integrasi, minta administrator untuk memberi Anda peran IAM berikut pada project:
-
Menguji integrasi:
Application Integration Invoker (
roles/integrations.integrationInvoker) -
Memublikasikan integrasi:
Application Integration Deployer (
roles/integrations.integrationDeployer)
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk menguji atau memublikasikan integrasi. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk menguji atau memublikasikan integrasi:
-
Menguji integrasi:
integrations.integrations.invoke -
Publikasikan integrasi:
integrations.integrationVersions.deploy
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Peran Application Integration Editor (roles/integrations.integrationEditor)
berisi kedua izin tersebut.
Jika integrasi menggunakan akun layanan run-as, Anda juga memerlukan peran Service Account User
(roles/iam.serviceAccountUser) di akun layanan tersebut untuk menguji atau memublikasikannya.
Lihat Memberikan Service Account User.
Menguji integrasi
Jika ingin, Anda dapat memverifikasi bahwa integrasi berfungsi sebagaimana mestinya dengan mengujinya sebelum memublikasikan. Menguji integrasi memungkinkan Anda bereksperimen dengan nilai variabel input integrasi, dan membantu mengidentifikasi kesalahan dalam alur koneksi integrasi.
Untuk menguji coba integrasi, pilih salah satu opsi berikut:
Konsol
- Di konsol Google Cloud, buka halaman Application Integration.
- Klik Integrations dari menu navigasi kiri untuk membuka halaman Integrations.
- Pilih integrasi yang ingin Anda uji.
- Di menu navigasi desainer, klik Test.
Jika Anda memiliki beberapa pemicu yang dikonfigurasi dalam integrasi, pilih pemicu yang ingin Anda gunakan untuk menjalankan pengujian integrasi. Panel Test Integration akan muncul.
- Klik Test integration.
Application Integration akan menjalankan integrasi dan menampilkan hasil eksekusi di panel Test Integration:
- Untuk mengedit variabel input, klik Edit variabel input.
- Untuk menguji ulang integrasi, klik Retest integration.
- Untuk memulihkan nilai, klik Pulihkan nilai.
- Untuk melihat dan memeriksa log eksekusi dari pengujian yang dijalankan, klik View logs.
- Jika Anda telah mengaktifkan Cloud Logging, klik View Cloud logs untuk melihat log di Cloud Logging.
- Untuk mengedit integrasi tanpa membuat versi baru integrasi, klik Edit integration.
- Untuk menutup operasi pengujian dan kembali ke editor integrasi, klik Close.
API
Panggil metode projects.locations.integrations.test.
Kolom clientId dalam isi permintaan wajib diisi. Tetapkan ke nomor project Google Cloud Anda, bukan project ID.
Untuk menetapkan waktu tunggu flow, tetapkan kolom X-Server-Timeout di header. Secara default, waktu tunggunya adalah 120 detik. Untuk mengetahui daftar kumpulan parameter permintaan yang telah ditentukan, lihat Parameter sistem.
Memublikasikan integrasi
Memublikasikan versi integrasi akan men-deploy versi integrasi tersebut, dan menempatkannya dalam status aktif. Setiap versi integrasi yang dipublikasikan sebelumnya akan otomatis dibatalkan publikasinya, dan semua layanan yang mengandalkan versi integrasi yang dipublikasikan sebelumnya akan otomatis menggunakan versi terbaru yang dipublikasikan.
Untuk memublikasikan integrasi, pilih salah satu opsi berikut:
Konsol
- Di konsol Google Cloud, buka halaman Application Integration.
- Klik Integrations dari menu navigasi kiri untuk membuka halaman Integrations.
- Pilih integrasi yang ingin Anda publikasikan.
- Di menu navigasi desainer, klik dropdown Version, lalu pilih versi integrasi yang ingin Anda publikasikan.
- Klik Publikasikan.
Dialog Autogenerate Integration description akan muncul. Jika Anda ingin membuat deskripsi, klik Ya, lanjutkan. Jika tidak, klik Tidak, publikasikan saja.
Setelah berhasil memublikasikan integrasi, Anda dapat melihat dan memeriksa log eksekusi integrasi yang dipublikasikan. Untuk melihat log, klik Logs di toolbar editor integrasi.
Secara default, Application Integration mengunci integrasi agar tidak dapat diedit saat dipublikasikan. Untuk melakukan perubahan pada integrasi yang dipublikasikan, klik Enable editing di editor integrasi. Mengedit integrasi yang dipublikasikan akan membuat versi baru dari integrasi tersebut.
API
Panggil metode projects.locations.integrations.versions.publish.
Membatalkan publikasi integrasi
Membatalkan publikasi versi integrasi yang aktif akan membatalkan deployment versi integrasi tersebut, dan menempatkannya dalam status snapshot. Semua layanan yang mengandalkan versi integrasi yang dipublikasikan akan otomatis dihentikan.
Untuk membatalkan publikasi integrasi, pilih salah satu opsi berikut:
Konsol
- Di konsol Google Cloud, buka halaman Application Integration.
- Klik Integrations dari menu navigasi kiri untuk membuka halaman Integrations.
- Pilih integrasi yang ingin Anda batalkan publikasinya.
- Di menu navigasi desainer, klik dropdown Version, lalu pilih versi integrasi yang ingin Anda batalkan publikasinya.
- Klik Batalkan publikasi.
Setelah integrasi berhasil dibatalkan publikasinya, Anda dapat mengklik Enable editing di editor integrasi untuk mengedit integrasi. Mengedit integrasi akan membuat versi baru dari integrasi tersebut.
API
Panggil metode projects.locations.integrations.versions.unpublish.
Kuota dan batas
Untuk mengetahui informasi tentang kuota dan batas Application Integration, lihat Kuota dan batas.
Praktik terbaik
- Tentukan kegunaan variabel (variabel input atau variabel output) sebelum menguji integrasi Anda. Lihat Variabel integrasi.
- Tentukan penanganan error untuk integrasi Anda.
Kuota dan batas
Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.