Siklus proses pengembangan API

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Baca dokumentasi Apigee Edge.

Bagian berikut merangkum siklus proses pengembangan API menggunakan Apigee.

Mengembangkan proxy API

Apigee mendukung opsi berikut untuk pengembangan proxy API iteratif:

Untuk mengetahui informasi selengkapnya tentang proxy API, lihat Memahami API dan proxy API.

Pengembangan cloud menggunakan Apigee

Kembangkan proxy API Anda menggunakan alat pengeditan dan proses debug proxy API yang disediakan dengan Apigee. Saat Anda mengerjakan proxy API, Apigee akan menyimpan iterasi konfigurasi Anda sebagai revisions.

Saat men-deploy proxy API, Anda memilih revisi tertentu untuk di-deploy. Biasanya, Anda men-deploy revisi terbaru, dan, jika perlu, kembali ke revisi sebelumnya. Lihat Men-deploy proxy API.

Untuk mulai mengembangkan proxy API menggunakan Apigee, lihat Mem-build proxy API sederhana.

Pengembangan lokal menggunakan Apigee di VS Code

Gunakan Apigee di Visual Studio Code (VS Code) untuk mengembangkan proxy API dan memverifikasi fungsinya melalui pengujian unit dan manual (misalnya, mengirim permintaan dan melihat hasilnya).

Setelah menyelesaikan validasi lokal, deploy konfigurasi proxy API sebagai arsip ke lingkungan Apigee Anda. Lihat Men-deploy proxy API.

Untuk mulai mengembangkan proxy API secara lokal menggunakan Apigee di VS Code, lihat Mem-build proxy API pertama Anda menggunakan Apigee di VS Code.

Men-deploy proxy API

Anda membuat lingkungan untuk men-deploy proxy API. Perbedaan antara berbagai lingkungan bersifat arbitrer — setiap lingkungan hanya diidentifikasi oleh kumpulan alamat jaringan (URL) yang berbeda. Tujuannya adalah untuk memberi Anda domain tempat Anda dapat mem-build dan memverifikasi proxy API sebelum API diekspos ke developer eksternal. Untuk mengetahui informasi selengkapnya, lihat Tentang lingkungan dan grup lingkungan.

Dengan men-deploy API ke beberapa lingkungan, Anda dapat memisahkan traffic antara proxy API yang sedang Anda kerjakan di lingkungan pengujian, dan yang diakses oleh aplikasi eksternal saat runtime di lingkungan produksi.

Apigee mendukung jenis deployment berikut di lingkungan:

Jenis Deskripsi
Proxy Kembangkan dan uji proxy API di lingkungan pengembangan Apigee, lalu deploy ke lingkungan produksi dan pengujian integrasi Apigee. Lihat Men-deploy proxy API.
Arsipkan Kembangkan dan uji proxy API yang dapat diprogram menggunakan Apigee di VS Code.

Menambahkan kebijakan

Apigee memungkinkan Anda memprogram perilaku API tanpa menulis kode apa pun, dengan menggunakan kebijakan. Kebijakan seperti modul yang menerapkan fungsi pengelolaan tertentu dan terbatas. Kebijakan dirancang agar Anda dapat menambahkan jenis kemampuan pengelolaan umum ke API dengan mudah dan andal. Kebijakan menyediakan fitur seperti kemampuan keamanan, pembatasan kapasitas, transformasi, dan mediasi, sehingga Anda tidak perlu membuat kode dan mengelola fungsi ini sendiri. Anda juga dapat menulis skrip dan kode kustom (seperti aplikasi JavaScript), yang memperluas fungsi proxy API dan memungkinkan Anda berinovasi di atas kemampuan pengelolaan dasar yang didukung oleh kebijakan Apigee. Untuk informasi selengkapnya tentang kebijakan Apigee, lihat Apa yang dimaksud dengan kebijakan?

Apigee menyediakan kebijakan siap pakai untuk berbagai fitur seperti kebijakan pengelolaan traffic, keamanan, mediasi, dan ekstensi. Untuk melihat daftar lengkap kebijakan yang tersedia di Apigee, lihat Ringkasan referensi kebijakan.

Mempromosikan ke produksi

Anda memilih tempat untuk men-deploy API. Misalnya, Anda dapat mempromosikan revisi ke lingkungan produksi agar developer dapat mulai menggunakan API Anda. Pada saat yang sama, Anda mungkin melakukan iterasi beberapa revisi di lingkungan lokal atau pengujian, tempat Anda menambahkan fitur atau menyesuaikan kebijakan. Kemudian, jika sudah siap, Anda dapat men-deploy revisi baru ke lingkungan produksi, yang akan menimpa revisi yang ada di lingkungan tersebut. Dengan menggunakan metode ini, Anda selalu dapat menyediakan revisi live API untuk developer saat mengembangkan dan menguji fitur baru.

Men-deploy skrip menggunakan Apigee API

Apigee menyediakan RESTful API yang memungkinkan Anda mengintegrasikan deployment dan pengelolaan proxy API ke dalam siklus proses pengembangan software (SDLC) organisasi Anda. Misalnya, untuk memastikan bahwa persyaratan keamanan, keandalan, dan konsistensi terpenuhi, penggunaan umum Apigee API adalah menulis skrip atau kode yang men-deploy proxy API secara terprogram dan mempromosikannya dari satu lingkungan ke lingkungan lain, sebagai bagian dari proses otomatis yang lebih besar.

Untuk informasi selengkapnya, lihat Apigee API.

Mengelola resource lingkungan

Lingkungan menyediakan pemisahan data dan resource. Misalnya, Anda dapat menyiapkan cache yang berbeda di lingkungan test dan production yang hanya dapat diakses oleh proxy API yang dijalankan di lingkungan tersebut. Selain itu, kunci API yang diterbitkan di lingkungan pengujian tidak valid di lingkungan produksi, dan sebaliknya.

Untuk kontrol tambahan selama promosi, sebaiknya Anda hanya melakukan iterasi pada proxy API di lingkungan pengujian, dan membuat perubahan seminimal mungkin pada proxy API yang di-deploy di lingkungan produksi.

Untuk melakukannya, Anda harus memastikan bahwa resource tertentu yang terkait dengan setiap lingkungan dikonfigurasi sedemikian rupa sehingga dapat tetap statis dalam konfigurasi proxy API.

  • Key value map (KVM): Jika dicakup ke lingkungan, Anda harus memastikan bahwa konvensi penamaan digunakan untuk memungkinkan proxy API menyimpan data tanpa memerlukan perubahan konfigurasi selama promosi. Untuk mengetahui informasi selengkapnya, lihat Menggunakan peta nilai kunci.
  • URL Target: Proxy API biasanya memanggil URL backend yang berbeda selama pengujian dan produksi. Anda dapat menggunakan konfigurasi TargetServer untuk membuat konfigurasi TargetEndpoint yang tidak bergantung pada lingkungan. Untuk informasi selengkapnya, lihat
  • Target ServiceCallout: Info layanan dapat menggunakan target yang berbeda bergantung pada lingkungan, misalnya, jika ServiceCallout di lingkungan pengujian menggunakan layanan demo. Lihat kebijakan ServiceCallout.

Agar konfigurasi proxy API tidak bergantung pada lingkungan, Anda juga dapat menggunakan pernyataan kondisional. Pernyataan kondisional yang dibuat dengan variabel environment.name dapat digunakan untuk mengevaluasi lingkungan saat ini sebelum menerapkan kebijakan atau sebelum merutekan ke URL di backend. Untuk mengetahui informasi selengkapnya, lihat Kondisi dengan variabel alur.