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

Paso 4: Configura el clúster

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/overrides/.
```
cd hybrid-base-directory/hybrid-files/overrides
```
Crea un archivo llamado overrides.yaml en tu editor de texto favorito. Por ejemplo:
```
vi overrides.yaml
```
El archivo overrides.yaml proporciona la configuración de tu instalación única de Apigee hybrid. El archivo de anulaciones de este paso proporciona una configuración básica para una instalación de tiempo de ejecución híbrido con un tamaño reducido, adecuada para tu primera instalación.

En overrides.yaml, añada los valores de propiedad obligatorios, que se muestran a continuación. A continuación, se incluye una descripción detallada de cada propiedad:

Sintaxis

Asegúrate de que el archivo overrides.yaml tenga 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: analytics-region
  projectID: gcp-project-id

k8sCluster:
  name: cluster-name
  region: cluster-region # Must be the same region where the cluster is running.

org: org-name

instanceID: "unique-instance-identifier"

cassandra:
  hostNetwork: false #Set this to `true` for GKE-On-prem installations.

virtualhosts:
  - name: environment-group-name
    sslCertPath: ./certs/cert-name.pem
    sslKeyPath: ./certs/key-name.key

envs:
  - name: environment-name
    serviceAccountPaths:
      synchronizer: ./service-accounts/synchronizer-service-account-name.json
      udca: ./service-accounts/udca-service-account-name.json

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

connectAgent:
  serviceAccountPath: ./service-accounts/mart-service-account-name.json
  # Same account used for mart and connectAgent

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

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

logger:
  enabled: true
  serviceAccountPath: ./service-accounts/logger-service-account-name.json

Ejemplo

En el siguiente ejemplo se muestra un archivo de anulaciones completado con valores de propiedad de ejemplo:

gcp:
  region: us-central1
  projectID: hybrid-example

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

org: hybrid-example

instanceID: "my_hybrid_example"

cassandra:
  hostNetwork: false #Set this to `true` for GKE-On Prem installations.

virtualhosts:
  - name: example-env-group
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key

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

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

connectAgent:
  serviceAccountPath: ./service-accounts/example-hybrid-apigee-mart.json

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

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

logger:
  enabled: true
  serviceAccountPath: ./service-accounts/logger-service-account-name.json

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
`analytics-region`	Debe asignar a este valor la misma región en la que se ejecuta el clúster. Este es el valor que has asignado a la variable de entorno `ANALYTICS_REGION` anteriormente durante la creación del clúster `apigee-logger` y `apigee-metrics` envían sus datos a esta región.
`gcp-project-id`	Identifica el proyecto de Google Cloud en el que `apigee-logger` y `apigee-metrics` insertan sus datos. Este es el valor asignado a la variable de entorno `PROJECT_ID`.
`cluster-name`	Nombre del clúster de Kubernetes. Este es el valor asignado a la variable de entorno `CLUSTER_NAME`.
`org-name`	ID de tu organización de Apigee Hybrid. Este es el valor asignado a la variable de entorno `ORG_NAME`.
`unique-instance-identifier`	Una cadena única para identificar esta instancia. Puede ser cualquier combinación de letras y números de hasta 63 caracteres. Nota: Puedes crear varias organizaciones en el mismo clúster, pero el `instanceId` debe ser el mismo para todas las organizaciones del mismo clúster de Kubernetes. En las instalaciones multirregión, cada región requiere su propio clúster (los clústeres individuales no abarcan regiones). Puedes crear varias organizaciones en el mismo clúster, pero el `instanceId` debe ser el mismo para todas las organizaciones del mismo clúster de Kubernetes.
`environment-group-name`	Nombre del grupo de entornos al que se han asignado tus entornos. Este es el grupo que has creado en Configuración del proyecto y de la organización: paso 6. Crea un grupo de entorno. Este es el valor asignado a la variable de entorno `ENV_GROUP`. Nota: Si quieres colocar instancias de clúster en varias regiones, debes tener cuidado al definir tus entornos y hosts virtuales. Si tienes uno o varios entornos asociados a un grupo de entornos, debes incluir la misma configuración del grupo de entornos en el archivo de anulaciones de cada instancia del clúster.
`cert-name` `key-name`	Introduce el nombre de los archivos de clave y certificado TLS autofirmados que has generado anteriormente en el paso 3: Instala apigeectl. Estos archivos deben estar en el directorio `base_directory/hybrid-files/certs`. Por ejemplo: sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key
`environment-name`	Usa el mismo nombre que usaste cuando creaste un entorno en la interfaz de usuario, tal como se explica en el paso 6 del artículo sobre la configuración de proyectos y organizaciones: crea un grupo de entorno.
`synchronizer-service-account-name`	El nombre del archivo de clave de cuenta de servicio `synchronizer` que has generado con la herramienta `create-service-account`. Por ejemplo: serviceAccountPath: 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: serviceAccountPath: udca: ./service-accounts/hybrid-project-apigee-udca.json
`mart-service-account-name`	El nombre del archivo JSON de la clave de la cuenta de servicio de `mart` que has generado con la herramienta `create-service-account`.
`metrics-service-account-name`	Nombre del archivo JSON de la cuenta de servicio de métricas que has generado con la herramienta `create-service-account`. Por ejemplo: metrics: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json
`mart-service-account-name`	El nombre de la cuenta de servicio `mart` (que tiene asignado el rol Agente de conexión de Apigee) que has creado en el paso 3: Instala apigeectl. MART y el agente de Apigee Connect usan la misma cuenta de servicio.
`watcher-service-account-name`	El nombre del archivo JSON de la cuenta de servicio `watcher` que has generado con la herramienta `create-service-account`. Por ejemplo: watcher: serviceAccountPath: ./service-accounts/hybrid-project-apigee-watcher.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 4 (SIGUIENTE) Paso 5: Instala el tiempo de ejecución híbrido