Halaman ini diterjemahkan oleh Cloud Translation API.

Tentang lingkungan

Lingkungan menyediakan konteks atau "sandbox" yang terisolasi untuk menjalankan proxy API. Dalam satu organisasi, Anda dapat membuat beberapa lingkungan. Untuk mengetahui informasi selengkapnya, lihat Tentang lingkungan dan grup lingkungan.

Kode berikut menunjukkan contoh konfigurasi penggantian tempat beberapa lingkungan ditentukan. Perlu diketahui bahwa lingkungan prod dan test memiliki alias host yang berbeda:

namespace: my-namespace
org: my-organization
...
envs:
  - name: test
    serviceAccountPaths:
      synchronizer: "your_keypath/synchronizer-manager-service-account.json
      udca: "your_keypath/analytic-agent-service-account.json

  - name: prod
    serviceAccountPaths:
      synchronizer: "your_keypath/synchronizer-manager-service-account.json
      udca: "your_keypath/analytic-agent-service-account.json
...

Tambahkan properti virtualhosts yang memetakan routingRules-nya ke lingkungan.

virtualhosts:
  - name: default
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: test

virtualhosts:
  - name: external
    hostAliases: ["apiprod.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: prod

Misalkan proxy dengan jalur dasar /foo1 di-deploy ke pengujian lingkungan. Anda dapat memanggil {i>proxy<i} seperti ini:

curl -k https://api.example.com/foo1

Saat panggilan ini mencapai ingress, ingress akan tahu untuk mengirimkannya ke pemroses pesan yang terkait dengan lingkungan test, yang menangani permintaan tersebut.

Demikian pula, jika foo1 juga di-deploy ke lingkungan prod, Anda dapat membuat permintaan proxy seperti ini, ke alias host apiprod.mydomain.net:

curl -k https://apiprod.example.com/foo1

Dan panggilan dialihkan oleh masuknya ke MP yang terkait dengan {i>host<i} tersebut.

CATATAN Pada permintaan ke proxy API, traffic masuk akan membandingkan header Host dari permintaan masuk dengan daftar alias host untuk menentukan host virtual mana yang menangani permintaan tersebut. Perintah curl, browser, dan berbagai utilitas lainnya secara otomatis menetapkan header Host dengan domain permintaan. Jika karena alasan apa pun aplikasi Anda tidak menyetel header Host secara otomatis, Anda harus menyetelnya secara manual.

Antipola: Deploy semua proxy Anda ke satu lingkungan hybrid.

Praktik terbaik: Buat beberapa lingkungan dan deploy proxy dalam jumlah terbatas ke setiap lingkungan. Anda dapat membuat aturan perutean yang menentukan lingkungan mana yang akan dikirimi jalur dasar proxy API tertentu. Untuk mengetahui detailnya, lihat Konfigurasi host virtual.

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 sistem 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 pasti untuk pertanyaan ini; namun, tabel berikut memberikan panduan umum tentang alasan sebaiknya membatasi jumlah proxy yang di-deploy ke setiap lingkungan dan hal yang perlu Anda pikirkan ketika mengelola deployment proxy:

Masalah yang perlu dipertimbangkan	Deskripsi
Waktu booting pemroses pesan	Ada korelasi langsung antara jumlah waktu yang diperlukan prosesor 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. Semakin banyak proxy yang di-deploy ke MP, semakin lama waktu yang diperlukan untuk memunculkan MP jika perlu diskalakan atau dibuat ulang.
Menskalakan performa	Jika Anda memiliki beberapa proxy yang di-deploy ke suatu lingkungan, dan salah satu proxy mendapatkan banyak traffic sehingga sering kali melakukan penskalaan otomatis, semua proxy di lingkungan tersebut akan menskalakannya. Efek performa dari penskalaan beberapa proxy dengan satu proxy dengan traffic tinggi mungkin akan menjadi masalah.
Tetangga yang berisik	Jika Anda memiliki beberapa proxy yang di-deploy ke lingkungan yang sama, dan satu proxy mengalami error, semua proxy di lingkungan tersebut akan dihapus saat Anggota Parlemen dimulai ulang. Dengan membatasi jumlah proxy yang di-deploy ke suatu lingkungan, Anda meminimalkan dampak error pada satu proxy.

Referensi konfigurasi lingkungan

Untuk mengetahui daftar lengkap elemen konfigurasi lingkungan, lihat envs dalam Referensi properti konfigurasi.

Bekerja dengan lingkungan

Untuk informasi selengkapnya tentang konfigurasi, lihat topik berikut: