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 berulang:

Untuk 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 bersama Apigee. Saat Anda mengerjakan proxy API, Apigee menyimpan iterasi konfigurasi sebagai revisi.

Saat men-deploy proxy API, Anda memilih revisi tertentu untuk di-deploy. Biasanya, Anda men-deploy revisi terbaru, dan, jika perlu, mengembalikan 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 Kode Visual Studio (VS Code) untuk mengembangkan proxy API dan memverifikasi fungsi melalui pengujian unit dan manual (misalnya, mengirim permintaan dan melihat hasilnya).

Setelah menyelesaikan validasi lokal, deploy konfigurasi proxy API Anda sebagai arsip ke lingkungan Apigee. 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 menerapkan proxy API. Perbedaan antara lingkungan yang berbeda bersifat tidak tentu — setiap lingkungan hanya diidentifikasi oleh 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 traffic yang diakses oleh aplikasi eksternal saat runtime di lingkungan produksi.

Apigee mendukung jenis deployment berikut di lingkungan:

Type Deskripsi
Proxy Kembangkan dan uji proxy API Anda di lingkungan pengembangan Apigee, lalu deploy ke lingkungan pengujian dan produksi Apigee. Lihat Men-deploy proxy API.
Arsip 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 menggunakan kebijakan. Kebijakan itu seperti modul yang mengimplementasikan fungsi manajemen tertentu yang terbatas. Kebijakan dirancang untuk memungkinkan Anda 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 fungsionalitas ini sendiri. Anda juga dapat menulis skrip dan kode kustom (seperti aplikasi JavaScript), yang memperluas fungsi proxy API dan memungkinkan Anda untuk berinovasi selain dengan kemampuan pengelolaan dasar yang didukung oleh kebijakan Apigee. Untuk mengetahui 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 lokasi untuk men-deploy API. Misalnya, Anda dapat mempromosikan revisi pada lingkungan produksi agar developer dapat mulai menggunakan API Anda. Secara bersamaan, Anda dapat melakukan iterasi beberapa revisi di lingkungan pengujian atau lokal, 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 metode ini, Anda selalu dapat memiliki revisi langsung atas API yang tersedia untuk developer saat 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 software development lifecycle (SDLC) organisasi Anda. Misalnya, untuk memastikan bahwa persyaratan keamanan, keandalan, dan konsistensi terpenuhi, penggunaan umum Apigee API adalah menulis skrip atau kode yang secara terprogram men-deploy proxy API 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 lingkungan test dan production yang hanya dapat diakses oleh proxy API yang dijalankan di lingkungan tersebut. Selain itu, kunci API yang dikeluarkan dalam lingkungan pengujian tidak valid di lingkungan produksi, begitu juga sebaliknya.

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

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

  • Peta nilai kunci (KVM): Jika dicakupkan 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: Biasanya proxy API 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-beda bergantung pada lingkungannya, jika, misalnya, ServiceCallout di lingkungan pengujian menggunakan layanan demo. Lihat kebijakan InfoService.

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 rute ke URL di backend. Untuk informasi selengkapnya, lihat Kondisi dengan variabel alur.