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.

  1. Asegúrate de que estás en el directorio hybrid-base-directory/hybrid-files.
  2. 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.

  3. cd en el directorio overrides:
    4. cd overrides
  4. 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:

    Sintaxis

    El archivo overrides.yaml tiene la siguiente estructura y sintaxis. Los valores de red, bold italics son valores de propiedad que debe proporcionar:

    gcpProjectID: project-id
k8sClusterName: cluster-name
org: org-name

envs:
  - name: environment-name  # The same name of the env you created in the UI
    hostAlias: test-host-alias
    sslCertPath: ./certs/test-cert-name.pem
    sslKeyPath: ./certs/test-key-name.key
    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:

    gcpProjectID: hybrid-project
k8sClusterName: apigee-hybrid
org: hybrid-org

envs:
  - name: test
    hostAlias: "*"
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key
    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
  5. Cuando hayas terminado, guarda el archivo.

En la siguiente tabla se describen los valores de propiedad que debe proporcionar en el archivo de anulaciones.

Variable Descripción
project-id El ID de tu proyecto de GCP.
cluster-name Nombre del clúster de Kubernetes.
org-name El nombre de tu organización de Apigee Hybrid.
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.
test-host-alias

(Obligatorio) En la guía de inicio rápido, usa el carácter comodín "*".

Solo se recomienda usar * para una instalación de prueba cuando se utilicen credenciales TLS autofirmadas. Más adelante, cuando desarrolles configuraciones híbridas de Apigee más complejas, como la creación de varios entornos, tendrás que usar un nombre de dominio cualificado para este valor.

test-cert-name
test-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
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
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