環境を作成する

このトピックでは、新しい環境を作成する方法について説明します。概要については、環境についてをご覧ください。

環境の作成について

環境の作成は次の 2 段階のプロセスで行います。

• UI または Apigee API を使用して、管理プレーンで環境を作成します。
• その環境の構成をオーバーライド ファイルに追加してクラスタに適用します。

環境の追加と設定に関する手順については、ステップ 5: 環境を追加すると構成オーバーライドを指定するで説明します。

環境を作成する方法

1. Apigee ハイブリッド UI または Create Environments API を使用して、1 つ以上の新しい環境を作成します。基本的な手順については、ステップ 5: 環境を追加するをご覧ください。

2. 新しい環境定義をオーバーライド ファイル内の envs[] プロパティに追加します。 このプロパティは配列なので、複数の環境定義を追加できます。 新しい環境に、UI で作成した環境と同じ名前を付けます。 たとえば、次の構成では、test と prod の 2 つの環境を定義します。

   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. routingRules を環境にマッピングする virtualhosts プロパティを追加します。

   virtualhosts:
     - name: default
       hostAliases: ["api.example.com"]
       sslCertPath: ./certs/fullchain.pem
       sslKeyPath: ./certs/privkey.pem
       routingRules:
         - env: test

4. クラスタに変更を適用します。envs[] プロパティと virtualhosts[] プロパティの両方を変更した場合は、次のコマンドを使用して変更を適用します。

   apigeectl apply -f overrides-file.yaml -c synchronizer,udca,runtime

   virtualhosts プロパティのみを変更する場合は、--settings フラグを使用して構成の変更を適用します。

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

複数のベースパス ルーティング ルールの構成方法など、仮想ホストの構成の詳細については、仮想ホストの構成をご覧ください。 環境設定要素の完全なリストについては、構成プロパティのリファレンスの envs をご覧ください。