Mengonfigurasi pemilihan rute jalur dasar

Topik ini membahas pemilihan rute jalur dasar. Pemilihan rute jalur dasar memungkinkan Anda mengonfigurasi dan mengelola cara Apigee Hybrid merutekan panggilan proxy API ke lingkungan yang benar.

Menggunakan pemilihan rute jalur dasar untuk mengelola deployment proxy

Karena Anda dapat memetakan satu host virtual ke beberapa lingkungan dalam hybrid, Anda memerlukan cara untuk menentukan jalur dasar proxy yang dipetakan ke lingkungan mana.

Misalnya, Anda ingin memetakan dua lingkungan ke alias host yang sama: apitest.mydomain.net. Dalam file penggantian, Anda dapat membuat konfigurasi berikut dengan lingkungan dev1 dan dev2 yang dipetakan ke host ini. Contoh: 

envs:
  - name: dev1
    hostAlias: "apitest.mydomain.net"
    ...
  - name: dev2
    hostAlias: "apitest.mydomain.net"
    ...

Sekarang, misalkan Anda men-deploy proxy ke lingkungan ini. Anda men-deploy:

  • Proxy foo1 dengan jalur dasar /foo1 ke dev1
  • Membuat proxy foo2 dengan jalur dasar /foo2 ke dev2

Misalkan klien memanggil API ini: https://apitest.mydomain.net/foo1. Perhatikan bahwa tidak ada di jalur ini (atau di header host yang dibuat untuk permintaan) yang memberi tahu hybrid lingkungan mana yang akan merutekan panggilan. Apakah proxy foo1 di-deploy ke dev1 atau dev2? Hanya berdasarkan URL permintaan, tidak ada cara untuk mengetahuinya. Anda harus memetakan setiap jalur dasar ini secara eksplisit ke satu atau beberapa lingkungan.

Untuk menentukan lingkungan mana yang akan dirutekan panggilan proxy, tambahkan properti paths.uri.prefixes ke properti envs dalam file penggantian Anda, seperti ditunjukkan dalam contoh berikut: 

gcpProjectID: example
k8sClusterName: apigee-hybrid

# Apigee org name.
org: my-org

envs:
    # Apigee environment name.
  - name: dev1
    hostAlias: "apitest.mydomain.net"
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key
    serviceAccountPaths:
      synchronizer: ./service-accounts/example-apigee-synchronizer.json
      udca: ./service-accounts/example-apigee-udca.json
    paths:
      uri:
        prefixes:
          - /foo1
  - name: dev2
    hostAlias: "apitest.mydomain.net"
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key
    serviceAccountPaths:
      synchronizer: ./service-accounts/example-apigee-synchronizer.json
      udca: ./service-accounts/example-apigee-udca.json
    paths:
      uri:
        prefixes:
          - /foo2
    ...

Sekarang, saat panggilan API masuk seperti: https://apitest.mydomain.net/foo1, router masuk akan mengetahui tempat untuk mengirimnya. Proxy ini mengetahui bahwa proxy /foo1 di-deploy ke lingkungan dev1, dan panggilan dialihkan ke pemroses pesan dev1.

Jika Anda mengirim panggilan ini, https://apitest.mydomain.net/foo2, panggilan tersebut juga akan dirutekan ke MP lingkungan dev2, dan seterusnya.

Singkatnya, konfigurasi paths.uri.prefixes memungkinkan Anda mengelola deployment proxy di antara beberapa lingkungan yang memiliki alias host yang sama.

Praktik Terbaik: Gunakan pemilihan rute jalur dasar jika Anda ingin beberapa lingkungan menggunakan alias host yang sama. Pemilihan rute jalur dasar memungkinkan Anda membatasi jumlah proxy yang di-deploy ke satu lingkungan. Untuk informasi selengkapnya, lihat Membatasi jumlah deployment proxy.

Menambahkan lingkungan baru ke domain yang sama

Bagian ini menjelaskan cara menambahkan lingkungan baru ke domain.

Dalam skenario ini, asumsikan bahwa Anda memiliki lingkungan dev1 yang sudah di-deploy ke cluster. Dalam contoh konfigurasi ini, hanya proxy dengan awalan jalur dasar /foo1 yang diizinkan: 

gcpProjectID: example
k8sClusterName: apigee-hybrid

# Apigee org name.
org: my-org

envs:
    # Apigee environment name.
  - name: dev1
    hostAlias: "apitest.mydomain.net"
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key
    serviceAccountPaths:
      synchronizer: ./service-accounts/example-apigee-synchronizer.json
      udca: ./service-accounts/example-apigee-udca.json
    paths:
      uri:
        prefixes:
          - /foo1

mart:
  hostAlias: "mart.apigee-hybrid-docs.net"
  serviceAccountPath: ./service-accounts/example-apigee-mart.json
  sslCertPath: ./certs/fullchain.pem
  sslKeyPath: ./certs/privkey.key

metrics:
  serviceAccountPath: ./service-accounts/willwitman-istio-25240157d44a.json

Untuk menambahkan lingkungan lain yang memiliki domain yang sama, ikuti langkah-langkah berikut:

  1. Buat file penggantian baru dengan konfigurasi lingkungan baru. Misalnya, konfigurasi ini membuat lingkungan yang disebut dev2. Di lingkungan ini, hanya proxy dengan akhiran jalur /foo2 yang diizinkan: 
    gcpProjectID: example
k8sClusterName: apigee-hybrid

# Apigee org name.
org: my-org

envs:
    # Apigee environment name.
  - name: dev2
    hostAlias: "apitest.mydomain.net"
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key
    serviceAccountPaths:
      synchronizer: ./service-accounts/example-apigee-synchronizer.json
      udca: ./service-accounts/example-apigee-udca.json
    paths:
      uri:
        prefixes:
          - /foo2

mart:
  hostAlias: "mart.apigee-hybrid-docs.net"
  serviceAccountPath: ./service-accounts/example-apigee-mart.json
  sslCertPath: ./certs/fullchain.pem
  sslKeyPath: ./certs/privkey.key

metrics:
  serviceAccountPath: ./service-accounts/willwitman-istio-25240157d44a.json
  2. Jalankan perintah berikut dalam urutan apa pun: 
    1. apigeectl apply -f overrides/overrides-dev2.yaml -c udca
    2. apigeectl apply -f overrides/overrides-dev2.yaml -c synchronizer
    3. apigeectl apply -f overrides/overrides-dev2.yaml -c runtime
  3. Deploy proxy foo2 ke lingkungan dev2.
  4. Panggil proxy untuk menguji penyiapan. 
    curl https://apitest.mydomain.net/foo2

Menambahkan jalur dasar proxy baru ke lingkungan yang ada

Untuk menambahkan jalur dasar baru ke lingkungan yang ada, cukup tambahkan entri prefixes untuk setiap jalur dasar baru. Misalnya, jika Anda membuat proxy baru dengan jalur dasar /foo4, dan ingin men-deploy-nya ke lingkungan yang disebut dev2, ikuti langkah-langkah berikut:

  1. Buka file penggantian yang memiliki definisi lingkungan dev2.
  2. Tambahkan jalur dasar /foo4 ke elemen paths.uri.prefixes: 
    gcpProjectID: example
k8sClusterName: apigee-hybrid

# Apigee org name.
org: my-org

envs:
    # Apigee environment name.
  - name: dev2
    hostAlias: "apitest.mydomain.net"
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key
    serviceAccountPaths:
      synchronizer: ./service-accounts/example-apigee-synchronizer.json
      udca: ./service-accounts/example-apigee-udca.json
    paths:
      uri:
        prefixes:
          - /foo2
          - /foo4

mart:
  hostAlias: "mart.apigee-hybrid-docs.net"
  serviceAccountPath: ./service-accounts/example-apigee-mart.json
  sslCertPath: ./certs/fullchain.pem
  sslKeyPath: ./certs/privkey.key

metrics:
  serviceAccountPath: ./service-accounts/willwitman-istio-25240157d44a.json
  3. Terapkan komponen runtime ke cluster: 
    apigeectl apply -f overrides/overrides-dev2.yaml -c runtime
  4. Panggil proxy untuk menguji penyiapan. 
    curl https://apitest.mydomain.net/foo4

    Jika panggilan API masuk untuk https://apitest.mydomain.net/foo4, hybrid akan mengetahui cara merutekannya ke lingkungan dev2.