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 informasi selengkapnya tentang proxy API, lihat Memahami proxy API dan 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 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, kembalikan 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 dalam Visual Studio Code (VS Code) untuk mengembangkan proxy API dan memverifikasi fungsinya melalui pengujian unit dan manual (misalnya, kirim permintaan dan lihat 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 Membangun proxy API pertama Anda 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 hanya diidentifikasi dengan kumpulan alamat jaringan (URL) yang berbeda. Tujuannya adalah untuk 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 yang sedang diakses oleh aplikasi eksternal saat runtime di lingkungan produksi.

Apigee mendukung jenis deployment berikut di lingkungan:

Jenis Deskripsi
Proxy Kembangkan dan uji proxy API Anda di lingkungan pengembangan Apigee, lalu deploy proxy ke pengujian integrasi dan lingkungan 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 ibarat modul yang mengimplementasikan fungsi pengelolaan terbatas yang spesifik. Kebijakan bersifat yang dirancang agar Anda dapat menambahkan jenis kemampuan pengelolaan umum ke API dengan mudah dan andal. Kebijakan menyediakan fitur seperti keamanan, pembatasan kapasitas, transformasi, dan mediasi kemampuan, sehingga Anda tidak perlu membuat kode dan mengelola fungsi ini sendiri. Anda juga dapat menulis skrip dan kode khusus (seperti aplikasi JavaScript), yang memperluas proxy API fungsionalitasnya dan memungkinkan Anda berinovasi di samping kemampuan pengelolaan dasar yang didukung berdasarkan kebijakan Apigee. Untuk mengetahui informasi selengkapnya tentang kebijakan Apigee, lihat Apa yang dimaksud dengan kebijakan?

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

Mempromosikan ke produksi

Anda dapat memilih tempat untuk men-deploy API. Misalnya, Anda dapat mempromosikan revisi ke lingkungan produksi untuk memungkinkan developer memulai bekerja dengan API Anda. Di saat yang sama, Anda dapat melakukan iterasi beberapa revisi di lingkungan lokal atau pengujian, dengan menambahkan fitur atau kebijakan fine-tuning. Kemudian, jika sudah siap, Anda dapat men-deploy revisi baru ke lingkungan produksi, yang akan menimpa revisi yang ada di lingkungan tersebut. Dengan metode ini, Anda selalu dapat memiliki revisi langsung terhadap API yang tersedia bagi developer, selagi Anda mengembangkan dan menguji fitur baru.

Deployment 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 keamanan, persyaratan keandalan, dan konsistensi terpenuhi, penggunaan umum Apigee API adalah untuk 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 Apigee API.

Mengelola sumber daya lingkungan

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

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

Untuk melakukannya, Anda perlu memastikan bahwa sumber daya tertentu yang terkait dengan setiap lingkungan dikonfigurasikan sedemikian rupa sehingga dapat tetap statis dalam konfigurasi proxy API.

  • Peta nilai kunci (KVM): Jika diberi cakupan lingkungan, Anda harus memastikan bahwa konvensi penamaan digunakan untuk mengaktifkan proxy API untuk menyimpan data tanpa memerlukan perubahan konfigurasi selama promosi. Untuk 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 ServiceInfo: Info layanan dapat menggunakan target yang berbeda bergantung pada lingkungannya, jika misalnya, ServiceInfo di lingkungan pengujian menggunakan layanan demo. Lihat kebijakan ServiceInfo.

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