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

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

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

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

Synchronizer アクセスを有効にする

GCP サービスアカウントを作成し、Apigee 組織管理者のロールをアカウントに追加します。このサービスアカウントは、この後のステップで行う API 呼び出しの認証に使用します。GCP Console を使用すると、サービスアカウントを簡単に作成できます。手順については、GCP ドキュメントのサービスアカウントの作成と管理をご覧ください。
サービスアカウントキーをシステムにダウンロードします。GCP ドキュメントのサービスアカウントキーの作成の手順に従ってください。
ダウンロードしたサービスアカウントキーをサービスアカウントディレクトリ /hybrid-base-directory/hybrid-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-email"]}'

ここで

your_org_name: ハイブリッド組織の名前。
synchronizer-manager-service-account-email: 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 が機能するためには、ホストエイリアスに完全修飾ドメイン名を指定する必要があります。
Synchronizer アクセスを有効にするセクションでダウンロードした Apigee 組織管理者のロールを持つサービスアカウントキーを確認します。
次の 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 組織管理者のロールでダウンロードしたサービスアカウントキーへのシステム上のパスです。

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

curl -v -X PUT \
   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 PUT \
   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"
    } ]
  }
}'

オーバーライドファイルを保存する

オーバーライドファイルを必ず保存するようにしてください。このファイルは、今後のアップグレード、パッチ、またはクラスタ構成のその他の変更を行うために必要です。