ステップ 11: Helm チャートを使用して Apigee ハイブリッドをインストールする

Apigee ハイブリッド Helm チャートをインストールする

このステップでは Helm を使用して、Apigee ハイブリッドの次のコンポーネントをインストールします。

Apigee オペレーター
Apigee データストア
Apigee テレメトリー
Apigee Redis
Apigee Ingress Manager
Apigee 組織
Apigee 環境

各環境のチャートを 1 つずつインストールします。コンポーネントをインストールする順序は重要です。

注: Helm のアップグレード / インストールコマンドを実行する前に、コマンドの末尾に --dry-run を追加して、Helm ドライラン機能を使用します。サポートされているコマンド、オプション、使用方法の一覧は、helm install --h をご覧ください。

注意: Apigee Helm 移行ツールを使用して apigeectl 管理から Helm 管理に移行するクラスタにチャートをインストールする場合は、以下のすべてのコマンドで --atomic フラグを省略してください。

まだ行っていない場合は、APIGEE_HELM_CHARTS_HOME ディレクトリに移動します。このディレクトリから次のコマンドを実行します。

Apigee オペレーター / コントローラをインストールします。

注: この手順では、昇格されたクラスタ権限が必要です。詳細については、helm -h または helm install -h を実行します。

ドライランを実行します。

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  --atomic \
  -f overrides.yaml \
  --dry-run

チャートをインストールします。

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  --atomic \
  -f overrides.yaml

Apigee オペレーターのインストールを確認します。

helm ls -n apigee-system

NAME           NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                   APP VERSION
operator    apigee-system   3               2023-06-26 00:42:44.492009 -0800 PST    deployed        apigee-operator-1.11.2   1.11.2

可用性をチェックして、稼働していることを確認します。

kubectl -n apigee-system get deploy apigee-controller-manager

NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
apigee-controller-manager   1/1     1            1           7d20h

Apigee データストアをインストールします。

ドライランを実行します。

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

チャートをインストールします。

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

次のステップに進む前に状態をチェックして、apigeedatastore が稼働していることを確認します。

kubectl -n apigee get apigeedatastore default

NAME      STATE       AGE
default   running    2d

Apigee テレメトリーをインストールします。

ドライランを実行します。

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

チャートをインストールします。

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

状態をチェックして、稼働していることを確認します。

kubectl -n apigee get apigeetelemetry apigee-telemetry

NAME               STATE     AGE
apigee-telemetry   running   2d

Apigee Redis をインストールします。

ドライランを実行します。

helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

チャートをインストールします。

helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

状態をチェックして、稼働していることを確認します。

kubectl -n apigee get apigeeredis default

NAME      STATE     AGE
default   running   2d

Apigee Ingress マネージャーをインストールします。

ドライランを実行します。

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

チャートをインストールします。

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

可用性をチェックして、稼働していることを確認します。

kubectl -n apigee get deployment apigee-ingressgateway-manager

NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
apigee-ingressgateway-manager   2/2     2            2           2d

Apigee 組織をインストールします。

ドライランを実行します。

helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

チャートをインストールします。

helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

それぞれの組織の状態をチェックして、稼働していることを確認します。

kubectl -n apigee get apigeeorg

NAME                      STATE     AGE
apigee-org1-xxxxx          running   2d

環境をインストールします。

同時にインストールできる環境は 1 つだけです。--set env=ENV_NAME で環境を指定します。

ドライランを実行します。

helm upgrade ENV_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --atomic \
  --set env=ENV_NAME \
  -f overrides.yaml \
  --dry-run

チャートをインストールします。

helm upgrade ENV_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --atomic \
  --set env=ENV_NAME \
  -f overrides.yaml

それぞれの環境の状態をチェックして、稼働していることを確認します。

kubectl -n apigee get apigeeenv

NAME                          STATE       AGE   GATEWAYTYPE
apigee-org1-dev-xxx            running     2d

環境グループ（virtualhosts）をインストールします。
1. 一度にインストールできる環境グループ（virtualhost）は 1 つだけです。--set envgroup=ENV_GROUP_NAME を使用して環境グループを指定します。overrides.yaml ファイルに記述されている各 env グループに対して、次のコマンドを繰り返します。
  ドライランを実行します。
```
helm upgrade ENV_GROUP_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --atomic \
  --set envgroup=ENV_GROUP_NAME \
  -f overrides.yaml \
  --dry-run
```
  チャートをインストールします。
```
helm upgrade ENV_GROUP_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --atomic \
  --set envgroup=ENV_GROUP_NAME \
  -f overrides.yaml
```
  注: ENV_GROUP_NAME は apigee 名前空間内で一意である必要があります。たとえば、prod env と envgroup がある場合は、この名前を prod-envgroup に設定する必要があります。後の環境グループ名は prod のままにします。
2. ApigeeRoute（AR）の状態を確認します。
  virtualhosts をインストールすると、ApigeeRouteConfig（ARC）が作成されます。これにより、Apigee ウォッチャーがコントロールプレーンから env グループ関連の詳細を pull した時点で、ApigeeRoute（AR）が内部で作成されます。このため、対応する AR の状態が実行中であることを確認します。
```
kubectl -n apigee get arc
```
```
NAME                                STATE   AGE
apigee-org1-dev-egroup                       2d
```
```
kubectl -n apigee get ar
```
```
NAME                                        STATE     AGE
apigee-org1-dev-egroup-xxxxxx                running   2d
```

GKE での Workload Identity の使用

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

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

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

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

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