クラスタに構成を適用する
次の手順で Apigee ハイブリッドをクラスタにインストールします。
- 現在のディレクトリが
hybrid-base-directory/hybrid-files
ディレクトリであることを確認します。cd $HYBRID_FILES
- 次のコマンドを使用して、
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
- (プラットフォームが Anthos on bare metal、AWS on GKE、EKS、GKE On-Prem の場合のみ)次のコマンドを使用して、
KUBECONFIG
変数が設定されていることを検証します。echo ${KUBECONFIG}
- ドライランの初期化を行います。ドライランを行うと、クラスタが変更される前にエラーがないかどうかを確認できます。次のように
--dry-run
フラグを指定してinit
コマンドを実行します。${APIGEECTL_HOME}/apigeectl init -f overrides/overrides.yaml --dry-run=client
- エラーがなければ、次のように
init
コマンドを実行します。${APIGEECTL_HOME}/apigeectl init -f overrides/overrides.yaml
init
コマンドにより、Apigee デプロイメント サービスの Apigee Deployment Controller と Apigee Admission Webhook がインストールされます。 - デプロイのステータスを確認するには、次のコマンドを使用します。
${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml
kubectl get pods -n apigee-system
kubectl get pods -n apigee
Pod の準備ができたら、次のステップに進みます。
- ドライランのインストールを行います。
--dry-run
フラグを指定してapply
コマンドを実行します。${APIGEECTL_HOME}/apigeectl apply -f overrides/overrides.yaml --dry-run=client
-
エラーがなければ、次のコマンドを使用して Apigee 固有のランタイム コンポーネントをクラスタに適用できます。
${APIGEECTL_HOME}/apigeectl apply -f overrides/overrides.yaml
- デプロイのステータスを確認するには、次のコマンドを実行します。
${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