Membuat lingkungan

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

Tentang pembuatan lingkungan

Pembuatan lingkungan adalah proses dua langkah:

  • Buat lingkungan di platform pengelolaan menggunakan UI atau Apigee API.
  • Tambahkan konfigurasi untuk lingkungan tersebut ke file penggantian dan terapkan ke cluster.

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

Cara membuat lingkungan

  1. Buat satu atau beberapa lingkungan baru di UI Apigee atau dengan Create environments API. Untuk mengetahui langkah-langkah dasarnya, lihat Langkah 5: Menambahkan lingkungan.
  2. Tambahkan definisi lingkungan baru ke properti envs[] dalam file penggantian Anda. Perhatikan bahwa properti ini adalah array; oleh karena itu, Anda dapat menambahkan lebih dari satu definisi lingkungan ke dalamnya. Beri nama lingkungan baru yang sama dengan lingkungan 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. Terapkan perubahan apa pun ke cluster:

    Helm

    Dengan diagram Helm, terapkan perubahan ke setiap lingkungan secara berurutan dengan perintah berikut.

    Contoh:

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
      --install \
      --namespace APIGEE_NAMESPACE \
      --set env=ENV_NAME \
      -f OVERRIDES_FILE \
      --dry-run=server
    

      ENV_RELEASE_NAME adalah nama yang digunakan untuk melacak penginstalan dan upgrade bagan apigee-env. Nama rilis Helm harus unik dalam penginstalan campuran Apigee Anda. Jika nama lingkungan Anda unik, nama ini dapat sama dengan ENV_NAME. Namun, jika Anda memiliki nama yang sama untuk lingkungan dan grup lingkungan, pastikan untuk memasukkan nama rilis Helm yang unik untuk setiap nama. Misalnya, jika keduanya bernama dev, Anda dapat menggunakan sesuatu seperti dev-env-release dan dev-envgroup-release.

      Untuk mengetahui informasi selengkapnya tentang rilis di Helm, lihat Tiga konsep besar dalam dokumentasi Helm.

    Lingkungan test:

    helm upgrade test-release apigee-env/ \
      --namespace apigee \
      --atomic \
      --set env=test \
      -f OVERRIDES_FILE.yaml
    

    Lingkungan prod:

    helm upgrade prod-release apigee-env/ \
      --namespace apigee \
      --set env=prod \
      --atomic \
      -f OVERRIDES_FILE.yaml
    

    apigeectl

    Dengan apigeectl, Anda dapat menerapkan perubahan ke setiap lingkungan satu per satu dengan flag --env ENV_NAME atau ke semua lingkungan secara bersamaan dengan flag --all-envs. Contoh:

    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --all-envs

Untuk informasi selengkapnya tentang konfigurasi host virtual, lihat Mengonfigurasi host virtual. Untuk mengetahui daftar lengkap elemen konfigurasi lingkungan, lihat envs di Referensi properti konfigurasi.