Tentang lingkungan dan grup lingkungan

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Bagian ini menjelaskan lingkungan dan grup lingkungan.

Ringkasan

Lingkungan Apigee adalah lingkungan software, dalam organisasi, untuk membuat dan men-deploy proxy API. Anda harus men-deploy proxy API ke lingkungan agar dapat diakses. Anda dapat men-deploy proxy API ke satu atau beberapa lingkungan.

Setiap lingkungan dibatasi hingga total 60 deployment, maksimum 50 di antaranya bisa menjadi deployment proxy.

Grup lingkungan (terkadang disebut envgroup di Apigee API) adalah mekanisme dasar untuk menentukan cara permintaan diarahkan ke setiap lingkungan. Anda menentukan nama host pada grup lingkungan Anda (bukan pada lingkungan individual), dan Apigee merutekan permintaan ke lingkungan dalam grup menggunakan definisi nama host tersebut.

Lingkungan harus menjadi anggota dari setidaknya satu grup lingkungan sebelum Anda dapat mengakses proxy yang di-deploy di dalamnya. Dengan kata lain, Anda harus menetapkan lingkungan ke grup sebelum dapat menggunakannya.

Pengelompokan lingkungan secara logis berdasarkan grup lingkungan memberikan manfaat berikut:

• Pengelolaan nama host terpusat: Grup lingkungan menyediakan tempat terpusat untuk mengelola nama host.
• Insight gabungan: Dengan grup, Anda dapat menganalisis error dengan melihat laporan untuk seluruh grup lingkungan sekaligus, bukan lingkungan individual.
• Menghindari konflik: Dengan mengelompokkan lingkungan, Anda dapat memastikan bahwa jalur dasar untuk proxy yang di-deploy berada di nama host yang sama.

Jenis deployment yang didukung

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.

Ringkasan tindakan yang dicegah dengan deployment arsip

Saat mengaktifkan deployment arsip di lingkungan Apigee, Anda akan tidak dapat melakukan tindakan berikut di lingkungan tersebut untuk mencegah konflik:

• Di UI Apigee, Anda tidak dapat melihat, mengonfirmasi status deployment, atau mengelola deployment arsip, seperti yang dijelaskan dalam Men-deploy proxy API, atau menggunakan UI Debug seperti yang dijelaskan dalam Menggunakan Debug. Sebagai solusinya, Anda dapat menggunakan gcloud atau API untuk Mencantumkan semua deployment arsip dalam lingkungan dan menggunakan Debug API.
• Anda tidak dapat membuat, mengupdate, atau menghapus file resource atau server target menggunakan UI, API, atau gcloud Apigee.
• Saat ini, Autentikasi Google yang menggunakan Akun Layanan tidak didukung.

Catatan: Anda dapat mengelola peta nilai kunci (KVM), dan keystore TLS di lingkungan Apigee yang diaktifkan untuk deployment arsip.

Jika Anda mencoba melakukan tindakan dicegah yang tercantum di atas, tindakan tersebut akan gagal dengan pesan error berikut:

FAILED_PRECONDITION

Unit deployment proxy

Unit deployment proxy menghitung jumlah proxy dan alur bersama yang di-deploy ke lingkungan per region.

Berikut adalah jenis unit deployment:

• Unit deployment proxy standar menghitung jumlah proxy yang saat ini di-deploy dan memenuhi syarat sebagai Proxy standar.
• Unit deployment proxy yang dapat diperluas menghitung jumlah proxy yang saat ini di-deploy dan memenuhi syarat sebagai Proxy yang dapat diperluas.
• Unit deployment alur bersama menghitung jumlah alur bersama yang di-deploy.

Penggunaan Anda mungkin tunduk pada kuota deployment, yang merupakan batas jumlah unit deployment yang dapat Anda gunakan dalam satu waktu. Lihat hak Anda (Pay-as-you-go atau Langganan 2024) untuk mengetahui detailnya.

Untuk mengetahui informasi selengkapnya tentang cara melihat penggunaan unit deployment proxy dan detail kuota deployment untuk organisasi Anda, baca Melihat penggunaan deployment proxy.

Jenis lingkungan

Untuk pengguna Bayar sesuai penggunaan, saat membuat lingkungan, Anda akan memilih jenis lingkungan: Dasar, Menengah, atau Komprehensif. Fitur, fungsi, dan biaya yang terkait dengan lingkungan bergantung pada jenis lingkungan. Lihat Jenis lingkungan bayar sesuai penggunaan dan Hak bayar sesuai penggunaan untuk mengetahui informasi selengkapnya.

Untuk Paket langganan, jenis lingkungan Anda selalu Komprehensif dan Anda tidak perlu mengetahui jenis lingkungan.

Proxy maju

Apigee mendukung penerusan traffic ke URI yang ditentukan. Fitur ini berlaku di tingkat lingkungan dan dapat digunakan untuk mengarahkan traffic ke internet setelah pemrosesan awal dalam proxy.

Permintaan masuk ke proxy dalam proses lingkungan yang dikonfigurasi untuk kebijakan yang disertakan (lihat Dukungan fitur proxy penerusan), lalu teruskan menggunakan HTTP ke URI baru.

Perubahan yang dilakukan pada setelan proxy penerusan suatu lingkungan akan segera berlaku untuk permintaan baru saja. Permintaan sudah diproses selesai dengan setelan yang ada saat permintaan diterima.

Untuk mendapatkan petunjuk tentang cara mengonfigurasi proxy maju, lihat Mengonfigurasi proxy maju di lingkungan.

Dukungan fitur {i>forward proxying<i}

Tidak semua fitur proxy yang tersedia secara umum memiliki ketersediaan atau penerapan yang sama dengan proxy maju.

Apigee saat ini tidak mendukung Autentikasi Dasar dengan proxy maju, kecuali pada Apigee Hybrid.

Tabel ini menunjukkan dukungan untuk fungsi tambahan:

Fitur atau kebijakan	Didukung/berlaku untuk proxy penerusan?
Endpoint Target	Ya
Health Check HTTP	Ya
Info Layanan	Ya
Panggilan HTTP melalui JavaScript	Ya
Target integrasi	Ya
Perantaian proxy, melalui loopback lokal	Tidak
Memublikasikan pesan	Tidak
Cloud Logging	Tidak
Komunikasi dengan Penyinkron	Tidak
Logging pesan melalui Syslog	Tidak

Batasan proxy penerusan

GoogleToken melalui audiens eksternal saat ini tidak didukung dengan proxy penerusan.

Poin utama

Tabel berikut mencantumkan poin-poin penting yang perlu diingat tentang lingkungan, organisasi, dan grup lingkungan:

Elemen	Aturan
Organisasi	Dapat berisi beberapa grup lingkungan Harus memiliki setidaknya satu grup lingkungan
Lingkungan	Harus ada dalam setidaknya satu grup lingkungan Dapat berada di lebih dari satu grup Bagikan nama host dengan semua lingkungan lainnya dalam grup yang sama Dapat digunakan untuk meneruskan traffic ke URI yang ditentukan
Jenis Lingkungan	Menentukan fungsi yang tersedia di dan dengan lingkungan tersebut Menentukan harga untuk lingkungan (Lihat Jenis lingkungan.)
Grup Lingkungan	Dapat memiliki beberapa nama host Berisi satu atau beberapa lingkungan Nama host yang ditetapkan ke grup harus unik untuk grup tersebut (tidak dapat digunakan oleh grup lain)

Pengguna hybrid Apigee: Setiap grup lingkungan yang Anda buat dengan lingkungan terlampir harus disertakan dalam semua file penggantian tempat lingkungan tersebut digunakan.

Contoh

Bagian berikut menunjukkan cara umum untuk menyusun lingkungan dalam grup lingkungan.

Satu grup lingkungan dan satu lingkungan

Struktur yang paling sederhana adalah grup lingkungan tunggal dengan satu lingkungan di dalamnya. Hal ini umum terjadi bagi organisasi yang sedang mengevaluasi produk atau belum menyiapkan infrastruktur pengujian atau analisis, serta tidak memiliki proxy yang di-deploy dalam produksi.

Beberapa lingkungan dalam satu grup lingkungan

Grup lingkungan dapat berisi beberapa lingkungan. Dalam contoh di bawah, ada grup lingkungan tunggal, prod-group, yang berisi tiga lingkungan, cart-prod, catalog-prod, dan payment-prod.

Grup lingkungan memiliki satu nama host, example.com. Anda dapat menggunakan nama host untuk mengarahkan permintaan ke proxy yang di-deploy di salah satu lingkungan. Perlu diperhatikan bahwa nama host ditentukan pada tingkat grup lingkungan: nama host tidak dirutekan ke lingkungan tertentu.

Lihat Bekerja dengan grup lingkungan untuk mempelajari cara membuat grup lingkungan ini.

Membatasi pemilihan rute ke lingkungan tunggal

Pada contoh sebelumnya, permintaan dapat diarahkan ke proxy di ketiga lingkungan dengan satu nama host. Jika Anda ingin membatasi akses ke proxy dalam satu lingkungan, misalnya catalog-prod, buat grup lingkungan lain yang hanya berisi lingkungan catalog-prod. Kemudian, nama host yang ditentukan untuk grup lingkungan tersebut hanya dapat mengakses catalog-prod.

Pada contoh di bawah, nama host catalog.example.com, untuk grup lingkungan catalog-prod-group, hanya dapat merutekan permintaan ke proxy di lingkungan catalog-prod.

Siap membuat grup? Buka Konsol

Untuk mempelajari lingkungan lebih lanjut: Terus Membaca

Untuk mempelajari lebih lanjut grup lingkungan: Terus Membaca

Pemilihan rute dan jalur dasar

Dalam konfigurasi sederhana, permintaan ke proxy API yang di-deploy terdiri dari nama host, jalur dasar, dan nama resource API; misalnya:

https://www.example.com/shopping/cart/addItem
        |_____________| |___________| |_____|
               |             |           |
            hostname      basepath     resource

Anda menentukan nama host di grup lingkungan sehingga beberapa lingkungan dapat membagikannya. Basepath dan resource API ditentukan di proxy API.

Catatan: Nama grup dan lingkungan tidak memengaruhi URL endpoint API. Token ini hanya ditujukan untuk Anda guna mengatur dan mengonfigurasi lingkungan, dan tidak diekspos ke pengguna akhir proxy.

Untuk mengetahui informasi selengkapnya tentang jalur dasar dan resource API, mulailah dengan Memahami rute. Selain itu, lihat Referensi konfigurasi flow dan Referensi variabel flow untuk mendapatkan pemahaman yang lebih baik tentang bagaimana bagian-bagian ini saling terkait.

Nama host

Saat membuat grup lingkungan, Anda akan menyertakan satu atau beberapa nama host ke grup tersebut. Misalnya, Anda mungkin memiliki grup lingkungan berikut, masing-masing dengan nama host-nya sendiri:

Nama Grup Lingkungan (Lingkungan)	prod-group (catalog-prod cart-prod pymnt-prod)	dev-group (dev-env)	grup-pengujian (test-env)
Nama host	katalog.example.com pembayaran.contoh.com	dev.example.com	test.example.com

Anda menentukan jalur dasar pada proxy saat membuatnya.

Saat Anda menerapkan proxy ke lingkungan dalam grup, nama host beserta jalur dasar dan nama resource akan menentukan endpoint permintaan API ke proxy tersebut.

Anda dapat menentukan lebih dari satu nama host pada grup lingkungan. Semua fungsi tersebut dapat digunakan untuk memanggil proxy yang di-deploy ke lingkungan mana pun dalam grup. Misalnya, catalog.example.com/proxy1 dan payment.example.com/proxy1 akan memanggil resource proxy1 jika nama host catalog.example.com dan payment.example.com ditentukan pada grup lingkungan yang sama.

Contoh {i>routing<i}

Contoh:

• Grup lingkungan prod-group berisi lingkungan berikut:

  • catalog-prod
  • cart-prod
  • pymnt-prod

• prod-group memiliki nama host berikut yang ditentukan:

  • catalog.example.com
  • payment.example.com

• Proxy berikut di-deploy ke lingkungan ini:

  • Proxy catalog di catalog-prod dengan jalur dasar /catalog
  • Proxy cart di cart-prod dengan jalur dasar /catalog/cart
  • Proxy payment di pymnt-prod dengan jalur dasar /payment

Hal ini akan membuat endpoint berikut:

• catalog.example.com/catalog dirutekan ke proxy catalog di lingkungan catalog-prod.
• catalog.example.com/catalog/cart dirutekan ke proxy cart di lingkungan cart-prod.
• payment.example.com/payment dirutekan ke proxy payment di lingkungan pymnt-prod.

Contoh berikut menunjukkan bahwa permintaan dirutekan ke berbagai proxy yang di-deploy ke lingkungan dalam grup, yang cocok dengan nama host dan jalur dasar:

Tips:

Nama host yang Anda tentukan pada grup lingkungan:

• Harus unik di semua grup lingkungan dalam suatu organisasi; grup lingkungan tidak dapat digunakan oleh lebih dari satu grup
• Jangan dukung karakter pengganti
• Jalur dasar harus unik dalam grup lingkungan (tidak ada dua proxy yang dapat memiliki jalur dasar yang sama dalam grup lingkungan)

Untuk mengetahui informasi selengkapnya, lihat Menambahkan nama host ke grup.

Lingkungan dan pemilihan rute bersama

Lingkungan dapat dimiliki oleh beberapa grup lingkungan. Jika Anda menerapkan proxy ke lingkungan tersebut, proxy akan memiliki beberapa alamat, satu untuk setiap grup lingkungan yang mencakup lingkungan tersebut. Hal ini berguna jika pelanggan memiliki sertifikat karakter pengganti (seperti *.example.com) untuk beberapa partner.

Contoh:

• shared-env termasuk dalam dua grup lingkungan:
  • partner-1 dengan alias host api.partner-1.com
  • partner-2 dengan alias host api.partner-2.com
• Proxy foo di-deploy ke shared-env dengan jalur dasar /foo. Karena shared-env digunakan bersama oleh kedua grup lingkungan, foo memiliki dua alamat:
  • api.partner-1.com/foo
  • api.partner-2.com/foo

Perhatikan bahwa kedua nama host dirutekan ke lingkungan yang sama. Hal ini memberikan nama domain yang unik untuk setiap grup lingkungan. Untuk Apigee Hybrid, skenario ini dapat menggunakan mTLS dengan sertifikat yang berbeda untuk setiap partner.

Tentang cakupan lingkungan

Organisasi ini menyediakan cakupan untuk sejumlah kemampuan Apigee. Misalnya, data peta nilai kunci (KVM) dapat tersedia di tingkat organisasi, yang berarti bahwa proxy API yang di-deploy ke lingkungan mana pun dalam organisasi tersebut dapat mengakses data KVM yang sama.

Demikian pula, beberapa kemampuan dapat mencakup lingkungan atau grup lingkungan dalam organisasi. Misalnya, data analisis Apigee dipartisi oleh kombinasi organisasi, lingkungan, dan (akhirnya) grup lingkungan.

Pertimbangan

Setiap deployment ke suatu lingkungan berpotensi memengaruhi pemilihan rute traffic untuk setiap grup lingkungan tempat lingkungan tersebut terpasang. Jika jalur dasar baru ditambahkan, jalur tersebut dapat mulai menangkap traffic yang benar-benar baru, atau dapat mulai menangkap subset traffic yang ada yang sudah ditangani oleh deployment yang ada.

Demikian pula, jika jalur dasar dihapus, jalur tersebut mungkin berkaitan dengan endpoint yang tidak lagi menerima traffic, atau dapat menyebabkan traffic yang ada dialihkan ke proxy yang berbeda. Saat diubah rutenya, traffic mungkin menuju ke proxy di lingkungan yang sama, atau jika beberapa lingkungan berbagi satu grup lingkungan, mungkin menuju ke proxy di lingkungan yang berbeda.

Referensi lainnya

Informasi berikut menjelaskan cara mengelola lingkungan dan grup lingkungan Anda:

• Dengan UI Apigee:

  • Bekerja dengan lingkungan
  • Bekerja dengan grup lingkungan

• Dengan Apigee API:

  • Environments API
  • Environment groups API
  • Environment group attachment API