設定屬性參考資料

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

頂層屬性

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

屬性 說明
contractProvider 版本:1.0.0

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

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

gcpProjectID 版本:1.0.0

預設值: none

必要

您的 Google Cloud 專案 ID。與 k8sClusterNamegcpRegion 搭配使用,用於識別專案,並決定 apigee-loggerapigee-metrics 將資料推送至何處。

gcpRegion 版本:1.0.0

預設值: us-central1

必要

您 Kubernetes 叢集的鄰近 GCP 區域或區域。與 gcpProjectIDk8sClusterName 搭配使用,用於識別專案,並決定 apigee-loggerapigee-metrics 將資料推送至何處。

imagePullSecrets.name 版本:1.0.0

預設值:

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

k8sClusterName

類型:

版本:1.0.0

預設值:

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

namespace 版本:1.0.0

預設值: apigee

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

org 必填

版本:1.0.0

預設值:

必要

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

revision 版本:1.0.0

預設值: 1.0.0

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

adah

Apigee Deployment Admissionhook (ADAH) 負責驗證使用者為 apigee-deployment-controller 提供的設定。這個控制器會在 Kubernetes 叢集中執行,負責驗證 Apigee 部署控制器傳入的建立/更新/刪除要求。另請參閱:

下表說明 Apigee 部署控制器 adah 物件的屬性:

屬性 說明
adah.image.pullPolicy 版本:1.0.0

預設值: IfNotPresent

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

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

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

adah.image.tag 版本:1.0.0

預設值: 1.0.0

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

adah.image.url 版本:1.0.0

預設值: "us.gcr.io/google.com/edge-ci/release/eda/apigee-deployment-admissionhook/master/admissionhook"

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

adc

Apigee Deployment Controller (ADC) 是管理 Kubernetes 叢集中 Apigee 部署作業的程序。這是 Kubernetes 自訂控制器,可建立及更新部署及維護 ApigeeDeployment (AD) 所需的低階 Kubernetes 和 Istio 資源。

另請參閱 adah (Apigee 部署作業許可鉤子)

下表說明 apigee-deployment-controller adc 物件的屬性:

屬性 說明
adc.image.pullPolicy 版本:1.0.0

預設值: IfNotPresent

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

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

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

adc.image.tag 版本:1.0.0

預設值: 1.0.0

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

adc.image.url 版本:1.0.0

預設值: "us.gcr.io/google.com/edge-ci/release/eda/apigee-deployment-controller/master/controller"

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

adc.resources.limits.cpu 版本:1.0.0

預設值: 250m

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

adc.resources.limits.memory 版本:1.0.0

預設值: 256Mi

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

adc.resources.requests.cpu 版本:1.0.0

預設值: 250m

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

adc.resources.requests.memory 版本:1.0.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.0.0

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

authz.image.url 版本:1.0.0

預設值: "us.gcr.io/google.com/edge-ci/integration/featureplatform/apigee-authn-authz/master"

這項服務的 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

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

authz.serviceAccountPath 版本:1.0.0

預設值:

必要

具有「Apigee Read Only Admin」角色的 Google 服務帳戶金鑰檔案路徑。

busyBoxInit

下表說明 busyBoxInit 物件的屬性:

屬性 說明
busyBoxInit.image.pullPolicy 版本:1.0.0

預設值: IfNotPresent

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

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

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

busyBoxInit.image.tag 版本:1.0.0

預設值: "1.0.0"

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

busyBoxInit.image.url 版本: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.0.0

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

cassandra.auth.image.url 版本:1.0.0

預設值: "google/apigee-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.0.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

預設值:

如果已啟用備份功能,則為必要欄位。

具有「Apigee Read Only Admin」角色的 Google 服務帳戶金鑰檔案路徑。

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.externalSeedHost 版本:1.0.0

預設值:

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

cassandra.heapNewSize 版本:1.0.0

預設值: 100M

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

cassandra.hostNetwork 版本:1.1.1

預設值: true

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

cassandra.image.pullPolicy 版本:1.0.0

預設值: IfNotPresent

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

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

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

cassandra.image.tag 版本:1.0.0

預設值: 1.0.0

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

cassandra.image.url 版本:1.0.0

預設值: "google/apigee-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

預設值: 3

Cassandra 是複製資料庫。系統會將資料配置為在每個區域或資料中心中至少有 3 個副本。這項屬性會指定用於 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.0.0

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

cassandra.restore.image.url 版本:1.0.0

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

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

cassandra.restore.serviceAccountPath 版本:1.0.0

預設值:

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

具有「Apigee Read Only Admin」角色的 Google 服務帳戶金鑰檔案路徑。

cassandra.restore.snapshotTimestamp 版本:1.0.0

預設值:

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

應還原的備份時間戳記。

cassandra.storage.capacity 版本:1.0.0

預設值: 50Gi

如果指定 storage.storageClass,則為必要屬性

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

cassandra.storage.storageClass 版本:1.0.0

預設值:

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

cassandra.terminationGracePeriodSeconds 版本:1.0.0

預設值: 300

提出 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[] 設定基本路徑轉送,即可設定及管理 Apigee Hybrid 將 API Proxy 呼叫轉送至正確環境的方式。

如需詳細資訊,請參閱:

下表說明 envs 物件的屬性:

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

預設值:

必要

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

envs[].hostAlias 版本:1.0.0

預設值:

必要

伺服器的 DNS 名稱。例如,foo-test.mydomain.com。如果沒有 DNS 名稱,您可以使用萬用字元 ('*')。如果使用萬用字元,您可以使用 istio-ingressgateway 的外部 IP,您可以在完成安裝後呼叫 kubectl get services -n namespace 取得該 IP。

如果您有多個環境,則必須為每個環境使用專屬的主機別名名稱。例如 foo-test.mydomain.comfoo-prod.mydomain.com

envs[].kmsEncryptionKey 版本:1.0.0

預設值:

必要

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

envs[].name 版本:1.0.0

預設值:

必要

要同步的 Apigee 環境名稱。

envs[].pollInterval 版本:1.0.0

預設值:

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

envs[].paths.uri.prefixes 版本:1.0.0

預設值:

支援前置碼基本路徑轉送的屬性。請按照以下模式提供這些路徑:

      org: hybrid
      envs:
      - name: test
        paths:
          uri:
            prefixes:
            - /foo
            - /bar
envs[].port 版本:1.0.0

預設值:

HTTPS 流量的 TCP 通訊埠編號。

envs[].serviceAccountPaths.synchronizer 版本:GA

預設值:

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

envs[].serviceAccountPaths.udca 版本:GA

預設值:

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

envs[].sslCertPath 版本:1.0.0

預設值:

必要

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

envs[].sslKeyPath 版本:1.0.0

預設值:

必要

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

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 的例項化,Kubernetes Ingress 資源用於指定應在叢集外部公開的服務。它定義了容器化應用程式,可將從執行階段平面外部轉送的流量,轉送至執行階段平面內的服務。Apigee 安裝作業會建立兩個 Istio Ingress 物件,用於:

  1. 執行階段
  2. MART

另請參閱:

下表說明 ingress 物件的屬性:

屬性 說明
ingress.enableAccesslog 版本:1.0.0

預設值: false

啟用或停用 Ingress 存取記錄。預設為停用。

ingress.envoyHeaders.headers 版本:1.0.0

預設值:

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.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.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.nodeSelector.key 版本:1.0.0

    預設值:

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

    istio.nodeSelector.value 版本:1.0.0

    預設值:

    指定 istio 服務的 Kubernetes 節點的選用節點選取器標籤值。另請參閱 nodeSelector 物件。

    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

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

    請參閱:

    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.resource.limits.memory 版本:1.0.0

    預設值: 500Mi

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

    logger.resource.limits.cpu 版本:1.0.0

    預設值: 200m

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

    logger.resource.requests.cpu 版本:1.0.0

    預設值: 100m

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

    logger.resource.requests.memory 版本:1.0.0

    預設值: 250Mi

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

    logger.serviceAccountPath 版本:1.0.0

    預設值:

    必要

    具有「Apigee Read Only Admin」角色的 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.0.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

    預設值:

    必要

    具有「Apigee Read Only Admin」角色的 Google 服務帳戶金鑰檔案路徑。

    mart.sslCertPath 版本:1.0.0

    預設值:

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

    mart.sslKeyPath 版本:1.0.0

    預設值:

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

    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。

    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

    預設值:

    必要

    具有「Apigee Read Only Admin」角色的 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.0.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

    預設值: 1Gi

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

    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.0.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.resources.requests.cpu 版本:1.0.0

    預設值: 100m

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

    synchronizer.resources.requests.memory 版本:1.0.0

    預設值: 1Gi

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

    synchronizer.serviceAccountPath 版本:1.0.0

    預設值:

    必要

    具有「Apigee Read Only Admin」角色的 Google 服務帳戶金鑰檔案路徑。

    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.0.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.0.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 檔案系統中的資料目錄,以偵測要上傳的新檔案。

    prometheus.sslCertPath 版本:1.0.0

    預設值:

    必要

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

    請參閱:

    prometheus.sslKeyPath 版本:1.0.0

    預設值:

    必要

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

    請參閱:

    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.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 遭到終止之間的時間,以秒為單位。在這段期間內,系統會執行所有預停止掛鉤,並且所有執行中的程序都應能正常終止。