本部分列出了可用于自定义 Apigee 混合部署的运行时平面的所有配置属性。
顶层属性
下表描述了 overrides.yaml
文件中的顶层属性。以下属性不属于其他对象,并应用于组织或环境级别:
属性 | 说明 |
---|---|
contractProvider |
版本:1.0.0 默认值:https://apigee.googleapis.com 定义安装中所有 API 的 API 路径。 |
gcpProjectID |
版本:1.0.0 默认值:none 必需 您的 Google Cloud 项目的 ID。与 |
gcpRegion |
版本:1.0.0 默认值: 必需 您的 Kubernetes 集群的秘密 GCP 地区或区域。与 |
imagePullSecrets.name |
版本:1.0.0 默认值:none 配置为 docker-registry 类型的 Kubernetes 秘密名称;用于从私有代码库中提取映像。 |
k8sClusterName |
类型: 版本:1.0.0 默认值:none 您的混合项目正在运行的 Kubernetes (K8S) 专业集群名称。与 |
namespace |
版本:1.0.0 默认值: 将安装 Apigee 组件的 Kubernetes 集群的命名空间。 |
org |
必需
版本:1.0.0 默认值:none 必需 混合启用组织,由 Apigee 在混合安装期间为您预配。组织是 Apigee 中的顶层容器。它包含您的所有 API 代理及相关资源。如果值为空,则必须在创建后将其更新为组织名称。 |
revision |
版本:1.0.0 默认值: Apigee Hybrid 支持滚动 Kubernetes 更新,让部署更新可以通过用新的逐步更新 Pod 实例来实现零停机时间。 在更新可能导致底层 Kubernetes PodTemplateSpec 更改的特定 YAML 覆盖时,还必须在客户的 override.yaml 中更改 更改并应用
更改以下对象的属性时,需要更新 如需了解详情,请参阅滚动更新。 |
validateServiceAccounts |
版本:1.0.0 默认值:true 对服务账号权限启用严格验证。这使用 Cloud Resource Manager API 方法“testIamPermissions”来验证所提供的服务账号是否具备所需的权限。对于 Apigee 组织服务账号,项目 ID 检查就是映射到组织的。对于 Metrics 和 Logger,所检查的项目基于“gcpProjectID”override.yaml 配置。
另请参阅 |
adah
Apigee Deployment Admissionhook (ADAH) 负责验证用户为 apigee-deployment-controller 提供的配置。它在 Kubernetes 集群中运行,并负责验证来自 Apigee-deployment Controller的创建/更新/删除请求。另请参阅:
下表介绍了 Apigee Deployment Controller adah
对象的属性:
属性 | 说明 |
---|---|
adah.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
adah.image.tag |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
adah.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
adc
Apigee Deployment Controller (ADC) 用于管理 Kubernetes 集群中的 Apigee 部署。它是一个 Kubernetes 自定义控制器,可创建和更新用于部署和维护 ApigeeDeployment (AD) 的低级 Kubernetes 和 Istio 资源。
另请参阅 adah (Apigee Deployment Admissionhook)
。下表介绍了 apigee-deployment-controller adc
对象的属性:
属性 | 说明 |
---|---|
adc.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
adc.image.tag |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
adc.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
adc.resources.limits.cpu |
版本:1.0.0 默认值: Kubernetes 容器中资源的 CPU 限制,以毫米为单位。
|
adc.resources.limits.memory |
版本:1.0.0 默认值: Kubernetes 容器中资源的内存限制,以字节为单位。
|
adc.resources.requests.cpu |
版本:1.0.0 默认值: Kubernetes 容器中资源正常运行所需的 CPU,以毫秒为单位。 |
adc.resources.requests.memory |
版本:1.0.0 默认值: 在 Kubernetes 容器中资源正常运行所需的内存,以兆比字节为单位。 |
authz
下表介绍了 authz
对象的属性:
属性 | 说明 |
---|---|
authz.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
authz.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
authz.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
authz.livenessProbe.failureThreshold |
版本:1.0.0 默认值: Kubernetes 将验证重启容器前,活跃探测失败的次数。最小值为 1。 |
authz.livenessProbe.initialDelaySeconds |
版本:1.0.0 默认值: 活跃探测启动前,容易开始后经过的秒数。 |
authz.livenessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行活跃探测的频率,以秒为单位。最小值为 1。 |
authz.livenessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
authz.readinessProbe.failureThreshold |
版本:Beta2 默认值: Kubernetes 将验证将 Pod 标记为“未就绪”前,就绪探测失败的次数。最小值为 1。 |
authz.readinessProbe.initialDelaySeconds |
版本:1.0.0 默认值: 就绪探测启动前,容易开始后经过的秒数。 |
authz.readinessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行就绪探测的频率,以秒为单位。最小值为 1。 |
authz.readinessProbe.successThreshold |
版本:1.0.0 默认值: 在失败后,被认为成功就绪探测需要的最小持续成功次数。最小值为 1。 |
authz.readinessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
authz.resources.requests.cpu |
版本:1.0.0 默认值: 为身份验证请求分配的 CPU 资源数量。 |
authz.resources.requests.memory |
版本:1.0.0 默认值: 为身份验证请求分配的内存资源占用的内存。 |
authz.serviceAccountPath |
版本:1.0.0 默认值:none 必需 具有“Apigee Read Admin”角色的 Google 服务账号密钥文件的路径。 |
busyBoxInit
下表介绍了 busyBoxInit
对象的属性:
属性 | 说明 |
---|---|
busyBoxInit.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
busyBoxInit.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
busyBoxInit.image.url |
版本:1.0.0 默认值: 此服务的 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 默认值: 必需 启用身份验证时创建的默认 Cassandra 用户密码。配置 Cassandra 身份验证时,必须重置此密码。请参阅为 Cassandra 配置 TLS。 |
cassandra.auth.dml.password |
版本:1.0.0 默认值:“iloveapis123” 必需 Cassandra 数据操纵语言 (DML) 用户的密码。DML 用户供客户端通信读取和向 Cassandra 写入数据。 |
cassandra.auth.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
cassandra.auth.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
cassandra.auth.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
cassandra.backup.cloudProvider |
版本:1.0.0 默认值: 如果备份已启用,则是必需的。 用于备份存储的云提供商。 |
cassandra.backup.dbStorageBucket |
版本:1.0.0 默认值:none 如果备份已启用,则是必需的。 备份数据的 Cloud Storage 存储桶。 |
cassandra.backup.enabled |
版本:1.0.0 默认值: 默认情况下,数据备份未启用。要启用该功能,请设置为 请参阅 Cassandra 备份和恢复。 |
cassandra.backup.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
cassandra.backup.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
cassandra.backup.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
cassandra.backup.schedule |
版本:1.0.0 默认值: 时间作业的时间表。 请参阅 Cassandra 备份和恢复。 |
cassandra.backup.serviceAccountPath |
版本:1.0.0 默认值:none 如果备份已启用,则是必需的。 具有“Apigee Read Admin”角色的 Google 服务账号密钥文件的路径。 |
cassandra.clusterName |
版本:1.0.0 默认值: 指定 Cassandra 集群的名称。 |
cassandra.datacenter |
版本:1.0.0 默认值: 指定 Cassandra 节点的数据中心。 |
cassandra.dnsPolicy |
版本:1.1.1 默认值: 当 cassandra.hostNetwork 设置为 |
cassandra.externalSeedHost |
版本:1.0.0 默认值:none Cassandra 集群节点的主机名或 IP。如果未设置,则使用 Kubernetes 本地服务。 |
cassandra.heapNewSize |
版本:1.0.0 默认值: 分配给较新对象的 JVM 系统内存量,以兆字节为单位。 |
cassandra.hostNetwork |
版本:1.1.1 默认值: 对于基于 Anthos 的部署,设为 true。 |
cassandra.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
cassandra.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
cassandra.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
cassandra.maxHeapSize |
版本:1.0.0 默认值: JVM 系统内存的上限可用于 Cassandra 操作,以 MB 为单位。 |
cassandra.multiRegionSeedHost |
版本:1.0.0 默认值:none 现有 Cassandra 集群的 IP 地址,用于将现有集群扩展到新地区。请参阅配置多区域种子主机。 |
cassandra.nodeSelector.key |
版本:1.0.0 默认值:none 必需 节点选择器标签键,用于定位 请参阅添加节点选择器。 |
cassandra.nodeSelector.value |
版本:1.0.0 默认值:none 可选 ode 选择器标签值,用于定位 请参阅 nodeSelector。 |
cassandra.port |
版本:1.0.0 默认值: 用于连接到 Cassandra 的端口号。 |
cassandra.rack |
版本:1.0.0 默认值: 指定 Cassandra 节点的 Rack。 |
cassandra.readinessProbe.failureThreshold |
版本:1.0.0 默认值: Kubernetes 将验证将 Pod 标记为“未就绪”前,就绪探测失败的次数。最小值为 1。 |
cassandra.readinessProbe.initialDelaySeconds |
版本:1.0.0 默认值: 就绪探测启动前,容易开始后经过的秒数。 |
cassandra.readinessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行就绪探测的频率,以秒为单位。最小值为 1。 |
cassandra.readinessProbe.successThreshold |
版本:1.0.0 默认值: 在失败后,被认为成功就绪探测需要的最小持续成功次数。最小值为 1。 |
cassandra.readinessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
cassandra.replicaCount |
版本:1.0.0 默认值: Cassandra 是一个副本数据库。配置为在每个地区或数据中心至少有 3 个数据副本。此属性用于指定用作 StatefulSet 的 Cassandra 节点的数量。 |
cassandra.resources.requests.cpu |
版本:1.0.0 默认值: Kubernetes 容器中资源正常运行所需的 CPU,以毫秒为单位。 |
cassandra.resources.requests.memory |
版本:1.0.0 默认值: 在 Kubernetes 容器中资源正常运行所需的内存,以兆比字节为单位。 |
cassandra.restore.cloudProvider |
版本:1.0.0 默认值: 如果恢复已启用,则必须提供。 用于备份存储的云提供商。 |
cassandra.restore.dbStorageBucket |
版本:1.0.0 默认值:none 如果恢复已启用,则必须提供。 要恢复的备份数据的 Cloud Storage 存储桶。 |
cassandra.restore.enabled |
版本:1.0.0 默认值: |
cassandra.restore.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
cassandra.restore.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
cassandra.restore.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
cassandra.restore.serviceAccountPath |
版本:1.0.0 默认值:none 如果恢复已启用,则必须提供。 具有“Apigee Read Admin”角色的 Google 服务账号密钥文件的路径。 |
cassandra.restore.snapshotTimestamp |
版本:1.0.0 默认值:none 如果恢复已启用,则必须提供。 应恢复的备份的时间戳。 |
cassandra.storage.capacity |
版本:1.0.0 默认值: 如果指定了 storage.storageClass,则必须提供 指定所需的磁盘大小,以兆比字节为单位。 |
cassandra.storage.storageClass |
版本:1.0.0 默认值:none 指定正在使用的本地存储空间类别。 |
cassandra.terminationGracePeriodSeconds |
版本:1.0.0 默认值: 请求删除 Pod 与终止 Pod 之间的时间,以秒为单位。在此期间,将执行任何预停止钩子,并且所有正在运行的进程都应正常终止。 |
defaults
Apigee Hybrid 安装的默认加密密钥。
下表介绍了 defaults
对象的属性:
属性 | 说明 |
---|---|
defaults.org.kmsEncryptionKey |
版本:1.0.0 默认值: KMS 中组织的默认加密密钥。 |
defaults.org.kvmEncryptionKey |
版本:1.0.0 默认值: KVM 中组织的默认加密密钥。 |
defaults.env.kmsEncryptionKey |
版本:1.0.0 默认值: KMS 中环境 (env) 的默认加密密钥。 |
defaults.env.kvmEncryptionKey |
版本:1.0.0 默认值: KVM 中环境(env)的默认加密密钥。 |
defaults.env.cacheEncryptionKey |
版本:1.0.0 默认值: 环境 (env) 的默认缓存加密密钥。 |
envs
定义您可以部署 API 代理的环境数组。每个环境为运行 API 代理提供隔离上下文或“沙盒”。
您的混合启用组织必须至少包含一个环境。
使用 envs[]
配置基本路径路由,让您可以配置和管理 Apigee Hybrid 将 API 代理调用路由到正确环境的方式。
有关详情,请参阅:
下表介绍了 envs
对象的属性:
属性 | 说明 |
---|---|
envs[].cacheEncryptionKey |
版本:1.0.0 默认值:none 必需 Apigee 缓存数据加密密钥的本地文件系统路径。 |
envs[].hostAlias |
版本:1.0.0 默认值:none 必需
服务器的 DNS 名称。例如 如果您有多个环境,则必须对每个环境使用一个独一无二的主机别名。例如, |
envs[].kmsEncryptionKey |
版本:1.0.0 默认值:none 必需 Apigee KMS 数据加密密钥的本地文件系统路径。 |
envs[].name |
版本:1.0.0 默认值:none 必需 要同步的 Apigee 环境名称。 |
envs[].pollInterval |
版本:1.0.0 默认值:none 用于轮询组织和环境同步更改的时间间隔,以秒为单位。 |
envs[].paths.uri.prefixes |
版本:1.0.0 默认值:none 支持前缀基本路径路由的属性。请按以下格式提供这些路径: org: hybrid envs: - name: test paths: uri: prefixes: - /foo - /bar |
envs[].port |
版本:1.0.0 默认值:none HTTPS 流量的 TCP 端口号。 |
envs[].serviceAccountPaths.synchronizer |
版本:GA 默认值:none 具有 Apigee Synchronizer Manager 角色的 Google 服务账号密钥本地系统文件的路径。 |
envs[].serviceAccountPaths.udca |
版本:GA 默认值:none 具有 Apigee Analytic Agent 角色的 Google 服务账号密钥本地系统文件的路径。 |
envs[].sslCertPath |
版本:1.0.0 默认值:none 必需
系统上指向 TLS 证书文件的路径。 |
envs[].sslKeyPath |
版本:1.0.0 默认值:none 必需
在系统上指向 TLS 私钥文件的路径。 |
httpProxy
httpProxy
为 HTTP 转接代理服务器提供配置参数。在 override.yaml 中配置时,MART、Synchronizer 和 UDCA 组件的所有互联网通信都会通过代理服务器发送。
另请参阅:MART、Synchronizer 和 UDCA。
下表介绍了 httpProxy
对象的属性:
属性 | 说明 |
---|---|
httpProxy.host |
版本:1.1.1 默认值:none HTTP 代理的主机名。 |
httpProxy.port |
版本:1.1.1 默认值:none HTTP 代理的端口。 |
httpProxy.scheme |
版本:1.1.1 默认值: 代理使用的方案。值可以是 |
ingress
ingress
是 Istio Ingress Gateway 的实例化,Kubernetes Ingress 资源用于指定应在集群外部公开的服务。定义容器化应用,将流量从运行时层面外部路由到运行时层面中的服务。Apigee 安装会创建两个 Istio Ingress 对象:
- 运行时
- MART
另请参阅:
- Istio 文档中的 Ingress Gateways。
- 添加网关关于在 GCP 文档中添加 Istio Ingress Gatewaws。
- Apigee 中的 istio 对象
- MART 对象
- 运行时对象
下表介绍了 ingress
对象的属性:
属性 | 说明 |
---|---|
ingress.enableAccesslog |
版本:1.0.0 默认值: 启用或停用 Ingress 访问日志。默认情况下,该功能处于停用状态。 |
ingress.envoyHeaders.headers |
版本:1.0.0 默认值:none Envoy 标头列表。 |
ingress.envoyHeaders.preserved |
版本:1.0.0 默认值: 确定是否保留 Envoy 的标头。默认情况下不会。 |
ingress.httpsRedirect |
版本:1.0.0 默认值: 为所有传入流量启用或停用自动 HTTPS 重定向功能。 |
ingress.mart.loadBalancerIP |
版本:1.1.1 默认值: MART 负载均衡器的 IP 地址。 |
ingress.runtime.loadBalancerIP |
版本:1.1.1 默认值: Apigee 运行时对象负载均衡器的 IP 地址。 |
ingress.serviceType |
版本:1.0.0 默认值: 用于将外部流量路由到内部服务的服务类型。 可能的值包括:
|
istio
Google Cloud Platform (GCP) 的 Istio 实现是一个服务网格,可叠加在现有 Apigee 实例上,以帮助该实例与日志记录平台、遥测和政策系统集成。
另请参阅:GCP 的 Istio 文档和什么是 Istio。
下表介绍了 istio
对象的属性:
属性 | 说明 |
---|---|
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 默认值:100m 必需 分配给入站流量控制器的 CPU 资源,需要网关优化执行。 请参阅:
|
istio.ingressgateway.resources.requests.memory |
版本:1.0.0 默认值:128Mi 分配给入站流量控制器的内存资源,需要网关优化执行。 |
istio.nodeSelector.key |
版本:1.0.0 默认值:none 可选节点选择器标签键,用于定位 |
istio.nodeSelector.value |
版本:1.0.0 默认值:none 可选节点选择器标签值,用于定位 |
istio.pilot.replicaCountMax |
版本:1.0.0 默认值:5 必需 集群中的 请参阅 Istio 文档中的试用:核心流量管理 |
istio.pilot.replicaCountMin |
版本:1.0.0 默认值:1 必需 集群中的 请参阅 Istio 文档中的试用:核心流量管理 |
istio.pilot.resources.requests.cpu |
版本:1.0.0 默认值:500m 必需 分配给试运行进程的 CPU 资源,需要网关优化执行。 请参阅:
|
istio.pilot.resources.requests.memory |
版本:1.0.0 默认值:2048Mi 分配给试运行进程的内存资源,需要网关优化执行。 请参阅:
|
logger
定义管理运营日志的服务。Kubernetes 集群中运行的所有 Apigee 混合服务都会输出此信息。
如需了解详情,请参阅 Logging。
下表介绍了 logger
对象的属性:
属性 | 说明 |
---|---|
logger.enabled |
版本:1.0.0 默认值: 启用或停用集群上的日志记录功能。对于设置为 |
logger.fluentd.buffer_chunk_limit |
版本:1.0.0 默认值: 允许的缓冲区区块的大小上限,以千字节为单位。超出限制的区块将自动进入输出队列。 |
logger.fluentd.buffer_queue_limit |
版本:1.0.0 默认值: 输出队列的最大长度。默认限制为 256 个区块。 |
logger.fluentd.flush_interval |
版本:1.0.0 默认值: 调用下一个缓冲区刷新前等待的时间间隔,以秒为单位。 |
logger.fluentd.max_retry_wait |
版本:1.0.0 默认值: 写入操作之间的最大时间间隔,以秒为单位。 |
logger.fluentd.num_threads |
版本:1.0.0 默认值: 用于刷新缓冲区的线程数。默认值为 1。 |
logger.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
logger.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
logger.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
logger.livenessProbe.failureThreshold |
版本:1.0.0 默认值: Kubernetes 将验证重启容器前,活跃探测失败的次数。最小值为 1。 |
logger.livenessProbe.initialDelaySeconds |
版本:1.0.0 默认值: 活跃探测启动前,容易开始后经过的秒数。 |
logger.livenessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行活跃探测的频率,以秒为单位。最小值为 1。 |
logger.livenessProbe.successThreshold |
版本:1.0.0 默认值: 在失败后,被认为成功活跃性探测需要的最小持续成功次数。最小值为 1。 |
logger.livenessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
logger.nodeSelector.key |
版本:1.0.0 默认值: 必需 节点选择器标签键,用于定位 请参阅添加节点选择器。 |
logger.nodeSelector.value |
版本:1.0.0 默认值: 必需 节点选择器标签值,用于定位 请参阅添加节点选择器。 |
logger.proxyURL |
版本:1.0.0 默认值:none 客户代理服务器的网址。 |
logger.resource.limits.memory |
版本:1.0.0 默认值: Kubernetes 容器中资源的内存限制,以字节为单位。
|
logger.resource.limits.cpu |
版本:1.0.0 默认值: Kubernetes 容器中资源的 CPU 限制,以毫米为单位。
|
logger.resource.requests.cpu |
版本:1.0.0 默认值: Kubernetes 容器中资源正常运行所需的 CPU,以毫秒为单位。 |
logger.resource.requests.memory |
版本:1.0.0 默认值: 在 Kubernetes 容器中资源正常运行所需的内存,以兆比字节为单位。 |
logger.serviceAccountPath |
版本:1.0.0 默认值:none 必需 具有“Apigee Read Admin”角色的 Google 服务账号密钥文件的路径。 |
logger.terminationGracePeriodSeconds |
版本:1.0.0 默认值: 请求删除 Pod 与终止 Pod 之间的时间,以秒为单位。在此期间,将执行任何预停止钩子,并且所有正在运行的进程都应正常终止。 |
mart
定义 MART(运行时数据的 Management API)服务,它充当公开 Apigee API 的 API 提供商,以便您可以访问和管理运行时数据实体,例如 KMS(API 密钥和 OAuth 令牌)、KVM、配额和 API 产品。
下表介绍了 mart
对象的属性:
属性 | 说明 |
---|---|
mart.hostAlias |
版本:1.0.0 默认值:none 指向 MART 对象的主机别名。您可以将此属性设置为 |
mart.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
mart.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
mart.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。检查特定网址的 values.yaml 文件。您可以覆盖它。 |
mart.initCheckCF.resources.requests.cpu |
版本:1.0.0 默认值: 分配给 Cloud Foundry 进程初始化检查的 CPU 资源量。 |
mart.livenessProbe.failureThreshold |
版本:1.0.0 默认值: Kubernetes 将验证重启容器前,活跃探测失败的次数。最小值为 1。 |
mart.livenessProbe.initialDelaySeconds |
版本:1.0.0 默认值: 活跃探测启动前,容易开始后经过的秒数。 |
mart.livenessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行活跃探测的频率,以秒为单位。最小值为 1。 |
mart.livenessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
mart.metricsURL |
版本:1.0.0 默认值: |
mart.nodeSelector.key |
版本:1.0.0 默认值:none 可选节点选择器标签键,用于定位 请参阅添加节点选择器。 |
mart.nodeSelector.value |
版本:1.0.0 默认值:none 可选节点选择器标签值,用于定位 请参阅添加节点选择器。 |
mart.readinessProbe.failureThreshold |
版本:1.0.0 默认值: Kubernetes 将验证将 Pod 标记为“未就绪”前,就绪探测失败的次数。最小值为 1。 |
mart.readinessProbe.initialDelaySeconds |
版本:1.0.0 默认值: 就绪探测启动前,容易开始后经过的秒数。 |
mart.readinessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行就绪探测的频率,以秒为单位。最小值为 1。 |
mart.readinessProbe.successThreshold |
版本:1.0.0 默认值: 在失败后,被认为成功就绪探测需要的最小持续成功次数。最小值为 1。 |
mart.readinessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
mart.replicaCountMax |
版本:1.0.0 默认值: 可用于自动扩缩的副本数上限。 |
mart.replicaCountMin |
版本:1.0.0 默认值: 可自动扩缩的副本数下限。 |
mart.resources.requests.cpu |
版本:1.0.0 默认值: Kubernetes 容器中资源正常运行所需的 CPU,以毫秒为单位。 |
mart.resources.requests.memory |
版本:1.0.0 默认值: 在 Kubernetes 容器中资源正常运行所需的内存,以兆比字节为单位。 |
mart.serviceAccountPath |
版本:1.1.1 默认值:none 必需 具有“Apigee Read Admin”角色的 Google 服务账号密钥文件的路径。 |
mart.sslCertPath |
版本:1.0.0 默认值:none 将 SSL 证书加载和编码到 Secret 的本地文件系统路径。 |
mart.sslKeyPath |
版本:1.0.0 默认值:none 将 SSL 密钥加载和编码到 Secret 的本地文件系统路径。 |
mart.targetCPUUtilizationPercentage |
版本:1.0.0 默认值: Pod 上 MART 进程的目标 CPU 利用率。在 CPU 利用率达到此值(最多 |
mart.terminationGracePeriodSeconds |
版本:1.0.0 默认值: 请求删除 Pod 与终止 Pod 之间的时间,以秒为单位。在此期间,将执行任何预停止钩子,并且所有正在运行的进程都应正常终止。 |
metrics
定义收集操作指标的服务。您可以使用指标数据来监控混合服务的运行状况、设置提醒等。
如需了解详情,请参阅指标集合概览。
下表介绍了 metrics
对象的属性:
属性 | 说明 |
---|---|
metrics.enabled |
版本:1.0.0 默认值: 启用 Apigee 指标。设置为 |
metrics.nodeSelector.key |
版本:1.0.0 默认值:none 必需 节点选择器标签键,用于定位 请参阅添加节点选择器。 |
metrics.nodeSelector.value |
版本:1.0.0 默认值:none 必需 节点选择器标签值,用于定位 请参阅添加节点选择器。 |
metrics.prometheus.args.storage_tsdb_retention |
版本:1.0.0 默认值: Prometheus 从本地存储空间中移除旧数据之前等待的时间,以小时为单位。 |
metrics.prometheus.containerPort |
版本:1.0.0 默认值: 连接到 Prometheus 指标服务的端口。 |
metrics.prometheus.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
metrics.prometheus.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
metrics.prometheus.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
metrics.prometheus.livenessProbe.failureThreshold |
版本:1.0.0 默认值: Kubernetes 将验证重启容器前,活跃探测失败的次数。最小值为 1。 |
metrics.prometheus.livenessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行活跃探测的频率,以秒为单位。最小值为 1。 |
metrics.prometheus.livenessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
metrics.prometheus.readinessProbe.failureThreshold |
版本:1.0.0 默认值: Kubernetes 将验证将 Pod 标记为“未就绪”前,就绪探测失败的次数。最小值为 1。 |
metrics.prometheus.readinessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行就绪探测的频率,以秒为单位。最小值为 1。 |
metrics.prometheus.readinessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
metrics.proxyURL |
版本:1.0.0 默认值:none Kubernetes 集群中的指标进程 Sidecar 代理的网址。 |
metrics.resources.limits.cpu |
版本:1.0.0 默认值: Kubernetes 容器中资源的 CPU 限制,以毫米为单位。
|
metrics.resources.limits.memory |
版本:1.0.0 默认值: Kubernetes 容器中资源的内存限制,以字节为单位。
|
metrics.resources.requests.cpu |
版本:1.0.0 默认值: Kubernetes 容器中资源正常运行所需的 CPU,以毫秒为单位。 |
metrics.resources.requests.memory |
版本:1.0.0 默认值: 在 Kubernetes 容器中资源正常运行所需的内存,以兆比字节为单位。 |
metrics.sdSidecar.containerPort |
版本:1.0.0 默认值: 连接到 StackDriver 指标服务的端口。 |
metrics.sdSidecar.image.pullPolicy |
版本:1.0.0 默认值: 确定 Kubelet 何时提取此服务的 Docker 映像。可能的值包括:
|
metrics.sdSidecar.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
metrics.sdSidecar.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
metrics.serviceAccountPath |
版本:1.0.0 默认值:none 必需 具有“Apigee Read Admin”角色的 Google 服务账号密钥文件的路径。 |
metrics.terminationGracePeriodSeconds |
版本:1.0.0 默认值: 请求删除 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
对于生产环境, 请参阅添加节点选择器。 |
runtime
下表介绍了 runtime
对象的属性:
属性 | 说明 |
---|---|
runtime.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
runtime.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
runtime.image.url |
版本:1.0.0 默认值:安装映像资源网址,例如: 此服务的 Docker 映像的位置。 |
runtime.livenessProbe.failureThreshold |
版本:1.0.0 默认值: Kubernetes 将验证重启容器前,活跃探测失败的次数。最小值为 1。 |
runtime.livenessProbe.initialDelaySeconds |
版本:1.0.0 默认值: 活跃探测启动前,容易开始后经过的秒数。 |
runtime.livenessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行活跃探测的频率,以秒为单位。最小值为 1。 |
runtime.livenessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
runtime.nodeSelector.key |
版本:1.0.0 默认值:none 可选节点选择器标签键,用于定位 请参阅 nodeSelector 属性。 |
runtime.nodeSelector.value |
版本:1.0.0 默认值:none 节点选择器标签值,用于定位 请参阅添加节点选择器。 |
runtime.readinessProbe.failureThreshold |
版本:1.0.0 默认值: Kubernetes 将验证将 Pod 标记为“未就绪”前,就绪探测失败的次数。最小值为 1。 |
runtime.readinessProbe.initialDelaySeconds |
版本:1.0.0 默认值: 就绪探测启动前,容易开始后经过的秒数。 |
runtime.readinessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行就绪探测的频率,以秒为单位。最小值为 1。 |
runtime.readinessProbe.successThreshold |
版本:1.0.0 默认值: 在失败后,被认为成功就绪探测需要的最小持续成功次数。最小值为 1。 |
runtime.readinessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
runtime.replicaCountMax |
版本:1.0.0 默认值: 可用于自动扩缩的副本数上限。 |
runtime.replicaCountMin |
版本:1.0.0 默认值: 可自动扩缩的副本数下限。 |
runtime.resources.requests.cpu |
版本:1.0.0 默认值: Kubernetes 容器中资源正常运行所需的 CPU,以毫秒为单位。 |
runtime.resources.requests.memory |
版本:1.0.0 默认值: 在 Kubernetes 容器中资源正常运行所需的内存,以兆比字节为单位。 |
runtime.service.type |
版本:1.0.0 默认值: 服务类型。您可以将此设置为 ClusterIP 以外的服务;例如 |
runtime.targetCPUUtilizationPercentage |
版本:1.0.0 默认值: Pod 上运行时进程的目标 CPU 利用率。在 CPU 利用率达到此值(最多 |
runtime.terminationGracePeriodSeconds |
版本:1.0.0 默认值: 请求删除 Pod 与终止 Pod 之间的时间,以秒为单位。在此期间,将执行任何预停止钩子,并且所有正在运行的进程都应正常终止。 |
synchronizer
确保消息处理器与最新部署的 API 代理软件包保持同步。为此,Synchronizer 会轮询管理平面;检测到新合同时,Synchronizer 会将其发送到运行时平面。
如需了解详情,请参阅 Synchronizer。
下表介绍了 synchronizer
对象的属性:
属性 | 说明 |
---|---|
synchronizer.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
synchronizer.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
synchronizer.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
synchronizer.livenessProbe.failureThreshold |
版本:1.0.0 默认值: Kubernetes 将验证重启容器前,活跃探测失败的次数。最小值为 1。 |
synchronizer.livenessProbe.initialDelaySeconds |
版本:1.0.0 默认值: 活跃探测启动前,容易开始后经过的秒数。 |
synchronizer.livenessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行活跃探测的频率,以秒为单位。最小值为 1。 |
synchronizer.livenessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
synchronizer.nodeSelector.key |
版本:1.0.0 默认值:none 必需 可选节点选择器标签键,用于定位 请参阅 nodeSelector。 |
synchronizer.nodeSelector.value |
版本:1.0.0 默认值:none 可选节点选择器标签值,用于定位 请参阅 nodeSelector。 |
synchronizer.pollInterval |
版本:1.0.0 默认值: Synchronizer 在轮询操作之间等待的时长。Synchronizer 轮询 Apigee 控制平面服务,以检测并提取新的运行时合同。 |
synchronizer.readinessProbe.failureThreshold |
版本:1.0.0 默认值: Kubernetes 将验证将 Pod 标记为“未就绪”前,就绪探测失败的次数。最小值为 1。 |
synchronizer.readinessProbe.initialDelaySeconds |
版本:1.0.0 默认值: 就绪探测启动前,容易开始后经过的秒数。 |
synchronizer.readinessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行就绪探测的频率,以秒为单位。最小值为 1。 |
synchronizer.readinessProbe.successThreshold |
版本:1.0.0 默认值: 在失败后,被认为成功就绪探测需要的最小持续成功次数。最小值为 1。 |
synchronizer.readinessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
synchronizer.replicaCount |
版本:1.0.0 默认值: 自动扩缩的副本数。 |
synchronizer.resources.requests.cpu |
版本:1.0.0 默认值: Kubernetes 容器中资源正常运行所需的 CPU,以毫秒为单位。 |
synchronizer.resources.requests.memory |
版本:1.0.0 默认值: 在 Kubernetes 容器中资源正常运行所需的内存,以千兆字节为单位。 |
synchronizer.serviceAccountPath |
版本:1.0.0 默认值:none 必需 具有“Apigee Read Admin”角色的 Google 服务账号密钥文件的路径。 |
synchronizer.targetCPUUtilizationPercentage |
版本:1.0.0 默认值:
Pod 上 Synchronizer 进程的目标 CPU 利用率。在 CPU 利用率达到此值(最多 |
synchronizer.terminationGracePeriodSeconds |
版本:1.0.0 默认值: 请求删除 Pod 与终止 Pod 之间的时间,以秒为单位。在此期间,将执行任何预停止钩子,并且所有正在运行的进程都应正常终止。 |
udca
(通用数据收集代理)定义在运行时平面的数据收集 pod 中运行的服务。此服务会提取分析和部署状态数据并将其发送到统一分析平台 (UAP)。
如需了解详情,请参阅分析和部署状态数据收集。
下表介绍了 udca
对象的属性:
属性 | 说明 |
---|---|
udca.fluentd.image.pullPolicy |
版本:1.0.0 默认值: 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
udca.fluentd.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
udca.fluentd.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
udca.fluentd.resource.limits.memory |
版本:1.0.0 默认值: Kubernetes 容器中资源的内存限制,以字节为单位。
|
udca.fluentd.resource.requests.cpu |
版本:1.0.0 默认值: Kubernetes 容器中资源正常运行所需的 CPU,以毫秒为单位。 |
udca.fluentd.resource.requests.memory |
版本:1.0.0 默认值: 在 Kubernetes 容器中资源正常运行所需的内存,以兆比字节为单位。 |
udca.image.pullPolicy |
版本:1.0.0 默认值:IfNotPresent 确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括:
如需了解详情,请参阅更新映像。 |
udca.image.tag |
版本:1.0.0 默认值: 此服务 Docker 映像的版本标签。 |
udca.image.url |
版本:1.0.0 默认值: 此服务的 Docker 映像的位置。 |
udca.jvmXms |
版本:1.0.0 默认值: 数据收集 pod JVM 的内存量。 |
udca.jvmXmx |
版本:1.0.0 默认值: 数据收集 pod 的 JVM 的最大内存分配。 |
udca.livenessProbe.failureThreshold |
版本:1.0.0 默认值: Kubernetes 将验证重启容器前,活跃探测失败的次数。最小值为 1。 |
udca.livenessProbe.initialDelaySeconds |
版本:1.0.0 默认值: 活跃探测启动前,容易开始后经过的秒数。 |
udca.livenessProbe.periodSeconds |
版本:1.0.0 默认值: 确定执行活跃探测的频率,以秒为单位。最小值为 1。 |
udca.livenessProbe.timeoutSeconds |
版本:1.0.0 默认值: 活跃探测超时后的秒数。最小值为 1。 |
udca.nodeSelector.key |
版本:1.0.0 默认值:none 必需 节点选择器标签键,用于定位 请参阅添加节点选择器。 |
udca.nodeSelector.value |
版本:1.0.0 默认值:none 必需 节点选择器标签值,用于定位 请参阅添加节点选择器。 |
udca.pollingIntervalInSec |
版本:1.0.0 默认值: UDCA 轮询操作之间等待的时长,以秒为单位。UDCA 轮询数据收集 pod 文件系统上的数据目录,以检测要上传的新文件。 |
prometheus.sslCertPath |
版本:1.0.0 默认值:none 必需 指向 Prometheus 指标收集过程 SSL 证书的路径。Prometheus 是 Apigee 可用于收集和处理指标的工具。 请参阅:
|
prometheus.sslKeyPath |
版本:1.0.0 默认值:none 必需 指向 Prometheus 指标收集过程 SSL 密钥的路径。Prometheus 是 Apigee 可用于收集和处理指标的工具。 请参阅:
|
udca.replicaCountMax |
版本:1.0.0 默认值: 混合可为 UDCA 部署自动添加的 pod 数上限。由于 UDCA 是作为 ReplicaSet 实现的,因此 pod 是副本。 |
udca.replicaCountMin |
版本:1.0.0 默认值: UDCA 部署的 pod 数下限。由于 UDCA 是作为 ReplicaSet 实现的,因此 pod 是副本。 如果 CPU 使用率高于 udca.targetCPUUtilizationPercentage,则混合将逐步增加 pod 数,最高可达 |
udca.resource.requests.cpu |
版本:1.0.0 默认值: Kubernetes 容器中资源正常运行所需的 CPU,以毫秒为单位。 |
udca.revision |
版本:1 默认值: 填充到标签页中可启用 Canary 部署的静态值。 |
udca.targetCPUUtilizationPercentage |
版本:1.0.0 默认值: 用于扩缩 ReplicaSet 中 pod 数量的 CPU 使用率的阈值,表示为占可用 CPU 资源的百分比。混合使用数据收集 pod(fluentd 和 UDCA)中所有容器的组合利用率来计算当前利用率。 当 CPU 使用率超过此值时,混合将逐步增加 ReplicaSet 中的 pod 数,最高可达 |
udca.terminationGracePeriodSeconds |
版本:1.0.0 默认值: 请求删除 Pod 与终止 Pod 之间的时间,以秒为单位。在此期间,将执行任何预停止钩子,并且所有正在运行的进程都应正常终止。 |