步驟 11：使用 Helm 資訊套件安裝 Apigee Hybrid

安裝 Apigee Hybrid Helm 資訊套件

在這個步驟中，您將使用 Helm 安裝下列 Apigee Hybrid 元件：

  • Apigee 運算子
  • Apigee 資料儲存庫
  • Apigee 遙測
  • Apigee Redis
  • Apigee 入口管理工具
  • Apigee 機構
  • 您的 Apigee 環境

您將逐一安裝每個環境的圖表。安裝元件的順序很重要。

  1. 如果尚未建立，請前往 APIGEE_HELM_CHARTS_HOME 目錄。在該目錄中執行下列指令。
  2. 安裝 Apigee Operator/Controller：

    模擬測試：

    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 Operator 安裝作業：

    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

  3. 安裝 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

  4. 安裝 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

  5. 安裝 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

  6. 安裝 Apigee 入口管理工具：

    模擬測試：

    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

  7. 安裝 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

  8. 安裝環境。

    您一次只能安裝一個環境。使用 --set env=ENV_NAME 指定環境：

    模擬測試：

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

      ENV_RELEASE_NAME 是用於追蹤 apigee-env 圖表安裝和升級情形的名稱。此名稱不得與安裝程序中的其他 Helm 版本名稱重複。通常與 ENV_NAME 相同。不過，如果環境與環境群組的名稱相同，您必須為環境和環境群組使用不同的版本名稱，例如 dev-env-release 和 dev-envgroup-release。如要進一步瞭解 Helm 中的版本，請參閱 Helm 說明文件中的「三個重要概念 」。

    安裝圖表：

    helm upgrade ENV_RELEASE_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
  9. 安裝環境群組 (virtualhosts)。
    1. 您必須一次安裝一個環境群組 (虛擬主機)。使用 --set envgroup=ENV_GROUP_NAME 指定環境群組。針對 overrides.yaml 檔案中提到的每個 env 群組重複執行下列指令：

      模擬測試：

      helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --atomic \
  --set envgroup=ENV_GROUP_NAME \
  -f overrides.yaml \
  --dry-run

        ENV_GROUP_RELEASE_NAME 是用於追蹤 apigee-virtualhosts 圖表安裝和升級情形的名稱。此名稱不得與安裝程序中的其他 Helm 版本名稱重複。通常與 ENV_GROUP 相同。不過，如果環境群組的名稱與安裝環境相同，您必須為環境群組和環境使用不同的版本名稱，例如 dev-envgroup-release 和 dev-env-release。如要進一步瞭解 Helm 中的版本，請參閱 Helm 說明文件中的「 三大重要概念」。

      安裝圖表：

      helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --atomic \
  --set envgroup=ENV_GROUP_NAME \
  -f overrides.yaml
    2. 檢查 ApigeeRoute (AR) 的狀態。

      安裝 virtualhosts 會建立 ApigeeRouteConfig (ARC)，而 ApigeeRoute (AR) 會在 Apigee 監控器從控制平面擷取環境群組相關詳細資料後，在內部建立。因此，請檢查對應的 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

搭配 Workload Identity 的 GKE

如果您要在 GKE 上安裝 Apigee hybrid，並且要設定 Workload Identity 來驗證服務帳戶，請在下一個步驟中，為叢集設定 Kubernetes 服務帳戶與 Google 服務帳戶之間的關聯。

1 2 3 4 5 6 7 8 9 10 4 5 7 8 8 9 10 10 11 9 10 11 9 10 11 (NEXT) 步驟 12：設定 Workload Identity

所有其他安裝

在下一個步驟中，您將設定 Apigee 入口網關，並部署 Proxy 來測試安裝作業。

(NEXT) 步驟 1：公開 Apigee 入口 2