Referencia de la propiedad de configuración

En esta sección se enumeran todas las propiedades de configuración que puede usar para personalizar el plano de tiempo de ejecución de su implementación híbrida de Apigee.

Propiedades de nivel superior

En la siguiente tabla se describen las propiedades de nivel superior del archivo overrides.yaml. Estas son propiedades que no pertenecen a otro objeto y se aplican a nivel de organización o de entorno:

Propiedad Descripción
contractProvider Versión: 1.0.0

Valor predeterminado: https://apigee.googleapis.com

Define la ruta de la API de todas las APIs de tu instalación.
gcpProjectID Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio

ID de tu proyecto de Google Cloud. Funciona con k8sClusterName y gcpRegion para identificar el proyecto y determinar dónde envían sus datos apigee-logger y apigee-metrics.
gcpRegion Versión: 1.0.0

Valor predeterminado: us-central1

Obligatorio

La región o zona de GCP más cercana a tu clúster de Kubernetes. Funciona con gcpProjectID y k8sClusterName para identificar el proyecto y determinar dónde envían sus datos apigee-logger y apigee-metrics.
imagePullSecrets.name Versión: 1.0.0

Valor predeterminado: ninguno

Nombre del secreto de Kubernetes configurado como tipo docker-registry. Se usa para extraer imágenes de un repositorio privado.
k8sClusterName

Tipo:

Versión: 1.0.0

Valor predeterminado: ninguno

Nombre del proclúster de Kubernetes (K8S) en el que se ejecuta tu proyecto híbrido. Funciona con gcpProjectID y gcpRegion para identificar el proyecto y determinar dónde envían sus datos apigee-logger y apigee-metrics.
namespace Versión: 1.0.0

Valor predeterminado: apigee

El espacio de nombres de tu clúster de Kubernetes en el que se instalarán los componentes de Apigee.
org Obligatorio

Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio

La organización habilitada para el modo híbrido que Apigee te proporcionó durante la instalación híbrida. Una organización es el contenedor de nivel superior de Apigee. Contiene todos tus proxies de API y recursos relacionados. Si el valor está vacío, debes actualizarlo con el nombre de tu organización una vez que la hayas creado.
revision Versión: 1.0.0

Valor predeterminado: 1.0.0

Apigee hybrid admite actualizaciones continuas de Kubernetes, lo que permite que las actualizaciones de los despliegues se realicen sin tiempo de inactividad, ya que las instancias de Pod se actualizan de forma incremental con las nuevas.

Cuando se actualizan ciertas anulaciones de YAML que provocan un cambio en el elemento subyacente Kubernetes PodTemplateSpec, también se debe cambiar la propiedad de anulación revision en el archivo override.yaml del cliente. Esto es necesario para que el controlador ApigeeDeployment (AD) de Kubernetes subyacente pueda llevar a cabo una actualización gradual segura de la versión anterior a la nueva. Puede usar cualquier valor de texto, por ejemplo: "azul", "a", "1.0.0".

Cuando se cambia y se aplica la propiedad revision, se produce una actualización gradual de todos los componentes.

Para cambiar las propiedades de los siguientes objetos, es necesario actualizar revision:

Para obtener más información, consulta Actualizaciones continuas.
validateServiceAccounts Versión: 1.0.0

Valor predeterminado: true

Habilita la validación estricta de los permisos de la cuenta de servicio. Para ello, se usa el método "testIamPermissions" de la API Cloud Resource Manager, que verifica que la cuenta de servicio proporcionada tiene los permisos necesarios. En el caso de las cuentas de servicio de una organización de Apigee, la comprobación del ID de proyecto es la que se asigna a la organización. En el caso de las métricas y el registrador, el proyecto comprobado se basa en la configuración "gcpProjectID" de overrides.yaml.

Consulta también gcpProjectID.

adah

El webhook de admisión de implementaciones de Apigee (ADAH) se encarga de validar la configuración que proporciona el usuario para el controlador de implementaciones de Apigee. Se ejecuta en un clúster de Kubernetes y es responsable de validar las solicitudes de creación, actualización y eliminación entrantes del controlador de despliegue de Apigee. Consulta también:

En la siguiente tabla se describen las propiedades del objeto adah de Apigee Deployment Controller:

Propiedad Descripción
adah.image.pullPolicy Versión: 1.0.0

Valor predeterminado: IfNotPresent

Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

  • IfNotPresent: no descargues una imagen nueva si ya existe.
  • Always: siempre extrae la imagen, independientemente de si ya existe.

Para obtener más información, consulta Actualizar imágenes.
adah.image.tag Versión: 1.0.0

Valor predeterminado: 1.0.0

Ubicación de la imagen Docker de este servicio.
adah.image.url Versión: 1.0.0

Valor predeterminado: "us.gcr.io/google.com/edge-ci/release/eda/apigee-deployment-admissionhook/master/admissionhook"

Ubicación de la imagen Docker de este servicio.

adc

El controlador de despliegue de Apigee (ADC) es un proceso que gestiona el despliegue de Apigee en clústeres de Kubernetes. Es un controlador personalizado de Kubernetes que crea y actualiza recursos de Kubernetes e Istio de bajo nivel que son necesarios para desplegar y mantener ApigeeDeployment (AD).

Consulta también adah (Apigee Deployment Admissionhook).

En la siguiente tabla se describen las propiedades del objeto adc apigee-deployment-controller:

Propiedad Descripción
adc.image.pullPolicy Versión: 1.0.0

Valor predeterminado: IfNotPresent

Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

  • IfNotPresent: no descargues una imagen nueva si ya existe.
  • Always: siempre extrae la imagen, independientemente de si ya existe.

Para obtener más información, consulta Actualizar imágenes.
adc.image.tag Versión: 1.0.0

Valor predeterminado: 1.0.0

Ubicación de la imagen Docker de este servicio.
adc.image.url Versión: 1.0.0

Valor predeterminado: "us.gcr.io/google.com/edge-ci/release/eda/apigee-deployment-controller/master/controller"

Ubicación de la imagen Docker de este servicio.
adc.resources.limits.cpu Versión: 1.0.0

Valor predeterminado: 250m

Límite de CPU del recurso en un contenedor de Kubernetes, en milinúcleos.
adc.resources.limits.memory Versión: 1.0.0

Valor predeterminado: 256Mi

Límite de memoria del recurso en un contenedor de Kubernetes, en mebibytes.
adc.resources.requests.cpu Versión: 1.0.0

Valor predeterminado: 250m

La CPU necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en milinúcleos.
adc.resources.requests.memory Versión: 1.0.0

Valor predeterminado: 256Mi

La memoria necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en mebibytes.

authz

En la siguiente tabla se describen las propiedades del objeto authz:

Propiedad Descripción
authz.image.pullPolicy Versión: 1.0.0

Valor predeterminado: IfNotPresent

Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

  • IfNotPresent: no descargues una imagen nueva si ya existe.
  • Always: siempre extrae la imagen, independientemente de si ya existe.

Para obtener más información, consulta Actualizar imágenes.
authz.image.tag Versión: 1.0.0

Valor predeterminado: 1.0.0

La etiqueta de versión de la imagen Docker de este servicio.
authz.image.url Versión: 1.0.0

Valor predeterminado: "us.gcr.io/google.com/edge-ci/integration/featureplatform/apigee-authn-authz/master"

Ubicación de la imagen Docker de este servicio.
authz.livenessProbe.failureThreshold Versión: 1.0.0

Valor predeterminado: 2

El número de veces que Kubernetes verificará que las comprobaciones de actividad han fallado antes de reiniciar el contenedor. El valor mínimo es 1.
authz.livenessProbe.initialDelaySeconds Versión: 1.0.0

Valor predeterminado: 0

Número de segundos que transcurren después de iniciar un contenedor antes de que se inicie una prueba de actividad.
authz.livenessProbe.periodSeconds Versión: 1.0.0

Valor predeterminado: 5

Determina la frecuencia con la que se realiza una comprobación de actividad (en segundos). El valor mínimo es 1.
authz.livenessProbe.timeoutSeconds Versión: 1.0.0

Valor predeterminado: 1

Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
authz.readinessProbe.failureThreshold Versión: Beta2

Valor predeterminado: 2

Número de veces que Kubernetes verificará que las sondas de preparación han fallado antes de marcar el pod como no preparado. El valor mínimo es 1.
authz.readinessProbe.initialDelaySeconds Versión: 1.0.0

Valor predeterminado: 0

Número de segundos que deben transcurrir después de iniciar un contenedor para que se inicie una sonda de disponibilidad.
authz.readinessProbe.periodSeconds Versión: 1.0.0

Valor predeterminado: 5

Determina la frecuencia con la que se realiza una comprobación de disponibilidad (en segundos). El valor mínimo es 1.
authz.readinessProbe.successThreshold Versión: 1.0.0

Valor predeterminado: 1

Número mínimo de éxitos consecutivos necesarios para que una sonda de disponibilidad se considere correcta después de un fallo. El valor mínimo es 1.
authz.readinessProbe.timeoutSeconds Versión: 1.0.0

Valor predeterminado: 1

Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
authz.resources.requests.cpu Versión: 1.0.0

Valor predeterminado: 50m

Cantidad de recursos de CPU que se asignarán a las solicitudes de autenticación.

authz.resources.requests.memory Versión: 1.0.0

Valor predeterminado: 128Mi

Cantidad de recursos de memoria que se asignarán a las solicitudes de autenticación.

authz.serviceAccountPath Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio

Ruta al archivo de clave de la cuenta de servicio de Google con el rol "Administrador de Apigee de solo lectura".

busyBoxInit

En la siguiente tabla se describen las propiedades del objeto busyBoxInit:

Propiedad Descripción
busyBoxInit.image.pullPolicy Versión: 1.0.0

Valor predeterminado: IfNotPresent

Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

  • IfNotPresent: no descargues una imagen nueva si ya existe.
  • Always: siempre extrae la imagen, independientemente de si ya existe.

Para obtener más información, consulta Actualizar imágenes.
busyBoxInit.image.tag Versión: 1.0.0

Valor predeterminado: "1.0.0"

La etiqueta de versión de la imagen Docker de este servicio.
busyBoxInit.image.url Versión: 1.0.0

Valor predeterminado: "busybox"

Ubicación de la imagen Docker de este servicio.

cassandra

Define el servicio híbrido que gestiona el repositorio de datos de tiempo de ejecución. Este repositorio almacena configuraciones de aplicaciones, contadores de cuota distribuidos, claves de API y tokens de OAuth para las aplicaciones que se ejecutan en la pasarela.

Para obtener más información, consulta Configurar Cassandra.

En la siguiente tabla se describen las propiedades del objeto cassandra:

Propiedad Descripción
cassandra.auth.admin.password Versión: 1.0.0

Valor predeterminado: "iloveapis123"

Obligatorio

Contraseña del administrador de Cassandra. El usuario administrador se usa para cualquier actividad administrativa que se realice en el clúster de Cassandra.
cassandra.auth.ddl.password Versión: 1.0.0

Valor predeterminado: "iloveapis123"

Obligatorio

Contraseña del usuario del lenguaje de definición de datos (DDL) de Cassandra. Usada por MART para cualquiera de las tareas de definición de datos, como la creación, la actualización y la eliminación de espacios de claves.
cassandra.auth.default.password Versión: 1.0.0

Valor predeterminado: "iloveapis123"

Obligatorio

La contraseña del usuario predeterminado de Cassandra que se crea cuando se habilita la autenticación. Esta contraseña debe restablecerse al configurar la autenticación de Cassandra. Consulta Configurar TLS para Cassandra.
cassandra.auth.dml.password Versión: 1.0.0

Valor predeterminado: "iloveapis123"

Obligatorio

Contraseña del usuario del lenguaje de manipulación de datos (DML) de Cassandra. El usuario de DML lo usa la comunicación del cliente para leer y escribir datos en Cassandra.
cassandra.auth.image.pullPolicy Versión: 1.0.0

Valor predeterminado: IfNotPresent

Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

  • IfNotPresent: no descargues una imagen nueva si ya existe.
  • Always: siempre extrae la imagen, independientemente de si ya existe.

Para obtener más información, consulta Actualizar imágenes.
cassandra.auth.image.tag Versión: 1.0.0

Valor predeterminado: 1.0.0

La etiqueta de versión de la imagen Docker de este servicio.
cassandra.auth.image.url Versión: 1.0.0

Valor predeterminado: "google/apigee-cassandra-client"

Ubicación de la imagen Docker de este servicio.
cassandra.backup.cloudProvider Versión: 1.0.0

Valor predeterminado: "GCP"

Obligatorio si la copia de seguridad está habilitada.

Proveedor de servicios en la nube para el almacenamiento de copias de seguridad.
cassandra.backup.dbStorageBucket Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio si la copia de seguridad está habilitada.

Segmento de Cloud Storage para los datos de la copia de seguridad.
cassandra.backup.enabled Versión: 1.0.0

Valor predeterminado: false

La copia de seguridad de los datos no está habilitada de forma predeterminada. Para habilitarlo, selecciona true.

Consulta Copia de seguridad y recuperación de Cassandra.
cassandra.backup.image.pullPolicy Versión: 1.0.0

Valor predeterminado: IfNotPresent

Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

  • IfNotPresent: no descargues una imagen nueva si ya existe.
  • Always: siempre extrae la imagen, independientemente de si ya existe.

Para obtener más información, consulta Actualizar imágenes.
cassandra.backup.image.tag Versión: 1.0.0

Valor predeterminado: 1.0.0

La etiqueta de versión de la imagen Docker de este servicio.
cassandra.backup.image.url Versión: 1.0.0

Valor predeterminado: "google/apigee-cassandra-backup-utility"

Ubicación de la imagen Docker de este servicio.
cassandra.backup.schedule Versión: 1.0.0

Valor predeterminado: "0 2 * * *"

La programación de la tarea cron.

Consulta Copia de seguridad y recuperación de Cassandra.
cassandra.backup.serviceAccountPath Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio si la copia de seguridad está habilitada.

Ruta al archivo de clave de la cuenta de servicio de Google con el rol "Administrador de Apigee de solo lectura".
cassandra.clusterName Versión: 1.0.0

Valor predeterminado: "apigeecluster"

Especifica el nombre del clúster de Cassandra.
cassandra.datacenter Versión: 1.0.0

Valor predeterminado: "dc-1"

Especifica el centro de datos del nodo de Cassandra.
cassandra.dnsPolicy Versión: 1.1.1

Valor predeterminado: ClusterFirstWithHostNet

Cuando cassandra.hostNetwork se define como true, se determina qué política de DNS usa Cassandra. En las implementaciones basadas en Anthos, debe definirse como ClusterFirstWithHostNet.
cassandra.externalSeedHost Versión: 1.0.0

Valor predeterminado: ninguno

Nombre de host o IP de un nodo de clúster de Cassandra. Si no se define, se usa el servicio local de Kubernetes.
cassandra.heapNewSize Versión: 1.0.0

Valor predeterminado: 100M

Cantidad de memoria del sistema JVM asignada a objetos más recientes, en megabytes.

cassandra.hostNetwork Versión: 1.1.1

Valor predeterminado: true

Se define como true para las implementaciones basadas en Anthos.

cassandra.image.pullPolicy Versión: 1.0.0

Valor predeterminado: IfNotPresent

Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

  • IfNotPresent: no descargues una imagen nueva si ya existe.
  • Always: siempre extrae la imagen, independientemente de si ya existe.

Para obtener más información, consulta Actualizar imágenes.
cassandra.image.tag Versión: 1.0.0

Valor predeterminado: 1.0.0

La etiqueta de versión de la imagen Docker de este servicio.
cassandra.image.url Versión: 1.0.0

Valor predeterminado: "google/apigee-cassandra"

Ubicación de la imagen Docker de este servicio.
cassandra.maxHeapSize Versión: 1.0.0

Valor predeterminado: 512M

El límite superior de la memoria del sistema JVM disponible para las operaciones de Cassandra, en megabytes.

cassandra.multiRegionSeedHost Versión: 1.0.0

Valor predeterminado: ninguno

Dirección IP de un clúster de Cassandra que se usa para ampliar un clúster a una nueva región. Consulta Configurar el host de seed multirregional.

cassandra.nodeSelector.key Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio

Clave de etiqueta del selector de nodos que se usa para orientar los nodos de Kubernetes dedicados a los servicios de datos de cassandra.

Consulta Añadir selectores de nodos.
cassandra.nodeSelector.value Versión: 1.0.0

Valor predeterminado: ninguno

Valor de etiqueta de selector de nodo opcional que se usa para orientar los nodos de Kubernetes dedicados a los servicios de datos de cassandra y anular los ajustes de nodeSelector.apigeeData.

Consulta nodeSelector.
cassandra.port Versión: 1.0.0

Valor predeterminado: 9042

Número de puerto usado para conectarse a Cassandra.
cassandra.rack Versión: 1.0.0

Valor predeterminado: "ra-1"

Especifica el rack del nodo de Cassandra.
cassandra.readinessProbe.failureThreshold Versión: 1.0.0

Valor predeterminado: 2

Número de veces que Kubernetes verificará que las sondas de preparación han fallado antes de marcar el pod como no preparado. El valor mínimo es 1.
cassandra.readinessProbe.initialDelaySeconds Versión: 1.0.0

Valor predeterminado: 0

Número de segundos que deben transcurrir después de iniciar un contenedor para que se inicie una sonda de disponibilidad.
cassandra.readinessProbe.periodSeconds Versión: 1.0.0

Valor predeterminado: 10

Determina la frecuencia con la que se realiza una comprobación de disponibilidad (en segundos). El valor mínimo es 1.
cassandra.readinessProbe.successThreshold Versión: 1.0.0

Valor predeterminado: 1

Número mínimo de éxitos consecutivos necesarios para que una sonda de disponibilidad se considere correcta después de un fallo. El valor mínimo es 1.
cassandra.readinessProbe.timeoutSeconds Versión: 1.0.0

Valor predeterminado: 5

Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
cassandra.replicaCount Versión: 1.0.0

Valor predeterminado: 3

Cassandra es una base de datos replicada. Está configurado para tener al menos 3 copias de los datos en cada región o centro de datos. Esta propiedad especifica el número de nodos de Cassandra empleados como StatefulSet.
cassandra.resources.requests.cpu Versión: 1.0.0

Valor predeterminado: 500m

La CPU necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en milinúcleos.
cassandra.resources.requests.memory Versión: 1.0.0

Valor predeterminado: 1Gi

La memoria necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en mebibytes.
cassandra.restore.cloudProvider Versión: 1.0.0

Valor predeterminado: "GCP"

Obligatorio si la restauración está habilitada.

Proveedor de servicios en la nube para el almacenamiento de copias de seguridad.
cassandra.restore.dbStorageBucket Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio si la restauración está habilitada.

Segmento de Cloud Storage que contiene los datos de la copia de seguridad que se va a restaurar.
cassandra.restore.enabled Versión: 1.0.0

Valor predeterminado: false
cassandra.restore.image.pullPolicy Versión: 1.0.0

Valor predeterminado: IfNotPresent

Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

  • IfNotPresent: no descargues una imagen nueva si ya existe.
  • Always: siempre extrae la imagen, independientemente de si ya existe.

Para obtener más información, consulta Actualizar imágenes.
cassandra.restore.image.tag Versión: 1.0.0

Valor predeterminado: 1.0.0

La etiqueta de versión de la imagen Docker de este servicio.
cassandra.restore.image.url Versión: 1.0.0

Valor predeterminado: "google/apigee-cassandra-backup-utility"

Ubicación de la imagen Docker de este servicio.
cassandra.restore.serviceAccountPath Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio si la restauración está habilitada.

Ruta al archivo de clave de la cuenta de servicio de Google con el rol "Administrador de Apigee de solo lectura".
cassandra.restore.snapshotTimestamp Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio si la restauración está habilitada.

Marca de tiempo de la copia de seguridad que se debe restaurar.
cassandra.storage.capacity Versión: 1.0.0

Valor predeterminado: 50Gi

Obligatorio si se especifica storage.storageClass

Especifica el tamaño de disco necesario en mebibytes.
cassandra.storage.storageClass Versión: 1.0.0

Valor predeterminado: ninguno

Especifica la clase de almacenamiento local que se está usando.
cassandra.terminationGracePeriodSeconds Versión: 1.0.0

Valor predeterminado: 300

Tiempo transcurrido entre una solicitud de eliminación de un pod y el momento en que se elimina, en segundos. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución.

defaults

Las claves de cifrado predeterminadas de la instalación de Apigee Hybrid.

En la siguiente tabla se describen las propiedades del objeto defaults:

Propiedad Descripción
defaults.org.kmsEncryptionKey Versión: 1.0.0

Valor predeterminado: "aWxvdmVhcGlzMTIzNDU2Nw=="

Clave de cifrado predeterminada de la organización en KMS.

defaults.org.kvmEncryptionKey Versión: 1.0.0

Valor predeterminado: "aWxvdmVhcGlzMTIzNDU2Nw=="

Clave de cifrado predeterminada de la organización en KVM.

defaults.env.kmsEncryptionKey Versión: 1.0.0

Valor predeterminado: "aWxvdmVhcGlzMTIzNDU2Nw=="

Clave de cifrado predeterminada del entorno (env) en KMS.

defaults.env.kvmEncryptionKey Versión: 1.0.0

Valor predeterminado: "aWxvdmVhcGlzMTIzNDU2Nw=="

Clave de cifrado predeterminada del entorno (env) en KVM.

defaults.env.cacheEncryptionKey Versión: 1.0.0

Valor predeterminado: "aWxvdmVhcGlzMTIzNDU2Nw=="

Clave de cifrado de caché predeterminada del entorno.

envs

Define una matriz de entornos en los que puedes desplegar tus proxies de API. Cada entorno proporciona un contexto aislado o un "sandbox" para ejecutar proxies de API.

Tu organización con la función híbrida habilitada debe tener al menos un entorno.

Usa envs[] para configurar el enrutamiento de la ruta base, que te permite configurar y gestionar cómo Apigee hybrid enruta las llamadas de proxy de API al entorno correcto.

Para obtener más información, consulta estos artículos:

En la siguiente tabla se describen las propiedades del objeto envs:

Propiedad Descripción
envs[].cacheEncryptionKey Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio

Ruta del sistema de archivos local de la clave de cifrado de los datos de la caché de Apigee.
envs[].hostAlias Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio

El nombre DNS de tu servidor. Por ejemplo, foo-test.mydomain.com. Si no tienes un nombre de DNS, puedes usar un comodín ('*'). Si usas un comodín, puedes usar la IP EXTERNA de istio-ingressgateway, que puedes obtener llamando a kubectl get services -n namespace después de completar la instalación.

Si tienes varios entornos, debes usar un nombre de alias de host único para cada uno de ellos. Por ejemplo, foo-test.mydomain.com y foo-prod.mydomain.com.
envs[].kmsEncryptionKey Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio

Ruta del sistema de archivos local de la clave de cifrado de los datos del KMS de Apigee.
envs[].name Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio

Nombre del entorno de Apigee que se va a sincronizar.
envs[].pollInterval Versión: 1.0.0

Valor predeterminado: ninguno

Intervalo usado para sondear los cambios de sincronización de la organización y el entorno, en segundos.
envs[].paths.uri.prefixes Versión: 1.0.0

Valor predeterminado: ninguno

Una propiedad para admitir el enrutamiento de la ruta base de prefijo. Proporciona esas rutas siguiendo el patrón:

      org: hybrid
      envs:
      - name: test
        paths:
          uri:
            prefixes:
            - /foo
            - /bar
envs[].port Versión: 1.0.0

Valor predeterminado: ninguno

Número de puerto TCP para el tráfico HTTPS.
envs[].serviceAccountPaths.synchronizer Versión: GA

Valor predeterminado: ninguno

Ruta al archivo del sistema local de una clave de cuenta de servicio de Google con el rol Gestor de sincronizadores de Apigee.
envs[].serviceAccountPaths.udca Versión: GA

Valor predeterminado: ninguno

Ruta al archivo del sistema local de una clave de cuenta de servicio de Google con el rol Agente de analíticas de Apigee.
envs[].sslCertPath Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio

Ruta de tu sistema a un archivo de certificado TLS.
envs[].sslKeyPath Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio

Ruta de tu sistema al archivo de clave privada TLS.

httpProxy

httpProxy proporciona parámetros de configuración para un servidor proxy de reenvío HTTP. Cuando se configura en overrides.yaml, toda la comunicación por Internet de los componentes MART, Synchronizer y UDCA pasa por el servidor proxy.

Consulta también MART, Synchronizer y UDCA.

En la siguiente tabla se describen las propiedades del objeto httpProxy:

Propiedad Descripción
httpProxy.host Versión: 1.1.1

Valor predeterminado: ninguno

Nombre de host del proxy HTTP.
httpProxy.port Versión: 1.1.1

Valor predeterminado: ninguno

Puerto del proxy HTTP.
httpProxy.scheme Versión: 1.1.1

Valor predeterminado: HTTPS

El esquema usado por el proxy. Los valores pueden ser HTTP o HTTPS.

ingress

ingress es la instanciación de la pasarela de entrada de Istio. El recurso Ingress de Kubernetes se usa para especificar los servicios que se deben exponer fuera del clúster. Define una aplicación contenerizada que dirige el tráfico desde fuera del plano de ejecución a los servicios del plano de ejecución. La instalación de Apigee crea dos objetos Istio Ingress para:

  1. Tiempo de ejecución
  2. MART

Consulta también:

En la siguiente tabla se describen las propiedades del objeto ingress:

Propiedad Descripción
ingress.enableAccesslog Versión: 1.0.0

Valor predeterminado: false

Habilita o inhabilita el registro de acceso de entrada. De forma predeterminada, está inhabilitada.
ingress.envoyHeaders.headers Versión: 1.0.0

Valor predeterminado: ninguno

Lista de encabezados de Envoy.
ingress.envoyHeaders.preserved Versión: 1.0.0

Valor predeterminado: false

Determina si se conservan o no las cabeceras de Envoy. De forma predeterminada, no lo están.
ingress.httpsRedirect Versión: 1.0.0

Valor predeterminado: true

Habilita o inhabilita la redirección automática a HTTPS para todo el tráfico entrante.
ingress.mart.loadBalancerIP Versión: 1.1.1

Valor predeterminado: 10.0.10.252

Dirección IP del balanceador de carga de MART.
ingress.runtime.loadBalancerIP Versión: 1.1.1

Valor predeterminado: 10.0.10.251

Dirección IP del balanceador de carga del objeto Apigee-runtime.
ingress.serviceType Versión: 1.0.0

Valor predeterminado: LoadBalancer

El tipo de servicio que se usa para enrutar el tráfico externo a los servicios internos.

Estos son algunos de los posibles valores:

  • ClusterIP (no admitido)
  • LoadBalancer
  • NodePort

istio

La implementación de Istio en Google Cloud Platform (GCP) es una malla de servicios que se superpone a tu instancia de Apigee para ayudarla a integrarse con la plataforma de registro, la telemetría y el sistema de políticas.

Consulta también la documentación de Istio de GCP y ¿Qué es Istio?

En la siguiente tabla se describen las propiedades del objeto istio:

Propiedad Descripción
istio.ingressgateway.replicaCountMax Versión: 1.0.0

Valor predeterminado: 5

Obligatorio

Número máximo de réplicas de la puerta de enlace de entrada de Istio permitidas.

Consulta los siguientes artículos:
istio.ingressgateway.replicaCountMin Versión: 1.0.0

Valor predeterminado: 1

Obligatorio

Número mínimo de réplicas de la puerta de enlace de entrada de Istio necesarias.

Consulta los siguientes artículos:
istio.ingressgateway.resources.requests.cpu Versión: 1.0.0

Valor predeterminado: 100 m

Obligatorio

Recursos de CPU asignados al controlador de entrada, necesarios para que la pasarela funcione de forma óptima.

Consulta los siguientes artículos:
istio.ingressgateway.resources.requests.memory Versión: 1.0.0

Valor predeterminado: 128 Mi

Recursos de memoria asignados al controlador de entrada, necesarios para que la pasarela funcione de forma óptima.

  • objeto de entrada
  • Ingress Gateways en la documentación de Istio
  • Controladores de entrada en la documentación de Kubernetes.
    		•
    istio.nodeSelector.key Versión: 1.0.0

    Valor predeterminado: ninguno

    Clave de etiqueta de selector de nodo opcional para orientar los nodos de Kubernetes a los servicios de istio. Si no especificas una clave para mart.nodeselector, los servicios istio usarán el nodo especificado en el objeto nodeSelector.
    istio.nodeSelector.value Versión: 1.0.0

    Valor predeterminado: ninguno

    Valor de etiqueta de selector de nodo opcional para orientar los nodos de Kubernetes a los servicios istio. Consulta también el objeto nodeSelector.
    istio.pilot.replicaCountMax Versión: 1.0.0

    Valor predeterminado: 5

    Obligatorio

    La pilot gestión del tráfico principal dentro del clúster, que se comunica con el proxy sidecar envoy. replicaCountMax es el número máximo de réplicas de piloto de Istio permitido.

    Consulta la sección Prueba piloto: gestión del tráfico principal en la documentación de Istio.
    istio.pilot.replicaCountMin Versión: 1.0.0

    Valor predeterminado: 1

    Obligatorio

    La pilot gestión del tráfico principal dentro del clúster, que se comunica con el proxy sidecar envoy. replicaCountMax es el número máximo de réplicas de Istio Pilot necesarias.

    Consulta la sección Prueba piloto: gestión del tráfico principal en la documentación de Istio.
    istio.pilot.resources.requests.cpu Versión: 1.0.0

    Valor predeterminado: 500 m

    Obligatorio

    Recursos de CPU asignados al proceso piloto, necesarios para que la pasarela funcione de forma óptima.

    Consulta los siguientes artículos:
    istio.pilot.resources.requests.memory Versión: 1.0.0

    Valor predeterminado: 2048 Mi

    Recursos de memoria asignados al proceso piloto, necesarios para que la pasarela funcione de forma óptima.

    Consulta los siguientes artículos:

    logger

    Define el servicio que gestiona los registros operativos. Todos los servicios híbridos de Apigee que se ejecutan en tu clúster de Kubernetes generan esta información.

    Para obtener más información, consulta Registro.

    En la siguiente tabla se describen las propiedades del objeto logger:

    Propiedad Descripción
    logger.enabled Versión: 1.0.0

    Valor predeterminado: true

    Habilita o inhabilita el registro en el clúster. En el caso de GKE, se debe definir como true. En el caso de Anthos o GKE, se debe definir como false.
    logger.fluentd.buffer_chunk_limit Versión: 1.0.0

    Valor predeterminado: 512k

    Tamaño máximo permitido de un fragmento de búfer, en kilobytes. Los fragmentos que superen el límite se enviarán automáticamente a la cola de salida.
    logger.fluentd.buffer_queue_limit Versión: 1.0.0

    Valor predeterminado: 6

    Longitud máxima de la cola de salida. El límite predeterminado es de 256 fragmentos.
    logger.fluentd.flush_interval Versión: 1.0.0

    Valor predeterminado: 5s

    Intervalo de espera antes de invocar el siguiente vaciado del búfer, en segundos.
    logger.fluentd.max_retry_wait Versión: 1.0.0

    Valor predeterminado: 30

    Intervalo máximo entre reintentos de escritura, en segundos.
    logger.fluentd.num_threads Versión: 1.0.0

    Valor predeterminado: 2

    Número de subprocesos utilizados para vaciar el búfer. El valor predeterminado es 1.
    logger.image.pullPolicy Versión: 1.0.0

    Valor predeterminado: IfNotPresent

    Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

    • IfNotPresent: no descargues una imagen nueva si ya existe.
    • Always: siempre extrae la imagen, independientemente de si ya existe.

    Para obtener más información, consulta Actualizar imágenes.
    logger.image.tag Versión: 1.0.0

    Valor predeterminado: "1.6.8"

    La etiqueta de versión de la imagen Docker de este servicio.
    logger.image.url Versión: 1.0.0

    Valor predeterminado: "google/apigee-stackdriver-logging-agent"

    Ubicación de la imagen Docker de este servicio.
    logger.livenessProbe.failureThreshold Versión: 1.0.0

    Valor predeterminado: 3

    El número de veces que Kubernetes verificará que las comprobaciones de actividad han fallado antes de reiniciar el contenedor. El valor mínimo es 1.
    logger.livenessProbe.initialDelaySeconds Versión: 1.0.0

    Valor predeterminado: 0

    Número de segundos que transcurren después de iniciar un contenedor antes de que se inicie una prueba de actividad.
    logger.livenessProbe.periodSeconds Versión: 1.0.0

    Valor predeterminado: 60

    Determina la frecuencia con la que se realiza una comprobación de actividad (en segundos). El valor mínimo es 1.
    logger.livenessProbe.successThreshold Versión: 1.0.0

    Valor predeterminado: 1

    Número mínimo de éxitos consecutivos necesarios para que una prueba de actividad se considere correcta después de un fallo. El valor mínimo es 1.
    logger.livenessProbe.timeoutSeconds Versión: 1.0.0

    Valor predeterminado: 1

    Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
    logger.nodeSelector.key Versión: 1.0.0

    Valor predeterminado: "apigee.com/apigee-logger-enabled"

    Obligatorio

    Clave de etiqueta del selector de nodos que se usa para orientar los nodos de Kubernetes dedicados a los servicios de tiempo de ejecución de logger.

    Consulta Añadir selectores de nodos.
    logger.nodeSelector.value Versión: 1.0.0

    Valor predeterminado: "true"

    Obligatorio

    Valor de la etiqueta del selector de nodos que se usa para orientar la publicidad a nodos de Kubernetes dedicados para los servicios de tiempo de ejecución de logger.

    Consulta Añadir selectores de nodos.
    logger.proxyURL Versión: 1.0.0

    Valor predeterminado: ninguno

    URL del servidor proxy del cliente.
    logger.resource.limits.memory Versión: 1.0.0

    Valor predeterminado: 500Mi

    Límite de memoria del recurso en un contenedor de Kubernetes, en mebibytes.
    logger.resource.limits.cpu Versión: 1.0.0

    Valor predeterminado: 200m

    Límite de CPU del recurso en un contenedor de Kubernetes, en milinúcleos.
    logger.resource.requests.cpu Versión: 1.0.0

    Valor predeterminado: 100m

    La CPU necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en milinúcleos.
    logger.resource.requests.memory Versión: 1.0.0

    Valor predeterminado: 250Mi

    La memoria necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en mebibytes.
    logger.serviceAccountPath Versión: 1.0.0

    Valor predeterminado: ninguno

    Obligatorio

    Ruta al archivo de clave de la cuenta de servicio de Google con el rol "Administrador de Apigee de solo lectura".
    logger.terminationGracePeriodSeconds Versión: 1.0.0

    Valor predeterminado: 30

    Tiempo transcurrido entre una solicitud de eliminación de un pod y el momento en que se elimina, en segundos. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución.

    mart

    Define el servicio MART (API de gestión de datos de tiempo de ejecución), que actúa como proveedor de APIs de las APIs públicas de Apigee para que puedas acceder y gestionar entidades de datos de tiempo de ejecución, como KMS (claves de API y tokens de OAuth), KVM, cuota y productos de API.

    En la siguiente tabla se describen las propiedades del objeto mart:

    Propiedad Descripción
    mart.hostAlias Versión: 1.0.0

    Valor predeterminado: ninguno

    El alias de host que apunta al objeto MART. Puedes definir esta propiedad como * o un nombre de dominio completo.
    mart.image.pullPolicy Versión: 1.0.0

    Valor predeterminado: IfNotPresent

    Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

    • IfNotPresent: no descargues una imagen nueva si ya existe.
    • Always: siempre extrae la imagen, independientemente de si ya existe.

    Para obtener más información, consulta Actualizar imágenes.
    mart.image.tag Versión: 1.0.0

    Valor predeterminado: 1.0.0

    La etiqueta de versión de la imagen Docker de este servicio.
    mart.image.url Versión: 1.0.0

    Valor predeterminado: "google/apigee-mart-server"

    Ubicación de la imagen Docker de este servicio. Comprueba el archivo values.yaml para ver la URL específica.Puedes anularla.
    mart.initCheckCF.resources.requests.cpu Versión: 1.0.0

    Valor predeterminado: 10m

    Cantidad de recursos de CPU asignados a la comprobación de inicialización del proceso de Cloud Foundry.
    mart.livenessProbe.failureThreshold Versión: 1.0.0

    Valor predeterminado: 12

    El número de veces que Kubernetes verificará que las comprobaciones de actividad han fallado antes de reiniciar el contenedor. El valor mínimo es 1.
    mart.livenessProbe.initialDelaySeconds Versión: 1.0.0

    Valor predeterminado: 15

    Número de segundos que transcurren después de iniciar un contenedor antes de que se inicie una prueba de actividad.
    mart.livenessProbe.periodSeconds Versión: 1.0.0

    Valor predeterminado: 5

    Determina la frecuencia con la que se realiza una comprobación de actividad (en segundos). El valor mínimo es 1.
    mart.livenessProbe.timeoutSeconds Versión: 1.0.0

    Valor predeterminado: 1

    Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
    mart.metricsURL Versión: 1.0.0

    Valor predeterminado: "/v1/server/metrics"

    mart.nodeSelector.key Versión: 1.0.0

    Valor predeterminado: ninguno

    Clave de etiqueta de selector de nodo opcional para orientar los nodos de Kubernetes a los servicios de tiempo de ejecución de mart. Si no especificas una clave para mart.nodeselector, tu tiempo de ejecución usará el nodo especificado en el objeto nodeSelector.

    Consulta Añadir selectores de nodos.
    mart.nodeSelector.value Versión: 1.0.0

    Valor predeterminado: ninguno

    Valor de etiqueta de selector de nodo opcional para orientar los nodos de Kubernetes a los servicios de tiempo de ejecución de mart. Consulta también el objeto nodeSelector.

    Consulta Añadir selectores de nodos.
    mart.readinessProbe.failureThreshold Versión: 1.0.0

    Valor predeterminado: 2

    Número de veces que Kubernetes verificará que las sondas de preparación han fallado antes de marcar el pod como no preparado. El valor mínimo es 1.
    mart.readinessProbe.initialDelaySeconds Versión: 1.0.0

    Valor predeterminado: 15

    Número de segundos que deben transcurrir después de iniciar un contenedor para que se inicie una sonda de disponibilidad.
    mart.readinessProbe.periodSeconds Versión: 1.0.0

    Valor predeterminado: 5

    Determina la frecuencia con la que se realiza una comprobación de disponibilidad (en segundos). El valor mínimo es 1.
    mart.readinessProbe.successThreshold Versión: 1.0.0

    Valor predeterminado: 1

    Número mínimo de éxitos consecutivos necesarios para que una sonda de disponibilidad se considere correcta después de un fallo. El valor mínimo es 1.
    mart.readinessProbe.timeoutSeconds Versión: 1.0.0

    Valor predeterminado: 1

    Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
    mart.replicaCountMax Versión: 1.0.0

    Valor predeterminado: 5

    Número máximo de réplicas disponibles para el autoescalado.
    mart.replicaCountMin Versión: 1.0.0

    Valor predeterminado: 1

    Número mínimo de réplicas disponibles para el autoescalado.
    mart.resources.requests.cpu Versión: 1.0.0

    Valor predeterminado: 500m

    La CPU necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en milinúcleos.
    mart.resources.requests.memory Versión: 1.0.0

    Valor predeterminado: 512Mi

    La memoria necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en mebibytes.
    mart.serviceAccountPath Versión: 1.1.1

    Valor predeterminado: ninguno

    Obligatorio

    Ruta al archivo de clave de la cuenta de servicio de Google con el rol "Administrador de Apigee de solo lectura".
    mart.sslCertPath Versión: 1.0.0

    Valor predeterminado: ninguno

    Ruta del sistema de archivos local para cargar y codificar el certificado SSL en un secreto.
    mart.sslKeyPath Versión: 1.0.0

    Valor predeterminado: ninguno

    Ruta del sistema de archivos local para cargar y codificar la clave SSL en un secreto.
    mart.targetCPUUtilizationPercentage Versión: 1.0.0

    Valor predeterminado: 75

    Uso de CPU objetivo del proceso MART en el pod. El valor de este campo permite que MART se ajuste automáticamente cuando el uso de la CPU alcance este valor, hasta replicaCountMax.
    mart.terminationGracePeriodSeconds Versión: 1.0.0

    Valor predeterminado: 30

    Tiempo transcurrido entre una solicitud de eliminación de un pod y el momento en que se elimina, en segundos. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución.

    metrics

    Define el servicio que recoge métricas de operaciones. Puedes usar los datos de métricas para monitorizar el estado de los servicios híbridos, configurar alertas, etc.

    Para obtener más información, consulta el artículo Información general sobre la recogida de métricas.

    En la siguiente tabla se describen las propiedades del objeto metrics:

    Propiedad Descripción
    metrics.enabled Versión: 1.0.0

    Valor predeterminado: false

    Habilita las métricas de Apigee. Asigna el valor true para habilitar las métricas. Asigna el valor false para inhabilitar las métricas.

    metrics.nodeSelector.key Versión: 1.0.0

    Valor predeterminado: ninguno

    Obligatorio

    Clave de etiqueta del selector de nodos que se usa para orientar los nodos de Kubernetes dedicados a los servicios de tiempo de ejecución de metrics.

    Consulta Añadir selectores de nodos.
    metrics.nodeSelector.value Versión: 1.0.0

    Valor predeterminado: ninguno

    Obligatorio

    Valor de la etiqueta del selector de nodos que se usa para orientar la publicidad a nodos de Kubernetes dedicados para los servicios de tiempo de ejecución de metrics.

    Consulta Añadir selectores de nodos.
    metrics.prometheus.args.storage_tsdb_retention Versión: 1.0.0

    Valor predeterminado: 48h

    Tiempo que espera Prometheus antes de eliminar los datos antiguos del almacenamiento local (en horas).
    metrics.prometheus.containerPort Versión: 1.0.0

    Valor predeterminado: 9090

    Puerto para conectarse al servicio de métricas de Prometheus.
    metrics.prometheus.image.pullPolicy Versión: 1.0.0

    Valor predeterminado: IfNotPresent

    Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

    • IfNotPresent: no descargues una imagen nueva si ya existe.
    • Always: siempre extrae la imagen, independientemente de si ya existe.

    Para obtener más información, consulta Actualizar imágenes.
    metrics.prometheus.image.tag Versión: 1.0.0

    Valor predeterminado: "v2.9.2"

    La etiqueta de versión de la imagen Docker de este servicio.
    metrics.prometheus.image.url Versión: 1.0.0

    Valor predeterminado: "google/apigee-prom-prometheus"

    Ubicación de la imagen Docker de este servicio.
    metrics.prometheus.livenessProbe.failureThreshold Versión: 1.0.0

    Valor predeterminado: 6

    El número de veces que Kubernetes verificará que las comprobaciones de actividad han fallado antes de reiniciar el contenedor. El valor mínimo es 1.
    metrics.prometheus.livenessProbe.periodSeconds Versión: 1.0.0

    Valor predeterminado: 5

    Determina la frecuencia con la que se realiza una comprobación de actividad (en segundos). El valor mínimo es 1.
    metrics.prometheus.livenessProbe.timeoutSeconds Versión: 1.0.0

    Valor predeterminado: 3

    Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
    metrics.prometheus.readinessProbe.failureThreshold Versión: 1.0.0

    Valor predeterminado: 120

    Número de veces que Kubernetes verificará que las sondas de preparación han fallado antes de marcar el pod como no preparado. El valor mínimo es 1.
    metrics.prometheus.readinessProbe.periodSeconds Versión: 1.0.0

    Valor predeterminado: 5

    Determina la frecuencia con la que se realiza una comprobación de disponibilidad (en segundos). El valor mínimo es 1.
    metrics.prometheus.readinessProbe.timeoutSeconds Versión: 1.0.0

    Valor predeterminado: 3

    Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
    metrics.proxyURL Versión: 1.0.0

    Valor predeterminado: ninguno

    URL del proxy sidecar del proceso de métricas en el clúster de Kubernetes.

    metrics.resources.limits.cpu Versión: 1.0.0

    Valor predeterminado: 250m

    Límite de CPU del recurso en un contenedor de Kubernetes, en milinúcleos.
    metrics.resources.limits.memory Versión: 1.0.0

    Valor predeterminado: 256Mi

    Límite de memoria del recurso en un contenedor de Kubernetes, en mebibytes.
    metrics.resources.requests.cpu Versión: 1.0.0

    Valor predeterminado: 250m

    La CPU necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en milinúcleos.
    metrics.resources.requests.memory Versión: 1.0.0

    Valor predeterminado: 256Mi

    La memoria necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en mebibytes.
    metrics.sdSidecar.containerPort Versión: 1.0.0

    Valor predeterminado: 9091

    Puerto para conectarse al servicio de métricas de Stackdriver.
    metrics.sdSidecar.image.pullPolicy Versión: 1.0.0

    Valor predeterminado: IfNotPresent

    Determina cuándo extrae Kubelet la imagen Docker de este servicio. Estos son algunos de los posibles valores:

    • IfNotPresent: no extraigas una imagen nueva si ya existe
    • Always: siempre se debe extraer la política, aunque ya exista.

      Para obtener más información, consulta Actualizar imágenes.
    metrics.sdSidecar.image.tag Versión: 1.0.0

    Valor predeterminado: "release-0.4.0"

    La etiqueta de versión de la imagen Docker de este servicio.
    metrics.sdSidecar.image.url Versión: 1.0.0

    Valor predeterminado: "google/apigee-stackdriver-prometheus-sidecar"

    Ubicación de la imagen Docker de este servicio.
    metrics.serviceAccountPath Versión: 1.0.0

    Valor predeterminado: ninguno

    Obligatorio

    Ruta al archivo de clave de la cuenta de servicio de Google con el rol "Administrador de Apigee de solo lectura".
    metrics.terminationGracePeriodSeconds Versión: 1.0.0

    Valor predeterminado: 300

    Tiempo transcurrido entre una solicitud de eliminación de un pod y el momento en que se elimina, en segundos. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución.

    nodeSelector

    El objeto nodeSelector define el nodo de tu instancia de Apigee. Cuando se ejecuta apigeectl, se encarga de asignar el par clave-valor de la etiqueta de apigeeRuntime y apigeeData a los componentes individuales de Istio y MART. Puedes anularlo en objetos concretos con las propiedades istio:nodeSelector y mart:nodeSelector.

    En la siguiente tabla se describen las propiedades del objeto nodeSelector:

    Propiedad Descripción
    nodeSelector.apigeeData.key Versión: 1.0.0

    Valor predeterminado: "cloud.google.com/gke-nodepool"

    ApigeeData es el nodo de la base de datos de Cassandra. Clave de etiqueta del selector de nodos para orientar los nodos de Kubernetes para trabajar con datos de servicios de Apigee.

    Consulta Añadir selectores de nodos.
    nodeSelector.apigeeData.value Versión: 1.0.0

    Valor predeterminado: "apigee-data"

    apigee-data es el nodo de la base de datos de Cassandra. Valor de la etiqueta del selector de nodos para orientar los nodos de Kubernetes para trabajar con datos de servicios de Apigee.

    Consulta Añadir selectores de nodos.
    nodeSelector.apigeeRuntime.key Versión: 1.0.0

    Valor predeterminado: "cloud.google.com/gke-nodepool"

    Apigee Runtime es el nodo del entorno de ejecución del proyecto. Clave de etiqueta del selector de nodos para orientar los nodos de Kubernetes a los servicios de tiempo de ejecución de Apigee.

    Consulta Añadir selectores de nodos.
    nodeSelector.apigeeRuntime.value Versión: 1.0.0

    Valor predeterminado: "apigee-runtime"

    apigee-runtime es el nodo del entorno de tiempo de ejecución del proyecto. Valor de la etiqueta del selector de nodos para orientar los nodos de Kubernetes a los servicios de tiempo de ejecución de Apigee.

    Consulta Añadir selectores de nodos.
    nodeSelector.requiredForScheduling Versión: 1.0.0

    Valor predeterminado: false

    El valor predeterminado de la propiedad requiredForScheduling es false. Si este valor se sustituye por true, significa que, si Kubernetes no encuentra nodos con la clave o el valor de la etiqueta configurados, los pods subyacentes no se programarán en los nodos de trabajo de la VM.

    En producción, nodeSelector.requiredForScheduling debe tener el valor "true".

    Consulta Añadir selectores de nodos.

    runtime

    En la siguiente tabla se describen las propiedades del objeto runtime:

    Propiedad Descripción
    runtime.image.pullPolicy Versión: 1.0.0

    Valor predeterminado: IfNotPresent

    Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

    • IfNotPresent: no descargues una imagen nueva si ya existe.
    • Always: siempre extrae la imagen, independientemente de si ya existe.

    Para obtener más información, consulta Actualizar imágenes.
    runtime.image.tag Versión: 1.0.0

    Valor predeterminado: 1.0.0

    La etiqueta de versión de la imagen Docker de este servicio.
    runtime.image.url Versión: 1.0.0

    Valor predeterminado: URL del recurso de imagen de tu instalación, como: "google/apigee-runtime"

    Ubicación de la imagen Docker de este servicio.
    runtime.livenessProbe.failureThreshold Versión: 1.0.0

    Valor predeterminado: 2

    El número de veces que Kubernetes verificará que las comprobaciones de actividad han fallado antes de reiniciar el contenedor. El valor mínimo es 1.
    runtime.livenessProbe.initialDelaySeconds Versión: 1.0.0

    Valor predeterminado: 60

    Número de segundos que transcurren después de iniciar un contenedor antes de que se inicie una prueba de actividad.
    runtime.livenessProbe.periodSeconds Versión: 1.0.0

    Valor predeterminado: 5

    Determina la frecuencia con la que se realiza una comprobación de actividad (en segundos). El valor mínimo es 1.
    runtime.livenessProbe.timeoutSeconds Versión: 1.0.0

    Valor predeterminado: 1

    Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
    runtime.nodeSelector.key Versión: 1.0.0

    Valor predeterminado: ninguno

    Clave de etiqueta de selector de nodo opcional para orientar los servicios de runtime a nodos de Kubernetes.

    Consulta la propiedad nodeSelector.
    runtime.nodeSelector.value Versión: 1.0.0

    Valor predeterminado: ninguno

    Valor de la etiqueta del selector de nodos para orientar los nodos de Kubernetes a los servicios de runtime.

    Consulta Añadir selectores de nodos.
    runtime.readinessProbe.failureThreshold Versión: 1.0.0

    Valor predeterminado: 2

    Número de veces que Kubernetes verificará que las sondas de preparación han fallado antes de marcar el pod como no preparado. El valor mínimo es 1.
    runtime.readinessProbe.initialDelaySeconds Versión: 1.0.0

    Valor predeterminado: 60

    Número de segundos que deben transcurrir después de iniciar un contenedor para que se inicie una sonda de disponibilidad.
    runtime.readinessProbe.periodSeconds Versión: 1.0.0

    Valor predeterminado: 5

    Determina la frecuencia con la que se realiza una comprobación de disponibilidad (en segundos). El valor mínimo es 1.
    runtime.readinessProbe.successThreshold Versión: 1.0.0

    Valor predeterminado: 1

    Número mínimo de éxitos consecutivos necesarios para que una sonda de disponibilidad se considere correcta después de un fallo. El valor mínimo es 1.
    runtime.readinessProbe.timeoutSeconds Versión: 1.0.0

    Valor predeterminado: 1

    Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
    runtime.replicaCountMax Versión: 1.0.0

    Valor predeterminado: 4

    Número máximo de réplicas disponibles para el autoescalado.
    runtime.replicaCountMin Versión: 1.0.0

    Valor predeterminado: 1

    Número mínimo de réplicas disponibles para el autoescalado.
    runtime.resources.requests.cpu Versión: 1.0.0

    Valor predeterminado: 500m

    La CPU necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en milinúcleos.
    runtime.resources.requests.memory Versión: 1.0.0

    Valor predeterminado: 1Gi

    La memoria necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en mebibytes.
    runtime.service.type Versión: 1.0.0

    Valor predeterminado: ClusterIP

    El tipo de servicio. Puedes definirlo en un servicio que no sea ClusterIP, por ejemplo, LoadBalancer.
    runtime.targetCPUUtilizationPercentage Versión: 1.0.0

    Valor predeterminado: 75

    Uso de CPU objetivo del proceso de tiempo de ejecución en el pod. El valor de este campo permite que el tiempo de ejecución se escale automáticamente cuando el uso de la CPU alcance este valor, hasta replicaCountMax.
    runtime.terminationGracePeriodSeconds Versión: 1.0.0

    Valor predeterminado: 180

    Tiempo transcurrido entre una solicitud de eliminación de un pod y el momento en que se elimina, en segundos. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución.

    synchronizer

    Asegura que los procesadores de mensajes estén actualizados con los últimos paquetes de proxies de API implementados. Para ello, el sincronizador sondea el plano de gestión. Cuando se detecta un nuevo contrato, el sincronizador lo envía al plano de tiempo de ejecución.

    Para obtener más información, consulta Sincronizador.

    En la siguiente tabla se describen las propiedades del objeto synchronizer:

    Propiedad Descripción
    synchronizer.image.pullPolicy Versión: 1.0.0

    Valor predeterminado: IfNotPresent

    Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

    • IfNotPresent: no descargues una imagen nueva si ya existe.
    • Always: siempre extrae la imagen, independientemente de si ya existe.

    Para obtener más información, consulta Actualizar imágenes.
    synchronizer.image.tag Versión: 1.0.0

    Valor predeterminado: 1.0.0

    La etiqueta de versión de la imagen Docker de este servicio.
    synchronizer.image.url Versión: 1.0.0

    Valor predeterminado: "google/apigee-synchronizer"

    Ubicación de la imagen Docker de este servicio.
    synchronizer.livenessProbe.failureThreshold Versión: 1.0.0

    Valor predeterminado: 2

    El número de veces que Kubernetes verificará que las comprobaciones de actividad han fallado antes de reiniciar el contenedor. El valor mínimo es 1.
    synchronizer.livenessProbe.initialDelaySeconds Versión: 1.0.0

    Valor predeterminado: 0

    Número de segundos que transcurren después de iniciar un contenedor antes de que se inicie una prueba de actividad.
    synchronizer.livenessProbe.periodSeconds Versión: 1.0.0

    Valor predeterminado: 5

    Determina la frecuencia con la que se realiza una comprobación de actividad (en segundos). El valor mínimo es 1.
    synchronizer.livenessProbe.timeoutSeconds Versión: 1.0.0

    Valor predeterminado: 1

    Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
    synchronizer.nodeSelector.key Versión: 1.0.0

    Valor predeterminado: ninguno

    Obligatorio

    Clave de etiqueta de selector de nodo opcional para orientar los nodos de Kubernetes a los servicios de tiempo de ejecución de synchronizer.

    Consulta nodeSelector.
    synchronizer.nodeSelector.value Versión: 1.0.0

    Valor predeterminado: ninguno

    Valor de etiqueta de selector de nodo opcional que se usa para orientar los nodos de Kubernetes a los servicios de tiempo de ejecución de synchronizer.

    Consulta nodeSelector.
    synchronizer.pollInterval Versión: 1.0.0

    Valor predeterminado: 60

    Tiempo que espera Synchronizer entre operaciones de sondeo. Synchronizer sondea los servicios del plano de control de Apigee para detectar y extraer nuevos contratos de tiempo de ejecución.
    synchronizer.readinessProbe.failureThreshold Versión: 1.0.0

    Valor predeterminado: 2

    Número de veces que Kubernetes verificará que las sondas de preparación han fallado antes de marcar el pod como no preparado. El valor mínimo es 1.
    synchronizer.readinessProbe.initialDelaySeconds Versión: 1.0.0

    Valor predeterminado: 0

    Número de segundos que deben transcurrir después de iniciar un contenedor para que se inicie una sonda de disponibilidad.
    synchronizer.readinessProbe.periodSeconds Versión: 1.0.0

    Valor predeterminado: 5

    Determina la frecuencia con la que se realiza una comprobación de disponibilidad (en segundos). El valor mínimo es 1.
    synchronizer.readinessProbe.successThreshold Versión: 1.0.0

    Valor predeterminado: 1

    Número mínimo de éxitos consecutivos necesarios para que una sonda de disponibilidad se considere correcta después de un fallo. El valor mínimo es 1.
    synchronizer.readinessProbe.timeoutSeconds Versión: 1.0.0

    Valor predeterminado: 1

    Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
    synchronizer.replicaCount Versión: 1.0.0

    Valor predeterminado: 2

    Número de réplicas para el autoescalado.
    synchronizer.resources.requests.cpu Versión: 1.0.0

    Valor predeterminado: 100m

    La CPU necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en milinúcleos.
    synchronizer.resources.requests.memory Versión: 1.0.0

    Valor predeterminado: 1Gi

    La memoria necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en gigabytes.
    synchronizer.serviceAccountPath Versión: 1.0.0

    Valor predeterminado: ninguno

    Obligatorio

    Ruta al archivo de clave de la cuenta de servicio de Google con el rol "Administrador de Apigee de solo lectura".
    synchronizer.targetCPUUtilizationPercentage Versión: 1.0.0

    Valor predeterminado: 75

    Uso de CPU objetivo del proceso Synchronizer en el pod. El valor de este campo permite que el sincronizador se ajuste automáticamente cuando el uso de la CPU alcance este valor, hasta replicaCountMax.

    synchronizer.terminationGracePeriodSeconds Versión: 1.0.0

    Valor predeterminado: 30

    Tiempo transcurrido entre una solicitud de eliminación de un pod y el momento en que se elimina, en segundos. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución.

    udca

    (Agente de recogida de datos universal) Define el servicio que se ejecuta en el pod de recogida de datos en el plano de tiempo de ejecución. Este servicio extrae datos de analíticas y de estado de la implementación, y los envía a la plataforma de analíticas unificada (UAP).

    Para obtener más información, consulta el artículo Recogida de datos de Analytics y del estado de la implementación.

    En la siguiente tabla se describen las propiedades del objeto udca:

    Propiedad Descripción
    udca.fluentd.image.pullPolicy Versión: 1.0.0

    Valor predeterminado: IfNotPresent

    Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

    • IfNotPresent: no descargues una imagen nueva si ya existe.
    • Always: siempre extrae la imagen, independientemente de si ya existe.

    Para obtener más información, consulta Actualizar imágenes.
    udca.fluentd.image.tag Versión: 1.0.0

    Valor predeterminado: 1.0.0

    La etiqueta de versión de la imagen Docker de este servicio.
    udca.fluentd.image.url Versión: 1.0.0

    Valor predeterminado: "google/apigee-stackdriver-logging-agent"

    Ubicación de la imagen Docker de este servicio.
    udca.fluentd.resource.limits.memory Versión: 1.0.0

    Valor predeterminado: 500Mi

    Límite de memoria del recurso en un contenedor de Kubernetes, en mebibytes.
    udca.fluentd.resource.requests.cpu Versión: 1.0.0

    Valor predeterminado: 500m

    La CPU necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en milinúcleos.
    udca.fluentd.resource.requests.memory Versión: 1.0.0

    Valor predeterminado: 250Mi

    La memoria necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en mebibytes.
    udca.image.pullPolicy Versión: 1.0.0

    Valor predeterminado: IfNotPresent

    Determina cuándo kubelet extrae la imagen Docker del pod. Estos son algunos de los posibles valores:

    • IfNotPresent: no descargues una imagen nueva si ya existe.
    • Always: siempre extrae la imagen, independientemente de si ya existe.

    Para obtener más información, consulta Actualizar imágenes.
    udca.image.tag Versión: 1.0.0

    Valor predeterminado: "1.0.0"

    La etiqueta de versión de la imagen Docker de este servicio.
    udca.image.url Versión: 1.0.0

    Valor predeterminado: "google/apigee-udca"

    Ubicación de la imagen Docker de este servicio.
    udca.jvmXms Versión: 1.0.0

    Valor predeterminado: 256m

    Cantidad inicial de memoria de la JVM del pod de recogida de datos.
    udca.jvmXmx Versión: 1.0.0

    Valor predeterminado: 256m

    Asignación máxima de memoria para la JVM del pod de recogida de datos.
    udca.livenessProbe.failureThreshold Versión: 1.0.0

    Valor predeterminado: 2

    El número de veces que Kubernetes verificará que las comprobaciones de actividad han fallado antes de reiniciar el contenedor. El valor mínimo es 1.
    udca.livenessProbe.initialDelaySeconds Versión: 1.0.0

    Valor predeterminado: 0

    Número de segundos que transcurren después de iniciar un contenedor antes de que se inicie una prueba de actividad.
    udca.livenessProbe.periodSeconds Versión: 1.0.0

    Valor predeterminado: 5

    Determina la frecuencia con la que se realiza una comprobación de actividad (en segundos). El valor mínimo es 1.
    udca.livenessProbe.timeoutSeconds Versión: 1.0.0

    Valor predeterminado: 1

    Número de segundos tras los cuales se agota el tiempo de espera de una prueba de actividad. El valor mínimo es 1.
    udca.nodeSelector.key Versión: 1.0.0

    Valor predeterminado: ninguno

    Obligatorio

    Clave de etiqueta del selector de nodos que se usa para orientar los nodos de Kubernetes dedicados a los servicios de tiempo de ejecución de udca.

    Consulta Añadir selectores de nodos.
    udca.nodeSelector.value Versión: 1.0.0

    Valor predeterminado: ninguno

    Obligatorio

    Valor de la etiqueta del selector de nodos que se usa para orientar la publicidad a nodos de Kubernetes dedicados para los servicios de tiempo de ejecución de udca.

    Consulta Añadir selectores de nodos.
    udca.pollingIntervalInSec Versión: 1.0.0

    Valor predeterminado: 1

    Tiempo, en segundos, que espera UDCA entre operaciones de sondeo. UDCA sondea el directorio de datos en el sistema de archivos del pod de recogida de datos para detectar los archivos nuevos que se van a subir.
    prometheus.sslCertPath Versión: 1.0.0

    Valor predeterminado: ninguno

    Obligatorio

    Ruta al certificado SSL del proceso de recogida de métricas de Prometheus. Prometheus es una herramienta que Apigee puede usar para recoger y procesar métricas.

    Consulta los siguientes artículos:

    prometheus.sslKeyPath Versión: 1.0.0

    Valor predeterminado: ninguno

    Obligatorio

    Ruta a la clave SSL del proceso de recogida de métricas de Prometheus. Prometheus es una herramienta que Apigee puede usar para recoger y procesar métricas.

    Consulta los siguientes artículos:

    udca.replicaCountMax Versión: 1.0.0

    Valor predeterminado: 4

    El número máximo de pods que la opción híbrida puede añadir automáticamente al despliegue de UDCA. Como UDCA se implementa como un ReplicaSet, los pods son réplicas.
    udca.replicaCountMin Versión: 1.0.0

    Valor predeterminado: 1

    El número mínimo de pods para la implementación de UDCA. Como UDCA se implementa como un ReplicaSet, los pods son réplicas.

    Si el uso de la CPU supera udca.targetCPUUtilizationPercentage, la opción híbrida aumentará gradualmente el número de pods hasta udca.replicaCountMax.
    udca.resource.requests.cpu Versión: 1.0.0

    Valor predeterminado: 250m

    La CPU necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en milinúcleos.
    udca.revision Versión: 1

    Valor predeterminado: "v1"

    Valor estático que se rellena en una etiqueta para habilitar las implementaciones canary.
    udca.targetCPUUtilizationPercentage Versión: 1.0.0

    Valor predeterminado: 75

    Umbral de uso de CPU para escalar el número de pods del ReplicaSet, como porcentaje del total de recursos de CPU disponibles. Híbrido usa la utilización combinada de todos los contenedores del pod de recogida de datos (tanto fluentd como UDCA) para calcular la utilización actual.

    Cuando el uso de la CPU supere este valor, el sistema híbrido aumentará gradualmente el número de pods del ReplicaSet hasta udca.replicaCountMax.
    udca.terminationGracePeriodSeconds Versión: 1.0.0

    Valor predeterminado: 600

    Tiempo transcurrido entre una solicitud de eliminación de un pod y el momento en que se elimina, en segundos. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución.