仮想ホストを構成する

このトピックでは、virtualhosts 構成プロパティについて説明します。仮想ホストを使用することで、Apigee ハイブリッドは環境グループに関連付けられたホスト エイリアスに対する API リクエストを処理できます。詳細については、環境と環境グループについてのルーティングとベースパスをご覧ください。

...
virtualhosts:
  - name: my-env-group
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.key
...

API プロキシの呼び出しが発生すると、API プロキシがデプロイされている環境グループのホスト エイリアスに転送されます。

virtualhosts をクラスタに適用する手順については、virtualhosts の変更の適用をご覧ください。TLS の構成については、Istio Ingress での TLS と mTLS の構成をご覧ください。

複数の仮想ホストの追加

virtualhosts[] プロパティは配列であるため、複数の仮想ホストを作成できます。

...
virtualhosts:
  - name: my-env-group-1
    sslCertPath: ./certs/fullchain1.pem
    sslKeyPath: ./certs/privkey1.key

  - name: my-env-group-2
    sslCertPath: ./certs/fullchain2.pem
    sslKeyPath: ./certs/privkey2.key
...

TLS の構成については、Istio Ingress での TLS と mTLS の構成をご覧ください。

virtualhosts の変更の適用

virtualhosts プロパティを追加または変更するだけであれば、apigee-virtualhost チャートと変更を適用する環境グループの名前を指定して変更を適用します。

helm upgrade $ENV_GROUP apigee-virtualhost/ \
  --namespace apigee \
  --atomic \
  --set envgroup=$ENV_GROUP \
  -f OVERRIDES_FILE.yaml

たとえば、virtualhosts と env を変更する場合は、ENV_GROUP apigee-virtualhost/ フラグを使用せずに helm upgrade で変更を適用してクラスタを更新する必要があります。次に例を示します。

更新する環境ごとに Helm のアップグレードを実行します。

helm upgrade $ENV_NAME apigee-env/ \
  --namespace apigee \
  --atomic \
  --set env=$ENV_NAME \
  -f OVERRIDES_FILE.yaml

TLS 鍵と証明書

virtualhost プロパティには TLS 鍵と証明書が必要です。この鍵や証明書は、Ingress ゲートウェイとの安全な通信を提供するために使用され、指定された環境グループで使用されるホスト エイリアスとの互換性がある必要があります。

ハイブリッド構成に適切な TLS 証明書と鍵のペアを生成する方法はユーザーが選択します。以下のトピックは、TLS 認証情報を別の方法で取得できない場合に、新しいハイブリッド インストールを試用またはテストするためのサンプルとしてのみ提供されています。