設定屬性參考資料

本節列出所有可用於自訂 Apigee Hybrid 部署作業執行階段層的設定屬性。

頂層屬性

下表說明 overrides.yaml 檔案中的頂層屬性。這些屬性不屬於其他物件，適用於機構或環境層級：

屬性 說明
contractProvider 版本：1.0.0

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

定義安裝中所有 API 的 API 路徑。
gcpProjectID Deprecated: 如果是 1.2.0 以上版本，請改用 gcp.projectID。

版本：1.0.0

預設值： 無

必要

Google Cloud 專案的 ID。可與 k8sClusterName (已淘汰) 和 gcpRegion (已淘汰) 搭配使用，識別專案並判斷 apigee-logger 和 apigee-metrics 要將資料推送至何處。
gcpRegion Deprecated: 如果是 1.2.0 以上版本，請改用 gcp.region。

版本：1.0.0

預設值： us-central1

必要

Kubernetes 叢集最近的 GCP 區域或可用區。與 gcpProjectID (已淘汰) 和 k8sClusterName (已淘汰) 搭配使用，可識別專案並判斷 apigee-logger 和 apigee-metrics 推送資料的位置。
imagePullSecrets.name 版本：1.0.0

預設值：無

設定為 docker-registry 類型的 Kubernetes 密鑰名稱，用於從私人存放區提取映像檔。
k8sClusterName Deprecated: 如為 1.2.0 以上版本，請改用 k8sCluster.name 和 k8sCluster.region。

版本：1.0.0

預設值：無

混合式專案執行的 Kubernetes (K8S) 叢集名稱。可與 gcpProjectID (已淘汰) 和 gcpRegion (已淘汰) 搭配使用，識別專案並判斷 apigee-logger 和 apigee-metrics 要將資料推送至何處。
kmsEncryptionKey 版本：1.0.0

預設值： defaults.org.kmsEncryptionKey

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

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

預設值：無

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

包含 Base64 編碼加密金鑰的檔案路徑。請參閱「資料加密」一節。
kmsEncryptionSecret.key 版本：1.2.0

預設值：無

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

Kubernetes Secret 的金鑰，其中包含 Base64 編碼的加密金鑰。請參閱「資料加密」一節。
kmsEncryptionSecret.name 版本：1.2.0

預設值：無

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

Kubernetes 密鑰的名稱，其中包含以 Base64 編碼的加密金鑰。請參閱「資料加密」一節。
kvmEncryptionKey 版本：1.0.0

預設值： defaults.org.kmsEncryptionKey

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

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

預設值：無

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

包含 Base64 編碼加密金鑰的檔案路徑。請參閱「資料加密」一節。
kvmEncryptionSecret.key 版本：1.2.0

預設值：無

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

Kubernetes Secret 的金鑰，其中包含 Base64 編碼的加密金鑰。請參閱「資料加密」一節。
kvmEncryptionSecret.name 版本：1.2.0

預設值：無

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

Kubernetes 密鑰的名稱，其中包含以 base64 編碼的加密金鑰。請參閱「資料加密」一節。
namespace 版本：1.0.0

預設值： apigee

Kubernetes 叢集的命名空間，Apigee 元件將安裝於此。
org

版本：1.0.0

預設值：無

必要

Apigee 在 Hybrid 安裝期間為您佈建的 Hybrid 啟用機構。機構是 Apigee 中的頂層容器，其中包含所有 API Proxy 和相關資源。如果值為空白，您必須在建立機構後更新機構名稱。
revision 版本：1.0.0

預設值： v120

Apigee Hybrid 支援 Kubernetes 滾動式更新，可逐步更新 Pod 執行個體，完全不必停機即可部署更新。

更新某些 YAML 覆寫項目時，如果導致基礎 Kubernetes PodTemplateSpec 變更，客戶的 override.yaml 中也必須變更 revision 覆寫屬性。這是因為底層 Kubernetes ApigeeDeployment (AD) 控制器必須執行安全更新，才能從舊版更新至新版。你可以使用任何小寫文字值， 例如：「blue」、「a」、「1.0.0」

變更並套用 revision 屬性後，所有元件都會進行滾動式更新。

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

詳情請參閱「推出更新」。
validateServiceAccounts 版本：1.0.0

預設值：true

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

另請參閱 gcpProjectID

ao

Apigee Operators (AO) 會建立及更新部署和維護 ApigeeDeployment (AD) 所需的低層級 Kubernetes 和 Istio 資源。舉例來說，控制器會釋出訊息處理器。此外，也會在 Kubernetes 叢集中保留 ApigeeDeployment 設定之前，先驗證該設定。

下表說明 apigee-operators ao 物件的屬性：

屬性 說明
ao.image.pullPolicy 版本：1.2.0

預設值： IfNotPresent

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

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

詳情請參閱「更新圖片」。
ao.image.tag 版本：1.2.0

預設值： 1.2.0

這項服務 Docker 映像檔的版本標籤。
ao.image.url 版本：1.2.0

預設值： "google/apigee-deployment-controller"

這項服務的 Docker 映像檔位置。
ao.resources.limits.cpu 版本：1.2.0

預設值： 250m

Kubernetes 容器中資源的 CPU 限制 (以毫核為單位)。
ao.resources.limits.memory 版本：1.2.0

預設值： 256Mi

Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。
ao.resources.requests.cpu 版本：1.2.0

預設值： 250m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核心為單位。
ao.resources.requests.memory 版本：1.2.0

預設值： 256Mi

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

authz

下表說明 authz 物件的屬性：

屬性 說明
authz.image.pullPolicy 版本：1.0.0

預設值： IfNotPresent

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

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

詳情請參閱「更新圖片」。
authz.image.tag 版本：1.0.0

預設值： 1.2.0

這項服務 Docker 映像檔的版本標籤。
authz.image.url 版本：1.0.0

預設值： "google/apigee-authn-authz"

這項服務的 Docker 映像檔位置。
authz.livenessProbe.failureThreshold 版本：1.0.0

預設值： 2

Kubernetes 會先驗證有效性探測失敗的次數，再重新啟動容器。最小值為 1。
authz.livenessProbe.initialDelaySeconds 版本：1.0.0

預設值： 0

容器啟動後，到啟動存活探測作業之間的時間間隔 (以秒為單位)。
authz.livenessProbe.periodSeconds 版本：1.0.0

預設值： 5

以秒為單位，決定執行 liveness 探測的頻率。最小值為 1。
authz.livenessProbe.timeoutSeconds 版本：1.0.0

預設值： 1

健康狀態探測逾時的秒數。最小值為 1。
authz.readinessProbe.failureThreshold 版本：Beta2

預設值： 2

Kubernetes 會先驗證完備性探測失敗的次數，再將 Pod 標示為「尚未準備就緒」。最小值為 1。
authz.readinessProbe.initialDelaySeconds 版本：1.0.0

預設值： 0

容器啟動後，啟動就緒探測作業前的秒數。
authz.readinessProbe.periodSeconds 版本：1.0.0

預設值： 5

決定執行準備狀態探測的頻率 (以秒為單位)。最小值為 1。
authz.readinessProbe.successThreshold 版本：1.0.0

預設值： 1

失敗後，至少要連續成功幾次，才算成功。最小值為 1。
authz.readinessProbe.timeoutSeconds 版本：1.0.0

預設值： 1

健康狀態探測逾時的秒數。最小值為 1。
authz.resources.requests.cpu 版本：1.0.0

預設值： 50m

要為驗證要求分配的 CPU 資源量。

authz.resources.requests.memory 版本：1.0.0

預設值： 128Mi

要為驗證要求分配的記憶體資源量。

busyBoxInit (已淘汰)

下表說明 busyBoxInit 物件的屬性：

屬性 說明
busyBoxInit.image.pullPolicy Deprecated.

版本：1.0.0

預設值： IfNotPresent

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

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

詳情請參閱「更新圖片」。
busyBoxInit.image.tag Deprecated.

版本：1.0.0

預設值： "1.0.0"

這項服務 Docker 映像檔的版本標籤。
busyBoxInit.image.url Deprecated.

版本：1.0.0

預設值： "busybox"

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

cassandra

定義用於管理執行階段資料存放區的混合式服務。這個存放區會儲存應用程式設定、分散式配額計數器、API 金鑰，以及在閘道上執行的應用程式 OAuth 權杖。

詳情請參閱「設定 Cassandra」。

下表說明 cassandra 物件的屬性：

屬性 說明
cassandra.auth.admin.password 版本：1.0.0

預設值：「iloveapis123」

必要

Cassandra 管理員的密碼。管理員使用者可用於在 Cassandra 叢集上執行的任何管理活動。
cassandra.auth.ddl.password 版本：1.0.0

預設值：「iloveapis123」

必要

Cassandra 資料定義語言 (DDL) 使用者的密碼。MART 用於任何資料定義工作，例如建立、更新及刪除鍵空間。
cassandra.auth.default.password 版本：1.0.0

預設值： "iloveapis123"

必要

啟用驗證時建立的預設 Cassandra 使用者密碼。設定 Cassandra 驗證時，必須重設這組密碼。請參閱「為 Cassandra 設定 TLS」。
cassandra.auth.dml.password 版本：1.0.0

預設值：「iloveapis123」

必要

Cassandra 資料操縱語言 (DML) 使用者的密碼。用戶端通訊會使用 DML 使用者，從 Cassandra 讀取及寫入資料。
cassandra.auth.image.pullPolicy 版本：1.0.0

預設值： IfNotPresent

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

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

詳情請參閱「更新圖片」。
cassandra.auth.image.tag 版本：1.0.0

預設值： 1.2.0

這項服務 Docker 映像檔的版本標籤。
cassandra.auth.image.url 版本：1.0.0

預設值： "google/apigee-hybrid-cassandra-client"

這項服務的 Docker 映像檔位置。
cassandra.backup.cloudProvider 版本：1.0.0

預設值： "GCP"

如果已啟用備份功能，則為必要選項。

備份儲存空間的雲端供應商。
cassandra.backup.dbStorageBucket 版本：1.0.0

預設值：無

如果已啟用備份功能，則為必要選項。

備份資料的 Cloud Storage bucket。
cassandra.backup.enabled 版本：1.0.0

預設值： false

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

請參閱「Cassandra 備份與復原」。
cassandra.backup.image.pullPolicy 版本：1.0.0

預設值： IfNotPresent

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

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

詳情請參閱「更新圖片」。
cassandra.backup.image.tag 版本：1.0.0

預設值： 1.2.0

這項服務 Docker 映像檔的版本標籤。
cassandra.backup.image.url 版本：1.0.0

預設值： "google/apigee-cassandra-backup-utility"

這項服務的 Docker 映像檔位置。
cassandra.backup.schedule 版本：1.0.0

預設值： "0 2 * * *"

Cron 工作的時間表。

請參閱「Cassandra 備份與復原」。
cassandra.backup.serviceAccountPath 版本：1.0.0

預設值：無

如果已啟用備份功能，則必須提供 backup.serviceAccountPath 或 backup.serviceAccountSecretRef 其中之一。

具有 Storage 物件管理員角色的 Google 服務帳戶金鑰檔案路徑。

cassandra.backup.serviceAccountSecretRef 版本：1.2.0

預設值：無

如果已啟用備份功能，則必須提供 backup.serviceAccountPath 或 backup.serviceAccountSecretRef 其中之一。

Kubernetes Secret 的名稱。您必須使用 Google 服務帳戶金鑰建立密鑰，並以「Storage 物件管理員」角色做為輸入內容。
cassandra.clusterName 版本：1.0.0

預設值： "apigeecluster"

指定 Cassandra 叢集的名稱。
cassandra.datacenter 版本：1.0.0

預設值： "dc-1"

指定 Cassandra 節點的資料中心。
cassandra.dnsPolicy 版本：1.1.1

預設值： ClusterFirstWithHostNet

如果將 cassandra.hostNetwork 設為 true，這項政策會決定 Cassandra 使用的 DNS 政策。如果是以 Anthos 為基礎的部署作業，則應設為 ClusterFirstWithHostNet。

如果 cassandra.hostNetwork 設為 false，系統會忽略 cassandra.dnsPolicy。

如需 cassandra.dnsPolicy 的更多值，請參閱 Kubernetes 說明文件中的「 Pod 的 DNS 政策」。
cassandra.externalSeedHost 版本：1.0.0

預設值：無

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

預設值： 100M

分配給較新物件的 JVM 系統記憶體量，以 MB 為單位。
cassandra.hostNetwork 版本：1.1.1

預設值：Anthos 部署作業為 true。false 適用於非 Anthos 部署作業。

如果是以 Anthos 為基礎的部署作業，請設為 true。

如果 cassandra.hostNetwork 為 true，請確認 cassandra.dnsPolicy 已設為 ClusterFirstWithHostNet。
cassandra.image.pullPolicy 版本：1.0.0

預設值： IfNotPresent

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

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

詳情請參閱「更新圖片」。
cassandra.image.tag 版本：1.0.0

預設值： 1.2.0

這項服務 Docker 映像檔的版本標籤。
cassandra.image.url 版本：1.0.0

預設值： "google/apigee-hybrid-cassandra"

這項服務的 Docker 映像檔位置。
cassandra.maxHeapSize 版本：1.0.0

預設值： 512M

Cassandra 作業可用的 JVM 系統記憶體上限 (以 MB 為單位)。
cassandra.multiRegionSeedHost 版本：1.0.0

預設值：無

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

預設值：無

必要

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

請參閱「新增節點選取器」。
cassandra.nodeSelector.value 版本：1.0.0

預設值：無

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

請參閱 nodeSelector。
cassandra.port 版本：1.0.0

預設值： 9042

連線至 Cassandra 時使用的通訊埠編號。
cassandra.rack 版本：1.0.0

預設值： "ra-1"

指定 Cassandra 節點的機架。
cassandra.readinessProbe.failureThreshold 版本：1.0.0

預設值： 2

Kubernetes 會先驗證完備性探測失敗的次數，再將 Pod 標示為「尚未準備就緒」。最小值為 1。
cassandra.readinessProbe.initialDelaySeconds 版本：1.0.0

預設值： 0

容器啟動後，啟動就緒探測作業前的秒數。
cassandra.readinessProbe.periodSeconds 版本：1.0.0

預設值： 10

決定執行準備狀態探測的頻率 (以秒為單位)。最小值為 1。
cassandra.readinessProbe.successThreshold 版本：1.0.0

預設值： 1

失敗後，至少要連續成功幾次，才算成功。最小值為 1。
cassandra.readinessProbe.timeoutSeconds 版本：1.0.0

預設值： 5

健康狀態探測作業逾時的秒數。最小值為 1。
cassandra.replicaCount 版本：1.0.0

預設值： 1

Cassandra 是複寫資料庫。這項屬性會指定做為 StatefulSet 的 Cassandra 節點數量。
cassandra.resources.requests.cpu 版本：1.0.0

預設值： 500m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核心為單位。
cassandra.resources.requests.memory 版本：1.0.0

預設值： 1Gi

Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。
cassandra.restore.cloudProvider 版本：1.0.0

預設值： "GCP"

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

備份儲存空間的雲端供應商。
cassandra.restore.dbStorageBucket 版本：1.0.0

預設值：無

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

用於還原備份資料的 Cloud Storage bucket。
cassandra.restore.enabled 版本：1.0.0

預設值： false
cassandra.restore.image.pullPolicy 版本：1.0.0

預設值： IfNotPresent

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

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

詳情請參閱「更新圖片」。
cassandra.restore.image.tag 版本：1.0.0

預設值： 1.2.0

這項服務 Docker 映像檔的版本標籤。
cassandra.restore.image.url 版本：1.0.0

預設值： "google/apigee-cassandra-backup-utility"

這項服務的 Docker 映像檔位置。
cassandra.restore.serviceAccountPath 版本：1.0.0

預設值：無

如果啟用還原功能，則必須提供 restore.serviceAccountPath 或 restore.serviceAccountSecretRef 其中之一。

具有 Storage 物件管理員角色的 Google 服務帳戶金鑰檔案路徑。

cassandra.restore.serviceAccountSecretRef 版本：1.2.0

預設值：無

如果啟用還原功能，則必須提供 restore.serviceAccountPath 或 restore.serviceAccountSecretRef 其中之一。

Kubernetes Secret 的名稱。您必須使用 Google 服務帳戶金鑰建立密鑰，並以「Storage 物件管理員」角色做為輸入內容。
cassandra.restore.snapshotTimestamp 版本：1.0.0

預設值：無

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

要還原的備份時間戳記。
cassandra.restore.user 版本：1.0.0

預設值： 管理員帳戶

用於還原結構定義備份的 Cassandra 使用者名稱。如未指定，則會使用管理員使用者。
cassandra.sslCertPath 版本：1.2.0

預設值：無

系統中傳輸層安全標準 (TLS) 憑證檔案的路徑。
cassandra.sslKeyPath 版本：1.2.0

預設值：無

系統中 TLS 私密金鑰檔案的路徑。
cassandra.sslRootCAPath 版本：1.2.0

預設值：無

根 CA (憑證授權單位) 的憑證鏈。
cassandra.storage.capacity 版本：1.0.0

預設值： 50Gi

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

指定所需磁碟大小 (以 MiB 為單位)。
cassandra.storage.storageClass 版本：1.0.0

預設值：無

指定使用的內部部署儲存空間類別。
cassandra.terminationGracePeriodSeconds 版本：1.0.0

預設值： 300

要求刪除 Pod 與終止 Pod 之間的時間 (以秒為單位)。在這段期間，系統會執行所有前置停止勾點，且所有執行中的程序都應正常終止。

certmanager

cert-manager 是 Apigee 使用的 Kubernetes 實作項目憑證管理工具。 請參閱「歡迎使用 cert-manager」。

下表說明 certmanager 物件的屬性：

屬性 說明
certmanager.image.tag 版本：1.2.0

預設值： "v0.12.0"

這項服務 Docker 映像檔的版本標籤。
certmanager.image.url 版本：1.2.0

預設值： "apigee-cert-manager-controller"

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

certmanagercainjector

cert-manager CA 注入器是 cert-manager 程序，負責將 CA 組合注入 cert-manager Webhook 程序。請參閱 cert-manager 說明文件中的「CA 注入器」。

下表說明 certmanagercainjector 物件的屬性：

屬性 說明
certmanagercainjector.image.tag 版本：1.2.0

預設值： "v0.12.0"

這項服務 Docker 映像檔的版本標籤。
certmanagercainjector.image.url 版本：1.2.0

預設值： "google/apigee-cert-manager-cainjector"

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

certmanagerwebhook

cert-manager Webhook 是一項程序，可動態控管 cert-manager 資源的許可。請參閱 cert-manager 說明文件中的「Webhook」。

下表說明 certmanagerwebhook 物件的屬性：

屬性 說明
certmanagerwebhook.image.tag 版本：1.2.0

預設值： "v0.12.0"

這項服務 Docker 映像檔的版本標籤。
certmanagerwebhook.image.url 版本：1.2.0

預設值： "google/apigee-cert-manager-webhook"

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

connectAgent

Apigee Connect 可讓 Apigee Hybrid 管理層安全地連線至執行階段層中的 MART 服務，不必將 MART 端點公開至網際網路。如果您使用 Apigee Connect，就不必透過主機別名和授權的 DNS 憑證設定 MART 輸入閘道。

下表說明 connectAgent 物件的屬性：

屬性 說明
connectAgent.enabled 版本：1.2.0

預設值： false

這個安裝項目是否使用 Apigee Connect，而非 Istio Ingress for MART？下列敘述是否正確？

請參閱「使用 Apigee Connect」。
connectAgent.server 版本：1.2.0

預設值： "apigeeconnect.googleapis.com:443"

這項服務的伺服器和通訊埠位置。
connectAgent.logLevel 版本：1.2.0

預設值： "INFO"

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

  • INFO：除了警告、錯誤和嚴重錯誤訊息外，還會顯示參考性訊息。最適合用於偵錯。
  • WARNING：除了錯誤和嚴重錯誤訊息外，也包含非嚴重警告。
  • ERROR：內部錯誤和未傳回給使用者的錯誤，以及嚴重錯誤訊息。
  • FATAL：無法復原的錯誤和事件，導致 Apigee Connect 停止運作。
connectAgent.image.pullPolicy 版本：1.2.0

預設值： IfNotPresent

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

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

詳情請參閱「更新圖片」。
connectAgent.image.tag 版本：1.2.0

預設值： "1.2.0"

這項服務 Docker 映像檔的版本標籤。
connectAgent.image.url 版本：1.2.0

預設值： "google/apigee-connect-agent"

這項服務的 Docker 映像檔位置。檢查 values.yaml 檔案中的特定網址。
connectAgent.replicaCountMax 版本：1.2.0

預設值： 5

自動調度資源功能可用的副本數量上限。
connectAgent.replicaCountMin 版本：1.2.0

預設值： 1

可供自動調度資源的副本數量下限。

在正式環境中，您可能需要將 replicaCountMin 增加至 3，以增加與控制層的連線數，確保可靠性和可擴充性。
connectAgent.resources.requests.cpu 版本：1.0.0

預設值： 100m

Kubernetes 容器中資源正常運作所需的 CPU，以毫核心為單位。
connectAgent.resources.requests.memory 版本：1.0.0

預設值： 30Mi

Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。
connectAgent.targetCPUUtilizationPercentage 版本：1.2.0

預設值： 75

Pod 中 Apigee Connect 代理程式的目標 CPU 使用率。當 CPU 使用率達到這個欄位的值時，Apigee Connect 就會自動調度資源，最多可達 replicaCountMax。
connectAgent.terminationGracePeriodSeconds 版本：1.2.0

預設值： 600

從要求刪除 Pod 到 Pod 終止的時間間隔 (以秒為單位)。在這段期間，系統會執行所有前置停止勾點，且所有執行中的程序都應正常終止。

defaults

Apigee Hybrid 安裝的預設加密金鑰。

下表說明 defaults 物件的屬性：

屬性 說明
defaults.org.kmsEncryptionKey 版本：1.0.0

預設值： "aWxvdmVhcGlzMTIzNDU2Nw=="

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

defaults.org.kvmEncryptionKey 版本：1.0.0

預設值： "aWxvdmVhcGlzMTIzNDU2Nw=="

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

defaults.env.kmsEncryptionKey 版本：1.0.0

預設值： "aWxvdmVhcGlzMTIzNDU2Nw=="

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

defaults.env.kvmEncryptionKey 版本：1.0.0

預設值： "aWxvdmVhcGlzMTIzNDU2Nw=="

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

defaults.env.cacheEncryptionKey 版本：1.0.0

預設值： "aWxvdmVhcGlzMTIzNDU2Nw=="

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

envs

定義可部署 API Proxy 的環境陣列。每個環境都會提供獨立的環境或「沙箱」，用於執行 API Proxy。

啟用混合式功能的機構必須至少有一個環境。

詳情請參閱「設定環境」。

下表說明 envs 物件的屬性：

屬性 說明
envs[].cacheEncryptionKey 版本：1.0.0

預設值：無

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

Base64 編碼的加密金鑰。請參閱「資料加密」一節。
envs[].cacheEncryptionPath 版本：1.2.0

預設值：無

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

包含 Base64 編碼加密金鑰的檔案路徑。請參閱「資料加密」一節。
envs[].cacheEncryptionSecret.key 版本：1.2.0

預設值：無

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

Kubernetes Secret 的金鑰，其中包含 Base64 編碼的加密金鑰。請參閱「資料加密」一節。
envs[].cacheEncryptionSecret.name 版本：1.2.0

預設值：無

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

Kubernetes 密鑰的名稱，其中包含以 Base64 編碼的加密金鑰。請參閱「資料加密」一節。
envs[].hostAlias 版本：1.0.0

預設值：無

已淘汰：請改用 hostAliases[]。
envs[].hostAliases[] 版本：1.2.0

預設值：無

指向環境的主機別名。每個主機別名都必須是完整網域名稱。
envs[].httpProxy.host 版本：1.2.0

預設值：無

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

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

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

另請參閱：設定 API Proxy 的轉送 Proxy。
envs[].httpProxy.port 版本：1.2.0

預設值：無

指定 HTTP Proxy 執行的通訊埠。如果省略這項屬性，系統預設會使用通訊埠 80 (HTTP) 和通訊埠 443 (HTTPS)。
envs[].httpProxy.scheme 版本：1.2.0

預設值：無

指定 HTTP Proxy 的類型，例如 HTTP 或 HTTPS。預設值為「HTTP」。
envs[].httpProxy.username 版本：1.2.0

預設值：無

如果 HTTP Proxy 需要基本驗證，請使用這個屬性提供使用者名稱。
envs[].httpProxy.password 版本：1.2.0

預設值：無

如果 HTTP Proxy 需要基本驗證，請使用這個屬性提供密碼。
envs[].kmsEncryptionKey 版本：1.0.0

預設值：無

kmsEncryptionKey、kmsEncryptionPath 或 kmsEncryptionSecret 必須提供其中一個。

Apigee KMS 資料加密金鑰的本機檔案系統路徑。
envs[].kmsEncryptionPath 版本：1.2.0

預設值：無

kmsEncryptionKey、kmsEncryptionPath 或 kmsEncryptionSecret 必須提供其中一個。

包含 Base64 編碼加密金鑰的檔案路徑。請參閱「資料加密」一節。
envs[].kmsEncryptionSecret.key 版本：1.2.0

預設值：無

必須提供 kmsEncryptionKey、kmsEncryptionPath 或 kmsEncryptionSecret。

Kubernetes Secret 的金鑰，其中包含 Base64 編碼的加密金鑰。請參閱「資料加密」一節。
envs[].kmsEncryptionSecret.name 版本：1.2.0

預設值：無

kmsEncryptionKey、kmsEncryptionPath 或 kmsEncryptionSecret 必須提供其中一個。

Kubernetes 密鑰的名稱，其中包含以 base64 編碼的加密金鑰。請參閱「資料加密」一節。
envs[].name 版本：1.0.0

預設值：無

必要

要同步處理的 Apigee 環境名稱。
envs[].pollInterval 版本：1.0.0

預設值：無

輪詢機構和環境同步處理變更的時間間隔 (以秒為單位)。
envs[].port 版本：1.0.0

預設值：無

HTTPS 流量的 TCP 通訊埠編號。
envs[].serviceAccountPaths.synchronizer 版本：GA

預設值：無

本機系統上檔案的路徑，該檔案是具有「Apigee Synchronizer Manager」角色的 Google 服務帳戶金鑰。
envs[].serviceAccountPaths.udca 版本：GA

預設值：無

本機系統上檔案的路徑，該檔案是具有 Apigee Analytic Agent 角色的 Google 服務帳戶金鑰。
envs[].serviceAccountSecretRefs.synchronizer 版本：1.2.0

預設值：無

Kubernetes Secret 的名稱。您必須使用具有 Apigee Synchronizer Manager 角色的 Google 服務帳戶金鑰做為輸入內容，建立密鑰。
envs[].serviceAccountSecretRefs.udca 版本：1.2.0

預設值：無

Kubernetes Secret 的名稱。您必須使用具有「Apigee Analytic Agent」角色的 Google 服務帳戶金鑰，建立密鑰。
envs[].sslCertPath 版本：1.2.0

預設值：無

請提供 sslCertPath/sslKeyPath 或 sslSecret。

系統中傳輸層安全標準 (TLS) 憑證檔案的路徑。
envs[].sslKeyPath 版本：1.2.0

預設值：無

請提供 sslCertPath/sslKeyPath 或 sslSecret。

系統中 TLS 私密金鑰檔案的路徑。
envs[].sslSecret 版本：1.2.0

預設值：無

請提供 sslCertPath/sslKeyPath 或 sslSecret。

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

另請參閱：

gcp

識別 apigee-logger 和 apigee-metrics 推送資料的 GCP 專案 ID 和區域。

下表說明 gcp 物件的屬性：

屬性 說明
gcp.region 版本：1.2.0

預設值：無

必要

識別 apigee-logger 和 apigee-metrics 推送資料的 GCP 區域。
gcp.projectID 版本：1.2.0

預設值：無

必要

識別 Google Cloud 專案，其中 apigee-logger 和 apigee-metrics 會推送資料。
gcp.projectIDRuntime 版本：1.2.0

預設值：無

識別執行階段 Kubernetes 叢集專案。

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

httpProxy

httpProxy 提供 HTTP 轉送 Proxy 伺服器的設定參數。在 overrides.yaml 中設定時，MART、Synchronizer 和 UDCA 元件的所有網際網路通訊都會透過 Proxy 伺服器傳遞。

另請參閱：MART、Synchronizer 和 UDCA。

下表說明 httpProxy 物件的屬性：

屬性 說明
httpProxy.host 版本：1.1.1

預設值：無

HTTP Proxy 的主機名稱。
httpProxy.port 版本：1.1.1

預設值：無

HTTP Proxy 的通訊埠。
httpProxy.scheme 版本：1.1.1

預設值： HTTPS

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

ingress

Ingress 是 Istio Ingress Gateway 的例項。Ingress 用於指定應在叢集外部公開的服務。混合式執行階段安裝程序會為下列兩個執行階段元件建立 Ingress 物件：

  • 執行階段
  • MART

另請參閱：

下表說明 ingress 物件的屬性：

屬性 說明
ingress.enableAccesslog 版本：1.0.0

預設值： false

啟用或停用 Ingress 存取記錄。這項功能預設為停用。
ingress.envoyHeaders.headers 版本：1.0.0
預設值： 
"x-envoy-decorator-operation"
"x-envoy-expected-rq-timeout-ms"
"x-envoy-external-address"
"x-istio-attributes"

無

Envoy 標頭清單。
ingress.envoyHeaders.preserved 版本：1.0.0

預設值： false

決定是否保留 Envoy 的標頭。根據預設，系統不會顯示。
ingress.httpsRedirect 版本：1.0.0

預設值： true

啟用或停用所有傳入流量的自動 HTTPS 重新導向功能。
ingress.mart.loadBalancerIP 版本：1.1.1

預設值： 10.0.10.252

MART 負載平衡器的 IP 位址。
ingress.minTLSProtocolVersion 版本：1.2.0

預設值：如果未指定 minTLSProtocolVersion 或 maxTLSProtocolVersion，輸入內容會使用預設的 TLS_AUTO，如 Envoy 代理程式文件中的「常見的 TLS 設定」所述。

可為 Ingress 設定最低 TLS 版本。可能的值為 1.0、1.1、1.2 和 1.3。
ingress.maxTLSProtocolVersion 版本：1.2.0

預設值：如果未指定 minTLSProtocolVersion 或 maxTLSProtocolVersion，輸入內容會使用預設的 TLS_AUTO，如 Envoy 代理程式文件中的「常見的 TLS 設定」所述。

可為 Ingress 設定 TLS 版本上限。 可能的值為 1.0、1.1、1.2 和 1.3。
ingress.runtime.loadBalancerIP 版本：1.1.1

預設值： 10.0.10.251

Apigee-runtime 物件的負載平衡器 IP 位址。
ingress.serviceType 版本：1.0.0

預設值： LoadBalancer

用於將外部流量轉送至內部服務的服務類型。

可能的值包括：

  • ClusterIP (不支援)
  • LoadBalancer
  • NodePort

istio

Google Cloud Platform (GCP) 的 Istio 實作項目是服務網格，可疊加在現有的 Apigee 執行個體上，協助與記錄平台、遙測和政策系統整合。

另請參閱：GCP 的 Istio 說明文件和「什麼是 Istio」。

下表說明 istio 物件的屬性：

屬性 說明
istio.citadel.image.url 版本：1.2.0

預設值： "google/apigee-istio-citadel"

這項服務的 Docker 映像檔位置。
istio.galley.image.url 版本：1.2.0

預設值： "google/apigee-istio-galley"

這項服務的 Docker 映像檔位置。
istio.ingressgateway.replicaCountMax 版本：1.0.0

預設值：5

必要

允許的 Istio Ingress 閘道副本數量上限。

請參閱：
istio.ingressgateway.replicaCountMin 版本：1.0.0

預設值：1

必要

Istio Ingress 閘道副本數量下限。

請參閱：
istio.ingressgateway.resources.requests.cpu 版本：1.0.0

預設值：100 公尺

必要

分配給 Ingress 控制器的 CPU 資源，這是閘道發揮最佳效能的必要條件。

請參閱：
istio.ingressgateway.resources.requests.memory 版本：1.0.0

預設值：128Mi

分配給 Ingress 控制器的記憶體資源，這是閘道發揮最佳效能的必要條件。

  • Ingress 物件
  • Istio 說明文件中的 Ingress Gateways
  • Kubernetes 說明文件中的「 Ingress 控制器」。
    		•
    istio.kubectl.image.url 版本：1.2.0

    預設值： "google/apigee-istio-kubectl"

    這項服務的 Docker 映像檔位置。
    istio.mixer.image.url 版本：1.2.0

    預設值： "google/apigee-istio-mixer"

    這項服務的 Docker 映像檔位置。
    istio.node_agent_k8s.image.url 版本：1.2.0

    預設值： "google/apigee-istio-node-agent-k8s"

    這項服務的 Docker 映像檔位置。
    istio.nodeSelector.key 版本：1.0.0

    預設值：無

    選用節點選取器標籤鍵，用於指定 Kubernetes 節點的 istio 服務。如未指定 mart.nodeselector 的金鑰，istio 服務會使用 nodeSelector 物件中指定的節點。
    istio.nodeSelector.value 版本：1.0.0

    預設值：無

    選用節點選取器標籤值，用於指定 istio 服務的 Kubernetes 節點。另請參閱 nodeSelector 物件。
    istio.pilot.image.url 版本：1.2.0

    預設值： "google/apigee-istio-pilot"

    這項服務的 Docker 映像檔位置。
    istio.pilot.replicaCountMax 版本：1.0.0

    預設值：5

    必要

    叢集內的 pilot 核心流量管理，與 envoy 輔助 Proxy 通訊。replicaCountMax 是允許的 Istio Pilot 副本數量上限。

    請參閱 Istio 說明文件中的「 試用版：核心流量管理」
    istio.pilot.replicaCountMin 版本：1.0.0

    預設值：1

    必要

    叢集內的 pilot 核心流量管理，與 envoy 輔助 Proxy 通訊。replicaCountMax 是 Istio Pilot 副本數量上限。

    請參閱 Istio 說明文件中的「 試用版：核心流量管理」
    istio.pilot.resources.requests.cpu 版本：1.0.0

    預設值：500 公尺

    必要

    分配給試用程序 (閘道正常運作所需) 的 CPU 資源。

    請參閱：
    istio.pilot.resources.requests.memory 版本：1.0.0

    預設值：2048Mi

    分配給試用程序使用的記憶體資源，閘道需要這些資源才能發揮最佳效能。

    請參閱：
    istio.proxyv2.image.url 版本：1.2.0

    預設值： "google/apigee-istio-proxyv2"

    這項服務的 Docker 映像檔位置。
    istio.sidecar_injector.image.url 版本：1.2.0

    預設值： "google/apigee-istio-sidecar-injector"

    這項服務的 Docker 映像檔位置。
    istio.version 版本：1.2.0

    預設值： 1.4.6

    用於這個 Apigee 實作的 Istio 版本。

    請參閱： GitHub 上的 Istio 版本

    k8sCluster

    識別安裝 Hybrid 執行階段的 Kubernetes 叢集。

    下表說明 k8sCluster 物件的屬性：

    屬性 說明
    k8sCluster.name 版本：1.2.0

    預設值：無

    安裝 Hybrid 執行階段的 Kubernetes 叢集名稱。
    k8sCluster.region 版本：1.2.0

    預設值：無

    識別 Kubernetes 叢集建立所在的 GCP 區域。

    kubeRBACProxy

    指出 Apigee 應在何處尋找 Kubernetes 角色型存取權控管。

    下表說明 kubeRBACProxy 物件的屬性：

    屬性 說明
    kubeRBACProxy.image.pullPolicy 版本：1.2.0

    預設值： IfNotPresent

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

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

    詳情請參閱「更新圖片」。
    kubeRBACProxy.image.tag 版本： "v0.4.1"

    預設值： 1.2.0

    這項服務 Docker 映像檔的版本標籤。
    kubeRBACProxy.image.url 版本：1.2.0

    預設值： "google/apigee-kube-rbac-proxy"

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

    如不想使用 Google Docker Hub，請下載映像檔，並使用內部 Docker 映像檔的代管地址。

    logger

    定義管理作業記錄的服務。在 Kubernetes 叢集中執行的所有 Apigee Hybrid 服務都會輸出這項資訊。

    詳情請參閱「記錄」。

    下表說明 logger 物件的屬性：

    屬性 說明
    logger.enabled 版本：1.0.0

    預設值： true

    啟用或停用叢集的記錄功能。如果不是 GKE，請設為 true；如果是 Anthos 或 GKE，請設為 false。
    logger.fluentd.buffer_chunk_limit 版本：1.0.0

    預設值： 512k

    允許的緩衝區區塊大小上限 (以 KB 為單位)。超過上限的區塊會自動排入輸出佇列。
    logger.fluentd.buffer_queue_limit 版本：1.0.0

    預設值： 6

    輸出佇列的長度上限。預設上限為 256 個區塊。
    logger.fluentd.flush_interval 版本：1.0.0

    預設值： 5s

    在叫用下一個緩衝區排清作業前等待的時間間隔 (以秒為單位)。
    logger.fluentd.max_retry_wait 版本：1.0.0

    預設值： 30

    寫入重試之間的時間間隔上限 (以秒為單位)。
    logger.fluentd.num_threads 版本：1.0.0

    預設值： 2

    用於排清緩衝區的執行緒數量。預設值為 1。
    logger.image.pullPolicy 版本：1.0.0

    預設值： IfNotPresent

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

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

    詳情請參閱「更新圖片」。
    logger.image.tag 版本：1.0.0

    預設值： "1.6.8"

    這項服務 Docker 映像檔的版本標籤。
    logger.image.url 版本：1.0.0

    預設值： "google/apigee-stackdriver-logging-agent"

    這項服務的 Docker 映像檔位置。
    logger.livenessProbe.failureThreshold 版本：1.0.0

    預設值： 3

    Kubernetes 會先驗證有效性探測失敗的次數，再重新啟動容器。最小值為 1。
    logger.livenessProbe.initialDelaySeconds 版本：1.0.0

    預設值： 0

    容器啟動後，到啟動存活探測作業之間的時間間隔 (以秒為單位)。
    logger.livenessProbe.periodSeconds 版本：1.0.0

    預設值： 60

    以秒為單位，決定執行 Liveness 探測的頻率。最小值為 1。
    logger.livenessProbe.successThreshold 版本：1.0.0

    預設值： 1

    探測失敗後，至少要連續成功幾次，才算成功。最小值為 1。
    logger.livenessProbe.timeoutSeconds 版本：1.0.0

    預設值： 1

    健康狀態探測逾時的秒數。最小值為 1。
    logger.nodeSelector.key 版本：1.0.0

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

    必要

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

    請參閱「新增節點選取器」。
    logger.nodeSelector.value 版本：1.0.0

    預設值： "true"

    必要

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

    請參閱「新增節點選取器」。
    logger.proxyURL 版本：1.0.0

    預設值：無

    客戶 Proxy 伺服器的網址。
    logger.resources.limits.memory 版本：1.0.0

    預設值： 500Mi

    Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。
    logger.resources.limits.cpu 版本：1.0.0

    預設值： 200m

    Kubernetes 容器中資源的 CPU 限制 (以毫核為單位)。
    logger.resources.requests.cpu 版本：1.0.0

    預設值： 100m

    Kubernetes 容器中資源正常運作所需的 CPU，以毫核心為單位。
    logger.resources.requests.memory 版本：1.0.0

    預設值： 250Mi

    Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。
    logger.serviceAccountPath 版本：1.0.0

    預設值：無

    您必須提供 serviceAccountPath 或 serviceAccountSecretRef 其中之一。

    具有「記錄檔寫入者」角色的 Google 服務帳戶金鑰檔案路徑。

    logger.serviceAccountSecretRef 版本：1.2.0

    預設值：無

    您必須提供 serviceAccountPath 或 serviceAccountSecretRef 其中之一。

    Kubernetes Secret 的名稱。您必須使用具有「記錄檔寫入者」角色的 Google 服務帳戶金鑰做為輸入內容，建立密鑰。
    logger.terminationGracePeriodSeconds 版本：1.0.0

    預設值： 30

    從要求刪除 Pod 到 Pod 終止的時間間隔 (以秒為單位)。在這段期間，系統會執行所有前置停止勾點，且所有執行中的程序都應正常終止。

    mart

    定義 MART (Management API for RunTime data) 服務，做為公開 Apigee API 的 API 供應商，方便您存取及管理執行階段資料實體，例如 KMS (API 金鑰和 OAuth 權杖)、KVM、配額和 API 產品。

    下表說明 mart 物件的屬性：

    屬性 說明
    mart.hostAlias 版本：1.0.0

    預設值：無

    指向 MART 物件的主機別名。您可以將這項屬性設為 * 或完整網域名稱。
    mart.image.pullPolicy 版本：1.0.0

    預設值： IfNotPresent

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

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

    詳情請參閱「更新圖片」。
    mart.image.tag 版本：1.0.0

    預設值： 1.2.0

    這項服務 Docker 映像檔的版本標籤。
    mart.image.url 版本：1.0.0

    預設值： "google/apigee-mart-server"

    這項服務的 Docker 映像檔位置。在 values.yaml 檔案中檢查特定網址。您可以覆寫這個網址。
    mart.initCheckCF.resources.requests.cpu 版本：1.0.0

    預設值： 10m

    分配給 Cloud Foundry 程序初始化檢查的 CPU 資源量。
    mart.livenessProbe.failureThreshold 版本：1.0.0

    預設值： 12

    Kubernetes 會先驗證有效性探測失敗的次數，再重新啟動容器。最小值為 1。
    mart.livenessProbe.initialDelaySeconds 版本：1.0.0

    預設值： 15

    容器啟動後，到啟動存活探測作業之間的時間間隔 (以秒為單位)。
    mart.livenessProbe.periodSeconds 版本：1.0.0

    預設值： 5

    以秒為單位，決定執行 liveness 探測的頻率。最小值為 1。
    mart.livenessProbe.timeoutSeconds 版本：1.0.0

    預設值： 1

    健康狀態探測逾時的秒數。最小值為 1。
    mart.metricsURL 版本：1.0.0

    預設值： "/v1/server/metrics"

    mart.nodeSelector.key 版本：1.0.0

    預設值：無

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

    請參閱「新增節點選取器」。
    mart.nodeSelector.value 版本：1.0.0

    預設值：無

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

    請參閱「新增節點選取器」。
    mart.readinessProbe.failureThreshold 版本：1.0.0

    預設值： 2

    Kubernetes 會先驗證完備性探測失敗的次數，再將 Pod 標示為「尚未準備就緒」。最小值為 1。
    mart.readinessProbe.initialDelaySeconds 版本：1.0.0

    預設值： 15

    容器啟動後，啟動就緒探測作業前的秒數。
    mart.readinessProbe.periodSeconds 版本：1.0.0

    預設值： 5

    決定執行準備狀態探測的頻率 (以秒為單位)。最小值為 1。
    mart.readinessProbe.successThreshold 版本：1.0.0

    預設值： 1

    失敗後，至少要連續成功幾次，才算成功。最小值為 1。
    mart.readinessProbe.timeoutSeconds 版本：1.0.0

    預設值： 1

    健康狀態探測逾時的秒數。最小值為 1。
    mart.replicaCountMax 版本：1.0.0

    預設值： 5

    自動調度資源功能可用的副本數量上限。
    mart.replicaCountMin 版本：1.0.0

    預設值： 1

    可供自動調度資源的副本數量下限。
    mart.resources.requests.cpu 版本：1.0.0

    預設值： 500m

    Kubernetes 容器中資源正常運作所需的 CPU，以毫核心為單位。
    mart.resources.requests.memory 版本：1.0.0

    預設值： 512Mi

    Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。
    mart.serviceAccountPath 版本：1.1.1

    預設值：無

    請使用 serviceAccountPath 或 serviceAccountSecretRef 其中之一個屬性即可。

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

    mart.serviceAccountSecretRef 版本：1.2.0

    預設值：無

    請使用 serviceAccountPath 或 serviceAccountSecretRef 其中之一個屬性即可。

    Kubernetes Secret 的名稱。您必須使用沒有角色的 Google 服務帳戶金鑰做為輸入內容，建立密鑰。
    mart.sslCertPath 版本：1.0.0

    預設值：無

    請提供 sslCertPath/sslKeyPath 或 sslSecret。

    用於將 SSL 憑證載入及編碼至 Secret 的本機檔案系統路徑。
    mart.sslKeyPath 版本：1.0.0

    預設值：無

    請提供 sslCertPath/sslKeyPath 或 sslSecret。

    用於將 SSL 金鑰載入及編碼為 Secret 的本機檔案系統路徑。
    mart.sslSecret 版本：1.2.0

    預設值：無

    請提供 sslCertPath/sslKeyPath 或 sslSecret。

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

    另請參閱：
    mart.targetCPUUtilizationPercentage 版本：1.0.0

    預設值： 75

    Pod 中 MART 程序的目標 CPU 使用率。當 CPU 使用率達到這個欄位的值時，MART 會自動調度資源，最高可達 replicaCountMax。
    mart.terminationGracePeriodSeconds 版本：1.0.0

    預設值： 30

    從要求刪除 Pod 到 Pod 終止的時間間隔 (以秒為單位)。在這段期間，系統會執行所有前置停止勾點，且所有執行中的程序都應正常終止。

    metrics

    定義收集作業指標的服務。您可以運用指標資料監控 Hybrid 服務的健康狀態、設定快訊等。

    詳情請參閱「指標收集總覽」。

    下表說明 metrics 物件的屬性：

    屬性 說明
    metrics.enabled 版本：1.0.0

    預設值： false

    啟用 Apigee 指標。設為 true 即可啟用指標。設為 false 即可停用指標。
    metrics.nodeSelector.key 版本：1.0.0

    預設值：無

    必要

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

    請參閱「新增節點選取器」。
    metrics.nodeSelector.value 版本：1.0.0

    預設值：無

    必要

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

    請參閱「新增節點選取器」。
    metrics.prometheus.args.storage_tsdb_retention 版本：1.0.0

    預設值： 48h

    Prometheus 從本機儲存空間移除舊資料前等待的時間量 (以小時為單位)。
    metrics.prometheus.containerPort 版本：1.0.0

    預設值： 9090

    用來連線至 Prometheus 指標服務的通訊埠。
    metrics.prometheus.image.pullPolicy 版本：1.0.0

    預設值： IfNotPresent

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

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

    詳情請參閱「更新圖片」。
    metrics.prometheus.image.tag 版本：1.0.0

    預設值： "v2.9.2"

    這項服務 Docker 映像檔的版本標籤。
    metrics.prometheus.image.url 版本：1.0.0

    預設值： "google/apigee-prom-prometheus"

    這項服務的 Docker 映像檔位置。
    metrics.prometheus.livenessProbe.failureThreshold 版本：1.0.0

    預設值： 6

    Kubernetes 會先驗證有效性探測失敗的次數，再重新啟動容器。最小值為 1。
    metrics.prometheus.livenessProbe.periodSeconds 版本：1.0.0

    預設值： 5

    以秒為單位，決定執行 liveness 探測的頻率。最小值為 1。
    metrics.prometheus.livenessProbe.timeoutSeconds 版本：1.0.0

    預設值： 3

    健康狀態探測逾時的秒數。最小值為 1。
    metrics.prometheus.readinessProbe.failureThreshold 版本：1.0.0

    預設值： 120

    Kubernetes 會先驗證完備性探測失敗的次數，再將 Pod 標示為「尚未準備就緒」。最小值為 1。
    metrics.prometheus.readinessProbe.periodSeconds 版本：1.0.0

    預設值： 5

    決定執行準備狀態探測的頻率 (以秒為單位)。最小值為 1。
    metrics.prometheus.readinessProbe.timeoutSeconds 版本：1.0.0

    預設值： 3

    健康狀態探測逾時的秒數。最小值為 1。
    prometheus.sslCertPath 版本：1.0.0

    預設值：無

    必要

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

    請參閱：

    prometheus.sslKeyPath 版本：1.0.0

    預設值：無

    必要

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

    請參閱：

    metrics.proxyURL 版本：1.0.0

    預設值：無

    Kubernetes 叢集中指標程序輔助 Proxy 的網址。

    metrics.resources.limits.cpu 版本：1.0.0

    預設值： 250m

    Kubernetes 容器中資源的 CPU 限制 (以毫核為單位)。
    metrics.resources.limits.memory 版本：1.0.0

    預設值： 256Mi

    Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。
    metrics.resources.requests.cpu 版本：1.0.0

    預設值： 250m

    Kubernetes 容器中資源正常運作所需的 CPU，以毫核心為單位。
    metrics.resources.requests.memory 版本：1.0.0

    預設值： 256Mi

    Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。
    metrics.sdSidecar.containerPort 版本：1.0.0

    預設值： 9091

    連線至 StackDriver 指標服務的通訊埠。
    metrics.sdSidecar.image.pullPolicy 版本：1.0.0

    預設值： IfNotPresent

    決定 Kubelet 何時會提取這項服務的 Docker 映像檔。 可能的值包括：

    • IfNotPresent：如果已有新映像檔，請勿提取
    • Always：一律要提取政策，即使政策已存在

      詳情請參閱「 更新圖片」。
    metrics.sdSidecar.image.tag 版本：1.0.0

    預設值： "release-0.4.0"

    這項服務 Docker 映像檔的版本標籤。
    metrics.sdSidecar.image.url 版本：1.0.0

    預設值： "google/apigee-stackdriver-prometheus-sidecar"

    這項服務的 Docker 映像檔位置。
    metrics.serviceAccountPath 版本：1.0.0

    預設值：無

    您必須提供 serviceAccountPath 或 serviceAccountSecretRef 其中之一。

    具有「監控指標寫入者」角色的 Google 服務帳戶金鑰檔案路徑。

    metrics.serviceAccountSecretRef 版本：1.2.0

    預設值：無

    您必須提供 serviceAccountPath 或 serviceAccountSecretRef 其中之一。

    Kubernetes Secret 的名稱。您必須使用具有「Monitoring Metric Writer」角色的 Google 服務帳戶金鑰，建立密鑰。
    metrics.terminationGracePeriodSeconds 版本：1.0.0

    預設值： 300

    要求刪除 Pod 與終止 Pod 之間的時間 (以秒為單位)。在這段期間，系統會執行所有前置停止勾點，且所有執行中的程序都應正常終止。

    nodeSelector

    nodeSelector 物件會定義 Apigee 執行個體的節點。在幕後，當 apigeectl 執行時，會負責將 apigeeRuntime 和 apigeeData 的標籤鍵/值對應至個別的 Istio 和 MART 元件。您可以在 istio:nodeSelector 和 mart:nodeSelector 屬性中，為個別物件覆寫這項設定。

    下表說明 nodeSelector 物件的屬性：

    屬性 說明
    nodeSelector.apigeeData.key 版本：1.0.0

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

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

    請參閱「新增節點選取器」。
    nodeSelector.apigeeData.value 版本：1.0.0

    預設值：「apigee-data」

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

    請參閱「新增節點選取器」。
    nodeSelector.apigeeRuntime.key 版本：1.0.0

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

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

    請參閱「新增節點選取器」。
    nodeSelector.apigeeRuntime.value 版本：1.0.0

    預設值：「apigee-runtime」

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

    請參閱「新增節點選取器」。
    nodeSelector.requiredForScheduling 版本：1.0.0

    預設值：false

    requiredForScheduling 屬性預設為 false。如果將這個值覆寫為 true，表示 Kubernetes 找不到設定的標籤鍵/值節點時，系統不會在 VM 工作節點上排定基礎 Pod。

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

    請參閱「新增節點選取器」。

    runtime

    下表說明 runtime 物件的屬性：

    屬性 說明
    runtime.image.pullPolicy 版本：1.0.0

    預設值： IfNotPresent

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

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

    詳情請參閱「更新圖片」。
    runtime.image.tag 版本：1.0.0

    預設值： 1.2.0

    這項服務 Docker 映像檔的版本標籤。
    runtime.image.url 版本：1.0.0

    預設值： 安裝圖片資源的網址，例如： "google/apigee-runtime"

    這項服務的 Docker 映像檔位置。
    runtime.livenessProbe.failureThreshold 版本：1.0.0

    預設值： 2

    Kubernetes 會先驗證有效性探測失敗的次數，再重新啟動容器。最小值為 1。
    runtime.livenessProbe.initialDelaySeconds 版本：1.0.0

    預設值： 60

    容器啟動後，到啟動存活探測作業之間的時間間隔 (以秒為單位)。
    runtime.livenessProbe.periodSeconds 版本：1.0.0

    預設值： 5

    以秒為單位，決定執行 liveness 探測的頻率。最小值為 1。
    runtime.livenessProbe.timeoutSeconds 版本：1.0.0

    預設值： 1

    健康狀態探測逾時的秒數。最小值為 1。
    runtime.nodeSelector.key 版本：1.0.0

    預設值：無

    選用節點選取器標籤鍵，用於指定 runtime 服務的 Kubernetes 節點。

    請參閱nodeSelector 屬性。
    runtime.nodeSelector.value 版本：1.0.0

    預設值：無

    指定 Kubernetes 節點的節點選取器標籤值，以用於 runtime 服務。

    請參閱「新增節點選取器」。
    runtime.readinessProbe.failureThreshold 版本：1.0.0

    預設值： 2

    Kubernetes 會先驗證完備性探測失敗的次數，再將 Pod 標示為「尚未準備就緒」。最小值為 1。
    runtime.readinessProbe.initialDelaySeconds 版本：1.0.0

    預設值： 60

    容器啟動後，啟動就緒探測作業前的秒數。
    runtime.readinessProbe.periodSeconds 版本：1.0.0

    預設值： 5

    決定執行準備狀態探測的頻率 (以秒為單位)。最小值為 1。
    runtime.readinessProbe.successThreshold 版本：1.0.0

    預設值： 1

    失敗後，至少要連續成功幾次，才算成功。最小值為 1。
    runtime.readinessProbe.timeoutSeconds 版本：1.0.0

    預設值： 1

    健康狀態探測逾時的秒數。最小值為 1。
    runtime.replicaCountMax 版本：1.0.0

    預設值： 4

    自動調度資源功能可用的副本數量上限。
    runtime.replicaCountMin 版本：1.0.0

    預設值： 1

    可供自動調度資源的副本數量下限。
    runtime.resources.requests.cpu 版本：1.0.0

    預設值： 500m

    Kubernetes 容器中資源正常運作所需的 CPU，以毫核心為單位。
    runtime.resources.requests.memory 版本：1.0.0

    預設值： 512Mi (請參閱下方附註)

    Kubernetes 容器中資源正常運作所需的記憶體，單位為 MiB (Mi) 或 GiB (Gi)。
    runtime.service.type 版本：1.0.0

    預設值： ClusterIP

    服務類型。您可以將此項設為 ClusterIP 以外的服務，例如 LoadBalancer。
    runtime.targetCPUUtilizationPercentage 版本：1.0.0

    預設值： 75

    Pod 中執行階段程序的目標 CPU 使用率。這個欄位的值可讓執行階段在 CPU 使用率達到這個值時，自動調度資源至 replicaCountMax。
    runtime.terminationGracePeriodSeconds 版本：1.0.0

    預設值： 180

    從要求刪除 Pod 到 Pod 終止的時間間隔 (以秒為單位)。在這段期間，系統會執行所有前置停止勾點，且所有執行中的程序都應正常終止。

    synchronizer

    確保訊息處理器與最新部署的 API Proxy 套件保持同步。為此，Synchronizer 會輪詢管理層，偵測到新合約時，就會將合約傳送至執行階段層。

    詳情請參閱「同步器」。

    下表說明 synchronizer 物件的屬性：

    屬性 說明
    synchronizer.image.pullPolicy 版本：1.0.0

    預設值： IfNotPresent

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

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

    詳情請參閱「更新圖片」。
    synchronizer.image.tag 版本：1.0.0

    預設值： 1.2.0

    這項服務 Docker 映像檔的版本標籤。
    synchronizer.image.url 版本：1.0.0

    預設值： "google/apigee-synchronizer"

    這項服務的 Docker 映像檔位置。
    synchronizer.livenessProbe.failureThreshold 版本：1.0.0

    預設值： 2

    Kubernetes 會先驗證有效性探測失敗的次數，再重新啟動容器。最小值為 1。
    synchronizer.livenessProbe.initialDelaySeconds 版本：1.0.0

    預設值： 0

    容器啟動後，到啟動存活探測作業之間的時間間隔 (以秒為單位)。
    synchronizer.livenessProbe.periodSeconds 版本：1.0.0

    預設值： 5

    以秒為單位，決定執行 liveness 探測的頻率。最小值為 1。
    synchronizer.livenessProbe.timeoutSeconds 版本：1.0.0

    預設值： 1

    健康狀態探測逾時的秒數。最小值為 1。
    synchronizer.nodeSelector.key 版本：1.0.0

    預設值：無

    必要

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

    請參閱 nodeSelector。
    synchronizer.nodeSelector.value 版本：1.0.0

    預設值：無

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

    請參閱 nodeSelector。
    synchronizer.pollInterval 版本：1.0.0

    預設值： 60

    Synchronizer 在輪詢作業之間等待的時間長度。同步器會輪詢 Apigee 控制平面服務，偵測並提取新的執行階段合約。
    synchronizer.readinessProbe.failureThreshold 版本：1.0.0

    預設值： 2

    Kubernetes 會先驗證完備性探測失敗的次數，再將 Pod 標示為「尚未準備就緒」。最小值為 1。
    synchronizer.readinessProbe.initialDelaySeconds 版本：1.0.0

    預設值： 0

    容器啟動後，啟動就緒探測作業前的秒數。
    synchronizer.readinessProbe.periodSeconds 版本：1.0.0

    預設值： 5

    決定執行準備狀態探測的頻率 (以秒為單位)。最小值為 1。
    synchronizer.readinessProbe.successThreshold 版本：1.0.0

    預設值： 1

    失敗後，至少要連續成功幾次，才算成功。最小值為 1。
    synchronizer.readinessProbe.timeoutSeconds 版本：1.0.0

    預設值： 1

    健康狀態探測逾時的秒數。最小值為 1。
    synchronizer.replicaCount 版本：1.0.0

    預設值： 2

    自動調度資源的備用資源數量。
    synchronizer.replicaCountMax 版本：1.2.0

    預設值： 4

    自動調度資源的副本數量上限。
    synchronizer.replicaCountMin 版本：1.2.0

    預設值： 1

    自動調度資源的副本數量下限。
    synchronizer.resources.requests.cpu 版本：1.0.0

    預設值： 100m

    Kubernetes 容器中資源正常運作所需的 CPU，以毫核心為單位。
    synchronizer.resources.requests.memory 版本：1.0.0

    預設值： 1Gi

    Kubernetes 容器中資源正常運作所需的記憶體，以 GB 為單位。
    synchronizer.serviceAccountPath 版本：1.0.0

    預設值：無

    您必須提供 serviceAccountPath 或 serviceAccountSecretRef 其中之一。

    具有 Apigee Synchronizer Manager 角色的 Google 服務帳戶金鑰檔案路徑。

    synchronizer.serviceAccountSecretRef 版本：1.2.0

    預設值：無

    您必須提供 serviceAccountPath 或 serviceAccountSecretRef 其中之一。

    Kubernetes Secret 的名稱。您必須使用具有 Apigee Synchronizer Manager 角色的 Google 服務帳戶金鑰做為輸入內容，建立密鑰。
    synchronizer.targetCPUUtilizationPercentage 版本：1.0.0

    預設值： 75

    Pod 中 Synchronizer 程序的目標 CPU 使用率。當 CPU 使用率達到這個欄位的值時，同步器就會自動調度資源，最多可調度至 replicaCountMax。
    synchronizer.terminationGracePeriodSeconds 版本：1.0.0

    預設值： 30

    要求刪除 Pod 與終止 Pod 之間的時間 (以秒為單位)。在這段期間，系統會執行所有前置停止勾點，且所有執行中的程序都應正常終止。

    udca

    (通用資料收集代理程式) 定義在執行階段平面資料收集 Pod 中執行的服務。這項服務會擷取分析和部署狀態資料，並傳送至 Unified Analytics Platform (UAP)。

    詳情請參閱「收集 Analytics 和部署狀態資料」。

    下表說明 udca 物件的屬性：

    屬性 說明
    udca.fluentd.image.pullPolicy 版本：1.0.0

    預設值： IfNotPresent

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

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

    詳情請參閱「更新圖片」。
    udca.fluentd.image.tag 版本：1.0.0

    預設值： 1.2.0

    這項服務 Docker 映像檔的版本標籤。
    udca.fluentd.image.url 版本：1.0.0

    預設值： "google/apigee-stackdriver-logging-agent"

    這項服務的 Docker 映像檔位置。
    udca.fluentd.resource.limits.memory 版本：1.0.0

    預設值： 500Mi

    Kubernetes 容器中資源的記憶體限制，以 MiB 為單位。
    udca.fluentd.resource.requests.cpu 版本：1.0.0

    預設值： 500m

    Kubernetes 容器中資源正常運作所需的 CPU，以毫核心為單位。
    udca.fluentd.resource.requests.memory 版本：1.0.0

    預設值： 250Mi

    Kubernetes 容器中資源正常運作所需的記憶體，以 MiB 為單位。
    udca.image.pullPolicy 版本：1.0.0

    預設值：IfNotPresent

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

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

    詳情請參閱「更新圖片」。
    udca.image.tag 版本：1.0.0

    預設值： "1.2.0"

    這項服務 Docker 映像檔的版本標籤。
    udca.image.url 版本：1.0.0

    預設值： "google/apigee-udca"

    這項服務的 Docker 映像檔位置。
    udca.jvmXms 版本：1.0.0

    預設值： 256m

    資料收集 Pod JVM 的起始記憶體量。
    udca.jvmXmx 版本：1.0.0

    預設值： 256m

    資料收集 Pod JVM 的記憶體分配上限。
    udca.livenessProbe.failureThreshold 版本：1.0.0

    預設值： 2

    Kubernetes 會先驗證有效性探測失敗的次數，再重新啟動容器。最小值為 1。
    udca.livenessProbe.initialDelaySeconds 版本：1.0.0

    預設值： 0

    容器啟動後，到啟動存活探測作業之間的時間間隔 (以秒為單位)。
    udca.livenessProbe.periodSeconds 版本：1.0.0

    預設值： 5

    以秒為單位，決定執行 liveness 探測的頻率。最小值為 1。
    udca.livenessProbe.timeoutSeconds 版本：1.0.0

    預設值： 1

    健康狀態探測逾時的秒數。最小值為 1。
    udca.nodeSelector.key 版本：1.0.0

    預設值：無

    必要

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

    請參閱「新增節點選取器」。
    udca.nodeSelector.value 版本：1.0.0

    預設值：無

    必要

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

    請參閱「新增節點選取器」。
    udca.pollingIntervalInSec 版本：1.0.0

    預設值： 1

    UDCA 在輪詢作業之間等待的時間長度 (以秒為單位)。UDCA 會輪詢資料收集 Pod 檔案系統中的資料目錄，偵測要上傳的新檔案。
    udca.replicaCountMax 版本：1.0.0

    預設值： 4

    混合式可為 UDCA 部署項目自動新增的 Pod 數量上限。由於 UDCA 是以 ReplicaSet 形式實作，因此 Pod 是副本。
    udca.replicaCountMin 版本：1.0.0

    預設值： 1

    UDCA 部署項目的 Pod 數量下限。由於 UDCA 是以 ReplicaSet 形式實作，因此 Pod 是副本。

    如果 CPU 使用率超過 udca.targetCPUUtilizationPercentage，混合式系統會逐步增加 Pod 數量，最多可達 udca.replicaCountMax。
    udca.resource.requests.cpu 版本：1.0.0

    預設值： 250m

    Kubernetes 容器中資源正常運作所需的 CPU，以毫核心為單位。
    udca.revision 版本：1

    預設值： "v1"

    在標籤中填入的靜態值，可啟用 Canary 部署。
    udca.serviceAccountPath 版本：1.0.0

    預設值：無

    您必須提供 serviceAccountPath 或 serviceAccountSecretRef 其中之一。

    具有 Apigee Analytics Agent 角色的 Google 服務帳戶金鑰檔案路徑。

    udca.serviceAccountSecretRef 版本：1.2.0

    預設值：無

    您必須提供 serviceAccountPath 或 serviceAccountSecretRef 其中之一。

    Kubernetes Secret 的名稱。您必須使用具有「Apigee Analytics 代理程式」角色的 Google 服務帳戶金鑰做為輸入內容，建立密鑰。
    udca.targetCPUUtilizationPercentage 版本：1.0.0

    預設值： 75

    Pod 數量的資源調度 CPU 使用率門檻，以可用 CPU 資源總數的百分比表示。混合模式會使用資料收集 Pod (fluentd 和 UDCA) 中所有容器的合併使用率，計算目前的使用率。

    如果 CPU 使用率超過這個值，混合式自動調度資源功能就會逐步增加 ReplicaSet 中的 Pod 數量，最多可達 udca.replicaCountMax。
    udca.terminationGracePeriodSeconds 版本：1.0.0

    預設值： 600

    要求刪除 Pod 與終止 Pod 之間的時間 (以秒為單位)。在這段期間，系統會執行所有前置停止勾點，且所有執行中的程序都應正常終止。

    virtualhosts

    virtualhosts 屬性是必要的設定屬性。 Apigee Hybrid 可透過虛擬主機處理多個網域名稱的 API 要求，並將 Proxy 基礎路徑路由至特定環境。

    詳情請參閱「設定虛擬主機」。

    下表說明 virtualhosts 物件的屬性：

    屬性 說明
    virtualhosts[].additionalGateways 版本：1.2.0

    預設值：無

    要將流量轉送至的 Istio 閘道清單。
    virtualhosts[].name 版本：1.2.0

    預設值：無

    必要

    虛擬主機的名稱。
    virtualhosts[].hostAliases[] 版本：1.2.0

    預設值：無

    必要

    伺服器的一或多個 DNS 名稱。例如：foo-test.mydomain.com。

    如果您在虛擬主機中使用多個主機別名，每個主機別名都不得重複。 例如 foo-test.mydomain.com 和 foo-prod.mydomain.com。

    如果您建立多個虛擬主機定義，每個定義都必須有專屬主機別名。 換句話說，兩個虛擬主機定義不得包含相同的主機別名網域名稱。
    virtualhosts[].routingRules[].connectTimeout 版本：1.2.0

    預設值： 300。

    一組已定義路徑的連線逾時時間 (以秒為單位)。

    connectTimeout 為選填欄位。
    virtualhosts[].routingRules[].env 版本：1.2.0

    預設值：無。

    必要

    API 呼叫將會轉送至的環境。您必須至少指定一個環境。

    如果加入 paths 項目，env 項目必須位於對應至這個環境的路徑下方。

    另請參閱「設定虛擬主機」。
    virtualhosts[].routingRules[].paths[] 版本：1.2.0

    預設值：預設路徑為 /。

    支援前置字元基本路徑轉送。轉送規則會將 API 呼叫導向特定路徑，以解析為 env 指定的環境。paths[] 為選填欄位。預設路徑為「/」。

    轉送規則設定遵循下列模式：

    org: hybrid
virtualhosts:
- name: default
  routingRules:
    - paths:
        - path-1
        - path-2
        - path-n
      env: test
    - paths:
        - /v1/customers
      env: prod

    另請參閱「設定虛擬主機」。
    virtualhosts[].selector 版本：1.2.0

    預設值： app: istio-ingressgateway

    必要

    鍵/值選擇器值組，用於指向不同的 Ingress 選擇器。
    virtualhosts[].sslCertPath 版本：1.2.0

    預設值：無

    請提供 sslCertPath/sslKeyPath 或 sslSecret。

    系統中傳輸層安全標準 (TLS) 憑證檔案的路徑。
    virtualhosts[].sslKeyPath 版本：1.2.0

    預設值：無

    請提供 sslCertPath/sslKeyPath 或 sslSecret。

    系統中 TLS 私密金鑰檔案的路徑。
    virtualhosts[].sslSecret 版本：1.2.0

    預設值：無

    請提供 sslCertPath/sslKeyPath 或 sslSecret。

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

    另請參閱：