Membuat lingkungan

Topik ini menjelaskan cara membuat lingkungan baru. Untuk pengantar, lihat Tentang lingkungan dan grup lingkungan.

Tentang pembuatan lingkungan

Pembuatan lingkungan adalah proses dua langkah:

  • Menciptakan lingkungan dalam manajemen menggunakan UI atau Apigee API.
  • Menambahkan konfigurasi untuk lingkungan tersebut ke file pengganti dan menerapkannya ke cluster.

Langkah-langkah untuk menambahkan lingkungan dijelaskan dalam menambahkan dan mengonfigurasi lingkungan adalah dijelaskan dalam Langkah 5: Menambahkan lingkungan dan Tentukan penggantian konfigurasi.

Cara membuat lingkungan

  1. Buat satu atau beberapa lingkungan baru di UI Apigee atau dengan Create lingkungan API. Untuk mengikuti langkah-langkah dasar, lihat Langkah 5: Menambahkan lingkungan.

  2. Tambahkan definisi lingkungan baru ke properti envs[] dalam file penggantian Anda. Perhatikan bahwa properti adalah array; Oleh karena itu, Anda bisa menambahkan lebih dari satu definisi lingkungan IP eksternal mana pun yang ditetapkan pada instance tersebut. Beri lingkungan baru nama yang sama dengan yang Anda buat di UI. Misalnya, konfigurasi berikut menentukan dua lingkungan: test dan prod:

    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
...
  3. 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
  4. Terapkan perubahan pada cluster. Jika Anda mengubah envs[] dan virtualhosts[], terapkan perubahan dengan perintah berikut: 
    apigeectl apply -f overrides-file.yaml -c synchronizer,udca,runtime

    Jika Anda hanya mengubah properti virtualhosts, terapkan perubahan konfigurasi tersebut dengan flag --settings: 

    apigeectl apply -f overrides-file.yaml --settings virtualhosts

Untuk informasi selengkapnya tentang konfigurasi host virtual, termasuk cara mengonfigurasi beberapa aturan pemilihan rute basepath, lihat Mengonfigurasi host virtual. Untuk mengetahui daftar lengkap elemen konfigurasi lingkungan, lihat envs di bagian Konfigurasi referensi properti.