Membuat alur bersama yang dapat digunakan kembali

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Lihat dokumentasi Apigee Edge.

Catatan: Di lingkungan yang diaktifkan untuk deployment arsip, Anda tidak dapat mengelola alur bersama menggunakan UI, API, atau gcloud Apigee. Untuk mengelola alur bersama untuk deployment arsip menggunakan Apigee di VS Code, lihat juga Mengembangkan alur bersama menggunakan Apigee di VS Code.

Gabungkan kebijakan dan resource ke dalam alur bersama yang dapat Anda gunakan dari beberapa proxy API, dan bahkan dari alur bersama lainnya. Meskipun seperti proxy, alur bersama tidak memiliki endpoint. Kebijakan ini hanya dapat digunakan dari proxy API atau alur bersama yang berada dalam organisasi yang sama dengan alur bersama itu sendiri.

Dengan menangkap fungsi yang berguna di beberapa tempat dalam satu tempat, alur bersama membantu Anda memastikan konsistensi, mempersingkat waktu pengembangan, dan mengelola kode dengan lebih mudah.

Catatan: Video ini direkam dengan UI Apigee versi sebelumnya; namun, konsepnya masih valid.

Video berikut menunjukkan cara membuat dan men-debug alur bersama di UI Apigee.

Anda dapat memanggil alur bersama menggunakan kebijakan FlowCallout. Selain itu, dengan melampirkan alur bersama ke hook alur, Anda dapat membuat alur bersama dijalankan sebelum permintaan proxy atau target, atau setelah respons proxy atau target.

Untuk referensi kebijakan FlowCallout, lihat kebijakan FlowCallout. Untuk mengetahui informasi selengkapnya tentang hook alur, lihat Melampirkan alur bersama menggunakan hook alur.

Misalnya, bayangkan Anda memiliki area fungsi yang digunakan di beberapa tempat atau harus distandardisasi di seluruh API dalam organisasi Anda. Anda dapat memiliki alur bersama untuk setiap kategori, termasuk:

• Keamanan, dengan kode otorisasi menggunakan OAuth dan verifikasi kunci API, serta kode perlindungan dari ancaman.
• Logging, untuk membuat pesan error standar.
• Mediasi, untuk mentransformasi antara format pesan XML dan JSON.

Dalam ilustrasi berikut, dua proxy API melakukan panggilan keluar (dengan kebijakan FlowCallout) ke shared flow untuk mengautentikasi permintaan pengguna yang masuk. AuthSharedFlow telah di-deploy secara terpisah ke organisasi sebelum proxy sehingga tersedia untuk mendukung permintaan dari proxy. Alur bersama dapat dikembangkan dan dikelola oleh tim yang bertanggung jawab atas kebijakan perusahaan secara luas, lalu digunakan dalam proxy oleh tim lini bisnis yang membuat aplikasi yang lebih khusus.

Mengembangkan alur bersama

Catatan: Tangani kesalahan dari dalam proxy API yang memanggil alur bersama Anda, bukan dari dalam alur bersama itu sendiri. Untuk mengetahui informasi selengkapnya, lihat Menangani kesalahan.

Saat mengembangkan alur bersama, Anda harus selalu mengujinya dengan panggilan yang dikirim ke proxy API. Dengan kata lain, Anda tidak dapat mengirim permintaan langsung ke alur bersama seperti yang Anda lakukan pada proxy API. Sebagai gantinya, Anda mengirim permintaan ke proxy API yang, pada gilirannya, memanggil alur bersama.

Berikut langkah-langkah umum untuk mengembangkan alur bersama:

1. Tentukan kumpulan fitur bersama yang harus ada.

   Misalnya, Anda mungkin ingin menggabungkan fitur pengelolaan traffic, termasuk menekan lonjakan traffic. Dengan begitu, Anda dapat mengelola konfigurasinya di luar alur kerja penerapan logika lini bisnis.

2. Kembangkan alur bersama dengan menerapkan kebijakan dan resource pendukung, seperti yang Anda lakukan saat mengembangkan proxy API.

   Alur bersama adalah urutan langkah bersyarat. Jadi, mengembangkan satu proxy sama seperti mengembangkan proxy API. Anda dapat menyertakan kebijakan dan resource yang mungkin Anda sertakan dalam proxy.

   Misalnya, sebagai bagian dari dukungan pengelolaan traffic, Anda dapat menerapkan kebijakan Penghentian Lonjakan untuk mengizinkan hanya 30 permintaan per detik, seperti dalam contoh berikut:

   <SpikeArrest async="false" continueOnError="false" enabled="true" name="Spike-Arrest">
       <DisplayName>Spike Arrest</DisplayName>
       <Properties/>
       <Identifier ref="request.header.some-header-name"/>
       <MessageWeight ref="request.header.weight"/>
       <Rate>30ps</Rate>
   </SpikeArrest>

   Kemudian, ke alur bersama untuk pengelolaan traffic, Anda dapat melampirkan kebijakan Spike Arrest sebagai langkah. Kebijakan akan dijalankan untuk setiap proxy API yang memanggil alur bersama.

   <SharedFlow name="default">
       <Step>
           <Name>Spike-Arrest</Name>
       </Step>
   </SharedFlow>

   Untuk mengetahui informasi tentang cara memulai alur bersama di konsol pengelolaan, lihat Membuat alur bersama di UI Apigee.

   Seperti proxy API, Anda dapat mengimpor file zip yang berisi artefak sumber alur bersama menggunakan Create shared flow API. Berikut ini mengilustrasikan cara mengimpor alur bersama dengan Apigee API:

   curl "https://apigee.googleapis.com/v1/organizations/$ORG/sharedflows?action=import&name=mySharedFlow" \
     -X POST \
     -F "file=@sharedflow.zip" \
     -H "Authorization: Bearer $TOKEN"

   Dengan $TOKEN ditetapkan ke token akses OAuth 2.0 Anda, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk mengetahui deskripsi variabel lingkungan yang dapat Anda gunakan, lihat Menetapkan variabel lingkungan untuk permintaan API Apigee.

3. Deploy alur bersama ke lingkungan sebelum men-deploy proxy atau alur bersama yang akan menggunakannya. Anda men-deploy alur bersama dengan cara yang sama seperti men-deploy proxy API. (Untuk mengetahui informasi selengkapnya, lihat Ringkasan deployment.)

   Alur bersama harus berada di organisasi yang sama dan di-deploy ke lingkungan yang sama dengan proxy API dan alur bersama lainnya yang menggunakannya. Men-deploy alur bersama sebelum proxy memungkinkan untuk menyelesaikan dependensi proxy pada alur bersama pada waktu deployment.

   Anda dapat men-deploy alur bersama dengan panggilan API Apigee seperti berikut:

   curl https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/sharedflows/$SHAREDFLOW/revisions/$REV/deployments \
     -X POST \
     -H "Authorization: Bearer $TOKEN"

   Mirip dengan proxy API, semua deployment alur bersama yang berhasil ke Apigee adalah deployment tanpa periode nonaktif.

4. Kembangkan proxy API yang menggunakan sehingga dapat memanggil alur bersama sebagai bagian dari alur sendiri.

   Dari proxy API, Anda memanggil alur bersama dengan kebijakan FlowCallout. (Anda juga dapat melampirkan alur bersama ke proxy menggunakan flow hook.)

   Untuk menggunakan alur bersama, Anda menambahkan kebijakan FlowCallout ke proxy atau alur bersama yang akan menggunakannya. Seperti kebijakan Info Layanan, yang digunakan untuk memanggil layanan lain, FlowCallout memanggil alur bersama. Proxy API yang menggunakan harus di-deploy setelah alur bersama dan ke lingkungan yang sama dengan alur bersama. Alur bersama harus ada saat Anda ingin menguji panggilan ke alur tersebut menggunakan kebijakan FlowCallout.

   Dalam kode berikut, kebijakan FlowCallout memanggil alur bersama yang disebut traffic-management-shared.

   <FlowCallout async="false" continueOnError="false" enabled="true" name="Traffic-Management-Flow-Callout">
       <DisplayName>Traffic Management FlowCallout</DisplayName>
       <Properties/>
       <SharedFlowBundle>traffic-management-shared</SharedFlowBundle>
   </FlowCallout>

   Untuk mengetahui informasi selengkapnya, lihat Memanggil alur bersama dari proxy API atau alur bersama

5. Deploy proxy API yang menggunakan untuk mulai menggunakan alur bersama. (Untuk mengetahui informasi selengkapnya tentang deployment secara umum, lihat Ringkasan deployment.)
6. Kembangkan secara berulang dengan men-debug, seperti yang Anda lakukan dengan proxy API.

   Seperti proxy API, Anda mengembangkan alur bersama dengan memanggil dan men-debug secara berulang hingga Anda mendapatkan logika yang diinginkan. Dalam hal ini, karena alur bersama tidak berjalan dengan sendirinya, Anda memanggil endpoint proxy dan men-debug proxy.

   Sebelum memulai langkah-langkah berikut, pastikan alur bersama dan proxy API yang memanggilnya dengan kebijakan FlowCallout berada di organisasi yang sama dan di-deploy ke lingkungan yang sama.

   Apigee di Konsol Cloud

   1. Di tab Debug proxy API, mulai debug proxy API.
   2. Kirim permintaan ke endpoint proxy di proxy API. Alur dari endpoint harus mencakup kebijakan FlowCallout yang memanggil alur bersama.
   3. Di tab Debug, periksa alur dari proxy API ke alur bersama. (Untuk mengetahui informasi selengkapnya tentang proses debug, lihat Alat debug.)

   Apigee Klasik

   1. Pada tab Trace proxy API, mulai lacak proxy API.
   2. Kirim permintaan ke endpoint proxy di proxy API. Alur dari endpoint harus mencakup kebijakan FlowCallout yang memanggil alur bersama.
   3. Di tab Trace, periksa alur dari proxy API ke alur bersama.

      Perhatikan bahwa dalam pelacakan, alur bersama ditampilkan sebagai serangkaian langkah atau kebijakan yang berada dalam kotak abu-abu. Ikon yang mewakili kebijakan FlowCallout mendahului alur bersama. (Untuk mengetahui informasi selengkapnya tentang pelacakan, lihat Alat debug.)

      

Membuat alur bersama di UI Apigee

Saat menggunakan Apigee API untuk membuat shared flow, Anda dapat membuatnya dari awal atau dengan mengimpor sumber flow yang ada sebagai file ZIP paket flow.

Akses halaman Shared Flows, seperti yang dijelaskan di bawah. Di halaman Alur Bersama, Anda dapat melihat daftar alur bersama dalam organisasi, dan mengedit atau menghapus alur dalam daftar.

Untuk membuat alur bersama di UI Apigee:

Apigee di Konsol Cloud

1. Di konsol Google Cloud , buka halaman Proxy development > Shared flows.

   Buka Alur bersama

2. Pilih organisasi yang berisi alur bersama Anda. Lihat Beralih antar-organisasi Anda.

   Alur bersama akan tersedia untuk semua proxy API dan alur bersama yang di-deploy ke lingkungan dari organisasi ini. Aplikasi tidak akan tersedia dari luar organisasi ini.

3. Membuat atau mengupload alur bersama:
   • Klik Buat untuk membuat alur baru dari awal. Anda akan dapat mengonfigurasi kebijakan dan resource sebagai langkah dalam alur.

     Dialog Create a Shared Flow akan ditampilkan.

     1. Masukkan nama alur bersama.

        Nama ini akan digunakan oleh proxy API dan alur bersama lainnya untuk mereferensikan alur bersama ini. Nama harus deskriptif bagi developer yang menggunakan alur.

     2. Masukkan deskripsi untuk memberikan informasi selengkapnya tentang fungsi alur.
     3. Jika organisasi Anda telah mengaktifkan Apigee Spaces, Anda dapat mengaitkan alur bersama dengan Ruang yang dipilih dari daftar opsi yang tersedia. Untuk mengetahui informasi selengkapnya, lihat Ringkasan Ruang Apigee.
     4. Klik Buat.

        Alur bersama dibuat.

     5. Selanjutnya, Anda dapat mengembangkan fitur alur bersama dan men-deploy-nya ke lingkungan yang diinginkan.
   • Klik Upload paket untuk membuat alur bersama dari sumber yang ada dengan mengupload paket alur.

     Paket alur bersama berisi artefak sumber alur bersama. Misalnya, jika Anda mendownload alur bersama dari konsol Apigee, Anda akan memiliki file zip dengan paket alur.

     Dialog Create a Shared Flow akan ditampilkan.

     1. Pilih file zip yang berisi artefak yang Anda inginkan dalam alur baru.
     2. Klik Buka.
     3. Masukkan nama untuk alur bersama yang diimpor.

        Nama ini akan menjadi nama yang digunakan proxy API dan alur bersama lainnya untuk mereferensikan alur bersama ini. Nama harus deskriptif bagi developer yang menggunakan alur.

     4. Klik Buat.

        Alur bersama dibuat dari paket.

     5. Selanjutnya, Anda dapat mengembangkan fitur alur bersama dan men-deploy-nya ke lingkungan yang diinginkan.

Apigee Klasik

1. Login ke UI Apigee.
2. Pilih organisasi yang berisi alur bersama Anda. Lihat Beralih antar-organisasi Anda.

   Alur bersama akan tersedia untuk semua proxy API dan alur bersama yang di-deploy ke lingkungan dari organisasi ini. Aplikasi tidak akan tersedia dari luar organisasi ini.

3. Pilih Develop > Shared Flows di menu navigasi sebelah kiri.
4. Membuat atau mengupload alur bersama:
   • Klik Buat Baru untuk membuat alur baru dari awal. Anda akan dapat mengonfigurasi kebijakan dan resource sebagai langkah dalam alur.

     Dialog Create a Shared Flow akan ditampilkan.

     1. Masukkan nama alur bersama.

        Nama ini akan digunakan oleh proxy API dan alur bersama lainnya untuk mereferensikan alur bersama ini. Nama harus deskriptif bagi developer yang menggunakan alur.

     2. Masukkan deskripsi untuk memberikan informasi selengkapnya tentang fungsi alur.
     3. Jika organisasi Anda telah mengaktifkan Apigee Spaces, Anda dapat mengaitkan alur bersama dengan Ruang yang dipilih dari daftar opsi yang tersedia. Untuk mengetahui informasi selengkapnya, lihat Ringkasan Ruang Apigee.
     4. Klik Buat.

        Alur bersama dibuat.

     5. Selanjutnya, Anda dapat mengembangkan fitur alur bersama dan men-deploy-nya ke lingkungan yang diinginkan.
   • Klik Upload paket untuk membuat alur bersama dari sumber yang ada dengan mengupload paket alur.

     Paket alur bersama berisi artefak sumber alur bersama. Misalnya, jika Anda mendownload alur bersama dari UI Apigee, Anda akan mendapatkan file zip dengan paket alur.

     Dialog Create a Shared Flow akan ditampilkan.

     1. Pilih file zip yang berisi artefak yang Anda inginkan dalam alur baru.
     2. Klik Buka.
     3. Masukkan nama untuk alur bersama yang diimpor.

        Nama ini akan menjadi nama yang digunakan proxy API dan alur bersama lainnya untuk mereferensikan alur bersama ini. Nama harus deskriptif bagi developer yang menggunakan alur.

     4. Klik Buat.

        Alur bersama dibuat dari paket.

     5. Selanjutnya, Anda dapat mengembangkan fitur alur bersama dan men-deploy-nya ke lingkungan yang diinginkan.

Memanggil alur bersama dari proxy API atau alur bersama

Anda dapat memanggil alur bersama dari proxy atau dari alur bersama lain menggunakan kebijakan FlowCallout.

Apigee di Konsol Cloud

1. Lakukan salah satu tindakan berikut:

   • Di konsol Google Cloud , buka halaman Proxy development > API proxies.

     Buka proxy API

   • Di konsol Google Cloud , buka halaman Proxy development > Shared flows.

     Buka Alur bersama

2. Klik tab Mengembangkan.
3. Di panel navigasi, di samping Kebijakan, klik .
4. Dalam daftar kebijakan, di bagian Ekstensi, pilih FlowCallout.
5. Masukkan nama tampilan dan nama (ID unik), lalu pilih alur bersama yang akan dipanggil oleh kebijakan ini.
6. Klik Buat.
7. Klik di samping Simpan, lalu klik Simpan sebagai revisi baru.

Apigee Klasik

1. Di UI Apigee, buka proxy API atau alur bersama yang ingin Anda gunakan untuk memanggil alur bersama.
2. Klik tab Mengembangkan.
3. Di Navigator, di samping Kebijakan, klik +.
4. Dalam daftar kebijakan, di bagian Ekstensi, klik FlowCallout.
5. Masukkan nama tampilan dan nama (ID unik), lalu pilih alur bersama yang akan dipanggil oleh kebijakan ini.
6. Klik Tambahkan.

Lihat juga

Menautkan proxy API bersama-sama