設定屬性參考資料

本節列出可用來自訂 Apigee 混合部署作業的執行階段平面設定屬性。

頂層屬性

下表說明 overrides.yaml 檔案中的頂層屬性。以下是不會屬於其他物件的屬性,並在機構或環境層級套用:

屬性 說明
contractProvider 版本:1.0.0

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

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

gcpProjectID Deprecated: 如果是 1.2.0 以上版本,請改用 gcp.projectID

版本:1.0.0

預設值: none

必要

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

gcpRegion Deprecated: 如果是 1.2.0 以上版本,請改用 gcp.region

版本:1.0.0

預設值: us-central1

必要

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

imagePullSecrets.name 版本:1.0.0

預設值:

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

k8sClusterName Deprecated: 如果是 1.2.0 以上版本,請改用 k8sCluster.namek8sCluster.region

版本:1.0.0

預設值:

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

kmsEncryptionKey 版本:1.0.0

預設值: defaults.org.kmsEncryptionKey

選填。請只使用 kmsEncryptionKeykmsEncryptionPathkmsEncryptionSecret 其中一個。

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

kmsEncryptionPath 版本:1.2.0

預設值:

選填。請只使用 kmsEncryptionKeykmsEncryptionPathkmsEncryptionSecret 其中一個。

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

kmsEncryptionSecret.key 版本:1.2.0

預設值:

選填。請只使用 kmsEncryptionKeykmsEncryptionPathkmsEncryptionSecret 其中一個。

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

kmsEncryptionSecret.name 版本:1.2.0

預設值:

選填。請只使用 kmsEncryptionKeykmsEncryptionPathkmsEncryptionSecret 其中一個。

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

kvmEncryptionKey 版本:1.0.0

預設值: defaults.org.kmsEncryptionKey

選填。請只使用 kvmEncryptionKeykvmEncryptionPathkvmEncryptionSecret 其中一個。

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

kvmEncryptionPath 版本:1.2.0

預設值:

選填。請只使用 kvmEncryptionKeykvmEncryptionPathkvmEncryptionSecret 其中一個。

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

kvmEncryptionSecret.key 版本:1.2.0

預設值:

選填。請只使用 kvmEncryptionKeykvmEncryptionPathkvmEncryptionSecret 其中一個。

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

kvmEncryptionSecret.name 版本:1.2.0

預設值:

選填。請只使用 kvmEncryptionKeykvmEncryptionPathkvmEncryptionSecret 其中一個。

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

namespace 版本:1.0.0

預設值: apigee

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

org

版本:1.0.0

預設值:

必要

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

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 檢查項目就是對應至機構的專案 ID。對於指標和記錄器,系統會根據「gcpProjectID」overrides.yaml 設定檢查專案。

另請參閱 gcpProjectID

ao

Apigee 操作員 (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 值區。

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 密鑰的名稱。您必須使用 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 部署的 truefalse 非 Anthos 部署作業。

將此值設為 true,即可針對以 Anthos 為基礎的部署作業。

如果 cassandra.hostNetworktrue,請確認 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

預設值:

可選的 ode 選擇器標籤值,用於指定 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 值區。

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 密鑰的名稱。您必須使用 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,則為必要屬性

以位元組為單位指定所需的磁碟大小。

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 Injector 是 cert-manager 程序,負責將 CA 套件插入 cert-manager Webhook 程序。請參閱 cert-manager 說明文件中的「CA Injector」。

下表說明 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 來處理 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 使用率。這個欄位的值可讓 Apigee connect 在 CPU 使用率達到這個值 (上限為 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 其中一個值

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

envs[].cacheEncryptionSecret.name 版本:1.2.0

預設值:

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

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

envs[].hostAlias 版本:1.0.0

預設值:

已淘汰:請改用 hostAliases[]

envs[].hostAliases[] 版本:1.2.0

預設值:

指向環境的主機別名。每個主機別名都必須是完整的網域名稱。

envs[].httpProxy.host 版本:1.2.0

預設值:

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

依序列出 httpProxy 屬性 schemehostport。例如:

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

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

envs[].kmsEncryptionSecret.name 版本:1.2.0

預設值:

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

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

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

預設值:

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

envs[].serviceAccountSecretRefs.synchronizer 版本:1.2.0

預設值:

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

envs[].serviceAccountSecretRefs.udca 版本:1.2.0

預設值:

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

envs[].sslCertPath 版本:1.2.0

預設值:

必須提供 sslCertPath/sslKeyPathsslSecret

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

envs[].sslKeyPath 版本:1.2.0

預設值:

必須提供 sslCertPath/sslKeyPathsslSecret

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

envs[].sslSecret 版本:1.2.0

預設值:

必須提供 sslCertPath/sslKeyPathsslSecret

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

另請參閱:

gcp

指出 apigee-loggerapigee-metrics 推送資料的 GCP 專案 ID 和區域。

下表說明 gcp 物件的屬性:

屬性 說明
gcp.region 版本:1.2.0

預設值:

必要

指出 apigee-loggerapigee-metrics 推送資料的 GCP 區域

gcp.projectID 版本:1.2.0

預設值:

必要

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

gcp.projectIDRuntime 版本:1.2.0

預設值:

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

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

httpProxy

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

另請參閱:MARTSynchronizerUDCA

下表說明 httpProxy 物件的屬性:

屬性 說明
httpProxy.host 版本:1.1.1

預設值:

HTTP Proxy 的主機名稱。

httpProxy.port 版本:1.1.1

預設值:

HTTP Proxy 的通訊埠。

httpProxy.scheme 版本:1.1.1

預設值: HTTPS

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

ingress

Ingress 是 Istio Ingress Gateway 的例項化。ingress 用於指定應向叢集外部公開的服務。Hybrid 執行階段安裝程序會為這兩個執行階段元件建立 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

預設值:如果未指定 minTLSProtocolVersionmaxTLSProtocolVersion,輸入會使用 Envoy 代理程式文件中「常見的 TLS 設定」一節所述的預設 TLS_AUTO

可讓您設定入口網站的最低 TLS 版本。可能的值為 1.0、1.1、1.2 和 1.3。

ingress.maxTLSProtocolVersion 版本:1.2.0

預設值:如果未指定 minTLSProtocolVersionmaxTLSProtocolVersion,輸入會使用 Envoy 代理程式文件中「常見的 TLS 設定」一節所述的預設 TLS_AUTO

可讓您為 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 說明文件中的「Ingress Gateways」
  • 新增閘道,瞭解如何在 GCP 說明文件中新增 Istio 輸入閘道。
istio.ingressgateway.replicaCountMin 版本:1.0.0

預設值:1

必要

所需的 Istio 入口網頁備用資源數量下限。

請參閱:

  • ingress 物件
  • Istio 說明文件中的「Ingress Gateways」
  • 新增閘道,瞭解如何在 GCP 說明文件中新增 Istio 輸入閘道。
istio.ingressgateway.resources.requests.cpu 版本:1.0.0

預設值:100 公尺

必要

分配給入口控制器的 CPU 資源,閘道需要這些資源才能以最佳效能運作。

請參閱:

istio.ingressgateway.resources.requests.memory 版本:1.0.0

預設值:128 Mi

分配給入口控制器的記憶體資源,用於讓網關以最佳效能運作。

  • 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

    預設值:

    用於指定 istio 服務的 Kubernetes 節點的選用節點選取器標籤鍵。如果您未為 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 前導副本數量上限。

    請參閱 Istio 說明文件中的「 Pilot:核心流量管理

    istio.pilot.replicaCountMin 版本:1.0.0

    預設值:1

    必要

    叢集內的 pilot 核心流量管理,可與 envoy 補充 Proxy 通訊。replicaCountMax 是 Istio 前置備用資源所需的備用資源數量上限。

    請參閱 Istio 說明文件中的「 Pilot:核心流量管理

    istio.pilot.resources.requests.cpu 版本:1.0.0

    預設值:500 公尺

    必要

    分配給前測程序的 CPU 資源,用於讓網關以最佳效能運作。

    請參閱:

    istio.pilot.resources.requests.memory 版本:1.0.0

    預設值:2048 Mi

    分配給前測程序的記憶體資源,用於閘道器的最佳運作。

    請參閱:

    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

    指出安裝混合型執行階段的 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 混合服務都會輸出這項資訊。

    詳情請參閱「記錄」。

    下表說明 logger 物件的屬性:

    屬性 說明
    logger.enabled 版本:1.0.0

    預設值: true

    啟用或停用叢集中的記錄功能。將非 GKE 設為 true,將 Anthos 或 GKE 設為 false

    logger.fluentd.buffer_chunk_limit 版本:1.0.0

    預設值: 512k

    緩衝區區塊的大小上限 (以千位元為單位)。超過上限的區塊會自動刷新至輸出佇列。

    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 其中一個。

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

    logger.serviceAccountSecretRef 版本:1.2.0

    預設值:

    必須提供 serviceAccountPath 或 serviceAccountSecretRef 其中一個。

    Kubernetes 密鑰的名稱。您必須使用 Google 服務帳戶金鑰建立密鑰,並將記錄寫入器角色做為輸入內容。

    logger.terminationGracePeriodSeconds 版本:1.0.0

    預設值: 30

    提出 Pod 刪除要求與 Pod 遭到終止之間的時間,以秒為單位。在這段期間內,系統會執行所有預停止掛鉤,並且所有執行中的程序都應能正常終止。

    mart

    定義 MART (執行階段資料管理 API) 服務,該服務可做為公開 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

    預設值:

    必須使用 serviceAccountPathserviceAccountSecretRef 其中之一。

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

    mart.serviceAccountSecretRef 版本:1.2.0

    預設值:

    必須使用 serviceAccountPathserviceAccountSecretRef 其中之一。

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

    mart.sslCertPath 版本:1.0.0

    預設值:

    必須提供 sslCertPath/sslKeyPathsslSecret

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

    mart.sslKeyPath 版本:1.0.0

    預設值:

    必須提供 sslCertPath/sslKeyPathsslSecret

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

    mart.sslSecret 版本:1.2.0

    預設值:

    必須提供 sslCertPath/sslKeyPathsslSecret

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

    另請參閱:

    mart.targetCPUUtilizationPercentage 版本:1.0.0

    預設值: 75

    Pod 上 MART 程序的目標 CPU 使用率。這個欄位的值可讓 MART 在 CPU 使用率達到這個值 (最高為 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 其中一個。

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

    metrics.serviceAccountSecretRef 版本:1.2.0

    預設值:

    必須提供 serviceAccountPath 或 serviceAccountSecretRef 其中一個。

    Kubernetes 密鑰的名稱。您必須使用 Google 服務帳戶金鑰建立密碼,並將監控指標寫入器角色做為輸入內容。

    metrics.terminationGracePeriodSeconds 版本:1.0.0

    預設值: 300

    提出 Pod 刪除要求與 Pod 遭到終止之間的時間,以秒為單位。在這段期間內,系統會執行所有預停止掛鉤,並且所有執行中的程序都應能正常終止。

    nodeSelector

    nodeSelector 物件會定義 Apigee 執行個體的節點。在 apigeectl 執行時,會在幕後將 apigeeRuntime 和 apigeeData 的標籤鍵/值對應至個別 Istio 和 MART 元件。您可以針對 istio:nodeSelectormart: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 找不到標籤鍵/值已設定的節點,則底層 Pod 不會在 VM 工作節點上排程。

    在正式版中,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

    預設值:

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

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

    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 物件的屬性:

    屬性 說明
    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

    預設值:

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

    請參閱 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 密鑰的名稱。您必須使用 Google 服務帳戶金鑰建立密鑰,並將 Apigee Synchronizer Manager 角色做為輸入內容。

    synchronizer.targetCPUUtilizationPercentage 版本:1.0.0

    預設值: 75

    Pod 上 Synchronizer 程序的目標 CPU 使用率。這個欄位的值可讓 Synchronizer 在 CPU 使用率達到這個值時自動調度資源,上限為 replicaCountMax

    synchronizer.terminationGracePeriodSeconds 版本:1.0.0

    預設值: 30

    提出 Pod 刪除要求與 Pod 遭到終止之間的時間,以秒為單位。在這段期間內,系統會執行所有預停止掛鉤,並且所有執行中的程序都應能正常終止。

    udca

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

    詳情請參閱「數據分析和部署狀態資料收集」。

    下表說明 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

    hybrid 可為 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 密鑰的名稱。您必須使用 Google 服務帳戶金鑰建立密鑰,並將 Apigee Analytics Agent 角色做為輸入內容。

    udca.targetCPUUtilizationPercentage 版本:1.0.0

    預設值: 75

    在 ReplicaSet 中,用於調整 pod 數量的 CPU 使用率門檻,以可用 CPU 資源總數的百分比表示。Hybrid 會使用資料收集 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.comfoo-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

    必要

    鍵/值選擇器-值組合,用於指向不同的入口選擇器。

    virtualhosts[].sslCertPath 版本:1.2.0

    預設值:

    必須提供 sslCertPath/sslKeyPathsslSecret

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

    virtualhosts[].sslKeyPath 版本:1.2.0

    預設值:

    必須提供 sslCertPath/sslKeyPathsslSecret

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

    virtualhosts[].sslSecret 版本:1.2.0

    預設值:

    必須提供 sslCertPath/sslKeyPathsslSecret

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

    另請參閱: