このセクションでは Synchronizer について説明します。
Synchronizer の概要
Apigee ハイブリッドでの Synchronizer の主な役割は、管理プレーンから提供されるランタイム契約をポーリングし、ダウンロードすることです。契約によって通知される情報には、API プロキシ、API プロダクト、キャッシュ、仮想ホストなどがあります。
ランタイム プレーンで実行中の Synchronizer インスタンスにより、定期的に管理プレーンがポーリングされて契約がダウンロードされ、ローカルのランタイム インスタンスで同じ情報が使用できるようになります。
1 つの Synchronizer により、同じ Pod にデプロイされた複数の Message Processor がサポートされます。
Synchronizer アクセスを有効にする
プロキシ バンドルやリソースなどの Apigee アーティファクトを管理プレーンから pull するには、Synchronizer の権限を付与する必要があります。管理プレーンからランタイム プレーンにアーティファクトを pull するには、Apigee API を呼び出して Synchronizer を承認する必要があります。
- GCP の設定手順で説明したように Apigee API が有効になっていることを確認します。詳細については、ステップ 3: API を有効にするをご覧ください。
- サービス アカウントの作成の一環でダウンロードした書き込み可能な GCP サービス アカウント キー(JSON ファイル)を検索します。このサービス アカウントには Apigee 組織管理者のロールがあり、名前は apigee-org-admin です。このサービス アカウントをまだ作成していない場合は、アカウントを作成してから続行する必要があります。
-
GOOGLE_APPLICATION_CREDENTIALS
環境変数をサービス アカウント キーが置かれているパスに設定します。export GOOGLE_APPLICATION_CREDENTIALS=your_sa_credentials_file.json
- setSyncAuthorization API を呼び出して Synchronizer に必要な権限を有効にします。
curl -X POST -H "Authorization: Bearer $(gcloud auth application-default print-access-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 管理者ロールを持つサービス アカウントの名前。この名前はメールアドレスのような形式になっています。たとえば、my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com
のようになります。
例:
curl -X POST -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type:application/json" \ "https://apigee.googleapis.com/v1/organizations/my_org:setSyncAuthorization" \ -d '{"identities":["serviceAccount:my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com"]}'
この API の詳細については、SyncAuthorization API をご覧ください。
- サービス アカウントが設定されていることを確認するには、次の API を呼び出してサービス アカウントのリストを取得します。
curl -X POST -H "Authorization: Bearer $(gcloud auth application-default print-access-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=" }