配置属性参考文档

在以下版本中引入：1.3.0

默认值：iloveapis123

可选

Kubernetes Secret 的名称，其中包含在计算哈希值时使用的盐值，以在将用户数据发送到 Apigee Analytics 之前混淆用户数据。如果您未指定盐值，则默认使用 iloveapis123。使用盐值作为输入来创建 Secret。您可以对多个集群使用相同的盐，以确保集群之间的哈希结果保持一致。

Apigee 会先使用 SHA512 对原始值进行哈希处理，然后再将数据从运行时平面发送到控制平面。

请参阅对用户数据进行混淆处理以用于分析。

默认值：https://apigee.googleapis.com

定义安装中所有 API 的 API 路径。

如果 Hybrid 安装按照以下格式使用数据驻留，则是必需的：

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

其中 CONTROL_PLANE_LOCATION 是存储代理软件包等控制平面数据的位置。如需查看列表，请参阅可用的 Apigee API 控制平面区域。

例如：

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

在以下版本中引入：1.0.0

默认值：none

必需

您的 Google Cloud 项目的 ID。与 k8sClusterName（已弃用）和 gcpRegion（已弃用）搭配使用，用于标识项目并确定 apigee-logger 和 apigee-metrics 推送其数据的位置。

在以下版本中引入：1.0.0

默认值：us-central1

必需

您的 Kubernetes 集群的秘密 Google Cloud 区域或可用区。与 gcpProjectID（已弃用）和 k8sClusterName（已弃用）搭配使用，用于标识项目并确定 apigee-logger 和 apigee-metrics 推送其数据的位置。

默认值：None

用于从私有仓库中拉取所有 Apigee 组件的映像的私有映像容器仓库网址。

hub 提供所有 Apigee Hybrid 组件的默认路径。如果您使用的是私有仓库，请使用 hub 为所有组件设置仓库网址，而不是为每个组件使用单独的 image.url 属性。仅当您为特定组件使用单独的仓库时，才配置各个网址。

每个组件的映像路径是 hub 的值加上组件的映像名称和标记。

例如，如果值为 hub private-docker-host.example.com，则各个组件会自动将映像路径：

hub: private-docker-host.example.com

解析为：

## an example of internal component vs 3rd party
containers:
- name: apigee-udca
  image: private-docker-host.example.com/apigee-udca:1.12.4
  imagePullPolicy: IfNotPresent

containers:
- name: apigee-ingressgateway
  image: private-docker-host.example.com/apigee-asm-ingress:1.18.7-asm.4-distroless
  imagePullPolicy: IfNotPresent

其他组件遵循类似的模式。

使用 apigee-pull-push --list 查看所有组件的当前仓库网址。

请参阅使用 Apigee Hybrid 处理私有映像仓库。

您可以使用以下属性单独替换组件的映像网址：

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

默认值：None

配置为 docker-registry 类型的 Kubernetes 秘密名称；用于从私有代码库中提取映像。

默认值：None

必需

此安装的唯一标识符。

用于标识此实例的唯一字符串。该 ID 可以是字母和数字的任意组合，长度不得超过 63 个字符。

在以下版本中引入：1.0.0

默认值：None

您的混合项目正在运行的 Kubernetes (K8S) 专业集群名称。与 gcpProjectID（已弃用）和 gcpRegion（已弃用）搭配使用，用于标识项目并确定 apigee-logger 和 apigee-metrics 推送其数据的位置。

默认值：defaults.org.kmsEncryptionKey

可选。仅使用 kmsEncryptionKey、kmsEncryptionPath 或 kmsEncryptionSecret 之一。

Apigee KMS 数据加密密钥的本地文件系统路径。

默认值：None

可选。仅使用 kmsEncryptionKey、kmsEncryptionPath 或 kmsEncryptionSecret 之一。

包含 base64 编码的加密密钥的文件的路径。请参阅数据加密。

默认值：None

可选。仅使用 kmsEncryptionKey、kmsEncryptionPath 或 kmsEncryptionSecret 之一。

包含 base64 编码的加密密钥的 Kubernetes Secret 的密钥。请参阅数据加密。

默认值：None

可选。仅使用 kmsEncryptionKey、kmsEncryptionPath 或 kmsEncryptionSecret 之一。

包含 base64 编码的加密密钥的 Kubernetes Secret 的名称。请参阅数据加密。

默认值：defaults.org.kmsEncryptionKey

可选。仅使用 kvmEncryptionKey、kvmEncryptionPath 或 kvmEncryptionSecret 之一。

Apigee KVM 数据加密密钥的本地文件系统路径。

默认值：None

可选。仅使用 kvmEncryptionKey、kvmEncryptionPath 或 kvmEncryptionSecret 之一。

包含 base64 编码的加密密钥的文件的路径。请参阅数据加密。

默认值：None

可选。仅使用 kvmEncryptionKey、kvmEncryptionPath 或 kvmEncryptionSecret 之一。

包含 base64 编码的加密密钥的 Kubernetes Secret 的密钥。请参阅数据加密。

默认值：None

可选。仅使用 kvmEncryptionKey、kvmEncryptionPath 或 kvmEncryptionSecret 之一。

包含 base64 编码的加密密钥的 Kubernetes Secret 的名称。请参阅数据加密。

默认值：false

对于多组织集群，此属性可让您将组织的指标导出到 gcp.projectID 属性中列出的项目。 在多组织集群中每个组织的替换文件中应用此设置。如需了解详情，请参阅将多个 Hybrid 组织添加到集群。

默认值：apigee

将安装 Apigee 组件的 Kubernetes 集群的命名空间。

在以下版本中引入：1.0.0

默认值：None

必需

混合启用组织，由 Apigee 在混合安装期间为您预配。组织是 Apigee 中的顶层容器。它包含您的所有 API 代理及相关资源。如果值为空，则必须在创建后将其更新为组织名称。

默认值：true

在组织级别启用通用数据收集代理服务 (UDCA)，以提取分析、获利和调试（跟踪）并将其发送到控制平面中的统一分析平台 (UAP)。

组织级 UDCA 在所有 Apigee 环境中都使用一个 Google 服务账号。该服务账号需要具有 Apigee Analytics Agent (roles/apigee.analyticsAgent) 角色。

使用 udca.serviceAccountPath 属性指定服务账号密钥文件的路径或在 overrides.yaml 配置文件中使用 udca.serviceAccountRef 属性提供 Kubernetes Secret 中的密钥。

如果您希望为每个环境使用单独的 UDCA 代理，请设置 orgScopedUDCA: false 并为 envs[].serviceAccountPaths.udca 和 envs[].serviceAccountSecretRefs.udca 设置值。

另请参阅：udca。

默认值："1124"（不包含句点的 Apigee Hybrid 版本）。例如，对于 1.12.0 版，默认值为 "1120"。）

Apigee Hybrid 支持滚动 Kubernetes 更新，让部署更新可以通过用新的逐步更新 Pod 实例来实现零停机时间。

在更新可能导致底层 Kubernetes PodTemplateSpec 更改的特定 YAML 覆盖时，还必须在客户的 override.yaml 中更改 revision 替换属性。对于底层 Kubernetes ApigeeDeployment (AD) 控制器，必须执行此操作才能执行从上一个版本到新版本的安全滚动更新。您可以使用任意小写文本值，例如：blue、a、1.0.0

更改并应用 revision 属性后，将针对所有组件执行滚动更新

更改以下对象的属性时，需要更新 revision：

• nodeSelector
• envs
• imagePullSecrets
• gcpProjectID
• k8sClusterName
• contractProvider
• 单位部门

如需了解详情，请参阅滚动更新。

默认值：None

在 Vault 中存储服务账号密钥的组织专属 Secret 提供方类 (SecretProviderClass) 的名称。

请参阅在 Hashicorp Vault 中存储服务账号密钥。

默认值：true

启用对 Apigee 组织与 Google Cloud 项目之间的关联的严格验证，并检查是否存在环境组。

另请参阅 org

默认值：true

对服务账号权限启用严格验证。这使用 Cloud Resource Manager API 方法 testIamPermissions 来验证所提供的服务账号是否具备所需的权限。对于 Apigee 组织服务账号，项目 ID 检查就是映射到组织的。对于 Metrics 和 Logger，所检查的项目基于 gcpProjectID overrides.yaml 配置。

另请参阅 gcpProjectID

默认值：true

阻止 Apigee 向客户安装的 Cloud Service Mesh 提供配置。

• 对于使用 Apigee 入站流量网关的 Hybrid 安装，设置为 true。
• 对于使用 Cloud Service Mesh（Apigee Hybrid 1.8 版及更早版本）的 Hybrid 安装，设置为 false。

默认值：true

如果为 true（默认值），Apigee Hybrid 不会直接管理 Kubernetes ClusterRole 和 ClursterRoleBinding。如果您的进程需要管理这些资源，则此进程必须由具有正确权限的用户执行。

默认值：IfNotPresent

确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括：

• IfNotPresent：如果新映像已存在，则请勿提取它。
• Always：始终提取映像，无论它是否已经存在。

如需了解详情，请参阅更新映像。

默认值：1.12.4

此服务 Docker 映像的版本标签。

默认值：None

此服务的 Docker 映像的位置。

使用 apigee-pull-push --list 查看此组件的当前仓库网址。

默认值：250m

Kubernetes 容器中资源的 CPU 限制，以毫米为单位。

默认值：256Mi

Kubernetes 容器中资源的内存限制，以字节为单位。

默认值：250m

Kubernetes 容器中资源正常运行所需的 CPU，以毫秒为单位。

默认值：256Mi

在 Kubernetes 容器中资源正常运行所需的内存，以兆比字节为单位。

默认值：None

使用 Kubernetes 的污点和容忍功能所必需的属性。

effect 指定将容忍与污点匹配的影响。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

如需了解详情，请参阅污点和容忍：概念。

默认值：None

使用 Kubernetes 的污点和容忍功能所必需的属性。

key 标识可以应用容忍的 Pod。

如需了解详情，请参阅污点和容忍：概念。

默认值："Equal"

使用 Kubernetes 的污点和容忍功能所必需的属性。

operator 指定用于触发 effect 的操作。operator 的值可以是：

• Equal 匹配 value 中设置的值。
• Exists 忽略 value 中设置的值。

如需了解详情，请参阅污点和容忍：概念。

默认值：None

供 Kubernetes 的污点和容忍功能使用。

tolerationSeconds 定义 Pod 与故障节点或无响应节点绑定的时长，以秒为单位。

如需了解详情，请参阅污点和容忍：概念。

默认值：None

供 Kubernetes 的污点和容忍功能使用。

value 是在 operator 设置为 Equal 时触发 effect 的值。

如需了解详情，请参阅污点和容忍：概念。

默认值：IfNotPresent

确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括：

• IfNotPresent：如果新映像已存在，则请勿提取它。
• Always：始终提取映像，无论它是否已经存在。

如需了解详情，请参阅更新映像。

默认值：1.18.7-asm.4-distroless

此服务 Docker 映像的版本标签。

默认值：None

此服务的 Docker 映像的位置。

使用 apigee-pull-push --list 查看此组件的当前仓库网址。

默认值：None

必需

节点选择器标签键，用于定位入站流量网关服务的专用 Kubernetes 节点。

请参阅配置专用节点池。

默认值：None

可选的节点选择器标签值，用于定位入站流量网关服务的专用 Kubernetes 节点并替换 nodeSelector.apigeeData 设置。

请参阅 nodeSelector。

默认值：4

Hybrid 可以为可用于自动缩放的入口流量网关自动添加的最大 Pod 数量。

默认值：2

可用于自动扩缩的入站流量网关的 Pod 数下限。

默认值：75

用于扩缩 ReplicaSet 中 pod 数量的 CPU 使用率的阈值，表示为占可用 CPU 资源的百分比。

当 CPU 使用率超过此值时，混合将逐步增加 ReplicaSet 中的 pod 数，最高可达 apigeeIngressGateway.replicaCountMax。

如需详细了解如何在 Kubernetes 中进行扩缩，请参阅 Kubernetes 文档中的 Pod 横向自动扩缩部分。

默认值：None

使用 Kubernetes 的污点和容忍功能所必需的属性。

effect 指定将容忍与污点匹配的影响。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

如需了解详情，请参阅污点和容忍：概念。

默认值：None

使用 Kubernetes 的污点和容忍功能所必需的属性。

key 标识可以应用容忍的 Pod。

如需了解详情，请参阅污点和容忍：概念。

默认值："Equal"

使用 Kubernetes 的污点和容忍功能所必需的属性。

operator 指定用于触发 effect 的操作。operator 的值可以是：

• Equal 匹配 value 中设置的值。
• Exists 忽略 value 中设置的值。

如需了解详情，请参阅污点和容忍：概念。

默认值：None

供 Kubernetes 的污点和容忍功能使用。

tolerationSeconds 定义 Pod 与故障节点或无响应节点绑定的时长，以秒为单位。

如需了解详情，请参阅污点和容忍：概念。

默认值：None

供 Kubernetes 的污点和容忍功能使用。

value 是在 operator 设置为 Equal 时触发 effect 的值。

如需了解详情，请参阅污点和容忍：概念。

默认值：None

用于为 pod 添加注释的可选键值对映射。如需了解详情，请参阅自定义注释。

默认值：iloveapis123

必需

Cassandra 管理员的密码。管理员用户用于在 Cassandra 集群上执行的任何管理活动，例如备份和恢复。

默认值：iloveapis123

必需

Cassandra 数据定义语言 (DDL) 用户的密码。MART 用于任何数据定义任务，例如键空间创建、更新和删除。

默认值：iloveapis123

必需

启用身份验证时创建的默认 Cassandra 用户密码。配置 Cassandra 身份验证时，必须重置此密码。请参阅为 Cassandra 配置 TLS。

默认值：iloveapis123

必需

Cassandra 数据操纵语言 (DML) 用户的密码。DML 用户供客户端通信读取和向 Cassandra 写入数据。

默认值：IfNotPresent

确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括：

• IfNotPresent：如果新映像已存在，则请勿提取它。
• Always：始终提取映像，无论它是否已经存在。

如需了解详情，请参阅更新映像。

默认值：1.12.4

此服务 Docker 映像的版本标签。

默认值：None

此服务的 Docker 映像的位置。

使用 apigee-pull-push --list 查看此组件的当前仓库网址。

默认值：iloveapis123

必需

Cassandra JMX 操作用户的密码。用于通过 Cassandra JMX 接口进行身份验证和通信。

默认值：jmxuser

必需

Cassandra JMX 操作用户的用户名。用于通过 Cassandra JMX 接口进行身份验证和通信。

默认值：iloveapis123

必需

Cassandra Jolokia JMX 操作用户的密码。用于向 Cassandra JMX API 进行身份验证和通信。

默认值：apigee

必需

Cassandra Jolokia JMX 操作用户的用户名。用于向 Cassandra JMX API 进行身份验证和通信。

默认值：None

存储在包含 Cassandra 用户和密码的 Kubernetes Secret 中的文件的名称。您可以按照以下说明创建 Secret：创建 Secret。

另请参阅：

• 在 Kubernetes Secret 中存储数据
• Kubernetes 文档中的 Secret
• Kubernetes 文档中的使用 kubectl 创建 Secret

默认值：None

Cassandra Secret 存储政策。设置后，它必须与引用外部 Secret 提供程序（例如 Hashicorp Vault）的 SecretProviderClass 匹配。如果未设置，Apigee Hybrid 会使用存储在以下位置的用户名和密码：

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

或存储在以下位置的 Kubernetes Secret：

• cassandra.auth.secret

如需查看创建政策的说明，请参阅在 Hashicorp Vault 中存储 Cassandra Secret。

默认值：GCP

备份提供方的名称。支持的值：GCP、HYBRID 和 CSI。将值设置为：

• GCP 以在 Google Cloud Storage 上存储备份归档。
• HYBRID，用于在远程 SSH 服务器上存储备份归档。
• CSI（推荐），用于利用 Kubernetes CSI 卷快照进行备份。如需了解适用于 Google Cloud、AWS 和 Azure 等云平台的 CSI 备份和恢复，请参阅 CSI 备份和恢复。

默认值：None

如果已启用备份且 cassandra.backup.cloudProvider 设置为 GCP，则为必需。

必须采用 gs://BUCKET_NAME 格式（必须使用 gs:// 前缀）。

将用于存储备份归档的现有 Google Cloud Storage 存储桶的名称。如果您需要创建存储桶，请参阅创建存储桶。

默认值：false

默认情况下，数据备份未启用。 要启用该功能，请设置为 true。

请参阅 Cassandra 备份和恢复。

默认值：IfNotPresent

确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括：

• IfNotPresent：如果新映像已存在，则请勿提取它。
• Always：始终提取映像，无论它是否已经存在。

如需了解详情，请参阅更新映像。

默认值：1.12.4

此服务 Docker 映像的版本标签。

默认值：None

此服务的 Docker 映像的位置。

使用 apigee-pull-push --list 查看此组件的当前仓库网址。

默认值：None

如果已启用备份且 cassandra.backup.cloudProvider 设置为 HYBRID，则为必需。

SSH 私钥文件在本地文件系统中的路径。

默认值：0 2 * * *

备份 Cron 作业的时间表。

请参阅 Cassandra 备份和恢复。

默认值：None

如果已启用备份且 cassandra.backup.cloudProvider 设置为 HYBRID，则为必需。

远程 SSH 备份服务器的 IP 地址。

默认值：None

具有 Storage Object Admin (roles/storage.objectAdmin) 角色的 Google 服务账号密钥文件的路径。此 Google 服务账号将会用于将备份归档上传到指定的 cassandra.backup.dbStorageBucket。

如果已启用备份并将 cassandra.backup.cloudProvider 设置为 GCP，则需要执行以下操作之一才能确保 Apigee Hybrid 可以访问 Google Cloud Storage 存储桶以上传备份归档：

• 已指定 cassandra.backup.serviceAccountPath。
• 已指定 cassandra.backup.serviceAccountRef。
• 已配置 GKE 中适用于 Apigee Hybrid 的 Workload Identity。
• 已配置 AKS 或 EKS 中适用于 Apigee Hybrid 的工作负载身份联合。

默认值：None

现有 Kubernetes Secret 的名称，该 Secret 用于存储具有 Storage Object Admin (roles/storage.objectAdmin) 角色的 Google 服务账号密钥文件的内容。此 Google 服务账号将会用于将备份归档上传到指定的 cassandra.backup.dbStorageBucket。

如果已启用备份并将 cassandra.backup.cloudProvider 设置为 GCP，则需要执行以下操作之一才能确保 Apigee Hybrid 可以访问 Google Cloud Storage 存储桶以上传备份归档：

• 已指定 cassandra.backup.serviceAccountPath。
• 已指定 cassandra.backup.serviceAccountRef。
• 已配置 GKE 中适用于 Apigee Hybrid 的 Workload Identity。
• 已配置 AKS 或 EKS 中适用于 Apigee Hybrid 的工作负载身份联合。

默认值：None

如果已启用备份且 cassandra.backup.cloudProvider 设置为 HYBRID，则为必需。

可以是指向 apigee 用户主目录的绝对路径或相对路径。

备份 SSH 服务器上备份目录的名称。

默认值：apigeecluster

指定 Cassandra 集群的名称。

默认值：dc-1

指定 Cassandra 节点的数据中心。

默认值：None

将 hostNetwork 设置为 true 时，DNS 政策会设置为 ClusterFirstWithHostNet。

默认值：None

Cassandra 集群节点的主机名或 IP。如果未设置，则使用 Kubernetes 本地服务。

默认值：100M

分配给较新对象的 JVM 系统内存量，以兆字节为单位。

默认值：false

启用 Kubernetes hostNetwork 功能。如果集群之间的 pod 网络命名空间没有连接（集群以“孤岛网络模式”运行），则 Apigee 会在多区域安装中使用此功能在 pod 之间进行通信。前者是非 GKE 安装中的默认情况，包括 Google Distributed Cloud on VMware 或 Bare Metal、GKE on AWS、AKS、EKS 和 OpenShift。

对于单区域安装和不同集群的 pod 间有连接的多区域安装（例如 GKE 安装），将 cassandra.hostNetwork 设置为 false。

对于不同集群的 pod 之间没有通信的多区域安装（例如 Google Distributed Cloud on VMware 或 bare metal、GKE on AWS、AKS、EKS 和 OpenShift 安装），将 cassandra.hostNetwork 设置为 true。请参阅多区域部署：前提条件。

为 true 时，DNS 政策会自动设置为 ClusterFirstWithHostNet。

默认值：IfNotPresent

确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括：

• IfNotPresent：如果新映像已存在，则请勿提取它。
• Always：始终提取映像，无论它是否已经存在。

如需了解详情，请参阅更新映像。

默认值：1.12.4

此服务 Docker 映像的版本标签。

默认值：None

此服务的 Docker 映像的位置。

使用 apigee-pull-push --list 查看此组件的当前仓库网址。

默认值：512M

可用于 Cassandra 操作的 JVM 系统内存的上限（以 MB 为单位）。

默认值：None

现有 Cassandra 集群的 IP 地址，用于将现有集群扩展到新地区。请参阅配置多区域种子主机。

默认值：None

必需

节点选择器标签键，用于定位 cassandra 数据服务的专用 Kubernetes 节点。

请参阅配置专用节点池。

默认值：None

可选的节点选择器标签值，用于定位 cassandra 数据服务的专用 Kubernetes 节点并替换 nodeSelector.apigeeData 设置。

请参阅 nodeSelector。

默认值：9042

用于连接到 Cassandra 的端口号。

默认值：ra-1

指定 Cassandra 节点的 Rack。

默认值：2

Kubernetes 将验证将 Pod 标记为“未就绪”前，就绪探测失败的次数。最小值为 1。

默认值：0

就绪探测启动前，容易开始后经过的秒数。

默认值：10

确定执行就绪探测的频率，以秒为单位。最小值为 1。

默认值：1

在失败后，被认为成功就绪探测需要的最小持续成功次数。最小值为 1。

默认值：5

活跃探测超时后的秒数。最小值为 1。

默认值：1

Cassandra 是一个副本数据库。此属性用于指定用作 StatefulSet 的 Cassandra 节点的数量。

默认值：500m

Kubernetes 容器中资源正常运行所需的 CPU，以毫秒为单位。

默认值：1Gi

在 Kubernetes 容器中资源正常运行所需的内存，以兆比字节为单位。

默认值：GCP

恢复提供方的名称。支持的值：GCP、HYBRID 和 CSI。将值设置为：

• GCP 用于从存储在 Google Cloud Storage 中的备份恢复数据。
• HYBRID，用于从存储在远程 SSH 服务器上的备份恢复数据。
• CSI（推荐），用于利用 Kubernetes CSI 卷快照进行恢复。如需了解适用于 Google Cloud、AWS 和 Azure 等云平台的 CSI 备份和恢复，请参阅 CSI 备份和恢复。

默认值：None

如果已启用恢复且 cassandra.restore.cloudProvider 设置为 GCP，则为必需。

必须采用 gs://BUCKET_NAME 格式（必须使用 gs:// 前缀）。

存储要用于数据恢复的备份归档的 Google Cloud Storage 存储桶的名称。

默认值：false

数据恢复功能默认未启用。要启用该功能，请设置为 true。

请参阅 Cassandra 备份和恢复。

默认值：IfNotPresent

确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括：

• IfNotPresent：如果新映像已存在，则请勿提取它。
• Always：始终提取映像，无论它是否已经存在。

如需了解详情，请参阅更新映像。

默认值：1.12.4

此服务 Docker 映像的版本标签。

默认值：None

此服务的 Docker 映像的位置。

使用 apigee-pull-push --list 查看此组件的当前仓库网址。

默认值：None

具有 Storage Object Admin (roles/storage.objectAdmin) 角色的 Google 服务账号密钥文件的路径。此 Google 服务账号将会用于从指定的 cassandra.restore.dbStorageBucket 下载备份归档。

如果已启用恢复功能，并且 cassandra.restore.cloudProvider 已设为 GCP，则必须满足以下条件之一，以确保 Apigee Hybrid 能够访问 Google Cloud Storage 存储桶以下载备份归档进行恢复：

• 已指定 cassandra.restore.serviceAccountPath。
• 已指定 cassandra.restore.serviceAccountRef。
• 已配置 GKE 中适用于 Apigee Hybrid 的 Workload Identity。
• 已配置 AKS 或 EKS 中适用于 Apigee Hybrid 的工作负载身份联合。

默认值：None

现有 Kubernetes Secret 的名称，该 Secret 用于存储具有 Storage Object Admin (roles/storage.objectAdmin) 角色的 Google 服务账号密钥文件的内容。此 Google 服务账号将会用于从指定的 cassandra.restore.dbStorageBucket 下载备份归档。

如果已启用恢复功能，并且 cassandra.restore.cloudProvider 已设为 GCP，则必须满足以下条件之一，以确保 Apigee Hybrid 能够访问 Google Cloud Storage 存储桶以下载备份归档进行恢复：

• 已指定 cassandra.restore.serviceAccountPath。
• 已指定 cassandra.restore.serviceAccountRef。
• 已配置 GKE 中适用于 Apigee Hybrid 的 Workload Identity。
• 已配置 AKS 或 EKS 中适用于 Apigee Hybrid 的工作负载身份联合。

默认值：None

如果恢复已启用，则必须提供。

应恢复的备份的时间戳。

默认值：None

系统上指向 TLS 证书文件的路径。

默认值：None

在系统上指向 TLS 私钥文件的路径。

默认值：None

根 CA（证书授权机构）的证书链。

默认值：10Gi

如果指定了 storage.storageclass，则必须使用此属性

指定所需的磁盘大小，以兆比字节 (Mi) 或吉比字节 (Gi) 为单位。

默认值：None

指定正在使用的本地存储空间类别。

默认值：10Gi

如果指定了 storage.storageclass，则必须使用此属性

指定所需的磁盘大小，以兆比字节 (Mi) 或吉比字节 (Gi) 为单位。

默认值：300

请求删除 Pod 与终止 Pod 之间的时间，以秒为单位。在此期间，将执行任何预停止钩子，并且所有正在运行的进程都应正常终止。

默认值：None

使用 Kubernetes 的污点和容忍功能所必需的属性。

effect 指定将容忍与污点匹配的影响。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

如需了解详情，请参阅污点和容忍：概念。

默认值：None

使用 Kubernetes 的污点和容忍功能所必需的属性。

key 标识可以应用容忍的 Pod。

如需了解详情，请参阅污点和容忍：概念。

默认值："Equal"

使用 Kubernetes 的污点和容忍功能所必需的属性。

operator 指定用于触发 effect 的操作。operator 的值可以是：

• Equal 匹配 value 中设置的值。
• Exists 忽略 value 中设置的值。

如需了解详情，请参阅污点和容忍：概念。

默认值：None

供 Kubernetes 的污点和容忍功能使用。

tolerationSeconds 定义 Pod 与故障节点或无响应节点绑定的时长，以秒为单位。

如需了解详情，请参阅污点和容忍：概念。

默认值：None

供 Kubernetes 的污点和容忍功能使用。

value 是在 operator 设置为 Equal 时触发 effect 的值。

如需了解详情，请参阅污点和容忍：概念。

默认值：cert-manager

cert-manager 的命名空间。

请参阅在自定义命名空间中运行 cert-manager。

默认值：None

用于为 pod 添加注释的可选键值对映射。如需了解详情，请参阅自定义注释。

默认值：None

仅限 Helm：使用 Helm 图表在 GKE 集群上启用 Workload Identity 时，connectAgent 用于与相应的 Kubernetes 服务账号关联的 Google IAM 服务账号 (GSA) 的电子邮件地址。将 gcp.workloadIdentity.enabled 设置为 true 时设置此项。

GSA 电子邮件地址通常采用以下格式：

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

例如：

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

请参阅在 GKE 上启用 Workload Identity 或在 AKS 和 EKS 上启用工作负载身份联合。

默认值：INFO

日志报告的级别。包含以下值：

• INFO：除了警告、错误和严重消息之外的参考消息。最适用于调试。
• WARNING：除错误消息和严重消息外的非严重警告。
• ERROR：除了严重消息外，不会返回给用户的内部错误和错误。
• FATAL：可能会导致 Apigee Connect 崩溃且不可恢复的错误和事件。

默认值：IfNotPresent

确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括：

• IfNotPresent：如果新映像已存在，则请勿提取它。
• Always：始终提取映像，无论它是否已经存在。

如需了解详情，请参阅更新映像。

默认值：1.12.4

此服务 Docker 映像的版本标签。

默认值：None

此服务的 Docker 映像的位置。

使用 apigee-pull-push --list 查看此组件的当前仓库网址。

默认值：5

可用于自动扩缩的副本数上限。

默认值：1

可自动扩缩的副本数下限。

在生产环境中，您可能需要将 replicaCountMin 增加到 1，以便增加与控制平面的连接数量，从而实现可靠性和可伸缩性。

默认值：512m

Kubernetes 容器中资源的 CPU 限制，以毫米为单位。

默认值：512Mi

Kubernetes 容器中资源的内存限制，以字节为单位。

默认值：100m

Kubernetes 容器中资源正常运行所需的 CPU，以毫秒为单位。

默认值：30Mi

在 Kubernetes 容器中资源正常运行所需的内存，以兆比字节为单位。

默认值：apigeeconnect.googleapis.com:443

此服务的服务器和端口的位置。

默认值：None

必须提供 serviceAccountPath 或 serviceAccountRef 之一。

apigee-mart 服务账号的 Google 服务账号密钥文件的路径。

在大多数安装中，connectAgent.serviceAccountPath 的值必须与 mart.serviceAccountPath 的值匹配。

默认值：None

必须提供 serviceAccountPath 或 serviceAccountRef 之一。

在大多数安装中，connectAgent.serviceAccountRef 的值必须与 mart.serviceAccountRef 的值匹配。

默认值：75

pod 上 Apigee Connect 代理的目标 CPU 利用率。在 CPU 利用率达到此值（最多 replicaCountMax）时，此字段值启用 Apigee Connect 以自动扩缩。

默认值：600

请求删除 Pod 与终止 Pod 之间的时间，以秒为单位。在此期间，将执行任何预停止钩子，并且所有正在运行的进程都应正常终止。

默认值：None

使用 Kubernetes 的污点和容忍功能所必需的属性。

effect 指定将容忍与污点匹配的影响。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

如需了解详情，请参阅污点和容忍：概念。

默认值：None

使用 Kubernetes 的污点和容忍功能所必需的属性。

key 标识可以应用容忍的 Pod。

如需了解详情，请参阅污点和容忍：概念。

默认值："Equal"

使用 Kubernetes 的污点和容忍功能所必需的属性。

operator 指定用于触发 effect 的操作。operator 的值可以是：

• Equal 匹配 value 中设置的值。
• Exists 忽略 value 中设置的值。

如需了解详情，请参阅污点和容忍：概念。

默认值：None

供 Kubernetes 的污点和容忍功能使用。

tolerationSeconds 定义 Pod 与故障节点或无响应节点绑定的时长，以秒为单位。

如需了解详情，请参阅污点和容忍：概念。

默认值：None

供 Kubernetes 的污点和容忍功能使用。

value 是在 operator 设置为 Equal 时触发 effect 的值。

如需了解详情，请参阅污点和容忍：概念。

默认值：aWxvdmVhcGlzMTIzNDU2Nw==

KMS 中组织的默认加密密钥。

默认值：aWxvdmVhcGlzMTIzNDU2Nw==

KVM 中组织的默认加密密钥。

默认值：aWxvdmVhcGlzMTIzNDU2Nw==

KMS 中环境 (env) 的默认加密密钥。

默认值：aWxvdmVhcGlzMTIzNDU2Nw==

KVM 中环境（env）的默认加密密钥。

默认值：aWxvdmVhcGlzMTIzNDU2Nw==

环境 (env) 的默认缓存加密密钥。

默认值：None

必需

用于存储诊断数据的 Google Cloud 存储桶的名称。

请参阅创建存储桶。

默认值：None

必需

这用于指定要从中捕获数据的 pod 类型。这些值可以是以下值之一：

• "apigee-cassandra" 会捕获 Cassandra 数据存储库的数据。istio-cassandra pod 在 apigee 命名空间中运行。
• "apigee-mart-server" 会捕获有关 MART 的数据。apigee-mart-server pod 在 apigee 命名空间中运行。
• "apigee-runtime" 会捕获有关消息处理器的数据。apigee-runtime pod 在 apigee 命名空间中运行。
• "apigee-synchronizer" 会捕获有关同步器的数据。apigee-synchronizer pod 在 apigee 命名空间中运行。
• "apigee-udca" 会捕获有关 UDCA 的数据。apigee-udca pod 在 apigee 命名空间中运行。
• "apigee-watcher" 捕获有关 Watcher 的数据。apigee-watcher pod 在 apigee 命名空间中运行。
• "istio-proxy" 会捕获有关 Istio 入站流量网关的数据。istio-proxy pod 在 istio-system 命名空间中运行。

默认值：None

如果诊断收集操作为“LOGGING”（使用 operation: "LOGGING" 设置）时为必需

收集的日志数据的时长（以毫秒为单位）。典型值为 30000。

参见diagnostic.operation

默认值：None

如果诊断收集操作为“LOGGING”（使用 operation: "LOGGING" 设置）时为必需

按名称指定从哪个日志记录器收集数据。对于 Apigee Hybrid 1.6.0 版，唯一支持的值是 ALL，即所有记录器。例如：

diagnostic:
 loggingDetails:
   loggerNames:
   - ALL

默认值：None

如果诊断收集操作为“LOGGING”（使用 operation: "LOGGING" 设置）时为必需

指定要收集的日志记录数据的粒度。在 Apigee Hybrid 1.6 中，仅支持 FINE。

默认值：None

必需

您从中收集数据的 pod 所在的 Kubernetes 命名空间。命名空间必须是您使用 diagnostic.container 指定的容器的正确命名空间：

apigee 为

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

istio-system 为

• istio-proxy

默认值：None

必需

指定是收集所有统计信息还是仅收集日志。

有效值包括：

• "ALL"
• "LOGGING"

  如果将 diagnostic.operation 设置为 "LOGGING"，则需要以下属性：

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

默认值：None

必需

要为其收集数据的 Kubernetes pod 的名称。例如：

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

默认值：None

必需

具有 Storage Admin 角色 (roles/storage.admin) 的服务账号的密钥文件 (.json) 的路径。在大多数 Apigee Hybrid 安装中，这是 apigee-cassandra 服务账号。

请参阅服务账号简介。

默认值：None

如果使用 diagnostic.tcpDumpDetails，则必需选择diagnostic.tcpDumpDetails.maxMsgs 或 diagnostic.tcpDumpDetails.timeoutInSeconds。

设置要收集的最大 tcpDump 消息数。Apigee 建议的最大值不超过 1000。

默认值：None

如果使用 diagnostic.tcpDumpDetails，则必需选择diagnostic.tcpDumpDetails.maxMsgs 或 diagnostic.tcpDumpDetails.timeoutInSeconds。

设置等待 tcpDump 返回消息的时间（以秒为单位）。

默认值：None

如果您使用的是 diagnostic.threadDumpDetails，则 diagnostic.threadDumpDetails.delayInSeconds 和 diagnostic.threadDumpDetails.iterations必需的。

收集每个线程转储之间的延迟时间（以秒为单位）。

默认值：None

如果您使用的是 diagnostic.threadDumpDetails，则 diagnostic.threadDumpDetails.delayInSeconds 和 diagnostic.threadDumpDetails.iterations必需的。

要收集的 jstack 线程转储迭代的次数。

默认值：None

必须提供 cacheEncryptionKey、cacheEncryptionPath 或 cacheEncryptionSecret 之一。

base64 编码的加密密钥。请参阅数据加密。

默认值：None

必须提供 cacheEncryptionKey、cacheEncryptionPath 或 cacheEncryptionSecret 之一。

包含 base64 编码的加密密钥的文件的路径。请参阅数据加密。

默认值：None

必须提供 cacheEncryptionKey、cacheEncryptionPath 或 cacheEncryptionSecret 之一。

包含 base64 编码的加密密钥的 Kubernetes Secret 的密钥。请参阅数据加密。

默认值：None

必须提供 cacheEncryptionKey、cacheEncryptionPath 或 cacheEncryptionSecret 之一。

包含 base64 编码的加密密钥的 Kubernetes Secret 的名称。请参阅数据加密。

默认值：4

自动扩缩的副本数上限。 如果指定，则替换 runtime.replicaCountMax。

默认值：1

自动扩缩的副本数下限。 如果指定，则替换 runtime.replicaCountMin。

默认值：4

自动扩缩的副本数上限。 如果指定，则替换 synchronizer.replicaCountMax。

默认值：1

自动扩缩的副本数下限。 如果指定，则替换 synchronizer.replicaCountMin。

默认值：4

自动扩缩的副本数上限。 如果指定，则替换 udca.replicaCountMax。

默认值：1

自动扩缩的副本数下限。 如果指定，则替换 udca.replicaCountMin。

默认值：None

仅限 Helm：使用 Helm 图表在 GKE 集群上启用 Workload Identity 时，与相应的 Kubernetes 服务账号关联的运行时 Google IAM 服务账号的电子邮件地址。

请参阅在 GKE 上启用 Workload Identity 或在 AKS 和 EKS 上启用工作负载身份联合。

默认值：None

仅限 Helm：使用 Helm 图表在 GKE 集群上启用 Workload Identity 时，与相应的 Kubernetes 服务账号关联的同步器 Google IAM 服务账号的电子邮件地址。

请参阅在 GKE 上启用 Workload Identity 或在 AKS 和 EKS 上启用工作负载身份联合。

默认值：None

仅限 Helm：使用 Helm 图表在 GKE 集群上启用 Workload Identity 时，env 范围的 udca 用于与相应的 Kubernetes 服务账号关联的 udca Google IAM 服务账号的电子邮件地址。

请参阅在 GKE 上启用 Workload Identity 或在 AKS 和 EKS 上启用工作负载身份联合。

默认值：None

Deprecated：从 Hybrid 1.4 版开始，运行时平面会从管理平面接收此信息。请参阅环境和环境组简介。

默认值：None

指定运行 HTTP 代理的主机名或 IP 地址。

按 scheme、host 和 port 的顺序列出 httpProxy 属性。例如：

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

另请参阅：为 API 代理配置转发代理。

默认值：None

指定运行 HTTP 代理的端口。如果省略此属性，默认情况下，它将使用端口 80（用于 HTTP）和端口 443（用于 HTTPS）。

默认值：HTTPS

将 HTTP 代理的类型指定为 HTTP 或 HTTPS。默认情况下，它使用 HTTPS。

默认值：None

如果 HTTP 代理需要基本身份验证，则使用此属性提供用户名。

默认值：None

如果 HTTP 代理需要基本身份验证，则使用此属性提供密码。

默认值：None

必需

要同步的 Apigee 环境名称。

默认值：None

用于轮询组织和环境同步更改的时间间隔，以秒为单位。

默认值：None

HTTPS 流量的 TCP 端口号。

默认值：None

具有 Cloud Trace Agent 角色的 Google 服务账号（通常是 apigee-runtime 服务账号）密钥的本地系统文件路径。请参阅关于服务账号，了解服务账号的默认名称及其分配的角色。

默认值：None

具有 Apigee Synchronizer Manager 角色的 Google 服务账号密钥本地系统文件的路径。

默认值：None

具有 Apigee Analytic Agent 角色的 Google 服务账号密钥本地系统文件的路径。

仅当 orgScopedUDCA 设置为 false 时才设置此属性。

默认值：None

在 Vault 中存储服务账号密钥的环境专属 Secret 提供方类 (SecretProviderClass) 的名称。

请参阅在 Hashicorp Vault 中存储服务账号密钥。

默认值：None

Kubernetes Secret 的名称。您必须使用具有 Cloud Trace Agent 角色的 Google 服务账号密钥作为输入来创建 Secret。

默认值：None

Kubernetes Secret 的名称。您必须使用具有 Apigee Synchronizer Manager 角色的 Google 服务账号密钥作为输入来创建 Secret。

默认值：None

Kubernetes Secret 的名称。您必须使用具有 Apigee Analytic Agent 角色的 Google 服务账号密钥作为输入来创建 Secret。

仅当 orgScopedUDCA 设置为 false 时才设置此属性。

默认值：None

必须提供 sslCertPath/sslKeyPath 或 sslSecret。

系统上指向 TLS 证书文件的路径。

默认值：None

必须提供 sslCertPath/sslKeyPath 或 sslSecret。

在系统上指向 TLS 私钥文件的路径。

默认值：None

必须提供 sslCertPath/sslKeyPath 或 sslSecret。

包含 TLS 证书和私钥的 Kubernetes Secret 中存储的文件的名称。您必须使用 TLS 证书和密钥数据作为输入来创建 Secret。

另请参阅：

• 在 Kubernetes Secret 中存储数据
• Kubernetes 文档中的 Secret
• Kubernetes 文档中的使用 kubectl 创建 Secret

默认值：None

非 GKE 平台上工作负载身份提供方允许的目标对象。

请参阅在 AKS 和 EKS 上启用工作负载身份联合。

默认值：None

工作负载身份联合用来获取服务账号凭据的凭据源文件的文件名和路径。这是在使用 create-cred-config 命令配置工作负载身份联合时为 credential-source-file 提供的值。

请参阅在 AKS 和 EKS 上启用工作负载身份联合。

默认值：false

在非 GKE 平台上启用工作负载身份联合。如果在同一个集群中将 gcp.workloadIdentity.enabled 设置为 true，则不得设置为 true。

请参阅在 AKS 和 EKS 上启用工作负载身份联合。

默认值：3600

令牌的生命周期（以秒为单位）。

请参阅在 AKS 和 EKS 上启用工作负载身份联合。

默认值：None

必需

标识 apigee-logger 和 apigee-metrics 推送其数据的 Google Cloud 项目。

默认值：None

标识运行时 Kubernetes 集群项目。

projectIDRuntime 是可选属性。如果不使用此属性，则假定 Apigee 组织的 Google Cloud 项目和运行时 K8S 集群的项目均使用 projectID 值。

默认值：us-central1

必需

标识 apigee-logger 和 apigee-metrics 推送其数据的 Google Cloud 区域。

默认值：false

仅限 Helm：支持在 GKE 上使用 Workload Identity。Workload Identity 允许 GKE 集群中的工作负载模拟 Identity and Access Management (IAM) 服务账号来访问 Google Cloud 服务。

如果在同一个集群中将 gcp.federatedWorkloadIdentity.enabled 设置为 true，则不得设置为 true。

当 enabled 为 false（即默认值）时，Apigee 会为每个 Apigee Hybrid 组件使用 IAM 服务账号。请参阅服务账号简介。

当 workloadIdentityEnabled 为 true 时，Apigee 会使用 Kubernetes 服务账号并将其映射到每个组件的相应 IAM 服务账号。 使用以下项指定要映射到 Kubernetes 服务账号的 IAM 服务账号：

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

默认值：None

仅限 Helm：使用 Helm 图表在 GKE 集群上启用 Workload Identity 时，所有组件用于与相应的 Kubernetes 服务账号关联的 Google IAM 服务账号 (GSA) 的电子邮件地址。将 gcp.workloadIdentity.enabled 设置为 true 时设置此项。

gcp.workloadIdentity.gsa 适用于所有 Hybrid 组件。如果您为 gcp.workloadIdentity.gsa 指定了值，则无需为任何单个 Hybrid 组件提供 GSA。如果您为单个组件提供了 GSA，则该组件的 GSA 将仅为该组件替换 gcp.workloadIdentity.gsa。

GSA 电子邮件地址通常采用以下格式：

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

例如：

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

请参阅 Enabling Workload Identity on GKE。

默认值：false

仅限 apigeectl：使用 Workload Identity 启用。Workload Identity 允许 GKE 集群中的工作负载模拟 Identity and Access Management (IAM) 服务账号来访问 Google Cloud 服务。

当 workloadIdentityEnabled 为 false（即默认值）时，Apigee 会为每个 Apigee Hybrid 组件使用 IAM 服务账号。请参阅服务账号简介。

当 workloadIdentityEnabled 为 true 时，Apigee 会使用 Kubernetes 服务账号而不是 IAM 服务账号，并忽略以下配置属性：

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

默认值：None

HTTP 代理的主机名。

默认值：None

HTTP 代理的端口。

默认值：HTTPS

代理使用的方案。值可以是 HTTP 或 HTTPS。值只能为大写。

默认值：None

如果 HTTP 代理需要基本身份验证，则使用此属性提供用户名。

默认值：None

如果 HTTP 代理需要基本身份验证，则使用此属性提供密码。

默认值：None

必需

入站流量网关的名称。其他服务将使用此名称来访问网关的流量。名称必须符合以下要求：

• 长度不得超过 17 个字符
• 只能包含小写字母数字字符、'-' 或 '.'。
• 以字母数字字符开头
• 以字母数字字符结尾

如需了解详情，请参阅 Kubernetes 文档中的 DNS 子网域名称。

默认值：2000m

资源的 CPU 限制，以毫核为单位。

默认值：1Gi

资源的内存限制，以兆比字节 (MiB) 为单位。

默认值：300m

资源正常运行所需的 CPU，以毫核为单位。

默认值：128Mi

资源的正常操作所需的内存，以兆比字节为单位。

默认值：10

Hybrid 可以为可用于自动缩放的入口流量网关自动添加的最大 Pod 数量。

默认值：2

可用于自动扩缩的入站流量网关的 Pod 数下限。

默认值：None

可选键值对映射，用于在支持注释的平台上为入站流量网关添加注释。例如：

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

默认值：None

在支持指定负载均衡器 IP 地址的平台上，将使用此 IP 地址创建负载均衡器。在不允许指定负载均衡器 IP 地址的平台上，系统会忽略此属性。

默认值：LoadBalancer

用于更改入站流量部署的默认 k8s 服务的类型。如果要停用创建默认负载均衡器的功能，请将值设置为 ClusterIP。可能的值：

• ClusterIP
• LoadBalancer

默认值：75

用于扩缩 ReplicaSet 中 pod 数量的 CPU 使用率的阈值，表示为占可用 CPU 资源的百分比。

当 CPU 使用率超过此值时，混合将逐步增加 ReplicaSet 中的 pod 数，最高可达 ingressGateways[].replicaCountMax。

如需详细了解如何在 Kubernetes 中进行扩缩，请参阅 Kubernetes 文档中的 Pod 横向自动扩缩部分。

默认值：None

使用 Kubernetes 的污点和容忍功能所必需的属性。

effect 指定将容忍与污点匹配的影响。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

如需了解详情，请参阅污点和容忍：概念。

默认值：None

使用 Kubernetes 的污点和容忍功能所必需的属性。

key 标识可以应用容忍的 Pod。

如需了解详情，请参阅污点和容忍：概念。

默认值："Equal"

使用 Kubernetes 的污点和容忍功能所必需的属性。

operator 指定用于触发 effect 的操作。operator 的值可以是：

• Equal 匹配 value 中设置的值。
• Exists 忽略 value 中设置的值。

如需了解详情，请参阅污点和容忍：概念。

默认值：None

供 Kubernetes 的污点和容忍功能使用。

tolerationSeconds 定义 Pod 与故障节点或无响应节点绑定的时长，以秒为单位。

如需了解详情，请参阅污点和容忍：概念。

默认值：None

供 Kubernetes 的污点和容忍功能使用。

value 是在 operator 设置为 Equal 时触发 effect 的值。

如需了解详情，请参阅污点和容忍：概念。

默认值：/dev/stdout

入站流量访问日志的文件地址，例如 /dev/stdout。

保留此值未定义，将停用访问日志记录。

入站流量访问日志的格式。

保留此值未定义，将导致使用代理的默认访问日志格式。

默认访问日志格式：

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

以下是默认访问日志格式的副本，添加了换行符以提高可读性。

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

默认值：SANITIZE_SET

确定 Envoy 代理（用于 Apigee 入站流量网关）如何处理 x-forwarded-client-cert (XFCC) HTTP 标头。

可能的值包括：

• SANITIZE_SET：（默认值）当客户端连接是 mTLS 时，使用客户端证书信息重置 XFCC 标头，并将其发送到下一个跃点。
• FORWARD_ONLY：当客户端连接是 mTLS（双向 TLS）时，仅转发请求中的 XFCC 标头。
• APPEND_FORWARD：当客户端连接是 mTLS 时，将客户端证书信息附加到请求的 XFCC 标头并转发。
• SANITIZE：不转发 XFCC 标头。
• ALWAYS_FORWARD_ONLY：无论客户端连接是否是 mTLS，都始终转发请求中的 XFCC 标头。

如需详细了解这些值，请查看 Envoy 文档中的 Enum extensions.filters.network.http_connection_manager.v3.HttpConnectionManager.ForwardClientCertDetails。

如果您在安装 Hybrid 后更改此设置，请使用 apigeectl init 应用此设置，然后重启 Apigee 入站流量网关 pod。

默认值：

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

通过替换 Hybrid 中的默认用户代理许可名单，让非Google Cloud loadbalancer 能够检查入站流量网关的健康检查端点（/healthz/ingress 和 /healthz）。

如需替换指定的默认用户代理，请使用以下语法，并插入自定义用户代理：

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

如需移除用户代理要求，请使用以下命令：

istiod:
  healthCheckUserAgents: []

默认值：IfNotPresent

确定 kubelet 何时提取 pod 的 Docker 映像。可能的值包括：

• IfNotPresent：如果新映像已存在，则请勿提取它。
• Always：始终提取映像，无论它是否已经存在。

如需了解详情，请参阅更新映像。

默认值：1.18.7-asm.4-distroless

此服务 Docker 映像的版本标签。

默认值：None

此服务的 Docker 映像的位置。

使用 apigee-pull-push --list 查看此组件的当前仓库网址。

默认值：None

使用 Kubernetes 的污点和容忍功能所必需的属性。

effect 指定将容忍与污点匹配的影响。effect 的值可以是：

• NoExecute
• NoSchedule
• PreferNoSchedule

如需了解详情，请参阅污点和容忍：概念。

默认值：None

使用