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 Deprecated: En la versión 1.2.0 y posteriores, usa gcp.projectID.

Versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio

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

gcpRegion Deprecated: En la versión 1.2.0 y posteriores, usa gcp.region.

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 (obsoleto) y k8sClusterName (obsoleto) 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 Deprecated: En la versión 1.2.0 y posteriores, usa k8sCluster.name y k8sCluster.region en su lugar.

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 (obsoleto) y gcpRegion (obsoleto) para identificar el proyecto y determinar dónde envían sus datos apigee-logger y apigee-metrics.

kmsEncryptionKey Versión: 1.0.0

Valor predeterminado: defaults.org.kmsEncryptionKey

Opcional. Usa solo uno de los campos kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Ruta del sistema de archivos local de la clave de cifrado de los datos del KMS de Apigee.

kmsEncryptionPath Versión: 1.2.0

Valor predeterminado: ninguno

Opcional. Usa solo uno de los campos kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Ruta a un archivo que contiene una clave de cifrado codificada en base64. Consulta Cifrado de datos.

kmsEncryptionSecret.key Versión: 1.2.0

Valor predeterminado: ninguno

Opcional. Usa solo uno de los campos kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

La clave de un secreto de Kubernetes que contiene una clave de cifrado codificada en base64. Consulta Cifrado de datos.

kmsEncryptionSecret.name Versión: 1.2.0

Valor predeterminado: ninguno

Opcional. Usa solo uno de los campos kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Nombre de un secreto de Kubernetes que contiene una clave de cifrado codificada en base64. Consulta Cifrado de datos.

kvmEncryptionKey Versión: 1.0.0

Valor predeterminado: defaults.org.kmsEncryptionKey

Opcional. Usa solo uno de los siguientes campos: kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

Ruta del sistema de archivos local de la clave de encriptado de los datos de KVM de Apigee.

kvmEncryptionPath Versión: 1.2.0

Valor predeterminado: ninguno

Opcional. Usa solo uno de los siguientes campos: kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

Ruta a un archivo que contiene una clave de cifrado codificada en base64. Consulta Cifrado de datos.

kvmEncryptionSecret.key Versión: 1.2.0

Valor predeterminado: ninguno

Opcional. Usa solo uno de los siguientes campos: kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

La clave de un secreto de Kubernetes que contiene una clave de cifrado codificada en base64. Consulta Cifrado de datos.

kvmEncryptionSecret.name Versión: 1.2.0

Valor predeterminado: ninguno

Opcional. Usa solo uno de los siguientes campos: kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

Nombre de un secreto de Kubernetes que contiene una clave de cifrado codificada en base64. Consulta Cifrado de datos.

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

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: v120

Apigee hybrid admite actualizaciones continuas de Kubernetes, que permiten que las actualizaciones de despliegue se realicen sin tiempo de inactividad actualizando de forma incremental las instancias de Pod con otras nuevas.

Cuando se actualizan ciertas anulaciones de YAML que provocan un cambio en el elemento subyacente Kubernetes PodTemplateSpec, la propiedad de anulación revision también debe cambiarse 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 en minúsculas, por ejemplo: "blue", "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.

ao

Apigee Operators (AO) crea y actualiza recursos de Kubernetes e Istio de bajo nivel que son necesarios para desplegar y mantener ApigeeDeployment (AD). Por ejemplo, el controlador lleva a cabo la liberación de procesadores de mensajes. También valida la configuración de ApigeeDeployment antes de conservarla en el clúster de Kubernetes.

En la siguiente tabla se describen las propiedades del objeto ao de apigee-operators:

Propiedad Descripción
ao.image.pullPolicy Versión: 1.2.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.

ao.image.tag Versión: 1.2.0

Valor predeterminado: 1.2.0

La etiqueta de versión de la imagen Docker de este servicio.

ao.image.url Versión: 1.2.0

Valor predeterminado: "google/apigee-deployment-controller"

Ubicación de la imagen Docker de este servicio.

ao.resources.limits.cpu Versión: 1.2.0

Valor predeterminado: 250m

Límite de CPU del recurso en un contenedor de Kubernetes, en milinúcleos.

ao.resources.limits.memory Versión: 1.2.0

Valor predeterminado: 256Mi

Límite de memoria del recurso en un contenedor de Kubernetes, en mebibytes.

ao.resources.requests.cpu Versión: 1.2.0

Valor predeterminado: 250m

La CPU necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en milinúcleos.

ao.resources.requests.memory Versión: 1.2.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.2.0

La etiqueta de versión de la imagen Docker de este servicio.

authz.image.url Versión: 1.0.0

Valor predeterminado: "google/apigee-authn-authz"

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 que se inicia 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 disponibilidad han fallado antes de marcar el pod como no disponible. 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.

busyBoxInit (desactivada)

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

Propiedad Descripción
busyBoxInit.image.pullPolicy Deprecated.

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 Deprecated.

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 Deprecated.

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 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.2.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-hybrid-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 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.2.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

Si la copia de seguridad está habilitada, se debe especificar backup.serviceAccountPath o backup.serviceAccountSecretRef.

Ruta al archivo de clave de la cuenta de servicio de Google con el rol Administrador de objetos de Storage.

cassandra.backup.serviceAccountSecretRef Versión: 1.2.0

Valor predeterminado: ninguno

Si la copia de seguridad está habilitada, se debe especificar backup.serviceAccountPath o backup.serviceAccountSecretRef.

Nombre de un secreto de Kubernetes. Debes crear el secreto con una clave de cuenta de servicio de Google que tenga el rol Administrador de objetos de Storage.

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.

Si cassandra.hostNetwork se define como false, se ignora cassandra.dnsPolicy.

Consulta Política de DNS de los pods en la documentación de Kubernetes para ver más valores de cassandra.dnsPolicy.

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 para las implementaciones de Anthos. false para las implementaciones que no son de Anthos.

Se define como true para las implementaciones basadas en Anthos.

Si cassandra.hostNetwork es true, asegúrate de que cassandra.dnsPolicy esté configurado como ClusterFirstWithHostNet.

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.2.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-hybrid-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 inicialización 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 disponibilidad han fallado antes de marcar el pod como no disponible. 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: 1

Cassandra es una base de datos replicada. 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 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.2.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

Si la restauración está habilitada, se debe especificar restore.serviceAccountPath o restore.serviceAccountSecretRef.

Ruta al archivo de clave de la cuenta de servicio de Google con el rol Administrador de objetos de Storage.

cassandra.restore.serviceAccountSecretRef Versión: 1.2.0

Valor predeterminado: ninguno

Si la restauración está habilitada, se debe especificar restore.serviceAccountPath o restore.serviceAccountSecretRef.

Nombre de un secreto de Kubernetes. Debes crear el secreto con una clave de cuenta de servicio de Google que tenga el rol Administrador de objetos de Storage.

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.restore.user Versión: 1.0.0

Valor predeterminado: cuenta de administrador

Nombre de usuario de Cassandra que se usa para restaurar la copia de seguridad del esquema. Si no se especifica, se usará el usuario administrador.

cassandra.sslCertPath Versión: 1.2.0

Valor predeterminado: ninguno

Ruta de tu sistema a un archivo de certificado TLS.

cassandra.sslKeyPath Versión: 1.2.0

Valor predeterminado: ninguno

Ruta de tu sistema al archivo de clave privada TLS.

cassandra.sslRootCAPath Versión: 1.2.0

Valor predeterminado: ninguno

La cadena de certificados de la AC raíz (autoridad de certificación).

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.

certmanager

cert-manager es un gestor de certificados para implementaciones de Kubernetes que usa Apigee. Consulta Te damos la bienvenida a cert-manager.

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

Propiedad Descripción
certmanager.image.tag Versión: 1.2.0

Valor predeterminado: "v0.12.0"

La etiqueta de versión de la imagen Docker de este servicio.

certmanager.image.url Versión: 1.2.0

Valor predeterminado: "apigee-cert-manager-controller"

Ubicación de la imagen Docker de este servicio.

certmanagercainjector

El inyector de AC de cert-manager es un proceso de cert-manager responsable de inyectar el paquete de AC en el proceso de webhook de cert-manager. Consulta CA injector en la documentación de cert-manager.

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

Propiedad Descripción
certmanagercainjector.image.tag Versión: 1.2.0

Valor predeterminado: "v0.12.0"

La etiqueta de versión de la imagen Docker de este servicio.

certmanagercainjector.image.url Versión: 1.2.0

Valor predeterminado: "google/apigee-cert-manager-cainjector"

Ubicación de la imagen Docker de este servicio.

certmanagerwebhook

El webhook de cert-manager es un proceso que proporciona un control de admisión dinámico sobre los recursos de cert-manager. Consulta Webhook en la documentación de cert-manager.

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

Propiedad Descripción
certmanagerwebhook.image.tag Versión: 1.2.0

Valor predeterminado: "v0.12.0"

La etiqueta de versión de la imagen Docker de este servicio.

certmanagerwebhook.image.url Versión: 1.2.0

Valor predeterminado: "google/apigee-cert-manager-webhook"

Ubicación de la imagen Docker de este servicio.

connectAgent

Apigee Connect permite que el plano de gestión de Apigee hybrid se conecte de forma segura al servicio MART del plano de entorno de ejecución sin que tengas que exponer el endpoint de MART en Internet. Si usas Apigee Connect, no tienes que configurar la pasarela de entrada de MART con un alias de host y un certificado DNS autorizado.

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

Propiedad Descripción
connectAgent.enabled Versión: 1.2.0

Valor predeterminado: false

¿Esta instalación usa Apigee Connect en lugar de Istio Ingress para MART? ¿Verdadero o falso?

Consulta Usar Apigee Connect.

connectAgent.server Versión: 1.2.0

Valor predeterminado: "apigeeconnect.googleapis.com:443"

La ubicación del servidor y el puerto de este servicio.

connectAgent.logLevel Versión: 1.2.0

Valor predeterminado: "INFO"

El nivel de los registros. Los valores pueden ser:

  • INFO: mensajes informativos, además de mensajes de advertencia, error y error crítico. Es muy útil para depurar errores.
  • WARNING: advertencias no críticas, además de mensajes de error y críticos.
  • ERROR: errores internos y errores que no se devuelven al usuario, además de mensajes críticos.
  • FATAL: errores y eventos irrecuperables que provocan que Apigee Connect falle.
connectAgent.image.pullPolicy Versión: 1.2.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.

connectAgent.image.tag Versión: 1.2.0

Valor predeterminado: "1.2.0"

La etiqueta de versión de la imagen Docker de este servicio.

connectAgent.image.url Versión: 1.2.0

Valor predeterminado: "google/apigee-connect-agent"

Ubicación de la imagen Docker de este servicio. Comprueba el archivo values.yaml para ver la URL específica.

connectAgent.replicaCountMax Versión: 1.2.0

Valor predeterminado: 5

Número máximo de réplicas disponibles para el autoescalado.

connectAgent.replicaCountMin Versión: 1.2.0

Valor predeterminado: 1

Número mínimo de réplicas disponibles para el autoescalado.

En producción, puede que quieras aumentar replicaCountMin a 3 para tener un mayor número de conexiones con el plano de control por motivos de fiabilidad y escalabilidad.

connectAgent.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.

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

Valor predeterminado: 30Mi

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

connectAgent.targetCPUUtilizationPercentage Versión: 1.2.0

Valor predeterminado: 75

Uso de CPU objetivo del agente de conexión de Apigee en el pod. El valor de este campo permite que Apigee Connect se ajuste automáticamente cuando el uso de la CPU alcance este valor, hasta replicaCountMax.

connectAgent.terminationGracePeriodSeconds Versión: 1.2.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.

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 encriptado predeterminada de la organización en KMS.

defaults.org.kvmEncryptionKey Versión: 1.0.0

Valor predeterminado: "aWxvdmVhcGlzMTIzNDU2Nw=="

Clave de encriptado 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 encriptado 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 el modo híbrido habilitado debe tener al menos un entorno.

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

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

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

Valor predeterminado: ninguno

Es obligatorio usar cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

Clave de cifrado codificada en Base64. Consulta Cifrado de datos.

envs[].cacheEncryptionPath Versión: 1.2.0

Valor predeterminado: ninguno

Es obligatorio usar cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

Ruta a un archivo que contiene una clave de cifrado codificada en base64. Consulta Cifrado de datos.

envs[].cacheEncryptionSecret.key Versión: 1.2.0

Valor predeterminado: ninguno

Es obligatorio usar cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

La clave de un secreto de Kubernetes que contiene una clave de cifrado codificada en base64. Consulta Cifrado de datos.

envs[].cacheEncryptionSecret.name Versión: 1.2.0

Valor predeterminado: ninguno

Se debe incluir cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

Nombre de un secreto de Kubernetes que contiene una clave de cifrado codificada en base64. Consulta Cifrado de datos.

envs[].hostAlias Versión: 1.0.0

Valor predeterminado: ninguno

Obsoleto: use hostAliases[] en su lugar.

envs[].hostAliases[] Versión: 1.2.0

Valor predeterminado: ninguno

Los alias de host que apuntan al entorno. Cada alias de host debe ser un nombre de dominio completo.

envs[].httpProxy.host Versión: 1.2.0

Valor predeterminado: ninguno

Especifica el nombre de host o la dirección IP en la que se ejecuta el proxy HTTP.

Lista httpProxy propiedades en el orden scheme, host, port. Por ejemplo:

envs:
  - name: test
    httpProxy:
      scheme: HTTP
      host: 10.12.0.47
      port: 3128
      ...

Consulta también Configurar el reenvío de proxy para proxies de APIs.

envs[].httpProxy.port Versión: 1.2.0

Valor predeterminado: ninguno

Especifica el puerto en el que se ejecuta el proxy HTTP. Si se omite esta propiedad, se utilizará el puerto 80 para HTTP y el puerto 443 para HTTPS de forma predeterminada.

envs[].httpProxy.scheme Versión: 1.2.0

Valor predeterminado: ninguno

Especifica el tipo de proxy HTTP como HTTP o HTTPS. De forma predeterminada, se usa "HTTP".

envs[].httpProxy.username Versión: 1.2.0

Valor predeterminado: ninguno

Si el proxy HTTP requiere autenticación básica, usa esta propiedad para proporcionar un nombre de usuario.

envs[].httpProxy.password Versión: 1.2.0

Valor predeterminado: ninguno

Si el proxy HTTP requiere autenticación básica, usa esta propiedad para proporcionar una contraseña.

envs[].kmsEncryptionKey Versión: 1.0.0

Valor predeterminado: ninguno

Se debe incluir kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Ruta del sistema de archivos local de la clave de cifrado de los datos del KMS de Apigee.

envs[].kmsEncryptionPath Versión: 1.2.0

Valor predeterminado: ninguno

Se debe incluir kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Ruta a un archivo que contiene una clave de cifrado codificada en base64. Consulta Cifrado de datos.

envs[].kmsEncryptionSecret.key Versión: 1.2.0

Valor predeterminado: ninguno

Se requiere kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

La clave de un secreto de Kubernetes que contiene una clave de cifrado codificada en base64. Consulta Cifrado de datos.

envs[].kmsEncryptionSecret.name Versión: 1.2.0

Valor predeterminado: ninguno

Se debe incluir kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Nombre de un secreto de Kubernetes que contiene una clave de cifrado codificada en base64. Consulta Cifrado de datos.

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[].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[].serviceAccountSecretRefs.synchronizer Versión: 1.2.0

Valor predeterminado: ninguno

Nombre de un secreto de Kubernetes. Debes crear el secreto con una clave de cuenta de servicio de Google que tenga el rol Gestor de sincronizador de Apigee.

envs[].serviceAccountSecretRefs.udca Versión: 1.2.0

Valor predeterminado: ninguno

Nombre de un secreto de Kubernetes. Debe crear el secreto con una clave de cuenta de servicio de Google que tenga el rol Agente de analíticas de Apigee.

envs[].sslCertPath Versión: 1.2.0

Valor predeterminado: ninguno

Se debe usar sslCertPath/sslKeyPath o sslSecret.

Ruta de tu sistema a un archivo de certificado TLS.

envs[].sslKeyPath Versión: 1.2.0

Valor predeterminado: ninguno

Se debe usar sslCertPath/sslKeyPath o sslSecret.

Ruta de tu sistema al archivo de clave privada TLS.

envs[].sslSecret Versión: 1.2.0

Valor predeterminado: ninguno

Se debe usar sslCertPath/sslKeyPath o sslSecret.

Nombre de un archivo almacenado en un secreto de Kubernetes que contiene el certificado TLS y la clave privada. Debes crear el secreto usando los datos de la clave y el certificado TLS como entrada.

Consulta también:

gcp

Identifica el ID del proyecto de GCP y la región en los que apigee-logger y apigee-metrics insertan sus datos.

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

Propiedad Descripción
gcp.region Versión: 1.2.0

Valor predeterminado: ninguno

Obligatorio

Identifica la región de GCP donde apigee-logger y apigee-metrics envían sus datos.

gcp.projectID Versión: 1.2.0

Valor predeterminado: ninguno

Obligatorio

Identifica el proyecto de Google Cloud en el que apigee-logger y apigee-metrics envían sus datos.

gcp.projectIDRuntime Versión: 1.2.0

Valor predeterminado: ninguno

Identifica el proyecto del clúster de Kubernetes del tiempo de ejecución.

La propiedad projectIDRuntime es opcional. Si no se usa, se supone que el valor de projectID se usa tanto para el proyecto de GCP de la organización de Apigee como para el proyecto del clúster de K8s de tiempo de ejecución.

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. Los valores deben estar en mayúsculas.

ingress

Ingress es la instanciación de la pasarela Ingress de Istio. El Ingress se usa para especificar los servicios que deben exponerse fuera del clúster. La instalación del entorno de ejecución híbrido crea objetos Ingress para estos dos componentes del entorno de ejecución:

  • Tiempo de ejecución
  • 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 Ingress. De forma predeterminada, está inhabilitada.

ingress.envoyHeaders.headers Versión: 1.0.0
Valor predeterminado:
"x-envoy-decorator-operation"
"x-envoy-expected-rq-timeout-ms"
"x-envoy-external-address"
"x-istio-attributes"

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.minTLSProtocolVersion Versión: 1.2.0

Valor predeterminado: si no se especifica minTLSProtocolVersion ni maxTLSProtocolVersion, el ingreso usa el valor predeterminado TLS_AUTO, tal como se describe en la sección Configuración común de TLS de la documentación del proxy Envoy.

Permite definir la versión mínima de TLS para el ingreso. Los valores posibles son 1.0, 1.1, 1.2 y 1.3.

ingress.maxTLSProtocolVersion Versión: 1.2.0

Valor predeterminado: si no se especifica minTLSProtocolVersion ni maxTLSProtocolVersion, el ingreso usa el valor predeterminado TLS_AUTO, tal como se describe en la sección Configuración común de TLS de la documentación del proxy Envoy.

Permite definir la versión máxima de TLS para el tráfico de entrada. Los valores posibles son 1.0, 1.1, 1.2 y 1.3.

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 el artículo ¿Qué es Istio?

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

Propiedad Descripción
istio.citadel.image.url Versión: 1.2.0

Valor predeterminado: "google/apigee-istio-citadel"

Ubicación de la imagen Docker de este servicio.

istio.galley.image.url Versión: 1.2.0

Valor predeterminado: "google/apigee-istio-galley"

Ubicación de la imagen Docker de este servicio.

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.kubectl.image.url Versión: 1.2.0

    Valor predeterminado: "google/apigee-istio-kubectl"

    Ubicación de la imagen Docker de este servicio.

    istio.mixer.image.url Versión: 1.2.0

    Valor predeterminado: "google/apigee-istio-mixer"

    Ubicación de la imagen Docker de este servicio.

    istio.node_agent_k8s.image.url Versión: 1.2.0

    Valor predeterminado: "google/apigee-istio-node-agent-k8s"

    Ubicación de la imagen Docker de este servicio.

    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 especifica 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.image.url Versión: 1.2.0

    Valor predeterminado: "google/apigee-istio-pilot"

    Ubicación de la imagen Docker de este servicio.

    istio.pilot.replicaCountMax Versión: 1.0.0

    Valor predeterminado: 5

    Obligatorio

    La pilot gestión del tráfico principal 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 permitidas.

    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 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:

    istio.proxyv2.image.url Versión: 1.2.0

    Valor predeterminado: "google/apigee-istio-proxyv2"

    Ubicación de la imagen Docker de este servicio.

    istio.sidecar_injector.image.url Versión: 1.2.0

    Valor predeterminado: "google/apigee-istio-sidecar-injector"

    Ubicación de la imagen Docker de este servicio.

    istio.version Versión: 1.2.0

    Valor predeterminado: 1.4.6

    Versión de Istio que se va a usar en esta implementación de Apigee.

    Consulta las versiones de Istio en GitHub.

    k8sCluster

    Identifica el clúster de Kubernetes en el que está instalado el entorno de ejecución híbrido.

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

    Propiedad Descripción
    k8sCluster.name Versión: 1.2.0

    Valor predeterminado: ninguno

    Nombre del clúster de Kubernetes en el que está instalado el entorno de ejecución híbrido.

    k8sCluster.region Versión: 1.2.0

    Valor predeterminado: ninguno

    Identifica la región de GCP en la que se creó tu clúster de Kubernetes.

    kubeRBACProxy

    Identifica dónde debe buscar Apigee los controles de acceso basados en roles de Kubernetes.

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

    Propiedad Descripción
    kubeRBACProxy.image.pullPolicy Versión: 1.2.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.

    kubeRBACProxy.image.tag Versión: "v0.4.1"

    Valor predeterminado: 1.2.0

    La etiqueta de versión de la imagen Docker de este servicio.

    kubeRBACProxy.image.url Versión: 1.2.0

    Valor predeterminado: "google/apigee-kube-rbac-proxy"

    Ubicación de la imagen Docker de este servicio.

    Si no quieres usar Google Docker Hub, descarga las imágenes y usa la dirección en la que se alojan tus imágenes de Docker internamente.

    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 que se inicia 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.resources.limits.memory Versión: 1.0.0

    Valor predeterminado: 500Mi

    Límite de memoria del recurso en un contenedor de Kubernetes, en mebibytes.

    logger.resources.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.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.

    logger.resources.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

    Se debe incluir serviceAccountPath o serviceAccountSecretRef.

    Ruta al archivo de clave de la cuenta de servicio de Google con el rol Escritor de registros.

    logger.serviceAccountSecretRef Versión: 1.2.0

    Valor predeterminado: ninguno

    Se debe incluir serviceAccountPath o serviceAccountSecretRef.

    Nombre de un secreto de Kubernetes. Debes crear el secreto con una clave de cuenta de servicio de Google que tenga el rol Escritor de registros.

    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 Apigee públicas para que puedas acceder y gestionar entidades de datos de tiempo de ejecución, como KMS (claves de API y tokens de OAuth), KVM, cuotas 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.2.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 que se inicia 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 disponibilidad han fallado antes de marcar el pod como no disponible. 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

    Es obligatorio usar serviceAccountPath o serviceAccountSecretRef.

    Ruta al archivo de clave de la cuenta de servicio de Google sin rol.

    mart.serviceAccountSecretRef Versión: 1.2.0

    Valor predeterminado: ninguno

    Es obligatorio usar serviceAccountPath o serviceAccountSecretRef.

    Nombre de un secreto de Kubernetes. Debes crear el secreto con una clave de cuenta de servicio de Google sin rol como entrada.

    mart.sslCertPath Versión: 1.0.0

    Valor predeterminado: ninguno

    Se debe usar sslCertPath/sslKeyPath o sslSecret.

    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

    Se debe usar sslCertPath/sslKeyPath o sslSecret.

    Ruta del sistema de archivos local para cargar y codificar la clave SSL en un secreto.

    mart.sslSecret Versión: 1.2.0

    Valor predeterminado: ninguno

    Se debe usar sslCertPath/sslKeyPath o sslSecret.

    Nombre de un archivo almacenado en un secreto de Kubernetes que contiene el certificado TLS y la clave privada. Debes crear el secreto usando los datos de la clave y el certificado TLS como entrada.

    Consulta también:

    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 disponibilidad han fallado antes de marcar el pod como no disponible. 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.

    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:

    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 extrae 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

    Se debe incluir serviceAccountPath o serviceAccountSecretRef.

    Ruta al archivo de clave de la cuenta de servicio de Google con el rol Escritor de métricas de monitorización.

    metrics.serviceAccountSecretRef Versión: 1.2.0

    Valor predeterminado: ninguno

    Se debe incluir serviceAccountPath o serviceAccountSecretRef.

    Nombre de un secreto de Kubernetes. Debes crear el secreto con una clave de cuenta de servicio de Google que tenga el rol Escritor de métricas de monitorización.

    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 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.2.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 que se inicia 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 nodos de Kubernetes a los servicios de runtime.

    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 disponibilidad han fallado antes de marcar el pod como no disponible. 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: 512Mi (consulta la nota de abajo)

    La memoria necesaria para el funcionamiento normal del recurso en un contenedor de Kubernetes, en mebibytes (Mi) o gibibytes (Gi).

    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 se mantengan 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.2.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 que se inicia 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 disponibilidad han fallado antes de marcar el pod como no disponible. 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.replicaCountMax Versión: 1.2.0

    Valor predeterminado: 4

    Número máximo de réplicas para el autoescalado.

    synchronizer.replicaCountMin Versión: 1.2.0

    Valor predeterminado: 1

    Número mínimo 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

    Se debe incluir serviceAccountPath o serviceAccountSecretRef.

    Ruta al archivo de clave de la cuenta de servicio de Google con el rol Gestor de sincronizador de Apigee.

    synchronizer.serviceAccountSecretRef Versión: 1.2.0

    Valor predeterminado: ninguno

    Se debe incluir serviceAccountPath o serviceAccountSecretRef.

    Nombre de un secreto de Kubernetes. Debes crear el secreto con una clave de cuenta de servicio de Google que tenga el rol Gestor de sincronizador de Apigee.

    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.2.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.2.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 que se inicia 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.

    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 para la implementación 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.serviceAccountPath Versión: 1.0.0

    Valor predeterminado: ninguno

    Se debe incluir serviceAccountPath o serviceAccountSecretRef.

    Ruta al archivo de clave de la cuenta de servicio de Google con el rol Agente de analíticas de Apigee.

    udca.serviceAccountSecretRef Versión: 1.2.0

    Valor predeterminado: ninguno

    Se debe incluir serviceAccountPath o serviceAccountSecretRef.

    Nombre de un secreto de Kubernetes. Debes crear el secreto con una clave de cuenta de servicio de Google que tenga el rol Agente de analíticas de Apigee.

    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.

    virtualhosts

    La propiedad virtualhosts es una propiedad de configuración obligatoria. Los hosts virtuales permiten que Apigee hybrid gestione las solicitudes de API a varios nombres de dominio y que enrute las rutas base de los proxies a entornos específicos.

    Para obtener más información, consulta el artículo sobre cómo configurar hosts virtuales.

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

    Propiedad Descripción
    virtualhosts[].additionalGateways Versión: 1.2.0

    Valor predeterminado: ninguno

    Lista de pasarelas de Istio a las que enrutar el tráfico.

    virtualhosts[].name Versión: 1.2.0

    Valor predeterminado: ninguno

    Obligatorio

    Nombre del host virtual.

    virtualhosts[].hostAliases[] Versión: 1.2.0

    Valor predeterminado: ninguno

    Obligatorio

    Uno o varios nombres de DNS para tu servidor. Por ejemplo, foo-test.mydomain.com.

    Si utiliza varios alias de host en un host virtual, cada alias de host debe ser único. Por ejemplo, foo-test.mydomain.com y foo-prod.mydomain.com.

    Si crea varias definiciones de host virtual, cada una de ellas debe tener un alias de host único. Es decir, dos definiciones de host virtual no pueden incluir el mismo nombre de dominio de alias de host.

    virtualhosts[].routingRules[].connectTimeout Versión: 1.2.0

    Valor predeterminado: 300.

    Tiempo de espera de la conexión, en segundos, del conjunto de rutas definidas.

    connectTimeout es opcional.

    virtualhosts[].routingRules[].env Versión: 1.2.0

    Valor predeterminado: ninguno.

    Obligatorio

    El entorno (o los entornos) al que se dirigirán las llamadas a la API. Debes especificar al menos un entorno.

    Si incluye entradas paths, la entrada env debe estar debajo de las rutas que se hayan asignado a este entorno.

    Consulta también Configurar hosts virtuales.

    virtualhosts[].routingRules[].paths[] Versión: 1.2.0

    Valor predeterminado: la ruta predeterminada es /.

    Admite el enrutamiento de la ruta base de prefijo. Las reglas de enrutamiento dirigen las llamadas a la API a rutas específicas para que se resuelvan en el entorno especificado con env. paths[] es opcional. La ruta predeterminada es /.

    La configuración de las reglas de enrutamiento sigue este patrón:

    org: hybrid
    virtualhosts:
    - name: default
      routingRules:
        - paths:
            - path-1
            - path-2
            - path-n
          env: test
        - paths:
            - /v1/customers
          env: prod

    Consulta también Configurar hosts virtuales.

    virtualhosts[].selector Versión: 1.2.0

    Valor predeterminado: app: istio-ingressgateway

    Obligatorio

    Un par clave-valor de selector para apuntar a diferentes selectores de entrada.

    virtualhosts[].sslCertPath Versión: 1.2.0

    Valor predeterminado: ninguno

    Se debe usar sslCertPath/sslKeyPath o sslSecret.

    Ruta de tu sistema a un archivo de certificado TLS.

    virtualhosts[].sslKeyPath Versión: 1.2.0

    Valor predeterminado: ninguno

    Se debe usar sslCertPath/sslKeyPath o sslSecret.

    Ruta de tu sistema al archivo de clave privada TLS.

    virtualhosts[].sslSecret Versión: 1.2.0

    Valor predeterminado: ninguno

    Se debe usar sslCertPath/sslKeyPath o sslSecret.

    Nombre de un archivo almacenado en un secreto de Kubernetes que contiene el certificado TLS y la clave privada. Debes crear el secreto usando los datos de la clave y el certificado TLS como entrada.

    Consulta también: