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

安裝 Apigee Hybrid Helm 資訊套件

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

  • Apigee 運算子
  • Apigee 資料存放區
  • Apigee 遙測
  • Apigee Redis
  • Apigee Ingress 管理員
  • 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 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

  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 檔案中提及的每個環境群組，重複執行下列指令：

      模擬測試：

      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)，一旦 Apigee 監控程式從控制層提取環境群組相關詳細資料，ARC 就會在內部建立 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

搭配 Workload Identity 使用 GKE

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

1 2 3 4 5 6 7 8 9 10 11 (NEXT) Step 12: Set up Workload Identity

所有其他安裝項目

在下一個步驟中，您將設定 Apigee Ingress 閘道，並部署 Proxy 來測試安裝作業。

(下一步) 步驟 1：公開 Apigee Ingress 2