環境の作成

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

環境の作成について

環境の作成は次の 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 をご覧ください。