Paso 3: Configura el clúster de GKE

Especifica anulaciones de configuración

El instalador híbrido de Apigee usa los valores predeterminados para muchos parámetros de configuración. Sin embargo, hay algunos parámetros de configuración que no tienen valores predeterminados. Debes proporcionar valores para estos parámetros de configuración, como se explica a continuación.

Asegúrate de que estés en el directorio hybrid-base-directory/hybrid-files.
Copia el archivo overrides-small.yaml del directorio $APIGEECTL_HOME/examples a tu directorio overrides:
```
cp $APIGEECTL_HOME/examples/overrides-small.yaml ./overrides/overrides.yaml
```
Este archivo de ejemplo proporciona una configuración básica para una instalación de entorno de ejecución híbrido de huella pequeña, una configuración adecuada para tu primera instalación.
cd en el directorio overrides:

cd overrides

Abre overrides.yaml y agrega los valores de propiedad necesarios que se muestran a continuación. También se proporciona una descripción detallada de cada propiedad a continuación:

NOTA : Asegúrate de inhabilitar el registro en el archivo de anulaciones mediante la configuración de logger:enabled:false. Los registros se proporcionan de forma predeterminada como parte de GKE.

Sintaxis

El archivo overrides.yaml tiene la siguiente estructura y sintaxis. Los valores en red, bold italics son los valores de propiedad que debes proporcionar. Se describen en la siguiente tabla.

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

Ejemplo

En el ejemplo siguiente, se muestra un archivo de anulación completo con valores de propiedad de ejemplo agregados:

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

Cuando termines, guarda el archivo.

En la siguiente tabla, se describe cada uno de los valores de propiedad que debes proporcionar en el archivo de anulación. Para obtener más información, consulta Referencia de la propiedad de configuración.

Variable	Descripción
`gcp-region`	Identifica la región de GCP en la que `apigee-logger` y `apigee-metrics` envían sus datos.
`gcp-project-id`	Identifica el proyecto de Google Cloud en el que `apigee-logger` y `apigee-metrics` envían sus datos.
`cluster-name`	El nombre de tu clúster de Kubernetes.
`cluster-region`	La región en la que se creó el clúster.
`org-name`	El nombre de tu organización de Apigee Hybrid.
`virtual-host-name`	Un nombre para identificar el host virtual.
`host-alias (1 - n)`	Es un nombre de DNS calificado para el entorno (obligatorio). Puedes usar un comodín parcial, como `.foo.com`. No se permite el comodín genérico `""`.
`cert-name` `key-name`	Ingresa el nombre de la clave de TLS autofirmada y los archivos de certificado que generaste antes en el paso Crea credenciales de TLS para la puerta de enlace del entorno de ejecución. Estos archivos deben estar ubicados en el directorio `base_directory/hybrid-files/certs`. Por ejemplo: sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key
`path (1 - n)`	Las reglas de enrutamiento dirigen las llamadas a la API a las rutas de acceso proporcionadas al entorno mencionado. `path-1` a `path-n` son las rutas base a los proxies de API implementadas en el entorno llamado `environment-name`. `paths:` es opcional. La ruta predeterminada es /. Consulta también la sección sobre cómo configurar hosts virtuales. Nota: No se requiere `paths:` en este momento. Borra o comenta `paths:` y cualquier entrada de ruta de acceso.
`environment-name` (en `routingRules`)	Este es el entorno en el que se enrutarán las llamadas a la API. Usa el mismo nombre que usaste cuando creaste el entorno en la IU, como se explica en el Paso 5: Agrega un entorno nuevo en la IU híbrida. Si comentaste o borraste las entradas `path`, asegúrate de que `env` comience con un guion alineado debajo de `routingRules`, por ejemplo: routingRules: - env: my-environment .
`environment-name`	Usa el mismo nombre que usaste cuando creaste el entorno en la IU, como se explica en el Paso 5: Agrega un entorno nuevo en la IU híbrida.
`synchronizer-service-account-name`	El nombre del archivo de claves de la cuenta de servicio del sincronizador que generaste con la herramienta `create-service-account`. Por ejemplo: synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
`udca-service-account-name`	El nombre del archivo de claves de la cuenta de servicio de udca que generaste con la herramienta `create-service-account`. Por ejemplo: udca: ./service-accounts/hybrid-project-apigee-udca.json
`mart-host-alias`	Un nombre de DNS calificado para el extremo del servidor de MART. Este nombre debe coincidir con el nombre común (CN) que se usa en el certificado TLS autorizado que se requiere para esta configuración. Por ejemplo, `mart.mydomain.com` NOTA: El nombre común (CN) del certificado debe aceptar el valor especificado en la propiedad `mart.hostAlias`. Si el CN es `*.hybrid-domain.net` y registraste el host `mart.hybrid-domain.net`, debes establecer `mart.hostAlias` en el valor `mart.hybrid-domain.net`.
`mart-service-account-name`	El nombre del archivo de claves de la cuenta de servicio de mart que generaste con la herramienta `create-service-account`.
`mart-cert-name` `mart-key-name`	Ingresa el nombre de los archivos de certificados y de la clave de TLS autorizados que generaste en el paso Crea credenciales TLS para la puerta de enlace MART. Estos archivos deben estar ubicados en el directorio `base_directory/hybrid-files/certs`. Por ejemplo: sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.key
`metrics-service-account-name`	El nombre del archivo de claves de la cuenta de servicio de métricas que generaste con la herramienta `create-service-account`. Por ejemplo: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json

Resumen

El archivo de configuración le indica a Kubernetes cómo implementar los componentes híbridos en un clúster. A continuación, aplicarás esta configuración a tu clúster.

Próximo paso

1 2 3 (SIGUIENTE) Paso 4: Instala el entorno de ejecución de hybrid