Esta página se ha traducido con Cloud Translation API.

Paso 3: Configura el clúster de GKE

Especificar anulaciones de configuración

El instalador de Apigee hybrid usa valores predeterminados para muchos ajustes. Sin embargo, hay algunos ajustes que no tienen valores predeterminados. Debe proporcionar valores para estos ajustes, tal 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 en el 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 tiempo de ejecución híbrida con un tamaño reducido, una configuración adecuada para tu primera instalación.
cd en el directorio overrides:

cd overrides

Abre overrides.yaml y añade los valores de propiedad obligatorios, que se muestran a continuación. A continuación, se ofrece una descripción detallada de cada propiedad:

NOTA: No olvides inhabilitar el registro en el archivo de anulaciones definiendo logger:enabled:false. El registro se proporciona de forma predeterminada como parte de GKE.

Sintaxis

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

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 siguiente ejemplo se muestra un archivo de anulaciones completado con valores de propiedad de ejemplo:

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 hayas terminado, guarda el archivo.

En la siguiente tabla se describen los valores de propiedad que debe proporcionar en el archivo de anulaciones. Para obtener más información, consulta la referencia de la propiedad de configuración.

Variable	Descripción
`gcp-region`	Identifica la región de GCP donde `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` insertan sus datos.
`cluster-name`	Nombre del 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`	Nombre para identificar el host virtual.
`host-alias (1 - n)`	Obligatorio. Nombre de DNS cualificado del entorno. Puedes usar un comodín parcial como `.foo.com`. No se permite el comodín genérico `""`.
`cert-name` `key-name`	Introduce el nombre de los archivos de clave y certificado TLS autofirmados que has generado anteriormente en el paso Crear credenciales TLS para la pasarela de tiempo de ejecución. Estos archivos deben estar 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 proporcionadas en el entorno mencionado. `path-1` y `path-n` son las rutas base de los proxies de API implementados en el entorno llamado `environment-name`. `paths:` es opcional. La ruta predeterminada es /. Consulta también Configurar hosts virtuales. Nota: `paths:` no es obligatorio por el momento. Elimina o comenta `paths:` y cualquier entrada de ruta.
`environment-name` (en `routingRules`)	Este es el entorno al que se dirigirán las llamadas a la API. Usa el mismo nombre que usaste cuando creaste un entorno en la interfaz de usuario, tal como se explica en el paso 5: Añade un nuevo entorno en la interfaz de usuario híbrida. Si has comentado o eliminado las entradas de `path`, asegúrate de que `env` empiece por un guion alineado debajo de `routingRules`, como en este ejemplo: routingRules: - env: my-environment .
`environment-name`	Usa el mismo nombre que usaste cuando creaste un entorno en la interfaz de usuario, tal como se explica en el paso 5: Añade un nuevo entorno en la interfaz de usuario híbrida.
`synchronizer-service-account-name`	Nombre del archivo de clave de cuenta de servicio del sincronizador que has generado 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 clave de cuenta de servicio udca que has generado con la herramienta `create-service-account`. Por ejemplo: udca: ./service-accounts/hybrid-project-apigee-udca.json
`mart-host-alias`	Nombre de DNS cualificado del endpoint del servidor MART. Este nombre debe coincidir con el nombre común (CN) usado en el certificado TLS autorizado necesario para esta configuración. Por ejemplo: `mart.mydomain.com` NOTA: El nombre común (CN) del certificado debe coincidir con el valor especificado en la propiedad `mart.hostAlias`. Si el CN es `*.hybrid-domain.net` y has registrado el host `mart.hybrid-domain.net`, debes asignar a `mart.hostAlias` el valor `mart.hybrid-domain.net`.
`mart-service-account-name`	El nombre del archivo de clave de cuenta de servicio de mart que has generado con la herramienta `create-service-account`.
`mart-cert-name` `mart-key-name`	Introduce el nombre de los archivos de clave y certificado TLS autorizados que has generado anteriormente en el paso Crear credenciales TLS para la pasarela MART. Estos archivos deben estar 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 clave de cuenta de servicio de métricas que has generado con la herramienta `create-service-account`. Por ejemplo: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json

Resumen

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

1 2 3 (SIGUIENTE) Paso 4: Instala el tiempo de ejecución híbrido