ステップ 4: ハイブリッドをインストールする

構成をクラスタに適用する

Apigee ハイブリッドをクラスタにインストールするには:

hybrid-base-directory/apigee-hybrid ディレクトリに移動します。
init コマンドを実行します。
```
$APIGEECTL_HOME/apigeectl init -f overrides/overrides.yaml
```
init コマンドにより、Apigee デプロイメントサービスの Apigee Deployment Controller および Apigee Admission Webhook がインストールされ、Apigee 以外のコンポーネントである Istio と cert-manager がデプロイされます。
デプロイメントのステータスを確認するには、次のコマンドを使用します。
```
$APIGEECTL_HOME/apigeectl check-ready -f overrides/overrides.yaml
```
および
```
kubectl get pods -n apigee
```
ポッドの準備ができたら、次のステップに進みます。
「ドライラン」インストールを実行します。--dry-run=true フラグを指定して apply コマンドを実行します。ドライランでは、クラスタが変更される前にエラーがないかどうかを確認できます。
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml --dry-run=true
```
エラーがなければ、Apigee 固有のランタイムコンポーネントをクラスタに適用できます。
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
```
デプロイメントのステータスをチェックするには、次のコマンドを実行します。
```
$APIGEECTL_HOME/apigeectl check-ready -f overrides/overrides.yaml
```
ポッドの準備がすべて整うまで、このステップを繰り返します。ポッドの起動には数分かかることがあります。

Synchronizer アクセスを有効にする

GCP サービスアカウントを作成し、Apigee 組織管理者の役割をアカウントに追加します。このサービスアカウントは、この後のステップで行う API 呼び出しの認証に使用します。GCP Console を使用すると、サービスアカウントを簡単に作成できます。手順については、GCP ドキュメントのサービスアカウントの作成と管理をご覧ください。
サービスアカウントキーをシステムにダウンロードします。GCP ドキュメントのサービスアカウントキーの作成の手順に従ってください。
ダウンロードしたサービスアカウントキーをサービスアカウントディレクトリ /hybrid-base-directory/apigee-files/service-accounts に移動します。
次の 2 つのコマンドを実行して、トークンを取得します。
```
    export GOOGLE_APPLICATION_CREDENTIALS=org-admin-service-account-file
    export TOKEN=$(gcloud auth application-default print-access-token)
```
org-admin-service-account-file は、ダウンロードした Apigee 組織管理者の役割を持つサービスアカウントキーへのシステム上のパスです。

setSyncAuthorization API を呼び出して、Synchronizer に必要な権限を有効にします。

    curl -X POST -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type:application/json" \
      "https://apigee.googleapis.com/v1/organizations/your_org_name:setSyncAuthorization" \
       -d '{"identities":["serviceAccount:synchronizer-manager-service-account-name"]}'

ここで

your_org_name: ハイブリッド組織の名前。
synchronizer-manager-service-account-name: Apigee Synchronizer 管理者の役割を持つサービスアカウントの名前。名前の形式はメールアドレスと同様です。例: apigee-synchronizer@my-project.iam.gserviceaccount.com

例:

    curl -X POST -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type:application/json" \
      "https://apigee.googleapis.com/v1/organizations/my_org:setSyncAuthorization" \
       -d '{"identities":["serviceAccount:apigee-synchronizer@my-project.iam.gserviceaccount.com"]}'

サービスアカウントが設定されたことを確認するには、次の API を呼び出してサービスアカウントのリストを取得します。

    curl -X POST -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type:application/json" \
      "https://apigee.googleapis.com/v1/organizations/your_org_name:getSyncAuthorization" \
       -d ''

出力は次のようになります。

    {
       "identities":[
          "serviceAccount:my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com"
       ],
       "etag":"BwWJgyS8I4w="
    }

MART IP を組織に追加する

MART エンドポイントの IP アドレスを Apigee 組織に追加する必要があります。この値は、前にオーバーライドファイルの mart.hostAlias プロパティの値として設定した値です。MART を介してランタイムプレーンと通信するために、管理プレーンはこのアドレスを必要とします。

MART IP を組織に追加するには、次の手順を実行します。

前にオーバーライドファイルの mart.hostAlias プロパティに設定した値を確認します。MART が機能するためには、ホストエイリアスに完全修飾ドメイン名を指定する必要があります。
前にダウンロードした Apigee 組織管理者の役割を持つサービスアカウントキーを確認します。サービスアカウントの追加の説明をご覧ください。この後の手順を完了するには、この JSON キーファイルへのパスが必要です。

次の Management API を呼び出して、MART エンドポイントを使用する組織を更新します。

curl -v -X POST \
       https://apigee.googleapis.com/v1/organizations/your_org_name \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer $TOKEN" \
      -d '{
      "name" : "your_org_name",
      "properties" : {
        "property" : [ {
          "name" : "features.hybrid.enabled",
          "value" : "true"
        }, {
          "name" : "features.mart.server.endpoint",
          "value" : "https://HOST_ALIAS_DNS"
        } ]
      }
    }'

以下に例を示します。必ず接頭辞「https://」をドメイン名に追加してください。

curl -v -X POST \
       https://apigee.googleapis.com/v1/organizations/my_organization \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer $TOKEN" \
      -d '{
      "name" : "my_organization",
      "properties" : {
        "property" : [ {
          "name" : "features.hybrid.enabled",
          "value" : "true"
        }, {
          "name" : "features.mart.server.endpoint",
          "value" : "https://foo-mart.example.com"
        } ]
      }
    }'