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

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

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

現在のディレクトリが hybrid-base-directory/hybrid-files ディレクトリであることを確認します。
```
cd $HYBRID_FILES
```
注: オーバーライドファイルは、hybrid-base-directory/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

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

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

リージョン クラスタ

ゾーンクラスタ

GKE での Workload Identity の使用

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

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

リージョンクラスタ