このトピックでは、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
プロパティを追加または変更するだけの場合は、‑‑settings
フラグを使ってその変更を適用できます。
apigeectl apply -f overrides-file.yaml ‑‑settings virtualhosts
たとえば、virtualhosts
と env
を変更する場合は、‑‑settings
を使用せずに変更を適用し、クラスタを更新する必要があります。次に例を示します。
apigeectl apply -f overrides-file.yaml --env my-environment
あるいは、すべての環境のコンポーネントを更新します。
apigeectl apply -f overrides-file.yaml --all-envs
TLS 鍵と証明書
virtualhost
プロパティには TLS 鍵と証明書が必要です。この鍵や証明書は、Ingress ゲートウェイとの安全な通信を提供するために使用され、指定された環境グループで使用されるホスト エイリアスとの互換性がある必要があります。
ハイブリッド構成に適切な TLS 証明書と鍵のペアを生成する方法はユーザーが選択します。以下のトピックは、TLS 認証情報を別の方法で取得できない場合に、新しいハイブリッド インストールを試用またはテストするためのサンプルとしてのみ提供されています。
- 承認済みの TLS 証明書と鍵のペアを作成する一連のサンプルの手順については、TLS 認証情報の取得をご覧ください。
- 自己署名証明書と鍵のペアは、テスト目的でのみ使用できます。自己署名 TLS 認証情報を生成するをご覧ください。