ステップ 9: ハイブリッド ランタイムをインストールする

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

次の手順で Apigee ハイブリッドをクラスタにインストールします。

  1. 現在のディレクトリが hybrid-base-directory/hybrid-files ディレクトリであることを確認します。
    cd $HYBRID_FILES
  2. 次のコマンドを使用して、kubectl が正しいコンテキストに設定されていることを確認します。現在のコンテキストは、Apigee ハイブリッドをデプロイするクラスタに設定する必要があります。
    kubectl config current-context

    結果に、Apigee ハイブリッドをデプロイするクラスタの名前が含まれている必要があります。たとえば、GKE では、コンテキスト名は通常、gke_project-id_cluster-location_cluster-name の形式になります。

    gke_my-project_us-central1_my-cluster

    コンテキスト内のクラスタ名が一致しない場合は、次のコマンドを使ってクラスタの gcloud 認証情報を取得し、kubectl コンテキストを設定します。

    リージョン クラスタ

    gcloud container clusters get-credentials $CLUSTER_NAME \
--region $CLUSTER_LOCATION \
--project $PROJECT_ID

    ゾーンクラスタ

    gcloud container clusters get-credentials $CLUSTER_NAME \
--zone $CLUSTER_LOCATION \
--project $PROJECT_ID
  3. （プラットフォームが Anthos on bare metal、AWS on GKE、EKS、GKE On-Prem の場合のみ）次のコマンドを使用して、KUBECONFIG 変数が設定されていることを検証します。
    echo ${KUBECONFIG}
  4. ドライランの初期化を行います。ドライランを行うと、クラスタが変更される前にエラーがないかどうかを確認できます。次のように --dry-run フラグを指定して init コマンドを実行します。
    ${APIGEECTL_HOME}/apigeectl init -f overrides/overrides.yaml --dry-run=client
  5. エラーがなければ、次のように init コマンドを実行します。
    ${APIGEECTL_HOME}/apigeectl init -f overrides/overrides.yaml

    init コマンドにより、Apigee デプロイメント サービスの Apigee Deployment Controller と Apigee Admission Webhook がインストールされます。

  6. デプロイのステータスを確認するには、次のコマンドを使用します。
    ${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml
     
    kubectl get pods -n apigee-system
     
    kubectl get pods -n apigee

    Pod の準備ができたら、次のステップに進みます。

  7. ドライランのインストールを行います。--dry-run フラグを指定して apply コマンドを実行します。
    ${APIGEECTL_HOME}/apigeectl apply -f overrides/overrides.yaml --dry-run=client
  8. エラーがなければ、次のコマンドを使用して Apigee 固有のランタイム コンポーネントをクラスタに適用できます。
    ${APIGEECTL_HOME}/apigeectl apply -f overrides/overrides.yaml
  9. デプロイのステータスを確認するには、次のコマンドを実行します。
    ${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml

    Pod の準備がすべて整うまで、この手順を繰り返します。Pod の起動には数分かかることがあります。

GKE での Workload Identity の使用

GKE に Apigee ハイブリッドをインストールし、サービス アカウントを認証するように Workload Identity を構成する場合は、次のステップで、クラスタの Kubernetes サービス アカウントと Google サービス アカウント間の関連付けを構成します。

1 2 3 4 5 6 7 8 9 （次）ステップ 10: Workload Identity を設定する

その他のすべてのインストール

次のステップでは、Apigee Ingress ゲートウェイを構成し、プロキシをデプロイしてインストールをテストします。

（次）ステップ 1: Apigee ingress を公開する 2