設定屬性參考資料

這項元素已在以下版本推出：1.3.0

預設值： iloveapis123

選用

Kubernetes 密鑰的名稱，其中包含用於計算雜湊值的鹽值，可在將使用者資料傳送至 Apigee Analytics 前進行模糊處理。如果您未指定鹽值，系統會預設使用 iloveapis123。建立密鑰，並將鹽值做為輸入值。您可以在多個叢集中使用相同的鹽值，確保叢集之間的雜湊結果一致。

Apigee 會先使用 SHA512 雜湊原始值，再將資料從執行階段層傳送至控制層。

請參閱「模糊處理使用者資料以進行數據分析」。

預設值： https://apigee.googleapis.com

定義安裝項目中所有 API 的 API 路徑。

如果混合式安裝作業使用以下格式的資料居住地，則必須使用此屬性：

contractProvider: https://CONTROL_PLANE_LOCATION-apigee.googleapis.com

其中 CONTROL_PLANE_LOCATION 是用來儲存控制平面資料 (例如 Proxy 套件) 的位置。如需清單，請參閱「可用的 Apigee API 控制層區域」。

例如：

contractProvider: https://us-apigee.googleapis.com

預設值： true

將其設為 true (預設值) 時，即可啟用 Apigee 的以指標為依據的自動調度資源。設為 false 可停用自訂自動調度資源功能。

更新 apigee-telemetry 圖表，將變更套用至 customAutoscaling.enabled。

預設值： false

必要

enhanceProxyLimits 是 Apigee 強化的個別環境 Proxy 限制功能的必要條件。如果混合式機構有權使用強化的個別環境 Proxy 限制，請將這個值設為 enhanceProxyLimits: true。

請參閱：

• API Proxy 限制。
• 強化每個環境的 Proxy 限制。
• 訂閱授權。

設定 enhanceProxyLimits: true 是設定 Proxy Chaining、Endpoint Chaining 和 ServiceCallout Chaining 的必要條件。詳情請參閱：

• 鏈結多個 API Proxy
• ServiceCallout 政策

更新每個環境群組的 apigee-org 圖表和 apigee-virtualhost 圖表，將變更套用至 enhanceProxyLimits。

這項元素已在以下版本推出：1.0.0

預設值： none

必要

Google Cloud 專案的 ID。可搭配 k8sClusterName (已淘汰) 和 gcpRegion (已淘汰) 使用，用於識別專案，並決定 apigee-logger 和 apigee-metrics 要將資料推送至何處。

這項功能已在以下版本推出：1.0.0

預設值： us-central1

必要

您 Kubernetes 叢集的最近 Google Cloud 區域或區域。可搭配 gcpProjectID (已淘汰) 和 k8sClusterName (已淘汰) 使用，用於識別專案，並決定 apigee-logger 和 apigee-metrics 將資料推送至何處。

預設值：無

私人映像檔容器存放區的網址，用於從私人存放區提取所有 apigee 元件的映像檔。

hub 會為所有 Apigee Hybrid 元件提供預設路徑。如果您使用的是私人存放區，請使用 hub 為所有元件設定存放區網址，而不要為每個元件使用個別的 image.url 屬性。只有在您為特定元件使用個別存放區時，才設定個別網址。

每個個別元件的圖片路徑會是 hub 的值加上元件的圖片名稱和標記。

舉例來說，如果 hub 的值為 private-docker-host.example.com，個別元件會自動解析圖片路徑：

hub: private-docker-host.example.com

為：

containers:
- name: apigee-udca
  image: private-docker-host.example.com/apigee-udca:1.15.0
  imagePullPolicy: IfNotPresent

其他元件也會遵循類似的模式。

使用 apigee-pull-push --list 即可查看所有元件的目前存放區網址。

請參閱「使用 Apigee hybrid 搭配私人映像檔存放區」。

您可以使用下列屬性，個別覆寫元件的圖片網址：

• ao.image.url
• apigeeIngressGateway.image.url
• cassandra.image.url
• cassandra.auth.image.url
• cassandra.backup.image.url
• cassandra.restore.image.url
• connectAgent.image.url
• ingressGateways[].image.url
• istiod.image.url
• kubeRBACProxy.image.url
• logger.image.url
• mart.image.url
• metrics.adapter.image.url
• metrics.prometheus.image.url
• metrics.sdSidecar.image.url
• mintTaskScheduler.image.url
• redis.image.url
• redis.envoy.image.url
• runtime.image.url
• synchronizer.image.url
• udca.image.url
• udca.fluentd.image.url
• watcher.image.url

預設值：無

已設為 docker-registry 類型的 Kubernetes 密碼名稱，用於從私人存放區提取映像檔。

預設值：無

必要

此安裝作業的專屬 ID。

用於識別這個執行個體的專屬字串。可以是任意英文字母和數字的組合，長度上限為 63 個半形字元。

這項功能已在以下版本推出：1.0.0

預設值：無

混合專案執行的 Kubernetes (K8S) 專用叢集名稱。可搭配 gcpProjectID (已淘汰) 和 gcpRegion (已淘汰) 使用，用於識別專案，並決定 apigee-logger 和 apigee-metrics 將資料推送至何處。

預設值： defaults.org.kmsEncryptionKey

選填。請只使用 kmsEncryptionKey 或 kmsEncryptionPath 或 kmsEncryptionSecret 其中一個。

Apigee KMS 資料加密金鑰的本機檔案系統路徑。

預設值：無

選填。請只使用 kmsEncryptionKey 或 kmsEncryptionPath 或 kmsEncryptionSecret 其中一個。

包含以 Base64 編碼的加密金鑰檔案的路徑。請參閱「資料加密」一節。

預設值：無

選填。請只使用 kmsEncryptionKey 或 kmsEncryptionPath 或 kmsEncryptionSecret 其中一個。

包含 Base64 編碼加密金鑰的 Kubernetes 密鑰。請參閱「資料加密」一節。

預設值：無

選填。請只使用 kmsEncryptionKey 或 kmsEncryptionPath 或 kmsEncryptionSecret 其中一個。

包含 Base64 編碼加密金鑰的 Kubernetes 密鑰名稱。請參閱「資料加密」一節。

預設值： defaults.org.kmsEncryptionKey

選填。請只使用 kvmEncryptionKey 或 kvmEncryptionPath 或 kvmEncryptionSecret 其中一個。

Apigee KVM 資料加密金鑰的本機檔案系統路徑。

預設值：無

選填。請只使用 kvmEncryptionKey 或 kvmEncryptionPath 或 kvmEncryptionSecret 其中一個。

包含以 Base64 編碼的加密金鑰檔案的路徑。請參閱「資料加密」一節。

預設值：無

選填。請只使用 kvmEncryptionKey 或 kvmEncryptionPath 或 kvmEncryptionSecret 其中一個。

包含 Base64 編碼加密金鑰的 Kubernetes 密鑰。請參閱「資料加密」一節。

預設值：無

選填。請只使用 kvmEncryptionKey 或 kvmEncryptionPath 或 kvmEncryptionSecret 其中一個。

包含 Base64 編碼加密金鑰的 Kubernetes 密鑰名稱。請參閱「資料加密」一節。

預設值： false

對於多機構叢集，這個屬性可讓機構的評估指標匯出至 gcp.projectID 屬性中列出的專案。在多機構叢集中，為每個機構在覆寫檔案中套用這項設定。詳情請參閱「將多個混合式機構新增至叢集」。

預設值： apigee

要安裝 Apigee 元件的 Kubernetes 叢集命名空間。

這項元素已在以下版本推出：1.0.0

預設值：無

必要

在混合型安裝期間，Apigee 為您佈建的支援混合型機構。機構是 Apigee 中的頂層容器，其中包含所有 API 代理程式和相關資源。如果值為空白，請在建立後立即更新為貴機構名稱。

預設值： true

在機構層級啟用通用資料收集代理人服務 (UDCA)，用於擷取數據分析、營利和偵錯 (追蹤) 資料，並傳送至位於控制平面的統一數據分析平台 (UAP)。

機構層級 UDCA 會為所有 Apigee 環境使用單一 Google 服務帳戶。服務帳戶必須具備 Apigee Analytics 代理人 (roles/apigee.analyticsAgent) 角色。

使用 udca.serviceAccountPath 屬性指定服務帳戶金鑰檔案的路徑，或是在 overrides.yaml 設定檔中使用 udca.serviceAccountRef 屬性，在 Kubernetes 密鑰中提供金鑰。

如果您偏好為每個環境使用個別的 UDCA 代理程式，請設定 orgScopedUDCA: false，並設定 envs[].serviceAccountPaths.udca 和 envs[].serviceAccountSecretRefs.udca 的值。

另請參閱：udca。

預設值： "1150" (您的 Apigee Hybrid 版本，不含句點。例如，如果是 1.12.0 版，預設值就是 "1120")。

Apigee hybrid 支援滾動式 Kubernetes 更新，可透過逐步更新 Pod 例項，讓部署作業更新作業在完全不停機的情況下進行。

更新特定 YAML 覆寫值導致底層 Kubernetes PodTemplateSpec 變更時，客戶的 override.yaml 中也必須變更 revision 覆寫值屬性。這是必要步驟，可讓基礎 Kubernetes ApigeeDeployment (AD) 控制器安全地進行從舊版到新版的滾動更新。您可以使用任何小寫文字值，例如：blue、a、1.0.0

變更並套用 revision 屬性後，所有元件都會進行逐步更新

如要變更下列物件的屬性，就必須更新 revision：

• nodeSelector
• envs
• imagePullSecrets
• gcpProjectID
• k8sClusterName
• contractProvider
• org

詳情請參閱「逐步更新」。

預設值：無

用於在 Vault 中儲存服務帳戶金鑰的機構專屬密鑰提供者類別名稱 (SecretProviderClass)。

請參閱「在 Hashicorp Vault 中儲存服務帳戶金鑰」。

預設值： true

啟用嚴格驗證 Apigee 機構與 Google Cloud 專案之間的連結，並檢查環境群組是否存在。

另請參閱 org。

預設值： true

啟用服務帳戶權限的嚴格驗證。這會使用 Cloud Resource Manager API 方法 testIamPermissions，驗證提供的服務帳戶是否具備必要權限。如果是 Apigee 機構的服務帳戶，專案 ID 檢查項目就是對應至機構的專案 ID。對於指標和記錄器，系統會根據 gcpProjectID overrides.yaml 設定檢查專案。

另請參閱 gcpProjectID。

預設值： true

停止 Apigee 為客戶安裝的 Cloud Service Mesh 提供設定。

• 如果使用 Apigee 入口閘道進行混合式安裝，請將此值設為 true。
• 如果是使用 Cloud Service Mesh 的混合式安裝作業 (Apigee 混合式版本 1.8 以下)，請將這個值設為 false。

預設值： true

在 true (預設) 時，Apigee Hybrid 不會直接管理 Kubernetes ClusterRole 和 ClursterRoleBinding。如果您有需要管理這些資源的程序，則必須由具備正確權限的使用者執行該程序。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： 250m

Kubernetes 容器中資源的 CPU 限制 (以毫核為單位)。

預設值： 256Mi

Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。

預設值： 250m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核為單位。

預設值： 256Mi

Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容許值與污點比對後的效果。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容許值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值：無

必要

用於指定輸入閘道服務專屬 Kubernetes 節點的節點選取器標籤鍵。

請參閱「 設定專屬節點集區」。

預設值：無

用於指定輸入閘道服務的專屬 Kubernetes 節點，並覆寫 nodeSelector.apigeeData 設定的選用節點選取器標籤值。

請參閱 nodeSelector。

預設值： 4

hybrid 可自動新增的入口網關 Pod 數量上限，可用於自動調度資源。

預設值： 2

可用於自動調整資源配置的入口網關 Pod 數量下限。

預設值： 75

在 ReplicaSet 中，CPU 使用率的臨界值，以可用 CPU 資源總數的百分比表示。

當 CPU 使用率超過這個值時，混合型會逐漸增加 ReplicaSet 中的 Pod 數量，最多可達 apigeeIngressGateway.replicaCountMax。

如要進一步瞭解 Kubernetes 中的資源調度功能，請參閱 Kubernetes 說明文件中的「水平 Pod 自動調度」一節。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容忍度與污點配對的效果。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容忍值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

用於註解 Pod 的選用鍵/值對應。詳情請參閱「自訂註解」。

預設值： iloveapis123

必要

Cassandra 管理員的密碼。管理員使用者可用於在 Cassandra 叢集中執行的任何管理活動，例如備份和還原。

預設值： iloveapis123

必要

Cassandra 資料定義語言 (DDL) 使用者的密碼。由 MART 用於任何資料定義工作，例如建立、更新和刪除鍵空間。

預設值： iloveapis123

必要

啟用驗證功能時，系統為預設 Cassandra 使用者建立的密碼。設定 Cassandra 驗證時，必須重設這組密碼。請參閱「為 Cassandra 設定 TLS」。

預設值： iloveapis123

必要

Cassandra 資料操縱語言 (DML) 使用者的密碼。用戶端通訊會使用 DML 使用者，讀取及寫入 Cassandra 的資料。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： iloveapis123

必要

Cassandra JMX 作業使用者的密碼。用於驗證 Cassandra JMX 介面並與其通訊。

預設值： jmxuser

必要

Cassandra JMX 作業使用者的使用者名稱。用於驗證 Cassandra JMX 介面並與其通訊。

預設值： iloveapis123

必要

Cassandra Jolokia JMX 作業使用者的密碼。用於驗證 Cassandra JMX API 並與其通訊。

預設值： apigee

必要

Cassandra Jolokia JMX 作業使用者的使用者名稱。用於驗證 Cassandra JMX API 並與其通訊。

預設值：無

儲存在 Kubernetes 機密中，包含 Cassandra 使用者和密碼的檔案名稱。您可以按照下列操作說明建立密鑰：建立密鑰。

另請參閱：

• 將資料儲存在 Kubernetes 密鑰中
• Kubernetes 說明文件中的「Secrets」
• 請參閱 Kubernetes 說明文件中的 使用 kubectl 建立密鑰

預設值：無

Cassandra 機密資料儲存空間政策。設定時，必須與參照外部密鑰提供者的 SecretProviderClass 相符，例如 Hashicorp Vault。如果未設定，Apigee Hybrid 會使用以下位置儲存的使用者名稱和密碼：

• cassandra.auth.admin.password
• cassandra.auth.ddl.password
• cassandra.auth.default.password
• cassandra.auth.dml.password
• cassandra.auth.jmx.password
• cassandra.auth.jmx.username
• cassandra.auth.jolokia.password
• cassandra.auth.jolokia.username

或儲存在下列位置的 Kubernetes 密鑰：

• cassandra.auth.secret

如需建立政策的操作說明，請參閱「在 Hashicorp Vault 中儲存 Cassandra 密鑰」。

預設值： GCP

備份供應商的名稱。支援的值：GCP、HYBRID 和 CSI。將值設為：

• GCP 將備份封存檔儲存至 Google Cloud Storage。
• HYBRID 將備份封存檔儲存在遠端 SSH 伺服器上。
• CSI (建議) 使用 Kubernetes CSI 磁碟區快照進行備份。如要瞭解 Google Cloud、AWS 和 Azure 等雲端平台的 CSI 備份和還原作業，請參閱 CSI 備份和還原。

預設值：無

如果已啟用備份功能，且 cassandra.backup.cloudProvider 設為 GCP，則為必填欄位。

現有 Google Cloud Storage 值區的名稱，用於儲存備份封存檔案。如需建立值區，請參閱「 建立值區」。

預設值： false

系統預設不會啟用資料備份功能。如要啟用，請設為 true。

請參閱「Cassandra 備份與復原」。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值：無

如果已啟用備份功能，且 cassandra.backup.cloudProvider 設為 HYBRID，則為必填欄位。

本機檔案系統中 SSH 私密金鑰檔案的路徑。

預設值： 0 2 * * *

備份 Cron 工作的排程。

請參閱「Cassandra 備份與復原」。

預設值：無

如果已啟用備份功能，且 cassandra.backup.cloudProvider 設為 HYBRID，則為必填欄位。

遠端 SSH 備份伺服器的 IP 位址。

預設值：無

具有 Storage 物件管理員 (roles/storage.objectAdmin) 角色的 Google 服務帳戶金鑰檔案路徑。這個 Google 服務帳戶會用來將備份封存檔上傳至指定的 cassandra.backup.dbStorageBucket。

如果已啟用備份功能，且 cassandra.backup.cloudProvider 已設為 GCP，則必須執行下列任一操作，確保 Apigee Hybrid 能夠存取 Google Cloud Storage 值區，以便上傳備份檔案：

• 指定 cassandra.backup.serviceAccountPath。
• 指定 cassandra.backup.serviceAccountRef。
• 已設定 GKE 中 Apigee Hybrid 的工作負載身分。
• 已設定 在 AKS 或 EKS 中為 Apigee Hybrid 設定 Workload Identity Federation。

預設值：無

現有 Kubernetes 密鑰的名稱，用於儲存具有 Storage 物件管理員 (roles/storage.objectAdmin) 角色的 Google 服務帳戶金鑰檔案內容。這個 Google 服務帳戶會用於將備份封存檔案上傳至指定的 cassandra.backup.dbStorageBucket。

如果已啟用備份功能，且 cassandra.backup.cloudProvider 已設為 GCP，則必須執行下列任一操作，確保 Apigee Hybrid 能夠存取 Google Cloud Storage 值區，以便上傳備份檔案：

• 指定 cassandra.backup.serviceAccountPath。
• 指定 cassandra.backup.serviceAccountRef。
• 已設定 GKE 中 Apigee Hybrid 的工作負載身分。
• 已設定 在 AKS 或 EKS 中為 Apigee Hybrid 設定 Workload Identity Federation。

預設值：無

如果已啟用備份功能，且 cassandra.backup.cloudProvider 設為 HYBRID，則為必填欄位。

可以是 apigee 使用者主目錄的絕對或相對路徑。

備份 SSH 伺服器上的備份目錄名稱。

預設值： apigeecluster

指定 Cassandra 叢集的名稱。

預設值： dc-1

指定 Cassandra 節點的資料中心。

預設值：無

如果將 hostNetwork 設為 true，系統會為您將 DNS 政策設為 ClusterFirstWithHostNet。

預設值：無

Cassandra 叢集節點的主機名稱或 IP。如未設定，系統會使用 Kubernetes 本機服務。

預設值： 100M

系統為較新的物件分配的 JVM 記憶體量，以 MB 為單位。

預設值： false

啟用 Kubernetes hostNetwork 功能。如果 Pod 網路命名空間沒有叢集間的連線 (叢集會在「島嶼網路模式」中執行)，Apigee 會在多區域安裝作業中使用這項功能，以便在 Pod 之間進行通訊。這是非 GKE 安裝作業的預設情況，包括 VMware 或裸機上的 Google Distributed Cloud、AWS 上的 GKE、AKS、EKS 和 OpenShift。

將 cassandra.hostNetwork 設為 false，適用於單一區域安裝作業和多區域安裝作業，且不同叢集中的 Pod 之間有連線，例如 GKE 安裝作業。

如果是多區域安裝作業，且不同叢集的 Pod 之間沒有通訊，請將 cassandra.hostNetwork 設為 true，例如 VMware 或裸機上的 Google Distributed Cloud、AWS、AKS、EKS 和 OpenShift 安裝作業上的 GKE。請參閱「多區域部署：必要條件」一文。

當 true 時，DNS 政策會自動設為 ClusterFirstWithHostNet。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： 512M

可用於 Cassandra 作業的 JVM 系統記憶體上限，以 MB 為單位。

預設值：無

現有 Cassandra 叢集的 IP 位址，用於將現有叢集擴展至新的區域。請參閱「設定多區域種子主機」。

預設值：無

必要

節點選取器標籤鍵，用於指定 cassandra 資料服務的專屬 Kubernetes 節點。

請參閱「 設定專屬節點集區」。

預設值：無

選用的節點選取器標籤值，用於指定 cassandra 資料服務的專屬 Kubernetes 節點，並覆寫 nodeSelector.apigeeData 設定。

請參閱 nodeSelector。

預設值： 9042

用於連線至 Cassandra 的通訊埠編號。

預設值： ra-1

指定 Cassandra 節點的機架。

預設值： 2

Kubernetes 會在將 Pod 標示為「未準備就緒」之前，驗證完備性探針失敗的次數。最小值為 1。

預設值： 0

容器啟動後，啟動就緒探測作業前所需的秒數。

預設值： 10

決定執行就緒探測的頻率 (以秒為單位)。最小值為 1。

預設值： 1

連續成功次數下限，以便系統在失敗後將就緒性探測視為成功。最小值為 1。

預設值： 5

在這個秒數過後，連線探測就會逾時。最小值為 1。

預設值： 1

Cassandra 是複製資料庫。這項屬性會指定用於 StatefulSet 的 Cassandra 節點數量。

預設值： 500m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核為單位。

預設值： 1Gi

Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。

預設值： GCP

還原提供者的名稱。支援的值：GCP、HYBRID 和 CSI。將值設為：

• GCP 從儲存在 Google Cloud Storage 的備份還原資料。
• HYBRID 從儲存在遠端 SSH 伺服器的備份檔案還原資料。
• CSI (建議) 使用 Kubernetes CSI 磁碟區快照來進行還原。如要瞭解 Google Cloud、AWS 和 Azure 等雲端平台的 CSI 備份和還原作業，請參閱 CSI 備份和還原。

預設值：無

如果啟用復原功能，且 cassandra.restore.cloudProvider 設為 GCP，則為必填屬性。

用來儲存備份封存檔案的 Google Cloud Storage 值區名稱，用於資料還原作業。

預設值： false

根據預設，系統不會啟用資料還原功能。如要啟用，請設為 true。

請參閱「Cassandra 備份與復原」。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值：無

具有「儲存空間物件管理員」 (roles/storage.objectAdmin) 角色的 Google 服務帳戶金鑰檔案路徑。這個 Google 服務帳戶會用來從指定的 cassandra.restore.dbStorageBucket 下載備份封存檔。

如果啟用還原功能，且 cassandra.restore.cloudProvider 已設為 GCP，則必須執行下列任一操作，確保 Apigee Hybrid 能夠存取 Google Cloud Storage 值區，以便下載備份檔案進行還原：

• 指定 cassandra.restore.serviceAccountPath。
• 指定 cassandra.restore.serviceAccountRef。
• 已設定 GKE 中 Apigee Hybrid 的工作負載身分。
• 已設定 在 AKS 或 EKS 中為 Apigee Hybrid 設定 Workload Identity 聯盟。

預設值：無

現有 Kubernetes 密鑰的名稱，用於儲存具有 Storage 物件管理員 (roles/storage.objectAdmin) 角色的 Google 服務帳戶金鑰檔案內容。這個 Google 服務帳戶會用來從指定的 cassandra.restore.dbStorageBucket 下載備份封存檔。

如果啟用還原功能，且 cassandra.restore.cloudProvider 已設為 GCP，則必須執行下列任一操作，確保 Apigee Hybrid 能夠存取 Google Cloud Storage 值區，以便下載備份檔案進行還原：

• 指定 cassandra.restore.serviceAccountPath。
• 指定 cassandra.restore.serviceAccountRef。
• 已設定 GKE 中 Apigee Hybrid 的工作負載身分。
• 已設定 在 AKS 或 EKS 中為 Apigee Hybrid 設定 Workload Identity 聯盟。

預設值：無

如果已啟用還原功能，則為必填欄位。

應還原的備份時間戳記。

預設值： 10Gi

如果指定 storage.storageclass，則為必要欄位

以 MiB 或 GiB 為單位指定所需的磁碟空間大小。

預設值：無

指定所使用的內部儲存空間級別。

預設值： 10Gi

如果指定 storage.storageclass，則為必要欄位

以 MiB 或 GiB 為單位指定所需的磁碟空間大小。

預設值： 300

從要求刪除 Pod 到 Pod 遭到終止之間的時間上限 (以秒為單位)。在這段期間內，系統會執行所有預停止掛鉤，並且所有執行中的程序都應能正常終止。當所有執行中的程序終止，或寬限期結束時 (以先發生者為準)，Pod 就會遭到終止。如果沒有任何執行中的程序，系統會立即終止 Pod。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容許值與污點比對後的效果。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容許值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值： cert-manager

cert-manager 的命名空間。

請參閱「在自訂命名空間中執行 cert-manager」一文。

預設值：無

用於註解 Pod 的選用鍵/值對應。詳情請參閱「自訂註解」。

預設值：無

僅限 Helm：在使用 Helm 圖表在 GKE 叢集中啟用 Workload Identity 時，connectAgent 會與對應的 Kubernetes 服務帳戶建立關聯，此時 Google IAM 服務帳戶 (GSA) 的電子郵件地址。將 gcp.workloadIdentity.enabled 設為 true 時，請設定此值。

GSA 電子郵件地址的格式通常為：

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

例如：

apigee-mart@my-hybrid-project.iam.gserviceaccount.com

請參閱「在 GKE 上啟用 Workload Identity」或「在 AKS 和 EKS 上啟用 Workload Identity Federation」。

預設值： INFO

記錄回報層級。可能的值：

• INFO：除了警告、錯誤和嚴重錯誤訊息外，還有資訊性訊息。最適合用於偵錯。
• WARNING：除了錯誤和嚴重錯誤訊息外，還會記錄非致命警告。
• ERROR：除了嚴重錯誤訊息外，內部錯誤和未傳回給使用者的錯誤。
• FATAL：導致 Apigee Connect 當機的無法復原錯誤和事件。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： 5

可用於自動調整資源配置的備用資源數量上限。

預設值： 1

可用於自動調整資源配置的備用資源數量下限。

在實際作業環境中，您可能會將 replicaCountMin 增加至 1，以便有更多連線連線至控制層，提高可靠性和可擴充性。

預設值： 512m

Kubernetes 容器中資源的 CPU 限制，以毫核為單位。

預設值： 512Mi

Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。

預設值： 100m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核為單位。

預設值： 30Mi

Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。

預設值： apigeeconnect.googleapis.com:443

這項服務的伺服器和通訊埠位置。

預設值：無

必須使用 serviceAccountPath 或 serviceAccountRef 其中之一。

apigee-mart 服務帳戶的 Google 服務帳戶金鑰檔案路徑。

在大多數安裝作業中，connectAgent.serviceAccountPath 的值必須與 mart.serviceAccountPath 的值相符。

預設值：無

必須使用 serviceAccountPath 或 serviceAccountRef 其中之一。

在大多數安裝作業中，connectAgent.serviceAccountRef 的值必須與 mart.serviceAccountRef 的值相符。

預設值： 75

Pod 上 Apigee Connect 代理程式的目標 CPU 使用率。這個欄位的值可讓 Apigee Connect 在 CPU 使用率達到這個值 (最多 replicaCountMax) 時自動調度資源。

預設值： 600

從要求刪除 Pod 到 Pod 遭到終止之間的時間上限 (以秒為單位)。在這段期間內，系統會執行所有預停止掛鉤，並且所有執行中的程序都應能正常終止。當所有執行中的程序終止，或寬限期結束時 (以先發生者為準)，Pod 就會遭到終止。如果沒有任何執行中的程序，系統會立即終止 Pod。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容許值與污點比對後的效果。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容許值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值： aWxvdmVhcGlzMTIzNDU2Nw==

KMS 中機構的預設加密金鑰。

預設值： aWxvdmVhcGlzMTIzNDU2Nw==

KVM 中機構的預設加密金鑰。

預設值： aWxvdmVhcGlzMTIzNDU2Nw==

KMS 中環境 (env) 的預設加密金鑰。

預設值： aWxvdmVhcGlzMTIzNDU2Nw==

KVM 中環境 (env) 的預設加密金鑰。

預設值： aWxvdmVhcGlzMTIzNDU2Nw==

環境 (env) 的預設快取加密金鑰。

預設值：無

必要

診斷資料的儲存位置，即 Google Cloud 儲存空間值區名稱。

請參閱「建立儲存空間值區」。

預設值：無

必要

這會指定您要擷取哪種類型的 Pod 資料。值可以是下列其中一個：

• "apigee-cassandra" 會擷取 Cassandra 資料庫的資料。istio-cassandra Pod 會在 apigee 命名空間中執行。
• "apigee-mart-server" 會擷取 MART 相關資料。apigee-mart-server Pod 會在 apigee 命名空間中執行。
• "apigee-runtime" 會擷取訊息處理工具的資料。apigee-runtime Pod 會在 apigee 命名空間中執行。
• "apigee-synchronizer" 會擷取 Synchronizer 的資料。apigee-synchronizer Pod 會在 apigee 命名空間中執行。
• "apigee-udca" 會擷取 UDCA 相關資料。apigee-udca Pod 會在 apigee 命名空間中執行。
• "apigee-watcher" 會擷取 Watcher 的資料。apigee-watcher Pod 會在 apigee 命名空間中執行。
• "istio-proxy" 會擷取 Istio 輸入閘道相關資料。istio-proxy Pod 會在 istio-system 命名空間中執行。

預設值：無

如果診斷收集作業為「LOGGING」(使用 operation: "LOGGING" 設定)，則為必填

收集記錄資料的時間長度 (以毫秒為單位)。一般值為 30000。

請參閱 diagnostic.operation。

預設值：無

如果診斷收集作業為「LOGGING」(使用 operation: "LOGGING" 設定)，則為必填

根據名稱指定要從哪些記錄器收集資料。對於 Apigee hybrid 1.6.0 版本，唯一支援的值是 ALL，代表所有記錄器。例如：

diagnostic:
 loggingDetails:
   loggerNames:
   - ALL

預設值：無

如果診斷收集作業為「LOGGING」(使用 operation: "LOGGING" 設定)，則為必填

指定要收集的日誌資料精細程度。Apigee hybrid 1.6 僅支援 FINE。

預設值：無

必要

收集資料的 Pod 所在的 Kubernetes 命名空間。命名空間必須是您使用 diagnostic.container 指定容器的正確命名空間：

apigee

• apigee-runtime
• apigee-synchronizer
• apigee-udca
• apigee-watcher
• apigee-cassandra
• apigee-mart-server

istio-system

• istio-proxy

預設值：無

必要

指定是否要收集所有統計資料，還是只收集記錄。

值為：

• "ALL"
• "LOGGING"

  如果您將 diagnostic.operation 設為 "LOGGING"，則必須使用下列屬性：

  • diagnostic.loggingDetails.logDuration
  • diagnostic.loggingDetails.loggerNames
  • diagnostic.loggingDetails.logLevel

預設值：無

必要

您要收集資料的 Kubernetes 容器，例如：

diagnostic:
 podNames:
 - apigee-runtime-eng-hybrid-example-3b2ebf3-150-8vfoj-2wcjn
 - apigee-runtime-eng-hybrid-example-3b2ebf3-150-8vfoj-6xzn2

預設值：無

必要

具有 Storage 管理員角色 (roles/storage.admin) 的服務帳戶，其服務帳戶金鑰檔案 (.json) 的路徑。在大多數 Apigee 混合式安裝作業中，這會是 apigee-cassandra 服務帳戶。

請參閱「服務帳戶簡介」。

預設值：無

如果您使用 diagnostic.tcpDumpDetails，則 diagnostic.tcpDumpDetails.maxMsgs 或 diagnostic.tcpDumpDetails.timeoutInSeconds 其中之一為「必填」。

設定要收集的 tcpDump 訊息數量上限。Apigee 建議的最大值不超過 1000。

預設值：無

如果您使用 diagnostic.tcpDumpDetails，則 diagnostic.tcpDumpDetails.maxMsgs 或 diagnostic.tcpDumpDetails.timeoutInSeconds 其中之一為「必填」。

設定等待 tcpDump 傳回訊息的秒數。

預設值：無

如果您使用 diagnostic.threadDumpDetails，則 diagnostic.threadDumpDetails.delayInSeconds 和 diagnostic.threadDumpDetails.iterations 都屬於必填屬性。

收集每個執行緒傾印之間的延遲時間 (以秒為單位)。

預設值：無

如果您使用 diagnostic.threadDumpDetails，則 diagnostic.threadDumpDetails.delayInSeconds 和 diagnostic.threadDumpDetails.iterations 都屬於必填屬性。

要收集的 jstack 執行緒傾印疊代次數。

預設值：無

必須提供 cacheEncryptionKey、cacheEncryptionPath 或 cacheEncryptionSecret 其中一個。

採用 Base64 編碼的加密金鑰。請參閱「資料加密」一節。

預設值：無

必須提供 cacheEncryptionKey、cacheEncryptionPath 或 cacheEncryptionSecret 其中一個。

包含以 Base64 編碼的加密金鑰檔案的路徑。請參閱「資料加密」一節。

預設值：無

必須提供 cacheEncryptionKey、cacheEncryptionPath 或 cacheEncryptionSecret 其中一個。

包含 Base64 編碼加密金鑰的 Kubernetes 密鑰。請參閱「資料加密」一節。

預設值：無

必須提供 cacheEncryptionKey、cacheEncryptionPath 或 cacheEncryptionSecret 其中一個。

包含 Base64 編碼加密金鑰的 Kubernetes 密鑰名稱。請參閱「資料加密」一節。

預設值：4

自動調度資源的備用資源數量上限。如果已指定，則會覆寫 runtime.replicaCountMax。

預設值：1

自動調整資源配置的備用資源數量下限。如果已指定，則會覆寫 runtime.replicaCountMin。

預設值：無

Kubernetes 容器中資源的記憶體限制，以 MiB 或 GiB 為單位。

預設值：無

在 Kubernetes 容器中，資源正常運作所需的記憶體，以 MiB (Mi) 或 GiB (Gi) 為單位。

預設值：4

自動調度資源的備用資源數量上限。如果已指定，則會覆寫 synchronizer.replicaCountMax。

預設值：1

自動調整資源配置的備用資源數量下限。如果已指定，則會覆寫 synchronizer.replicaCountMin。

預設值：4

自動調度資源的備用資源數量上限。如果已指定，則會覆寫 udca.replicaCountMax。

預設值：1

自動調整資源配置的備用資源數量下限。如果已指定，則會覆寫 udca.replicaCountMin。

預設值：無

僅限 Helm：在使用 Helm 圖表在 GKE 叢集中啟用 Workload Identity 時，與對應 Kubernetes 服務帳戶建立關聯的 Google IAM 服務帳戶執行階段電子郵件地址。

請參閱「在 GKE 上啟用 Workload Identity」或「在 AKS 和 EKS 上啟用 Workload Identity Federation」。

預設值：無

僅限 Helm：使用 Helm 資訊套件在 GKE 叢集中啟用 Workload Identity 時，要與對應 Kubernetes 服務帳戶建立關聯的同步器 Google IAM 服務帳戶電子郵件地址。

請參閱「在 GKE 上啟用 Workload Identity」或「在 AKS 和 EKS 上啟用 Workload Identity Federation」。

預設值：無

僅限 Helm：當您使用 Helm 圖表在 GKE 叢集中啟用 Workload Identity 時，環境範圍 udca 會與對應的 Kubernetes 服務帳戶建立關聯，此時 udca Google IAM 服務帳戶的電子郵件地址。

請參閱「在 GKE 上啟用 Workload Identity」或「在 AKS 和 EKS 上啟用 Workload Identity Federation」。

預設值：無

Deprecated：從 Hybrid 1.4 版開始，執行階段平面會從管理平面接收這項資訊。請參閱「關於環境和環境群組」。

預設值：無

指定 HTTP Proxy 執行所在的主機名稱或 IP 位址。

依序列出 httpProxy 屬性 scheme、host、port。例如：

envs:
  - name: test
    httpProxy:
      scheme: HTTP
      host: 10.12.0.47
      port: 3128
      ...

另請參閱：為 API Proxy 設定轉送 Proxy。

預設值：無

指定 HTTP Proxy 執行的通訊埠。如果省略這個屬性，系統預設會使用 HTTP 的通訊埠 80，以及 HTTPS 的通訊埠 443。

預設值： HTTPS

指定 HTTP Proxy 的類型為 HTTP 或 HTTPS。預設會使用 HTTPS。

預設值：無

如果 HTTP Proxy 需要基本驗證，請使用這個屬性提供使用者名稱。

預設值：無

如果 HTTP Proxy 需要基本驗證，請使用這個屬性提供密碼。

預設值：無

必要

要同步處理的 Apigee 環境名稱。

預設值：無

用於輪詢機構和環境同步處理變更的間隔，以秒為單位。

預設值：無

HTTPS 流量的 TCP 通訊埠編號。

預設值：無

本機系統中檔案的路徑，可用於 Google 服務帳戶金鑰，並具有 Cloud Trace 代理人角色，通常是 apigee-runtime 服務帳戶。如要瞭解服務帳戶的預設名稱和指派的角色，請參閱「關於服務帳戶」一文。

預設值：無

本機系統中檔案的路徑，可用於具有 Apigee Synchronizer Manager 角色的 Google 服務帳戶金鑰。

預設值：無

本機系統中檔案的路徑，可用於取得具有 Apigee Analytic Agent 角色的 Google 服務帳戶金鑰。

只有在 orgScopedUDCA 設為 false 時，才設定這個屬性。

預設值：無

用於在 Vault 中儲存服務帳戶金鑰的環境專屬密鑰提供者類別 (SecretProviderClass) 名稱。

請參閱「在 Hashicorp Vault 中儲存服務帳戶金鑰」。

預設值：無

Kubernetes 密鑰的名稱。您必須使用 Google 服務帳戶金鑰建立機密金鑰，並將 Cloud Trace 代理人 角色做為輸入內容。

預設值：無

Kubernetes 密鑰的名稱。您必須使用 Google 服務帳戶金鑰建立密鑰，並將 Apigee Synchronizer Manager 角色做為輸入內容。

預設值：無

Kubernetes 密鑰的名稱。您必須使用 Google 服務帳戶金鑰建立密鑰，並將 Apigee Analytic Agent 角色做為輸入內容。

只有在 orgScopedUDCA 設為 false 時，才設定這個屬性。

預設值：無

必須提供 sslCertPath/sslKeyPath 或 sslSecret。

系統中 TLS 憑證檔案的路徑。

預設值：無

必須使用 sslCertPath/sslKeyPath 或 sslSecret。

系統中 TLS 私密金鑰檔案的路徑。

預設值：無

必須提供 sslCertPath/sslKeyPath 或 sslSecret。

如果檔案儲存在 Kubernetes 密鑰中，且包含 Cassandra 使用者和密碼，則為該檔案的名稱。您可以按照下列操作說明建立密鑰：建立密鑰。

另請參閱：

• 將資料儲存在 Kubernetes 密鑰中
• Kubernetes 說明文件中的「密鑰」
• 請參閱 Kubernetes 說明文件中的 使用 kubectl 建立密鑰

預設值：無

非 GKE 平台上 Workload Identity 提供者的許可對象。

請參閱「在 AKS 和 EKS 上啟用 Workload Identity Federation」。

預設值：無

Workload Identity Federation 用來取得服務帳戶憑證的憑證來源檔案檔案名稱和路徑。這是您使用 create-cred-config 指令設定 Workload Identity 聯盟時，為 credential-source-file 提供的值。

請參閱「在 AKS 和 EKS 上啟用 Workload Identity Federation」。

預設值： false

在非 GKE 平台上啟用 Workload Identity Federation。如果同一個叢集中的 gcp.workloadIdentity.enabled 設為 true，則不得設為 true。

請參閱「在 AKS 和 EKS 上啟用 Workload Identity 聯盟」。

預設值： 3600

權杖的生命週期 (以秒為單位)。

請參閱「在 AKS 和 EKS 上啟用 Workload Identity Federation」。

預設值：無

必要

指出 apigee-logger 和 apigee-metrics 推送資料的 Google Cloud 專案。

預設值：無

指出要執行的 Kubernetes 叢集專案。

projectIDRuntime 為選用屬性，如果未使用，系統會假設 projectID 值會用於 Apigee 機構的 Google Cloud 專案和執行階段 K8S 叢集的專案。

預設值： us-central1

必要

指出 apigee-logger 和 apigee-metrics 推送資料的 Google Cloud 區域。

預設值：false

僅限 Helm：啟用在 GKE 上使用 Workload Identity。Workload Identity 可讓 GKE 叢集中的工作負載模擬身分與存取權管理 (IAM) 服務帳戶，以便存取 Google Cloud 服務。

如果同一個叢集中的 gcp.federatedWorkloadIdentity.enabled 設為 true，則不得設為 true。

當 enabled 為預設值 false 時，Apigee 會使用每個 Apigee 混合元件的 IAM 服務帳戶。請參閱「服務帳戶簡介」。

當 workloadIdentityEnabled 為 true 時，Apigee 會使用 Kubernetes 服務帳戶，並將這些帳戶對應至每個元件的適當 IAM 服務帳戶。指定要對應至 Kubernetes 服務帳戶的 IAM 服務帳戶：

• gcp.workloadIdentity.gsa
• connectAgent.gsa
• envs.gsa.runtime
• envs.gsa.synchronizer
• envs.gsa.udca
• logger.gsa
• mart.gsa
• metrics.gsa
• udca.gsa
• watcher.gsa

預設值：無

僅限 Helm：在使用 Helm 圖表在 GKE 叢集中啟用 Workload Identity 時，所有元件要與對應的 Kubernetes 服務帳戶建立關聯的 Google IAM 服務帳戶 (GSA) 電子郵件地址。將 gcp.workloadIdentity.enabled 設為 true 時，請設定此值。

gcp.workloadIdentity.gsa 適用於所有混合式元件。如果您為 gcp.workloadIdentity.gsa 指定值，就不需要為任何個別混合型元件提供 GSA。如果您為個別元件提供 GSA，該元件的 GSA 會僅針對該元件覆寫 gcp.workloadIdentity.gsa。

GSA 電子郵件地址的格式通常為：

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

例如：

apigee-non-prod@my-hybrid-project.iam.gserviceaccount.com

請參閱 Enabling Workload Identity on GKE。

預設值：false

apigeectl 專用：啟用 Workload Identity。Workload Identity 可讓 GKE 叢集中的工作負載模擬身分與存取權管理 (IAM) 服務帳戶，以便存取 Google Cloud 服務。

當 workloadIdentityEnabled 為預設值 false 時，Apigee 會使用每個 Apigee 混合元件的 IAM 服務帳戶。請參閱「服務帳戶簡介」。

當 workloadIdentityEnabled 為 true 時，Apigee 會使用 Kubernetes 服務帳戶而非 IAM 服務帳戶，並忽略下列設定屬性：

• validateServiceAccounts
• cassandra.backup.serviceAccountPath
• cassandra.backup.serviceAccountRef
• cassandra.restore.serviceAccountPath
• cassandra.restore.serviceAccountRef
• envs[].serviceAccountPaths.*
• logger.serviceAccountPath
• logger.serviceAccountRef
• mart.serviceAccountPath
• mart.serviceAccountRef
• metrics.serviceAccountPath
• metrics.serviceAccountRef
• synchronizer.serviceAccountPath
• synchronizer.serviceAccountRef
• udca.serviceAccountPath
• udca.serviceAccountRef
• watcher.serviceAccountPath
• watcher.serviceAccountRef

預設值：無

HTTP Proxy 的主機名稱。

預設值：無

HTTP Proxy 的通訊埠。

預設值： HTTPS

Proxy 使用的配置。值可以是 HTTP 或 HTTPS。值必須為大寫。

預設值：無

如果 HTTP Proxy 需要基本驗證，請使用這個屬性提供使用者名稱。

預設值：無

如果 HTTP Proxy 需要基本驗證，請使用這個屬性提供密碼。

預設值：無

必要

入口閘道的名稱。其他服務會使用這個名稱，將流量轉送至閘道。名稱必須符合下列條件：

• 長度上限為 17 個半形字元
• 只能包含小寫英數字元、- 或 .
• 開頭必須是英數字元
• 結尾須為英數字元

詳情請參閱 Kubernetes 說明文件中的「DNS 子網域名稱」。

預設值： 2000m

資源的 CPU 限制值，以毫核為單位。

預設值： 1Gi

資源的記憶體限制，以 mebibyte 為單位。

預設值： 300m

資源正常運作所需的 CPU，以毫核為單位。

預設值： 128Mi

資源正常運作所需的記憶體大小 (以 MiB 為單位)。

預設值： 10

hybrid 可自動新增的入口網關 Pod 數量上限，可用於自動調度資源。

預設值： 2

可用於自動調整資源配置的入口網關 Pod 數量下限。

預設值：無

可選的鍵/值對應，用於在支援註解的平台上註解入口閘道。例如：

ingressGateways:
  svcAnnotations:
    networking.gke.io/load-balancer-type: "Internal"

預設值：無

在支援指定負載平衡器 IP 位址的平台上，負載平衡器會使用這個 IP 位址建立。如果平台不允許您指定負載平衡器 IP 位址，系統會忽略這個屬性。

預設值：LoadBalancer

用於變更用於入口部署作業的預設 k8s 服務類型。如果您想停用預設負載平衡器的建立作業，請將值設為 ClusterIP。可能的值包括：

• ClusterIP
• LoadBalancer

預設值： 75

在 ReplicaSet 中，CPU 使用率的臨界值，以可用 CPU 資源總數的百分比表示。

當 CPU 使用率超過這個值時，混合型會逐漸增加 ReplicaSet 中的 Pod 數量，最多可達 ingressGateways[].replicaCountMax。

如要進一步瞭解 Kubernetes 中的資源調度功能，請參閱 Kubernetes 說明文件中的「水平 Pod 自動調度」一節。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容許值與污點比對後的效果。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容許值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值： /dev/stdout

入站存取記錄的檔案路徑，例如 /dev/stdout。

如果未定義這個值，系統就會停用存取記錄功能。

ingress 存取記錄的格式。

如果未定義這個值，系統會使用 Proxy 的預設存取記錄格式。

預設存取記錄格式：

'{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'

以下是預設存取記錄格式的副本，我們已加入換行符號以利閱讀。

'{"start_time":"%START_TIME%",
  "remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%",
  "user_agent":"%REQ(USER-AGENT)%",
  "host":"%REQ(:AUTHORITY)%",
  "request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%",
  "request_time":"%DURATION%",
  "status":"%RESPONSE_CODE%",
  "status_details":"%RESPONSE_CODE_DETAILS%",
  "bytes_received":"%BYTES_RECEIVED%",
  "bytes_sent":"%BYTES_SENT%",
  "upstream_address":"%UPSTREAM_HOST%",
  "upstream_response_flags":"%RESPONSE_FLAGS%",
  "upstream_response_time":"%RESPONSE_DURATION%",
  "upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%",
  "upstream_cluster":"%UPSTREAM_CLUSTER%",
  "x_forwarded_for":"%REQ(X-FORWARDED-FOR)%",
  "request_method":"%REQ(:METHOD)%",
  "request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%",
  "request_protocol":"%PROTOCOL%",
  "tls_protocol":"%DOWNSTREAM_TLS_VERSION%",
  "request_id":"%REQ(X-REQUEST-ID)%",
  "sni_host":"%REQUESTED_SERVER_NAME%",
  "apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'

預設值： SANITIZE_SET

決定 Envoy Proxy (Apigee 入口閘道) 如何處理 x-forwarded-client-cert (XFCC) HTTP 標頭。

可能的值包括：

• SANITIZE_SET (預設) 當用戶端連線為 mTLS 時，請使用用戶端憑證資訊重設 XFCC 標頭，並將其傳送至下一個節點。
• FORWARD_ONLY 如果用戶端連線為 mTLS (互相傳輸層安全標準)，請只在要求中轉送 XFCC 標頭。
• APPEND_FORWARD 如果用戶端連線是 mTLS，請將用戶端憑證資訊附加至要求的 XFCC 標頭，然後轉送。
• SANITIZE 請勿轉送 XFCC 標頭。
• ALWAYS_FORWARD_ONLY 無論用戶端連線是否為 mTLS，一律在要求中轉送 XFCC 標頭。

如要進一步瞭解這些值，請參閱 Envoy 說明文件中的 Enum extensions.filters.network.http_connection_manager.v3.HttpConnectionManager.ForwardClientCertDetails。

如果在安裝 Hybrid 後變更這項設定，請使用 apigeectl init 套用，然後重新啟動 Apigee ingress gateway 容器。

預設值：

- "GoogleStackdriverMonitoring-UptimeChecks(https://cloud.google.com/monitoring)"
- "Edge Health Probe"

讓非Google Cloud 負載均衡器透過覆寫混合式中的預設使用者代理程式許可清單，檢查 ingress 閘道的健康狀態檢查端點 (/healthz/ingress 和 /healthz)。

如要覆寫指定的預設使用者代理程式，請使用下列語法，插入自訂使用者代理程式：

istiod:
  healthCheckUserAgents:
  - "CUSTOM_USER_AGENT_1"
  - "CUSTOM_USER_AGENT_2"

如要移除使用者代理程式規定，請使用以下內容：

istiod:
  healthCheckUserAgents: []

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容許值與污點比對後的效果。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容許值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

安裝 Hybrid 執行階段的 Kubernetes 叢集名稱。

預設值：無

指出 Kubernetes 叢集建立所在的 Google Cloud 區域。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： 500m

Kubernetes 容器中資源的 CPU 限制 (以毫核為單位)。

預設值： 128Mi

Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。

預設值： 5m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核為單位。

預設值： 64Mi

Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。

預設值：無

用於註解 Pod 的選用鍵/值對應。詳情請參閱「自訂註解」。

預設值：256k

讀取記錄檔時的初始緩衝區大小。

預設值：104857600

每個監控檔案的緩衝區大小限制。超出此限制的檔案會從監控的檔案清單中移除。

預設值：150 MB

記錄器可使用的記憶體上限。如果達到上限，記錄器會暫時停止讀取更多資料，直到現有資料在記憶體中刷新為止。

預設值： false

啟用或停用叢集中的記錄功能。如非 GKE，請將其設為 true；如為 Google Cloud 或 Google Distributed Cloud 上的 GKE，請將其設為 false。

預設值：無

可讓您加入 NO_PROXY Fluent Bit 環境變數，該變數會指定不透過 HTTP Proxy 轉送流量的網址。NO_PROXY 變數應定義為以逗號分隔的主機名稱字串，格式如下：

logger:
  ...
  envVars:
    NO_PROXY: '<comma-separated-values>'

例如：

  envVars:
    NO_PROXY: 'kubernetes.default.svc,oauth2.googleapis.com,logging.googleapis.com'

如果已啟用 HTTP 轉送 Proxy，請視需要使用 envVars: NO_PROXY。

請參閱 Fluent Bit 說明文件中的 NO_PROXY。

預設值：1

在叫用下一個緩衝區刷新前等待的間隔時間 (以秒為單位)。

預設值：無

僅限 Helm：使用 Helm 圖表在 GKE 叢集中啟用 Workload Identity 時，與對應 Kubernetes 服務帳戶建立關聯的 apigee-logger Google IAM 服務帳戶 (GSA) 電子郵件地址。將 gcp.workloadIdentity.enabled 設為 true 時，請設定此值。

GSA 電子郵件地址的格式通常為：

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

例如：

apigee-logger@my-hybrid-project.iam.gserviceaccount.com

請參閱「在 GKE 上啟用 Workload Identity」或「在 AKS 和 EKS 上啟用 Workload Identity Federation」。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： 3

Kubernetes 會在重新啟動容器前，驗證有效性探針失敗的次數。最小值為 1。

預設值： 0

在容器啟動後，等待啟動有效性探測作業的秒數。

預設值： 60

決定執行 liveness 探測的頻率 (以秒為單位)。最小值為 1。

預設值： 1

連續成功次數下限，連續成功次數達到這個數量後，系統才會將生命探針視為成功。最小值為 1。

預設值： 1

在這個秒數過後，連線探測就會逾時。最小值為 1。

預設值： apigee.com/apigee-logger-enabled

必要

節點選取器標籤鍵，用於指定 logger 執行階段服務的專屬 Kubernetes 節點。

請參閱「 設定專屬節點集區」。

預設值： true

必要

節點選取器標籤值，用於指定 logger 執行階段服務的專屬 Kubernetes 節點。

請參閱「 設定專屬節點集區」。

預設值： 200m

Kubernetes 容器中資源的 CPU 限制，以毫核為單位。

預設值： 500Mi

Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。

預設值： 100m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核為單位。

預設值： 250Mi

Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。

預設值：無

必須使用 serviceAccountPath 或 serviceAccountRef 其中之一。

具有「Logs Writer」角色的 Google 服務帳戶金鑰檔案路徑。

預設值：無

必須使用 serviceAccountPath 或 serviceAccountRef 其中之一。

預設值：128

記憶體中可用的區塊數量上限。超過限制的區塊會儲存在檔案系統中。

預設值： 30

從要求刪除 Pod 到 Pod 遭到終止之間的時間上限 (以秒為單位)。在這段期間內，系統會執行所有預停止掛鉤，並且所有執行中的程序都應能正常終止。當所有執行中的程序終止，或寬限期結束時 (以先發生者為準)，Pod 就會遭到終止。如果沒有任何執行中的程序，系統會立即終止 Pod。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容許值與污點比對後的效果。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容許值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

用於註解 Pod 的選用鍵/值對應。詳情請參閱「自訂註解」。

預設值：無

僅限 Helm：使用 Helm 圖表在 GKE 叢集中啟用 Workload Identity 時，與對應 Kubernetes 服務帳戶建立關聯的 apigee-mart Google IAM 服務帳戶 (GSA) 電子郵件地址。將 gcp.workloadIdentity.enabled 設為 true 時，請設定此值。

GSA 電子郵件地址的格式通常為：

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

例如：

apigee-mart@my-hybrid-project.iam.gserviceaccount.com

請參閱「在 GKE 上啟用 Workload Identity」或「在 AKS 和 EKS 上啟用 Workload Identity Federation」。

預設值：無

主機別名，指向 MART 物件。您可以將這個屬性設為 * 或完整的網域名稱。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看此元件的目前存放區網址。

預設值： 10m

分配給 Cloud Foundry 程序初始化檢查的 CPU 資源量。

預設值： 12

Kubernetes 會在重新啟動容器前，驗證有效性探針失敗的次數。最小值為 1。

預設值： 15

在容器啟動後，等待啟動有效性探測作業的秒數。

預設值： 5

決定執行 liveness 探測的頻率 (以秒為單位)。最小值為 1。

預設值： 1

在這個秒數過後，連線探測就會逾時。最小值為 1。

預設值： /v1/server/metrics

預設值：無

選用的節點選取器標籤鍵，用於指定 mart 執行階段服務的 Kubernetes 節點。如果您未為 mart.nodeselector 指定鍵，執行階段會使用 nodeSelector 物件中指定的節點。

請參閱「 設定專屬節點集區」。

預設值：無

指定 mart 執行階段服務的 Kubernetes 節點時，可用的節點選取器標籤值。另請參閱 nodeSelector 物件。

請參閱「 設定專屬節點集區」。

預設值： 2

Kubernetes 會在將 Pod 標示為「未準備就緒」之前，驗證完備性探針失敗的次數。最小值為 1。

預設值： 15

容器啟動後，啟動就緒探測作業前所需的秒數。

預設值： 5

決定執行就緒探測的頻率 (以秒為單位)。最小值為 1。

預設值： 1

連續成功次數下限，以便系統在失敗後將就緒性探測視為成功。最小值為 1。

預設值： 1

在這個秒數過後，連線探測就會逾時。最小值為 1。

預設值： 5

可用於自動調整資源配置的備用資源數量上限。

預設值： 1

可用於自動調整資源配置的備用資源數量下限。

預設值： 2000m

Kubernetes 容器中資源的 CPU 限制，以毫核為單位。

預設值： 5Gi

Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。

預設值： 500m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核為單位。

預設值： 512Mi

Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。

預設值：無

必須使用 serviceAccountPath 或 serviceAccountRef 其中之一。

沒有角色的 Google 服務帳戶金鑰檔案路徑。

預設值：無

必須使用 serviceAccountPath 或 serviceAccountRef 其中之一。

預設值：無

您必須使用 sslCertPath/sslKeyPath 或 sslSecret 其中之一。

用於將 SSL 憑證載入及編碼至密鑰的本機檔案系統路徑。

預設值：無

必須提供 sslCertPath/sslKeyPath 或 sslSecret。

用於將 SSL 金鑰載入至密鑰並編碼的本機檔案系統路徑。

預設值：無

您必須使用 sslCertPath/sslKeyPath 或 sslSecret 其中之一。

儲存在 Kubernetes 密鑰中的檔案名稱，其中包含 TLS 憑證和私密金鑰。您必須使用 TLS 憑證和金鑰資料做為輸入內容，建立密鑰。

另請參閱：

• 將資料儲存在 Kubernetes 密鑰中
• Kubernetes 說明文件中的「Secrets」
• 在 Kubernetes 說明文件中 使用 kubectl 建立密鑰

預設值： 75

Pod 中 MART 程序的目標 CPU 使用率。這個欄位的值可讓 MART 在 CPU 使用率達到這個值時自動調整，最高可達 replicaCountMax。

預設值： 30

從要求刪除 Pod 到 Pod 遭到終止之間的時間上限 (以秒為單位)。在這段期間內，系統會執行所有預停止掛鉤，並且所有執行中的程序都應能正常終止。當所有執行中的程序終止，或寬限期結束時 (以先發生者為準)，Pod 就會遭到終止。如果沒有任何執行中的程序，系統會立即終止 Pod。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容許值與污點比對後的效果。effect 的值可為：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容忍值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： 500m

Kubernetes 容器中適配器資源的 CPU 限制 (以毫核為單位)。

預設值： 4Gi

Kubernetes 容器中轉接器資源的記憶體限制，以 GB 為單位。

預設值： 100m

Kubernetes 容器中轉接程式正常運作所需的 CPU，以毫核為單位。

預設值： 128Mi

Kubernetes 容器中適配器正常運作所需的記憶體，以 MiB 為單位。

預設值： 500m

Kubernetes 容器中匯總器正常運作所需的 CPU，以毫核為單位。

預設值： 512Mi

Kubernetes 容器中匯入器正常運作所需的記憶體，以 MiB 為單位。

預設值： 500m

Kubernetes 容器中匯總器資源的 CPU 限制 (以毫核為單位)。

預設值： 3Gi

Kubernetes 容器中匯總器資源的記憶體限制，以 GB 為單位。

預設值：無

用於註解 Pod 的選用鍵/值對應。詳情請參閱「自訂註解」。

預設值： 500m

應用程式在 Kubernetes 容器中正常運作所需的 CPU，以毫核為單位。

預設值： 512Mi

應用程式在 Kubernetes 容器中正常運作所需的記憶體，以 Mebibyte 為單位。

預設值： 500m

Kubernetes 容器中應用程式資源的 CPU 限制 (以毫核為單位)。

預設值： 1Gi

Kubernetes 容器中應用程式資源的記憶體限制，以 GB 為單位。

預設值： 500m

Kubernetes 容器中 stackdriverExporter 資源的 CPU 限制 (以毫核為單位)。

預設值： 1Gi

Kubernetes 容器中 stackdriverExporter 資源的記憶體限制，以 GB 為單位。

預設值： 128m

Kubernetes 容器中 stackdriverExporter 正常運作所需的 CPU 數量，以毫核為單位。

預設值： 512Mi

Kubernetes 容器中 stackdriverExporter 正常運作所需的記憶體，以位元組為單位。

預設值：無

可讓您在 OpenTelemetry 中傳入及覆寫環境變數。舉例來說，您可以定義 HTTP_PROXY、HTTPS_PROXY 或 NO_PROXY，讓要求經過 Proxy 伺服器。

HTTP_PROXY 變數可定義為包含主機名稱的字串，格式如下：

metrics:
...
  envVars:
    HTTP_PROXY: '<host-name>'

例如：

  envVars:
    HTTP_PROXY: 'http://1.1.1.1:80'

HTTPS_PROXY 變數可定義為包含主機名稱的字串，格式如下：

metrics:
...
  envVars:
    HTTPS_PROXY: '<host-name>'

例如：

  envVars:
    HTTPS_PROXY: 'https://1.1.1.1:80'

NO_PROXY 變數應定義為以逗號分隔的主機名稱字串，格式如下：

metrics:
...
envVars:
  NO_PROXY: '<comma-separated-values>'

例如：

envVars:
  NO_PROXY: 'https://1.1.1.1:80, https://1.1.1.1:81'

如果已啟用 HTTP 轉送 Proxy，請視需要使用 envVars: HTTP_PROXY、envVars: HTTPS_PROXY 或 envVars: NO_PROXY。

請參閱 OpenTelemetry 說明文件中的「Proxy 支援」一節。

預設值： IfNotPresent

決定 kubelet 何時提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「使用私人圖像存放區搭配 Apigee hybrid 」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： 500m

在 Kubernetes 容器中，應用程式正常運作所需的 CPU 數量，以毫核為單位。

預設值： 512Mi

應用程式在 Kubernetes 容器中正常運作所需的記憶體，以 MiB 為單位。

預設值： 500m

Kubernetes 容器中應用程式資源的 CPU 限制 (以毫核為單位)。

預設值： 1Gi

Kubernetes 容器中應用程式資源的記憶體限制，以 GB 為單位。

預設值： 5

Kubernetes 會在重新啟動容器前，驗證有效性探針失敗的次數。最小值為 1。

預設值： 30

在容器啟動後，等待啟動有效性探測作業的秒數。

預設值： 10

決定執行 liveness 探測的頻率 (以秒為單位)。最小值為 1。

預設值： 1

連續成功次數下限，連續成功次數達到這個數量後，系統才會將生命徵候探測結果視為成功。最小值為 1。

預設值： 5

在這個秒數過後，生命力探測就會逾時。最小值為 1。

預設值： 3

Kubernetes 會在確認 Pod 未準備就緒前，驗證完備性探測失敗的次數。最小值為 1。

預設值： 30

容器啟動後，啟動就緒探測作業前所需的秒數。

預設值： 10

決定執行就緒性探測的頻率 (以秒為單位)。最小值為 1。

預設值： 1

連續成功次數下限，以便系統在失敗後將就緒性探測視為成功。最小值為 1。

預設值： 5

在這個秒數過後，連線探測就會逾時。最小值為 1。

預設值： true

將 ProxyV2 和 TargetV2 監控資源的指標設為 true 時，系統不會發出這些指標。請改用 Proxy 和 Target 受控資源的指標。

預設值： true

啟用 Apigee 指標。設為 true 即可啟用指標。設為 false 即可停用指標。

預設值：無

僅限 Helm：使用 Helm 圖表在 GKE 叢集中啟用 Workload Identity 時，與對應 Kubernetes 服務帳戶建立關聯的 apigee-metrics Google IAM 服務帳戶 (GSA) 電子郵件地址。將 gcp.workloadIdentity.enabled 設為 true 時，請設定此值。

GSA 電子郵件地址的格式通常為：

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

例如：

apigee-metrics@my-hybrid-project.iam.gserviceaccount.com

請參閱「在 GKE 上啟用 Workload Identity」或「在 AKS 和 EKS 上啟用 Workload Identity Federation」。

預設值：無

必要

節點選取器標籤鍵，用於指定 metrics 執行階段服務的專屬 Kubernetes 節點。

請參閱「 設定專屬節點集區」。

預設值：無

必要

節點選取器標籤值，用於指定 metrics 執行階段服務的專屬 Kubernetes 節點。

請參閱「 設定專屬節點集區」。

預設值： 9090

連線至 Prometheus 指標服務的通訊埠。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： 6

Kubernetes 會在重新啟動容器前，驗證有效性探針失敗的次數。最小值為 1。

預設值： 5

決定執行 liveness 探測的頻率 (以秒為單位)。最小值為 1。

預設值： 3

在這個秒數過後，連線探測就會逾時。最小值為 1。

預設值： 120

Kubernetes 會在將 Pod 標示為「未準備就緒」之前，驗證完備性探針失敗的次數。最小值為 1。

預設值： 5

決定執行就緒探測的頻率 (以秒為單位)。最小值為 1。

預設值： 3

在這個秒數過後，連線探測就會逾時。最小值為 1。

預設值： 500m

Kubernetes 容器中 Prometheus 資源的 CPU 限制 (以毫核為單位)。

預設值： 4Gi

Kubernetes 容器中 Prometheus 資源的記憶體限制 (以 GB 為單位)。

預設值： 128m

在 Kubernetes 容器中，Prometheus 正常運作所需的 CPU 數量 (以毫核為單位)。

預設值： 512Mi

Kubernetes 容器中 Prometheus 正常運作所需的記憶體，以 MiB 為單位。

預設值：無

必要

Prometheus 指標收集程序的 SSL 憑證路徑。Prometheus 是 Apigee 可用來收集及處理指標的工具。

請參閱：

• 指標
• 如需背景資訊，請造訪 Prometheus 網站

預設值：無

必要

Prometheus 指標收集程序的 SSL 金鑰路徑。Prometheus 是 Apigee 可用來收集及處理指標的工具。

請參閱：

• 指標
• 如需背景資訊，請造訪 Prometheus 網站

預設值： 500m

Kubernetes 容器中 Proxy 正常運作所需的 CPU，以毫核為單位。

預設值： 512Mi

Kubernetes 容器中代理程式正常運作所需的記憶體，以 mebibyte 為單位。

預設值： 500m

Kubernetes 容器中 Proxy 資源的 CPU 限制 (以毫核為單位)。

預設值： 1Gi

Kubernetes 容器中 Proxy 資源的記憶體限制，以 GB 為單位。

預設值： 128m

Kubernetes 容器中 stackdriverExporter 正常運作所需的 CPU 數量，以毫核為單位。

預設值： 512Mi

Kubernetes 容器中 stackdriverExporter 正常運作所需的記憶體，以位元組為單位。

預設值： 500m

Kubernetes 容器中 stackdriverExporter 資源的 CPU 限制 (以毫核為單位)。

預設值： 1Gi

Kubernetes 容器中 stackdriverExporter 資源的記憶體限制，以 GB 為單位。

預設值：無

Kubernetes 叢集中指標處理程序附加 Proxy 的網址。

預設值： 9091

用於連線至 Cloud Monitoring 指標服務的通訊埠。

預設值： IfNotPresent

決定 Kubelet 提取此服務的 Docker 映像檔的時間。可能的值包括：

• IfNotPresent：如果已存在新圖片，則不要拉取
• Always：一律會拉取政策，即使政策已存在也一樣

  詳情請參閱「 更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值：無

必須使用 serviceAccountPath 或 serviceAccountRef 其中之一。

具備 Monitoring Metric Writer 角色的 Google 服務帳戶金鑰檔案路徑。

預設值：無

必須使用 serviceAccountPath 或 serviceAccountRef 其中之一。

Deprecated：自 Hybrid 1.8 版起，metrics:stackdriverExporter 已替換為 metrics:appStackdriverExporter 和 metrics:proxyStackdriverExporter。請參閱：

• metrics.appStackdriverExporter.resources.requests.cpu
• metrics.proxyStackdriverExporter.resources.requests.cpu

Deprecated：自 Hybrid 1.8 版起，metrics:stackdriverExporter 已替換為 metrics:appStackdriverExporter 和 metrics:proxyStackdriverExporter。請參閱：

• metrics.appStackdriverExporter.resources.requests.memory
• metrics.proxyStackdriverExporter.resources.requests.memory

Deprecated：自 Hybrid 1.8 版起，metrics:stackdriverExporter 已替換為 metrics:appStackdriverExporter 和 metrics:proxyStackdriverExporter。請參閱：

• metrics.appStackdriverExporter.resources.limits.cpu
• metrics.proxyStackdriverExporter.resources.limits.cpu

Deprecated：自 Hybrid 1.8 版起，metrics:stackdriverExporter 已改為 metrics:appStackdriverExporter 和 metrics:proxyStackdriverExporter。請參閱：

• metrics.appStackdriverExporter.resources.limits.memory
• metrics.proxyStackdriverExporter.resources.limits.memory

預設值： 300

從要求刪除 Pod 到 Pod 遭到終止之間的時間上限 (以秒為單位)。在這段期間內，系統會執行所有預停止掛鉤，並且所有執行中的程序都應能正常終止。當所有執行中的程序終止，或寬限期結束時 (以先發生者為準)，Pod 就會遭到終止。如果沒有任何執行中的程序，系統會立即終止 Pod。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容許值與污點比對後的效果。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容許值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： 2000m

Kubernetes 容器中資源的 CPU 限制，以毫核為單位。

預設值： 4Gi

Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。

預設值： 500m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核為單位。

預設值： 512Mi

Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容許值與污點比對後的效果。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容許值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值： true

判斷是否已啟用 Pub/Sub 資料管道。

預設值： true

判斷分析是否使用 Pub/Sub 資料管道。

預設值： cloud.google.com/gke-nodepool

ApigeeData 是 Cassandra 資料庫的節點。用於指定 Kubernetes 節點，以便處理 Apigee 服務資料的節點選取器標籤鍵。

請參閱「設定專屬節點集區」。

預設值： apigee-data

apigee-data 是 Cassandra 資料庫的節點。用於指定 Kubernetes 節點，以便處理 Apigee 服務資料的節點選取器標籤值。

請參閱「設定專屬節點集區」。

預設值： cloud.google.com/gke-nodepool

Apigee Runtime 是專案執行階段環境的節點。用於指定 Apigee 執行階段服務的 Kubernetes 節點的節點選取器標籤鍵。

請參閱「設定專屬節點集區」。

預設值： apigee-runtime

apigee-runtime 是專案執行階段環境的節點。指定 Apigee 執行階段服務的 Kubernetes 節點的節點選取器標籤值。

請參閱「設定專屬節點集區」。

預設值：true

requiredForScheduling 屬性預設為 true。當 true 時，表示如果 Kubernetes 找不到具有已設定標籤鍵/值的節點，則底層 Pod 不會在 VM 工作站節點上排程。

在正式版中，nodeSelector.requiredForScheduling 應設為 true。

請參閱「設定專屬節點集區」。

預設值： iloveapis123

必要

Redis 管理員的密碼。管理員使用者可用於在 Redis 叢集中執行的任何管理活動。

預設值：無

儲存在 Kubernetes 密鑰中的檔案名稱，其中包含 Redis 管理員的密碼。密鑰檔案應包含以下金鑰：

data:
    redis.auth.password: encoded_value

另請參閱：

• redis.auth.password
• 將資料儲存在 Kubernetes 密鑰中
• Kubernetes 說明文件中的「密鑰」
• 在 Kubernetes 說明文件中參閱「 使用 kubectl 建立密鑰」

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： 2

Redis 是複製儲存空間，這個屬性會指定用作 StatefulSet 的 Redis 節點數量。

預設值： 500m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核為單位。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容許值與污點比對後的效果。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容忍值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

用於註解 Pod 的選用鍵/值對應。詳情請參閱「自訂註解」。

預設值：無

可讓您透過鍵/值組合，向執行階段元件提供其他環境變數：

runtime:
  envVars:
    KEY_1: VALUE_N
    ... ...
    KEY_N: VALUE_N

例如：

runtime:
  envVars:
    RUNTIME_ENV_VAR1: "value of runtime env-var 1"
    RUNTIME_ENV_VAR2: "value of runtime env-var 2"

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值：60

縮減執行階段執行個體百分比時，政策應維持有效的時間範圍。

預設值：20

縮減執行階段執行個體百分比時，政策允許的變更量。

預設值：60

在縮減執行階段執行個體數量時，政策應維持有效的時間範圍。

預設值：20

政策在縮減執行階段執行個體數量時，允許的變更量。

預設值：Min

自動配置器在多項自動調度資源政策之間做出的決定。將值設為「最小」可讓您在縮減執行階段執行個體時，盡可能減少變更。將值設為「Max」可讓您在縮減執行階段執行個體時，進行最大的變更。

預設值：120

縮減時應考慮過去最佳化建議的秒數。

預設值：60

在調整執行階段執行個體百分比時，政策應維持有效的時間範圍。

預設值：20

在調整執行階段執行個體百分比時，政策應維持有效的時間範圍。

預設值：60

在擴充執行階段執行個體數量時，政策應維持有效的時間範圍。

預設值：4

在擴充執行階段執行個體數量時，政策允許的變更量。

預設值：Max

自動配置器在多項自動調度資源政策之間做出的決定。將值設為「Min」可讓您在調高執行階段執行個體時，進行最小變更。將值設為「Max」可讓您在調整執行階段執行個體時，進行最大的變更。

預設值：30

在擴充執行階段執行個體時，應考慮過去建議的秒數。

預設值：400M

在 HTTP 層級，代理要求在執行階段執行個體中處理佇列的平均等待時間 (以毫秒為單位)。

預設值：400M

代理要求處理政策的執行階段執行個體中處理佇列的平均等待時間 (以毫秒為單位)。

預設值：75

所有執行階段執行個體的理想 CPU 使用率百分比。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。

預設值： 2

Kubernetes 會在重新啟動容器前，驗證有效性探針失敗的次數。最小值為 1。

預設值： 60

在容器啟動後，啟動有效性探測作業前所需的秒數。

預設值： 5

決定執行 liveness 探測的頻率 (以秒為單位)。最小值為 1。

預設值： 1

在這個秒數過後，連線探測就會逾時。最小值為 1。

預設值：無

用於指定 runtime 服務的 Kubernetes 節點的選用節點選取器標籤鍵。

請參閱「nodeSelector 屬性」。

預設值：無

指定 runtime 服務的 Kubernetes 節點的節點選取器標籤值。

請參閱「 設定專屬節點集區」。

預設值： 2

Kubernetes 會在將 Pod 標示為「未準備就緒」之前，驗證完備性探針失敗的次數。最小值為 1。

預設值： 60

容器啟動後，啟動就緒探測作業前所需的秒數。

預設值： 5

決定執行就緒探測的頻率 (以秒為單位)。最小值為 1。

預設值： 1

連續成功次數下限，以便系統在失敗後將就緒性探測視為成功。最小值為 1。

預設值： 1

在這個秒數過後，連線探測就會逾時。最小值為 1。

預設值： 4

可用於自動調整資源配置的備用資源數量上限。

如果使用強化的每個環境 Proxy 限制，這項限制會套用至該環境的所有複本集。每個複本集仍會個別自動調整。

預設值： 1

可用於自動調整資源配置的備用資源數量下限。

如果使用強化的每個環境 Proxy 限制，這項限制會套用至該環境的所有複本集。每個複本集仍會獨立進行自動調整。

預設值： 4000m

Kubernetes 容器中資源的 CPU 限制，以毫核為單位。

預設值： 6Gi

Kubernetes 容器中資源的記憶體限制，以 MiB 或 GiB 為單位。

預設值： 500m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核為單位。

預設值： 512Mi (請參閱下方附註)

在 Kubernetes 容器中，資源正常運作所需的記憶體，以 MiB (Mi) 或 GiB (Gi) 為單位。

預設值： ClusterIP

服務類型。您可以將此值設為 ClusterIP 以外的服務，例如 LoadBalancer。

預設值： 75

Pod 上執行階段程序的目標 CPU 使用率。這個欄位的值可讓執行階段在 CPU 使用率達到這個值時自動調整，上限為 replicaCountMax。

預設值： 3600

從要求刪除 Pod 到 Pod 遭到終止之間的時間上限 (以秒為單位)。在這段期間內，系統會執行所有預停止掛鉤，並且所有執行中的程序都應能正常終止。當所有執行中的程序終止，或是寬限期結束時 (以先發生者為準)，Pod 就會遭到終止。如果沒有任何執行中的程序，系統會立即終止 Pod。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容許值與污點比對後的效果。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容許值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

用於註解 Pod 的選用鍵/值對應。詳情請參閱「自訂註解」。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看此元件的目前存放區網址。

預設值： 2

Kubernetes 會在重新啟動容器前，驗證有效性探針失敗的次數。最小值為 1。

預設值： 0

在容器啟動後，等待啟動有效性探測作業的秒數。

預設值： 5

決定執行 liveness 探測的頻率 (以秒為單位)。最小值為 1。

預設值： 1

在這個秒數過後，連線探測就會逾時。最小值為 1。

預設值：無

必要

用於指定 synchronizer 執行階段服務的 Kubernetes 節點的選用節點選取器標籤鍵。

請參閱 nodeSelector。

預設值：無

用於指定 synchronizer 執行階段服務的 Kubernetes 節點的選用節點選取器標籤值。

請參閱 nodeSelector。

預設值： 60

Synchronizer 在輪詢作業之間等待的時間長度。同步器會輪詢 Apigee 控制平面服務，以偵測及提取新的執行階段合約。

預設值： 2

Kubernetes 會在將 Pod 標示為「未準備就緒」之前，驗證完備性探針失敗的次數。最小值為 1。

預設值： 0

容器啟動後，啟動就緒探測作業前所需的秒數。

預設值： 5

決定執行就緒探測的頻率 (以秒為單位)。最小值為 1。

預設值： 1

連續成功次數下限，以便系統在失敗後將就緒性探測視為成功。最小值為 1。

預設值： 1

在這個秒數過後，連線探測就會逾時。最小值為 1。

Deprecated：從 Hybrid 1.2 版開始，您可以使用以下方法管理 Synchronizer 備份副本數量：synchronizer.replicaCountMax 和 synchronizer.replicaCountMin

預設值： 4

自動調度資源的備用資源數量上限。

預設值： 1

自動調整資源配置的備用資源數量下限。

預設值： 2000m

Kubernetes 容器中資源的 CPU 限制，以毫核為單位。

預設值： 5Gi

Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。

預設值： 100m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核為單位。

預設值： 1Gi

Kubernetes 容器中資源正常運作所需的記憶體，以 GB 為單位。

預設值：無

必須使用 serviceAccountPath 或 serviceAccountRef 其中之一。

具有 Apigee Synchronizer Manager 角色的 Google 服務帳戶金鑰檔案路徑。

預設值：無

必須使用 serviceAccountPath 或 serviceAccountRef 其中之一。

預設值：無

Kubernetes 密鑰的名稱。您必須使用 Google 服務帳戶金鑰建立密鑰，並將 Apigee Synchronizer Manager 角色做為輸入內容。

預設值： 75

Pod 上 Synchronizer 程序的目標 CPU 使用率。這個欄位的值可讓 Synchronizer 在 CPU 使用率達到這個值 (上限為 replicaCountMax) 時自動調度資源。

預設值： 30

從要求刪除 Pod 到 Pod 遭到終止之間的時間上限 (以秒為單位)。在這段期間內，系統會執行所有預停止掛鉤，並且所有執行中的程序都應能正常終止。當所有執行中的程序終止，或寬限期結束時 (以先發生者為準)，Pod 就會遭到終止。如果沒有任何執行中的程序，系統會立即終止 Pod。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

effect 會指定將容忍度與污點配對的效果。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

詳情請參閱「污點和容許值：概念」。

預設值：無

必須使用 Kubernetes 的 Taint 和容許條件功能。

key 會指出可套用容許值的 Pod。

詳情請參閱「污點和容許值：概念」。

預設值： "Equal"

必須使用 Kubernetes 的 Taint 和容許條件功能。

operator 會指定用於觸發 effect 的作業。operator 的值可以是：

• Equal 會與 value 中設定的值相符。
• Exists 會忽略 value 中設定的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

tolerationSeconds 會以秒為單位定義 pod 與失敗或無回應節點繫結的時間長度。

詳情請參閱「污點和容許值：概念」。

預設值：無

由 Kubernetes 的 Taint 和容許條件功能使用。

value 是當 operator 設為 Equal 時，會觸發 effect 的值。

詳情請參閱「污點和容許值：概念」。

預設值：無

用於註解 Pod 的選用鍵/值對應。詳情請參閱「自訂註解」。

預設值： IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值： gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent

這項服務的 Docker 映像檔位置。

預設值： 1000m

Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。

預設值： 500Mi

Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。

預設值： 500m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核為單位。

預設值： 250Mi

Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。

預設值：無

僅限 Helm：使用 Helm 圖表在 GKE 叢集中啟用 Workload Identity 時，與對應 Kubernetes 服務帳戶建立關聯的 apigee-udca Google IAM 服務帳戶 (GSA) 電子郵件地址。將此值設為 gcp.workloadIdentity.enabled 時，請將其設為 true。

GSA 電子郵件地址的格式通常為：

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

例如：

apigee-udca@my-hybrid-project.iam.gserviceaccount.com

請參閱「在 GKE 上啟用 Workload Identity」或「在 AKS 和 EKS 上啟用 Workload Identity Federation」。

預設值：IfNotPresent

決定 kubelet 何時要提取 Pod 的 Docker 映像檔。可能的值包括：

• IfNotPresent：如果已存在圖片，請勿拉取新的圖片。
• Always：無論是否已存在，一律提取映像檔。

詳情請參閱「更新圖片」。

預設值： 1.15.0

這項服務 Docker 映像檔的版本標籤。

預設值：無

這項服務的 Docker 映像檔位置。

使用 apigee-pull-push --list 即可查看這個元件的目前存放區網址。