Tentang lingkungan

Lingkungan menyediakan konteks terisolasi atau "sandbox" 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. Perhatikan 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 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 lingkungan test. Anda dapat memanggil proxy seperti ini: 

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

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

    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

    Panggilan tersebut dirutekan oleh ingress ke MP yang terkait dengan host tersebut.

    Antipola: Men-deploy semua proxy Anda ke satu lingkungan hybrid.

    Praktik terbaik: Buat beberapa lingkungan dan deploy sejumlah kecil proxy ke setiap lingkungan. Anda dapat membuat aturan pemilihan rute yang menentukan lingkungan mana yang akan menjadi tujuan pemilihan rute basepath 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 berpikir matang tentang cara mengelola deployment proxy ke lingkungan tertentu. Dalam hybrid, praktik terbaiknya adalah membuat beberapa lingkungan dan men-deploy sejumlah kecil proxy 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 pertimbangkan saat mengelola deployment proxy:

    Masalah yang perlu dipertimbangkan Deskripsi
    Waktu booting Message Processor Ada korelasi langsung antara durasi waktu yang dibutuhkan prosesor pesan (MP) untuk melakukan booting dan jumlah proxy yang di-deploy ke MP tersebut. Di lingkungan Kubernetes dengan penskalaan otomatis, peningkatan waktu booting dapat menjadi masalah. Semakin banyak proxy yang di-deploy ke MP, semakin lama waktu yang dibutuhkan MP tersebut untuk aktif jika MP perlu diskalakan atau dibuat ulang.
    Performa penskalaan Jika Anda memiliki beberapa proxy yang di-deploy ke lingkungan, dan salah satu proxy mendapatkan banyak traffic sehingga sering melakukan penskalaan otomatis, semua proxy di lingkungan tersebut akan melakukan penskalaan bersamanya. Efek performa penskalaan beberapa proxy dengan satu proxy traffic tinggi mungkin 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 dihentikan saat MP dimulai ulang. Dengan membatasi jumlah proxy yang di-deploy ke lingkungan, Anda meminimalkan dampak jika satu proxy mengalami error.

    Referensi konfigurasi lingkungan

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

    Bekerja dengan lingkungan

    Untuk mengetahui informasi selengkapnya tentang konfigurasi, lihat topik berikut: