環境の作成

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

環境の作成について

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

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

環境の追加と構成に関する手順については、ステップ 5: 環境を追加すると、構成のオーバーライドを指定するをご覧ください。

環境の作成方法

  1. Apigee UI または Create Environments API を使用して、1 つ以上の新しい環境を作成します。基本的な手順については、ステップ 5: 環境を追加するをご覧ください。
  2. 新しい環境定義をオーバーライド ファイルの envs[] プロパティに追加します。このプロパティは配列で、複数の環境定義を追加できます。新しい環境に、UI で作成した環境と同じ名前を付けます。たとえば、次の構成では、testprod の 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 をご覧ください。