第 3 步：配置 GKE 集群

指定配置替换

Apigee Hybrid 安装程序使用许多设置的默认值；但是，有几项设置没有默认值。如下文所述，您必须为这些设置提供值。

确保您位于 hybrid-base-directory/hybrid-files 目录中。
将 overrides-small.yaml 文件从 $APIGEECTL_HOME/examples 目录复制到 overrides 目录：
```
cp $APIGEECTL_HOME/examples/overrides-small.yaml ./overrides/overrides.yaml
```
此示例文件为小规模混合运行时安装提供基本配置，即适用于第一次安装的配置。
将 cd 复制到 overrides 目录：

cd overrides

打开 overrides.yaml 并添加所需属性值（如下所示）。每个属性的详细说明也在下面提供：

注意：务必设置 logger:enabled:false 来在替换文件中停用日志记录。默认情况下，作为 GKE 的一部分提供日志记录。

语法

overrides.yaml 文件具有以下结构和语法。red, bold italics 中的值是您必须提供的属性值。下表中介绍了它们。

gcp:
  region: gcp-region
  projectID: gcp-project-id

k8sCluster:
  name: cluster-name
  region: cluster-region

org: org-name

virtualhosts:
  - name: virtual-host-name
    hostAliases:
      - "host-alias-1"
      - "host-alias-2"
      - "host-alias-n"
    sslCertPath: ./certs/cert-name.pem
    sslKeyPath: ./certs/key-name.key
    routingRules:
      - paths:
        - /path-1
        - /path-2
        - /path-n
        env: environment-name

envs:
  - name: environment-name          # The same name of the env you created in the UI
    serviceAccountPaths:
      synchronizer: ./service-accounts/synchronizer-service-account-name.json
      udca: ./service-accounts/udca-service-account-name.json

mart:
  hostAlias: mart-host-alias
  serviceAccountPath: ./service-accounts/mart-service-account-name.json
  sslCertPath: ./certs/mart-cert-name.pem
  sslKeyPath: ./certs/mart-key-name.key

metrics:
  serviceAccountPath: ./service-accounts/metrics-service-account-name.json

logger:
  enabled: false

示例

以下示例展示了一个添加了示例属性值的已完成替换文件：

gcp:
  region: us-central1
  projectID: my-gcp-project

k8sCluster:
  name: apigee-hybrid
  region: us-central1

org: hybrid-org

virtualhosts:
  - name: default
    hostAliases:
      - "*.acme.com"
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key
    routingRules:
      # - paths:
      - env: my-environment

envs:
  - name: test
    serviceAccountPaths:
      synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
      udca: ./service-accounts/hybrid-project-apigee-udca.json

mart:
  hostAlias: "mart.apigee-hybrid-docs.net"
  serviceAccountPath: ./service-accounts/hybrid-project-apigee-mart.json
  sslCertPath: ./certs/fullchain.pem
  sslKeyPath: ./certs/privkey.key

metrics:
  serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json

logger:
  enabled: false

完成后，保存文件。

下表介绍了您必须在替换文件中提供的每个属性值。如需了解详情，请参阅配置属性参考。

变量	说明
`gcp-region`	标识 `apigee-logger` 和 `apigee-metrics` 推送其数据的 GCP 地区。
`gcp-project-id`	标识 `apigee-logger` 和 `apigee-metrics` 推送其数据的 Google Cloud 项目。
`cluster-name`	您的 Kubernetes 集群名称。
`cluster-region`	创建集群的地区。
`org-name`	您的 Apigee Hybrid 组织的名称。
`virtual-host-name`	用于标识虚拟主机的名称。
`host-alias (1 - n)`	（必需）环境的限定 DNS 名称。您可以使用 `.foo.com` 之类的部分通配符。不允许使用通用通配符 `""`。
`cert-name` `key-name`	输入您之前在为运行时网关创建 TLS 凭据步骤中生成的自签名 TLS 密钥和证书文件的名称。这些文件必须位于 `base_directory/hybrid-files/certs` 目录中。例如： sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key
`path (1 - n)`	路由规则会将所提供路径的 API 调用定向到提到的环境。`path-1` 到 `path-n` 是部署在名为 `environment-name` 的环境中的 API 代理的基本路径。 `paths:` 为可选项。默认路径为 /。另请参阅配置虚拟主机。注意：目前不需要 `paths:`。删除或注释 `paths:` 和任何路径条目。
`environment-name` （在 `routingRules` 下方）	这是要将 API 调用路由到的环境。使用在界面中创建环境时使用的名称，如第 5 步：在混合界面中添加新环境中所述。如果您已注释或删除 `path` 条目，请确保 `env` 以与 `routingRules` 下方对齐的短划线开头，例如： routingRules: - env: my-environment 。
`environment-name`	使用在界面中创建环境时使用的名称，如第 5 步：在混合界面中添加新环境中所述。
`synchronizer-service-account-name`	您使用 `create-service-account` 工具生成的同步器服务账号密钥文件的名称。例如： synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
`udca-service-account-name`	您使用 `create-service-account` 工具生成的 udca 服务账号密钥文件的名称。例如： udca: ./service-accounts/hybrid-project-apigee-udca.json
`mart-host-alias`	MART 服务器端点的限定 DNS 名称。此名称必须与此配置所需的授权 TLS 证书中使用的公用名 (CN) 匹配。例如：`mart.mydomain.com` 注意：证书中的公用名 (CN) 必须与在 `mart.hostAlias` 属性中指定的值匹配。如果 CN 是 `*.hybrid-domain.net` 且您已注册主机 `mart.hybrid-domain.net`，则需要将 `mart.hostAlias` 设置为值 `mart.hybrid-domain.net`。
`mart-service-account-name`	您使用 `create-service-account` 工具生成的 mart 服务账号密钥文件的名称。
`mart-cert-name` `mart-key-name`	输入您之前在为 MART 网关创建 TLS 凭据步骤中生成的授权 TLS 密钥和证书文件的名称。这些文件必须位于 `base_directory/hybrid-files/certs` 目录中。例如： sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.key
`metrics-service-account-name`	您使用 `create-service-account` 工具生成的指标服务账号密钥文件的名称。例如： serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json

摘要

配置文件指示 Kubernetes 如何将混合组件部署到集群。接下来，您需要将此配置应用于您的集群。

下一步

1 2 3 （下一步）第 4 步：安装 Hybrid 运行时