Lingkungan menyediakan konteks atau "sandbox" terisolasi untuk menjalankan proxy API. Dalam satu organisasi, Anda dapat membuat beberapa lingkungan. Untuk mengetahui informasi selengkapnya, lihat Tentang lingkungan dan grup lingkungan.
Selama penginstalan dasar, Anda menambahkan lingkungan untuk pengujian. Namun, praktik terbaiknya adalah membuat beberapa lingkungan dan men-deploy proxy dalam jumlah terbatas ke setiap lingkungan.
Tentang host virtual dan lingkungan
Apigee hybrid menggunakan gateway ingress Istio untuk menangani traffic API yang masuk. Layanan MART dan runtime dikonfigurasi dengan gateway ingress Istio untuk mengelola koneksi yang diekspos di luar cluster. Artinya, misalnya, semua permintaan HTTP dan HTTPS ke proxy API pertama kali ditangani oleh gateway ingress Istio.
Dalam hybrid, Anda membuat satu atau beberapa lingkungan dan menetapkan alias host ke setiap lingkungan. Alias host adalah nama DNS. Traffic masuk ke nama DNS tersebut dirutekan oleh ingress ke lingkungan tersebut. Secara internal, setiap lingkungan ditetapkan ke satu dan hanya satu pemroses pesan, yang melakukan tugas pemrosesan permintaan proxy, menerapkan kebijakan, dan merutekan traffic ke dan dari layanan target. Oleh karena itu, alias host menentukan pemroses pesan mana yang menerima permintaan masuk tertentu.
Kode berikut menunjukkan contoh konfigurasi tempat beberapa lingkungan ditentukan. (Konfigurasi tersebut berada dalam file penggantian Anda.) Perhatikan bahwa lingkungan dev1 dan prod1 memiliki alias host yang berbeda:
envs:
- name: dev1
hostAlias: "apitest.mydomain.net"
...
- name: prod1
hostAlias: "apiprod.mydomain.net"
...
Misalkan proxy dengan jalur dasar /foo1 di-deploy ke lingkungan
dev1. Anda dapat memanggil proxy seperti ini:
curl -k https://apitest.mydomain.net/foo1
Saat panggilan ini mencapai ingress, ingress akan tahu untuk mengirimkannya ke pemroses pesan
yang terkait dengan lingkungan dev1, yang menangani permintaan.
Demikian pula, jika foo1 juga di-deploy ke lingkungan prod1,
Anda dapat membuat permintaan
proxy seperti ini, ke alias host apiprod.mydomain.net:
curl -k https://apiprod.mydomain.net/foo1
Selain itu, panggilan dirutekan oleh ingress ke MP yang terkait dengan host tersebut.
Singkatnya, setiap lingkungan yang Anda buat harus memiliki alias host yang ditetapkan. Setiap lingkungan dipetakan ke satu dan hanya satu pemroses pesan, dan alias host menentukan pemroses pesan mana yang menerima permintaan tertentu.
Lingkungan dapat menggunakan alias host yang sama
Apigee hybrid memungkinkan Anda membuat beberapa lingkungan yang dapat dikelola sesuai keinginan. Misalnya, Anda dapat membuat beberapa lingkungan pengembangan, dev1, dev2, dev3, dan seterusnya, serta memetakan satu alias host ke setiap lingkungan. Selain itu, Anda dapat men-deploy beberapa proxy ke setiap lingkungan.
Antipola: Men-deploy semua proxy ke satu lingkungan campuran.
Praktik terbaik: Buat beberapa lingkungan dan deploy proxy dalam jumlah terbatas ke setiap lingkungan. Teknik untuk mengelola cara rute hybrid merutekan panggilan proxy ke lingkungan yang benar yang berbagi alias host disebut pemilihan rute jalur dasar.
Misalnya, dalam konfigurasi berikut, lingkungan dev1 dan dev2 memiliki alias host yang sama:
envs:
- name: dev1
hostAlias: "apitest.mydomain.net"
...
- name: dev2
hostAlias: "apitest.mydomain.net"
...
Jika beberapa lingkungan memiliki alias host yang sama, Anda harus menggunakan teknik konfigurasi yang disebut rute jalur dasar untuk memetakan jalur dasar proxy tertentu ke lingkungan tertentu. Lihat pemilihan rute jalur dasar untuk mengetahui informasi selengkapnya.
Membatasi jumlah deployment proxy
Untuk hybrid, fakta bahwa banyak lingkungan dapat berbagi host virtual yang sama berarti Anda harus memikirkan dengan cermat cara mengelola deployment proxy ke lingkungan tertentu. Dalam hybrid, praktik terbaiknya adalah membuat beberapa lingkungan dan men-deploy proxy dalam jumlah terbatas ke setiap lingkungan.
Berapa banyak proxy yang harus Anda deploy ke lingkungan? Tidak ada jawaban yang ditetapkan untuk pertanyaan ini; namun, tabel berikut memberikan panduan umum tentang mengapa sebaiknya membatasi jumlah proxy yang di-deploy ke setiap lingkungan dan hal-hal yang perlu Anda pertimbangkan saat mengelola deployment proxy:
| Masalah yang perlu dipertimbangkan | Deskripsi |
|---|---|
| Waktu booting Message Processor | Ada korelasi langsung antara jumlah waktu yang diperlukan pemroses pesan (MP) untuk melakukan booting dan jumlah proxy yang di-deploy ke MP tersebut. Dalam lingkungan Kubernetes penskalaan otomatis, peningkatan waktu booting mungkin menjadi masalah. Makin banyak proxy yang di-deploy ke MP, makin lama waktu yang diperlukan MP tersebut untuk muncul jika perlu diskalakan atau dibuat ulang. |
| Melakukan penskalaan performa | Jika Anda memiliki beberapa proxy yang di-deploy ke lingkungan, dan salah satu proxy mendapatkan banyak traffic sehingga sering diskalakan secara otomatis, semua proxy di lingkungan tersebut akan diskalakan bersama. Efek performa dari penskalaan beberapa proxy dengan satu proxy traffic tinggi mungkin menjadi masalah. |
| Tetangga berisik | Jika Anda memiliki beberapa proxy yang di-deploy ke lingkungan yang sama, dan satu proxy mengalami error, semua proxy di lingkungan tersebut akan dinonaktifkan saat MP dimulai ulang. Dengan membatasi jumlah proxy yang di-deploy ke lingkungan, Anda akan meminimalkan dampak error satu proxy. |
Referensi konfigurasi lingkungan
Untuk mengetahui daftar lengkap elemen konfigurasi lingkungan, lihat envs di
Referensi properti konfigurasi.
Menggunakan lingkungan
Untuk informasi selengkapnya tentang konfigurasi, lihat topik berikut: