Paso 6: Crea las anulaciones

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.

Antes de empezar

Te recomendamos que revises los siguientes casos para determinar si quieres configurar tu clúster para ellos. Estas configuraciones son opcionales.

Configurar el clúster

Por convención, las anulaciones de configuración se escriben en un archivo llamado overrides.yaml que suele almacenarse en el directorio $APIGEE_HELM_CHARTS_HOME.

  1. Crea un archivo llamado overrides.yaml en el directorio $APIGEE_HELM_CHARTS_HOME.

    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íbrida con un tamaño reducido, adecuada para tu primera instalación.

  2. En overrides.yaml, 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.

    Selecciona la pestaña de tu instalación, ya sea de producción (Producción) o de no producción (No prod.) [demo, evaluación o prueba de concepto], según lo que hayas elegido en el paso 4: Crear cuentas de servicio.

    En el caso de las instalaciones en entornos de producción, consulta los requisitos de almacenamiento de la base de datos Cassandra en Configurar Cassandra para el entorno de producción.

    Si vas a instalar Apigee hybrid en GKE y tienes previsto usar Workload Identity para autenticar componentes híbridos, selecciona la pestaña Prod: Workload Identity o Non-prod: Workload Identity para configurar el archivo overrides.yaml.

    Producción

    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. Puedes editar sus valores en esta página. Se describen en la tabla de abajo.

    Hay diferencias entre las distintas plataformas en cuanto a la región del proyecto de Google Cloud y la región del clúster de Kubernetes. Elige la plataforma en la que vas a instalar Apigee Hybrid.

    instanceID: "UNIQUE_INSTANCE_IDENTIFIER"
    namespace: APIGEE_NAMESPACE # Usually "apigee"
    
    gcp:
      projectID: PROJECT_ID
      region: ANALYTICS_REGION
    
    k8sCluster:
      name: CLUSTER_NAME
      region: CLUSTER_LOCATION # Must be the closest Google Cloud region to your cluster.
    org: ORG_NAME
    
    # Required if using Data residency:
    contractProvider: https://CONTROL_PLANE_LOCATION-apigee.googleapis.com
      
    
    envs:
    - name: ENVIRONMENT_NAME
      serviceAccountPaths:
        # Provide the path relative to the apigee-env chart directory.
        synchronizer: SYNCHRONIZER_SERVICE_ACCOUNT_FILEPATH
        # For example: "PROJECT_ID-apigee-synchronizer.json"
        runtime: RUNTIME_SERVICE_ACCOUNT_FILEPATH
        # For example: "PROJECT_ID-apigee-runtime.json"
        udca: UDCA_SERVICE_ACCOUNT_FILEPATH
        # For example: "PROJECT_ID-apigee-udca.json"
    components:
          runtime:
            replicaCountMin: 2 # minimum for Prod
            replicaCountMax: 4 # minimum for Prod
    
    cassandra:
      hostNetwork: false
        # Set to false for single region installations and multi-region installations
        # with connectivity between pods in different clusters, for example GKE installations.
        # Set to true  for multi-region installations with no communication between
        # pods in different clusters, for example Google Distributed Cloud on VMware or bare metal, GKE on AWS,
        # AKS, EKS, and OpenShift installations.
        # See Multi-region deployment: Prerequisites
      replicaCount: 3
        # Use multiples of 3 for production.
        # See Configure Cassandra for production for guidelines.
      storage:
        capacity: 500Gi
      resources:
        requests:
          cpu: 7
          memory: 15Gi
      maxHeapSize: 8192M
      heapNewSize: 1200M
        # Minimum storage requirements for a production environment.
        # See Configure Cassandra for production.
    
    ingressGateways:
    - name: INGRESS_NAME # maximum 17 characters.
      replicaCountMin: 2
      replicaCountMax: 10
      svcAnnotations:  # optional. If you are on AKS, see Known issue #260772383
        SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
    
    virtualhosts:
    - name: ENVIRONMENT_GROUP_NAME
      selector:
        app: apigee-ingressgateway
        ingress_name: INGRESS_NAME
      sslCertPath: PATH_TO_CERT_FILE
      sslKeyPath: PATH_TO_KEY_FILE
    
    mart:
      serviceAccountPath: MART_SERVICE_ACCOUNT_FILEPATH
        # Provide the path relative to the apigee-org chart directory.
        # For example: "PROJECT_ID-apigee-mart.json"
    
    connectAgent:
      serviceAccountPath: MART_SERVICE_ACCOUNT_FILEPATH
        # Use the same service account for mart and connectAgent
        # Provide the path relative to the apigee-org chart directory.
        # For example: "PROJECT_ID-apigee-mart.json"
    
    logger:
      enabled: true
        # enabled by default
        # See apigee-logger in Service accounts and roles used by hybrid components.
      serviceAccountPath: LOGGER_SERVICE_ACCOUNT_FILEPATH
        # Provide the path relative to the apigee-telemetry directory.
        # For example: "PROJECT_ID-apigee-logger.json"
    
    metrics:
      serviceAccountPath: METRICS_SERVICE_ACCOUNT_FILEPATH
        # Provide the path relative to the apigee-telemetry chart directory.
        # For example: "PROJECT_ID-apigee-metrics.json"
    
    udca:
      serviceAccountPath: UDCA_SERVICE_ACCOUNT_FILEPATH
        # Provide the path relative to the apigee-org chart directory.
        # For example: "PROJECT_ID-apigee-udca.json"
    
    watcher:
      serviceAccountPath: WATCHER_SERVICE_ACCOUNT_FILEPATH
        # Provide the path relative to the apigee-org chart directory.
        # For example: "PROJECT_ID-apigee-watcher.json"
    

    No producción

    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. Puedes editar sus valores en esta página. Se describen en la tabla de abajo.

    Hay diferencias entre las distintas plataformas en cuanto a la región del proyecto de Google Cloud y la región del clúster de Kubernetes. Elige la plataforma en la que vas a instalar Apigee Hybrid.

    instanceID: "UNIQUE_INSTANCE_IDENTIFIER"
    namespace: APIGEE_NAMESPACE # Usually "apigee"
    
    gcp:
      projectID: PROJECT_ID
      region: ANALYTICS_REGION
    
    k8sCluster:
      name: CLUSTER_NAME
      region: CLUSTER_LOCATION # Must be the closest Google Cloud region to your cluster.
    org: ORG_NAME
    
    # Required if using Data residency:
    contractProvider: https://CONTROL_PLANE_LOCATION-apigee.googleapis.com
      
    
    envs:
    - name: ENVIRONMENT_NAME
      serviceAccountPaths:
        # Provide the path relative to the apigee-env chart directory.
        synchronizer: NON_PROD_SERVICE_ACCOUNT_FILEPATH
        # For example: "PROJECT_ID-apigee-non-prod.json"
        runtime: NON_PROD_SERVICE_ACCOUNT_FILEPATH
        # For example: "PROJECT_ID-apigee-non-prod.json"
        udca: NON_PROD_SERVICE_ACCOUNT_FILEPATH
        # For example: "PROJECT_ID-apigee-non-prod.json"
    
    cassandra:
      hostNetwork: false
        # Set to false for single region installations and multi-region installations
        # with connectivity between pods in different clusters, for example GKE installations.
        # Set to true  for multi-region installations with no communication between
        # pods in different clusters, for example Google Distributed Cloud on VMware or bare metal, GKE on AWS,
        # AKS, EKS, and OpenShift installations.
        # See Multi-region deployment: Prerequisites
      replicaCount: 1
        # Use 1 for non-prod or "demo" installations and multiples of 3 for production.
        # See Configure Cassandra for production for guidelines.
    
    ingressGateways:
    - name: INGRESS_NAME # maximum 17 characters.
      replicaCountMin: 2
      replicaCountMax: 10
      svcAnnotations:  # optional. If you are on AKS, see Known issue #260772383
        SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
    
    virtualhosts:
    - name: ENVIRONMENT_GROUP_NAME
      selector:
        app: apigee-ingressgateway
        ingress_name: INGRESS_NAME
      sslCertPath: PATH_TO_CERT_FILE
      sslKeyPath: PATH_TO_KEY_FILE
    
    mart:
      serviceAccountPath: NON_PROD_SERVICE_ACCOUNT_FILEPATH
      # Provide the path relative to the chart directory.
      # For example: "PROJECT_ID-apigee-non-prod.json"
    
    connectAgent:
      serviceAccountPath: NON_PROD_SERVICE_ACCOUNT_FILEPATH
      # Provide the path relative to the apigee-org chart directory.
      # Use the same service account for mart and connectAgent
      # For example: "PROJECT_ID-apigee-non-prod.json"
    
    logger:
      enabled: true
        # enabled by default
        # See apigee-logger in Service accounts and roles used by hybrid components.
      serviceAccountPath: NON_PROD_SERVICE_ACCOUNT_FILEPATH
        # Provide the path relative to the apigee-telemetry chart directory.
        # For example: "PROJECT_ID-apigee-non-prod.json"
    
    metrics:
      serviceAccountPath: NON_PROD_SERVICE_ACCOUNT_FILEPATH
        # Provide the path relative to the apigee-telemetry chart directory.
        # For example: "PROJECT_ID-apigee-non-prod.json"
    
    udca:
      serviceAccountPath: NON_PROD_SERVICE_ACCOUNT_FILEPATH
        # Provide the path relative to the apigee-org chart directory.
        # For example: "PROJECT_ID-apigee-non-prod.json"
    
    watcher:
      serviceAccountPath: NON_PROD_SERVICE_ACCOUNT_FILEPATH
        # Provide the path relative to the apigee-org chart directory.
        # For example: "PROJECT_ID-apigee-non-prod.json"
    

    Prod: Workload Identity

    Esta plantilla es para instalaciones de producción en GKE que usan Workload Identity. 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. Puedes editar sus valores en esta página. Se describen en la tabla de abajo.

    Si vas a instalar Apigee hybrid en GKE, tienes una alternativa para autenticarte y hacer solicitudes a las APIs de Google: Workload Identity. Para ver información general sobre Workload Identity, consulta los siguientes artículos:

    Para usar Workload Identity con Apigee hybrid en GKE, utiliza esta plantilla y, a continuación, sigue los pasos que se indican en Paso 11: Instala Apigee hybrid con gráficos de Helm para crear las cuentas de servicio de Kubernetes y asociarlas a las cuentas de servicio de Google que creaste en el Paso 4: Crea cuentas de servicio.

    instanceID: "UNIQUE_INSTANCE_IDENTIFIER"
    namespace: APIGEE_NAMESPACE # Usually "apigee"
    
    gcp:
      projectID: PROJECT_ID
      region: ANALYTICS_REGION
      workloadIdentity:
        enabled: true
    
    k8sCluster:
      name: CLUSTER_NAME
      region: CLUSTER_LOCATION # Must be the closest Google Cloud region to your cluster.
    org: ORG_NAME
    
    # Required if using Data residency:
    contractProvider: https://CONTROL_PLANE_LOCATION-apigee.googleapis.com
      
    
    envs:
    - name: ENVIRONMENT_NAME
      gsa:
        synchronizer: "SYNCHRONIZER_SERVICE_ACCOUNT_EMAIL"
        # For example: "apigee-synchronizer@PROJECT_ID.iam.gserviceaccount.com"
        runtime: "RUNTIME_SERVICE_ACCOUNT_EMAIL"
        # For example: "apigee-runtime@PROJECT_ID.iam.gserviceaccount.com"
        udca: "UDCA_SERVICE_ACCOUNT_EMAIL"
        # For example: "apigee-udca@PROJECT_ID.iam.gserviceaccount.com"
      components:
        runtime: 
          replicaCountMin: 2 # minimum for Prod 
          replicaCountMax: 4 # minimum for Prod
    cassandra:
      hostNetwork: false
        # Set to false for single region installations and multi-region installations
        # with connectivity between pods in different clusters, for example GKE installations.
        # Set to true  for multi-region installations with no communication between
        # pods in different clusters, for example Google Distributed Cloud on VMware or bare metal, GKE on AWS,
        # AKS, EKS, and OpenShift installations.
        # See Multi-region deployment: Prerequisites
      replicaCount: 3
        # Use multiples of 3 for production.
        # See Configure Cassandra for production for guidelines.
      storage:
        capacity: 500Gi
      resources:
        requests:
          cpu: 7
          memory: 15Gi
      maxHeapSize: 8192M
      heapNewSize: 1200M
        # Minimum storage requirements for a production environment.
        # See Configure Cassandra for production.
      backup:
        enabled: true
        # Set to true for initial installation.
        # This triggers the chart to create the apigee-cassandra-backup Kubernetes service account when you install it.
        # See Cassandra backup overview for instructions on using cassandra.backup.
    
    ingressGateways:
    - name: INGRESS_NAME # maximum 17 characters.
      replicaCountMin: 2
      replicaCountMax: 10
      svcAnnotations:  # optional. If you are on AKS, see Known issue #260772383
        SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
    
    virtualhosts:
    - name: ENVIRONMENT_GROUP_NAME
      selector:
        app: apigee-ingressgateway
        ingress_name: INGRESS_NAME
      sslCertPath: PATH_TO_CERT_FILE
      sslKeyPath: PATH_TO_KEY_FILE
    
    mart:
      gsa: "MART_SERVICE_ACCOUNT_EMAIL"
        # For example: "apigee-mart@PROJECT_ID.iam.gserviceaccount.com"
    
    connectAgent:
      gsa: "MART_SERVICE_ACCOUNT_EMAIL"
        # Use the same service account for mart and connectAgent
        # For example: "apigee-mart@PROJECT_ID.iam.gserviceaccount.com"
    
    logger:
      enabled: true
        # enabled by default
        # See apigee-logger in Service accounts and roles used by hybrid components.
      gsa: "LOGGER_SERVICE_ACCOUNT_EMAIL"
        # For example: "apigee-logger@PROJECT_ID.iam.gserviceaccount.com"
    metrics:
      gsa: "METRICS_SERVICE_ACCOUNT_EMAIL"
        # For example: "apigee-metrics@PROJECT_ID.iam.gserviceaccount.com"
    
    udca:
      gsa: "UDCA_SERVICE_ACCOUNT_EMAIL"
        # For example: "apigee-udca@PROJECT_ID.iam.gserviceaccount.com"
    
    watcher:
      gsa: "WATCHER_SERVICE_ACCOUNT_EMAIL"
        # For example: "apigee-watcher@PROJECT_ID.iam.gserviceaccount.com"
    

    Entorno de no producción: Workload Identity

    Esta plantilla es para instalaciones que no son de producción en GKE con Workload Identity. 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. Puedes editar sus valores en esta página. Se describen en la tabla de abajo.

    Si vas a instalar Apigee hybrid en GKE, tienes una alternativa para autenticarte y hacer solicitudes a las APIs de Google: Workload Identity. Para ver información general sobre Workload Identity, consulta los siguientes artículos:

    Para usar Workload Identity con Apigee hybrid en GKE, utiliza esta plantilla y, a continuación, sigue los pasos que se indican en Paso 11: Instala Apigee hybrid con gráficos de Helm para crear las cuentas de servicio de Kubernetes y asociarlas a las cuentas de servicio de Google que creaste en el Paso 4: Crea cuentas de servicio.

    instanceID: "UNIQUE_INSTANCE_IDENTIFIER"
    namespace: APIGEE_NAMESPACE # Usually "apigee"
    
    gcp:
      projectID: PROJECT_ID
      region: ANALYTICS_REGION
      workloadIdentity:
        enabled: true
        gsa: "NON_PROD_SERVICE_ACCOUNT_EMAIL"
        # For example: "apigee-non-prod@PROJECT_ID.iam.gserviceaccount.com"
    
    k8sCluster:
      name: CLUSTER_NAME
      region: CLUSTER_LOCATION # Must be the closest Google Cloud region to your cluster.
    org: ORG_NAME
    
    # Required if using Data residency:
    contractProvider: https://CONTROL_PLANE_LOCATION-apigee.googleapis.com
    
    instanceID: "UNIQUE_INSTANCE_IDENTIFIER"
    
    cassandra:
      hostNetwork: false
        # false for all GKE installations.
        # See Multi-region deployment: Prerequisites
      replicaCount: 1
        # Use 1 for non-prod or "demo" installations and multiples of 3 for production.
        # See Configure Cassandra for production for guidelines.
      backup:
        enabled: true
        # Set to true for initial installation.
        # This triggers the chart to create the apigee-cassandra-backup Kubernetes service account when you install it.
        # See Cassandra backup overview for instructions on using cassandra.backup.
    
    virtualhosts:
    - name: ENVIRONMENT_GROUP_NAME
      selector:
        app: apigee-ingressgateway
        ingress_name: INGRESS_NAME
        sslCertPath: PATH_TO_CERT_FILE
        sslKeyPath: PATH_TO_KEY_FILE
    
    ingressGateways:
    - name: INGRESS_NAME # maximum 17 characters.
      replicaCountMin: 2
      replicaCountMax: 10
      svcAnnotations:  # optional. If you are on AKS, see Known issue #260772383
        SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
      svcLoadBalancerIP: SVC_LOAD_BALANCER_IP  # optional
      
    
    envs:
    - name: ENVIRONMENT_NAME
    
    logger:
      enabled: false # Set to false for all GKE installations.
    

    Ejemplo

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

    instanceID: "my_hybrid_example"
    namespace: apigee
    
    gcp:
      projectID: hybrid-example
      region: us-central1
    
    k8sCluster:
      name: apigee-hybrid
      region: us-central1
    
    org: hybrid-example
    
    contractProvider: https://us-apigee.googleapis.com
      
    
    envs:
    - name: test
      serviceAccountPaths:
        synchronizer:my-hybrid-project-apigee-synchronizer.json
        runtime: my-hybrid-project-apigee-runtime.json
        udca: my-hybrid-project-apigee-udca.json
        components: 
          runtime: 
            replicaCountMin: 2 
            replicaCountMax: 4
    cassandra:
      hostNetwork: false
      replicaCount: 3
    
    ingressGateways:
    - name: my-ingress-1
      replicaCountMin: 2
      replicaCountMax: 10
    
    virtualhosts:
    - name: example-env-group
      selector:
        app: apigee-ingressgateway
        ingress_name: my-ingress-1
      sslCertPath: certs/keystore.pem
      sslKeyPath: certs/keystore.key
    
    logger:
      enabled: true # Set to "false" for GKE. Set to "true" for all other Kubernetes platforms.
      serviceAccountPath: my-hybrid-project-apigee-logger.json
    
    mart:
      serviceAccountPath: my-hybrid-project-apigee-mart.json
    
    connectAgent:
      serviceAccountPath: my-hybrid-project-apigee-mart.json
    
    metrics:
      serviceAccountPath: my-hybrid-project-apigee-metrics.json
    
    udca:
      serviceAccountPath: my-hybrid-project-apigee-udca.json
    
    watcher:
      serviceAccountPath: my-hybrid-project-apigee-watcher.json
    
  3. 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
UNIQUE_INSTANCE_IDENTIFIER

Una cadena única para identificar esta instancia. Puede ser cualquier combinación de letras y números de hasta 63 caracteres.

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.

APIGEE_NAMESPACE

El espacio de nombres de Kubernetes de tus componentes de Apigee Hybrid.

El valor predeterminado es apigee.

ANALYTICS_REGION En GKE, debes definir este valor en la misma región en la que se ejecuta el clúster. En el resto de las plataformas, selecciona la región de analíticas más cercana a tu clúster que admita analíticas (consulta la tabla del paso 2 de la parte 1: crea una organización).

Este es el valor que has asignado a la variable de entorno ANALYTICS_REGION anteriormente.

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. Se trata del valor asignado a la variable de entorno CLUSTER_NAME.
CLUSTER_LOCATION La región en la que se ejecuta el clúster. Esta es la región en la que has creado el clúster en el paso 1: Crea un clúster.

Este es el valor que has asignado a la variable de entorno CLUSTER_LOCATION anteriormente.

ORG_NAME ID de tu organización de Apigee Hybrid. Este es el valor asignado a la variable de entorno ORG_NAME.
CONTROL_PLANE_LOCATION Obligatorio si usas la residencia de datos con tu instalación híbrida de Apigee. Es la ubicación en la que se almacena el contenido principal del cliente, como los paquetes proxy. Para ver una lista, consulta Regiones disponibles del plano de control de la API de Apigee. Es el valor asignado a la variable de entorno CONTROL_PLANE_LOCATION en el paso 2: Crea una organización.
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 3: Crea un grupo de entorno. Este es el valor asignado a la variable de entorno ENV_GROUP.
PATH_TO_CERT_FILE
PATH_TO_KEY_FILE
Introduce la ruta y el nombre de los archivos de clave y certificado TLS autofirmados que has generado anteriormente en el paso 5: Crea certificados TLS. Estos archivos deben estar en el directorio APIGEE_HELM_CHARTS_HOME/apigee-virtualhosts/certs. Por ejemplo:
sslCertPath: certs/keystore.crt
sslKeyPath: certs/keystore.key
INGRESS_NAME El nombre de la pasarela de entrada de Apigee de tu implementación. Puede ser cualquier nombre que cumpla los siguientes requisitos:
  • Tener una longitud máxima de 17 caracteres
  • Contener solo caracteres alfanuméricos en minúscula, guiones ("-") o puntos (".").
  • Empezar con un carácter alfanumérico
  • Terminar con un carácter alfanumérico

Consulta ingressGateways[].name en la referencia de la propiedad de configuración

SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE (Opcional) Se trata de un par clave-valor que proporciona anotaciones para tu servicio de entrada predeterminado. Tu plataforma en la nube usa anotaciones para ayudarte a configurar tu instalación híbrida. Por ejemplo, puedes definir el tipo de balanceador de carga como interno o externo.

Las anotaciones varían de una plataforma a otra. Consulta la documentación de tu plataforma para ver las anotaciones obligatorias y sugeridas.

Comenta o elimina esta sección si no la usas.

SVC_LOAD_BALANCER_IP (Opcional) Una dirección IP que hayas reservado para tu balanceador de carga. En las plataformas que admiten la especificación de la dirección IP del balanceador de carga, este se creará con esa dirección IP. En las plataformas que no te permiten especificar la IP del balanceador de carga, esta propiedad se ignora.

Comenta o elimina esta sección si no la usas.

ENVIRONMENT_NAME Usa el mismo nombre que usaste cuando creaste un entorno en la interfaz de usuario, tal como se explica en el Paso 3: Crea un grupo de entornos de la sección Configuración de proyectos y organizaciones.
*_SERVICE_ACCOUNT_FILEPATH La ruta y el nombre de archivo de las cuentas de servicio JSON en el directorio de gráficos correspondiente. Proporcione los nombres con la ruta relativa al directorio del gráfico. . Por ejemplo:
  • Si el archivo my-hybrid-project-apigee-synchronizer.json se encuentra en el directorio del gráfico apigee-env/, solo tienes que proporcionar el nombre del archivo, como este:
    synchronizer:  "my-hybrid-project-apigee-synchronizer.json"
  • Si el archivo se encuentra en un directorio apigee-env/service-accounts/, debes especificar una ruta relativa:
    synchronizer:  "service-accounts/my-hybrid-project-apigee-synchronizer.json"

En los entornos que no son de producción, el nombre de la cuenta de servicio única es PROJECT_ID-non-prod.json de forma predeterminada.

En los entornos de producción, el nombre del archivo de clave de cuenta de servicio que has generado con la herramienta create-service-account en el paso 4: Crea cuentas de servicio.

Puedes ver los archivos de la cuenta de servicio en cada directorio de gráficos correspondiente.

Los nombres predeterminados de los directorios de gráficos correspondientes a las cuentas de servicio son los siguientes:

Cuenta de servicio Nombre de archivo Directorio de gráficos
Administrador de objetos de Storage PROJECT_ID-apigee-cassandra.json apigee-datastore/
Escritor de registros PROJECT_ID-apigee-logger.json apigee-telemetry/
Agente de conexión de Apigee PROJECT_ID-apigee-mart.json apigee-org/
Escritor de las métricas de supervisión PROJECT_ID-apigee-metrics.json apigee-telemetry/
No se requiere ningún rol PROJECT_ID-apigee-runtime.json apigee-env/
Administrador del sincronizador de Apigee PROJECT_ID-apigee-synchronizer.json apigee-env/
Agente de Analytics de Apigee PROJECT_ID-apigee-udca.json apigee-org/
Agente de entorno de ejecución de Apigee PROJECT_ID-apigee-watcher.json apigee-org/
*_SERVICE_ACCOUNT_EMAIL Las direcciones de correo de las cuentas de servicio de Google (GSAs) que debes proporcionar si usas Workload Identity en GKE. Estas son las cuentas de servicio que has creado en el paso 4: Crea cuentas de servicio. Puedes encontrar las direcciones de correo de las cuentas de servicio con el siguiente comando:
gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee"

Resumen

El archivo de configuración indica a Kubernetes cómo desplegar los componentes híbridos en un clúster. A continuación, habilitarás el acceso del sincronizador para que los planos de gestión y de tiempo de ejecución de Apigee puedan comunicarse.

Paso siguiente

1 2 3 4 5 6 (SIGUIENTE) Paso 7: Habilita el acceso de Synchronizer 8 9 10 11 12