Siklus proses pengembangan API

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Lihat 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 pen-debug-an proxy API yang disediakan bersama Apigee. Saat Anda mengerjakan proxy API, Apigee menyimpan iterasi konfigurasi Anda sebagai revisi.

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 Membangun proxy API sederhana.

Pengembangan lokal menggunakan Apigee di VS Code

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

Setelah Anda 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 Membangun proxy API pertama menggunakan Apigee di VS Code.

Men-deploy proxy API

Anda membuat lingkungan tempat men-deploy proxy API. Perbedaan antara lingkungan yang berbeda bersifat arbitrer — setiap lingkungan diidentifikasi hanya dengan sekumpulan alamat jaringan (URL) yang berbeda. Tujuannya adalah memberi Anda domain tempat Anda dapat membangun 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 proxy API 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 pengujian integrasi dan produksi 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 untuk memungkinkan Anda menambahkan jenis kemampuan pengelolaan umum ke API dengan mudah dan andal. Kebijakan menyediakan fitur seperti keamanan, pembatasan kapasitas, transformasi, dan kemampuan mediasi, sehingga Anda tidak perlu membuat kode dan memelihara 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 mengetahui informasi selengkapnya tentang kebijakan Apigee, lihat Apa itu kebijakan?

Apigee menyediakan kebijakan siap pakai untuk berbagai fitur seperti pengelolaan traffic, keamanan, mediasi, dan kebijakan 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 dapat 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, menggantikan revisi yang ada di lingkungan tersebut. Dengan metode ini, Anda selalu dapat menyediakan revisi API aktif untuk developer saat Anda 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 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 mengetahui informasi selengkapnya, lihat API Apigee.

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 dikeluarkan 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 melakukan perubahan sesedikit 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.

  • Peta nilai kunci (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 independen terhadap lingkungan. Untuk informasi selengkapnya, lihat
  • Target ServiceCallout: Panggilan layanan dapat menggunakan target yang berbeda, bergantung pada lingkungan. Misalnya, ServiceCallout di lingkungan pengujian menggunakan layanan demo. Lihat kebijakan ServiceCallout.

Untuk membuat konfigurasi proxy API tidak bergantung pada lingkungan, Anda juga dapat menggunakan pernyataan bersyarat. Pernyataan bersyarat 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.