指定設定覆寫值
Apigee Hybrid 安裝程式會為許多設定使用預設值,但有些設定沒有預設值。您必須為這些設定提供值,如下文所述。
- 確認您位於
hybrid-base-directory/hybrid-files
目錄。 - 將
overrides-small.yaml
檔案從
目錄複製到$APIGEECTL_HOME
/examplesoverrides
目錄:cp
$APIGEECTL_HOME
/examples/overrides-small.yaml ./overrides/overrides.yaml這個範例檔案提供小型混合式執行階段安裝作業的基本設定,這類設定適合用於首次安裝作業。
cd
至overrides
目錄:- 開啟
overrides.yaml
並新增必要的屬性值,如下所示。以下也提供各個屬性的詳細說明:語法
overrides.yaml
檔案的結構和語法如下。red, bold italics 中的值是您必須提供的屬性值:gcpProjectID: project-id k8sClusterName: cluster-name org: org-name envs: - name: environment-name # The same name of the env you created in the UI hostAlias: test-host-alias sslCertPath: ./certs/test-cert-name.pem sslKeyPath: ./certs/test-key-name.key serviceAccountPaths: synchronizer: ./service-accounts/synchronizer-service-account-name.json udca: ./service-accounts/udca-service-account-name.json mart: hostAlias: mart-host-alias serviceAccountPath: ./service-accounts/mart-service-account-name.json sslCertPath: ./certs/mart-cert-name.pem sslKeyPath: ./certs/mart-key-name.key metrics: serviceAccountPath: ./service-accounts/metrics-service-account-name.json logger: enabled: false
範例
以下範例顯示已完成的覆寫檔案,其中加入了屬性值範例:
gcpProjectID: hybrid-project k8sClusterName: apigee-hybrid org: hybrid-org envs: - name: test hostAlias: "*" sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key serviceAccountPaths: synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json udca: ./service-accounts/hybrid-project-apigee-udca.json mart: hostAlias: "mart.apigee-hybrid-docs.net" serviceAccountPath: ./service-accounts/hybrid-project-apigee-mart.json sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.key metrics: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json logger: enabled: false
- 完成後,請儲存檔案。
cd overrides
下表說明您必須在覆寫檔案中提供的每個屬性值。
變數 | 說明 |
---|---|
project-id | 您的 GCP 專案 ID。 |
cluster-name | Kubernetes 叢集名稱。 |
org-name | Apigee Hybrid 機構的名稱。 |
environment-name | 請使用在 UI 中建立環境時使用的名稱,如步驟 5:在混合式 UI 中新增環境所述。 |
test-host-alias | (必填) 在快速入門中,請使用萬用字元「 只有在使用自行簽署的 TLS 憑證時,才建議在試用安裝作業中使用 |
test-cert-name test-key-name |
輸入您先前在「
為執行階段閘道建立 TLS 憑證」步驟中產生的自行簽署 TLS 金鑰和憑證檔案名稱。這些檔案必須位於 base_directory/hybrid-files/certs 目錄中。例如:sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key |
synchronizer-service-account-name | 您使用 create-service-account 工具產生的同步器服務帳戶金鑰檔案名稱。例如:synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json |
udca-service-account-name | 您使用 create-service-account 工具產生的 udca 服務帳戶金鑰檔案名稱。例如:udca: ./service-accounts/hybrid-project-apigee-udca.json |
mart-host-alias | MART 伺服器端點的合格 DNS 名稱。這個名稱必須與此設定所需的授權 TLS 憑證中使用的通用名稱 (CN) 相符。例如:
mart.mydomain.com
|
mart-service-account-name | 您使用 create-service-account 工具產生的 Mart 服務帳戶金鑰檔案名稱。 |
mart-cert-name mart-key-name |
輸入先前在「為 MART 閘道建立 TLS 憑證」步驟中產生的授權 TLS 金鑰和憑證檔案名稱。這些檔案必須位於 base_directory/hybrid-files/certs 目錄中。例如:sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.key |
metrics-service-account-name | 您使用 create-service-account 工具產生的成效評估服務帳戶金鑰檔案名稱。例如:
serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json |
摘要
設定檔會告訴 Kubernetes 如何將混合型元件部署至叢集。接下來,您將將這項設定套用至叢集。
1 2 3 (下一頁) 步驟 4:安裝混合式執行階段