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.

Filtrar esta página

Para filtrar las propiedades que se muestran en esta página, seleccione Básico (las propiedades más habituales) o Avanzado (las propiedades que rara vez necesitan cambios):

Pantalla   propiedades de configuración en esta página.

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 Tipo Descripción
axHashSalt Avanzado

Introducido en la versión: 1.3.0

Valor predeterminado: iloveapis123

Optional

Nombre de un secreto de Kubernetes que contiene un salt usado al calcular hashes para ofuscar los datos de usuario antes de que se envíen a las analíticas de Apigee. Si no especificas ningún valor de salt, se usa iloveapis123 de forma predeterminada. Crea el secreto con el valor de la sal como entrada. Puedes usar la misma sal en varios clústeres para asegurarte de que los resultados del cifrado hash sean coherentes entre los clústeres.

Apigee usa SHA512 para cifrar con tecnología hash el valor original antes de enviar datos del plano de ejecución al plano de control.

Consulte Ofuscar datos de usuario para analíticas.

contractProvider Avanzado Introducido en la 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.

Obligatorio si tu instalación híbrida usa residencia de datos en el siguiente formato:

contractProvider: https://CONTROL_PLANE_LOCATION-apigee.googleapis.com

CONTROL_PLANE_LOCATION es la ubicación donde se almacenan los datos del plano de control, como los paquetes proxy. Para ver una lista, consulta Regiones disponibles del plano de control de la API de Apigee.

Por ejemplo:

contractProvider: https://us-apigee.googleapis.com
customAutoscaling.enabled Básico Introducido en la versión: 1.14.0

Valor predeterminado: true

Habilita el autoescalado basado en métricas de Apigee cuando se le asigna el valor true (el valor predeterminado). Asígnale el valor false para inhabilitar el autoescalado personalizado.

Aplica los cambios a customAutoscaling.enabled actualizando el gráfico apigee-telemetry.

enhanceProxyLimits Avanzado Introducido en la versión: 1.14.0

Valor predeterminado: false

Obligatorio

enhanceProxyLimits es necesario para la función de límites de proxy por entorno mejorados de Apigee. Defina este valor como enhanceProxyLimits: true si su organización híbrida tiene derecho a límites de proxy mejorados por entorno.

Consulta los siguientes artículos:

Es necesario definir enhanceProxyLimits: true para el encadenamiento de proxies, el encadenamiento de endpoints y el encadenamiento de ServiceCallout. Para obtener más información, consulta:

Aplica los cambios a enhanceProxyLimits actualizando el gráfico apigee-org y el gráfico apigee-virtualhost de cada grupo de entornos.

gcpProjectID Avanzado Deprecated: En la versión 1.2.0 y posteriores, usa gcp.projectID.

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

Introducido en la versión: 1.0.0

Valor predeterminado: us-central1

Obligatorio

La región o zona de Google Cloud 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.

hub Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: ninguno

URL de un repositorio de contenedores de imágenes privadas que se usa para extraer imágenes de todos los componentes de Apigee de un repositorio privado.

hub proporciona una ruta predeterminada para todos los componentes de Apigee hybrid. Si usas un repositorio privado, utiliza hub para definir la URL del repositorio de todos los componentes en lugar de usar la propiedad image.url individual para cada componente. Solo debe configurar URLs individuales si utiliza un repositorio independiente para un componente específico.

La ruta de la imagen de cada componente será el valor de hub más el nombre y la etiqueta de la imagen del componente.

Por ejemplo, si el valor de hub private-docker-host.example.com, los componentes individuales resolverán automáticamente la ruta de la imagen:

hub: private-docker-host.example.com

como:

containers:
- name: apigee-udca
  image: private-docker-host.example.com/apigee-udca:1.14.2
  imagePullPolicy: IfNotPresent

Los demás componentes seguirán un patrón similar.

Usa apigee-pull-push --list para ver la URL del repositorio actual de todos los componentes.

Consulta Usar un repositorio de imágenes privado con Apigee hybrid.

Puede anular la URL de la imagen de los componentes de forma individual con las siguientes propiedades:

imagePullSecrets.name Avanzado Introducido en la 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.

instanceID Básico Introducido en la versión: 1.3.0

Valor predeterminado: ninguno

Obligatorio

Identificador único de esta instalación.

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

k8sClusterName Avanzado Deprecated: En la versión 1.2.0 y posteriores, usa k8sCluster.name y k8sCluster.region en su lugar.

Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 cifrado de los datos de KVM de Apigee.

kvmEncryptionPath Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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.

multiOrgCluster Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: false

En el caso de los clústeres de varias organizaciones, esta propiedad permite exportar las métricas de la organización al proyecto que se indica en la propiedad gcp.projectID. Aplica este ajuste en el archivo de anulaciones de cada organización de un clúster de varias organizaciones. Para obtener más información, consulta Añadir varias organizaciones híbridas a un clúster.

namespace Básico Introducido en la 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 Básico

Introducido en la 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.

orgScopedUDCA Avanzado Introducido en la versión: 1.8.0

Valor predeterminado: true

Habilita el servicio Universal Data Collection Agent (UDCA) a nivel de organización, que extrae analíticas, monetización y depuración (seguimiento) y los envía a la plataforma de analíticas unificada (UAP), que reside en el plano de control.

UDCA con ámbito de organización usa una sola cuenta de servicio de Google para todos los entornos de Apigee. La cuenta de servicio debe tener el rol Agente de analíticas de Apigee (roles/apigee.analyticsAgent).

Especifica la ruta al archivo de clave de la cuenta de servicio con la propiedad udca.serviceAccountPath o proporciona la clave en un secreto de Kubernetes con la propiedad udca.serviceAccountRef en el archivo de configuración overrides.yaml.

Si prefiere usar un agente de UDCA independiente para cada entorno, defina orgScopedUDCA: false y los valores de envs[].serviceAccountPaths.udca y envs[].serviceAccountSecretRefs.udca.

Consulta también udca.

revision Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: "1142" (tu versión de Apigee Hybrid sin puntos. Por ejemplo, en la versión 1.12.0, el valor predeterminado es "1120".

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 determinadas anulaciones de YAML que provocan un cambio en el PodTemplateSpec de Kubernetes subyacente, también se debe cambiar la propiedad de anulación revision en el 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. Puedes usar cualquier valor de texto en minúsculas, como blue, a o 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.

serviceAccountSecretProviderClass Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: ninguno

Nombre de la clase de proveedor de secretos específica de la organización (SecretProviderClass) que se usa para almacenar claves de cuenta de servicio en Vault.

Consulta Almacenar claves de cuentas de servicio en HashiCorp Vault.

validateOrg Avanzado Introducido en la versión: 1.8.0

Valor predeterminado: true

Habilita la validación estricta del vínculo entre la organización de Apigee y el proyecto de Google Cloud, y comprueba si existen grupos de entornos.

Consulta también org.

validateServiceAccounts Avanzado Introducido en la 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 los registradores, el proyecto que se comprueba se basa en la configuración gcpProjectID overrides.yaml.

Consulta también gcpProjectID.

ao

Los operadores de Apigee (AO) crean y actualizan recursos de Kubernetes e Istio de bajo nivel que son necesarios para desplegar y mantener un componente. Por ejemplo, el controlador lleva a cabo la liberación de procesadores de mensajes.

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

Propiedad Tipo Descripción
ao.args.disableIstioConfigInAPIServer Avanzado Introducido en la versión: 1.8.0

Valor predeterminado: true

Impide que Apigee proporcione configuración a la malla de servicios de Cloud instalada por el cliente.

  • Definir como true para las instalaciones híbridas que usan la pasarela de entrada de Apigee.
  • false para instalaciones híbridas que usen Cloud Service Mesh (versiones 1.8 y anteriores de Apigee hybrid).
ao.args.disableManagedClusterRoles Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: true

Cuando se usa true (el valor predeterminado), Apigee hybrid no gestiona Kubernetes ClusterRole y ClursterRoleBinding directamente. Si tienes un proceso que requiere gestionar estos recursos, debe llevarlo a cabo un usuario con los permisos correctos.

ao.image.pullPolicy Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: 1.14.2

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

ao.image.url Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

ao.resources.limits.cpu Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: 256Mi

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

ao.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

ao.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

ao.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

ao.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

ao.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

apigeeIngressGateway

Configura la pasarela de entrada de Apigee para Apigee Hybrid. Usa las propiedades apigeeIngressGateway para aplicar una configuración común a todas las instancias de la pasarela de entrada de Apigee.

Consulta ingressGateways para configurar instancias individuales de forma única.

Aplica cambios a las propiedades de apigeeIngressGateway con el gráfico apigee-org.

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

Propiedad Tipo Descripción
apigeeIngressGateway.image.pullPolicy Avanzado Introducido en la versión: 1.11.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.

apigeeIngressGateway.image.tag Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 1.14.2

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

apigeeIngressGateway.image.url Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

apigeeIngressGateway.nodeSelector.key Avanzado Introducido en la versión: 1.11.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 la puerta de enlace de entrada.

Consulta Configurar grupos de nodos dedicados.

apigeeIngressGateway.nodeSelector.value Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: ninguno

Valor de etiqueta de selector de nodos opcional que se usa para orientar los nodos de Kubernetes dedicados a los servicios de puerta de enlace de entrada y anular la configuración de nodeSelector.apigeeData.

Consulta nodeSelector.

apigeeIngressGateway.replicaCountMax Básico Introducido en la versión: 1.11.0

Valor predeterminado: 4

El número máximo de pods que puede añadir automáticamente el sistema híbrido para la puerta de enlace de entrada disponible para el autoescalado.

apigeeIngressGateway.replicaCountMin Básico Introducido en la versión: 1.11.0

Valor predeterminado: 2

El número mínimo de pods de la puerta de enlace de entrada disponibles para el autoescalado.

apigeeIngressGateway.targetCPUUtilizationPercentage Avanzado Introducido en la versión: 1.10.5, 1.11.2 y 1.12.1

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.

Cuando el uso de la CPU supera este valor, el modo híbrido aumentará gradualmente el número de pods del ReplicaSet hasta apigeeIngressGateway.replicaCountMax.

Para obtener más información sobre el escalado en Kubernetes, consulta el artículo sobre el autoescalado horizontal de pods en la documentación de Kubernetes.

apigeeIngressGateway.tolerations.effect Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

apigeeIngressGateway.tolerations.key Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

apigeeIngressGateway.tolerations.operator Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

apigeeIngressGateway.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

apigeeIngressGateway.tolerations.value Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

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 Configuración de StorageClass.

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

Propiedad Tipo Descripción
cassandra.annotations Avanzado Introducido en la versión: 1.5.0

Valor predeterminado: ninguno

Mapa de clave-valor opcional que se usa para anotar pods. Para obtener más información, consulta Anotaciones personalizadas.

cassandra.auth.admin.password Básico Introducido en la 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, como crear y restaurar copias de seguridad.

cassandra.auth.ddl.password Básico Introducido en la 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 Básico Introducido en la 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 Básico Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 1.14.2

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

cassandra.auth.image.url Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

cassandra.auth.jmx.password Básico Introducido en la versión: 1.4.0

Valor predeterminado: iloveapis123

Obligatorio

Contraseña del usuario de operaciones JMX de Cassandra. Se usa para autenticar y comunicarse con la interfaz JMX de Cassandra.

cassandra.auth.jmx.username Básico Introducido en la versión: 1.4.0

Valor predeterminado: jmxuser

Obligatorio

Nombre de usuario del usuario de operaciones JMX de Cassandra. Se usa para autenticar y comunicarse con la interfaz JMX de Cassandra.

cassandra.auth.jolokia.password Básico Introducido en la versión: 1.4.0

Valor predeterminado: iloveapis123

Obligatorio

Contraseña del usuario de operaciones JMX de Jolokia de Cassandra. Se usa para autenticar y comunicarse con la API JMX de Cassandra.

cassandra.auth.jolokia.username Básico Introducido en la versión: 1.4.0

Valor predeterminado: apigee

Obligatorio

Nombre de usuario del usuario de operaciones JMX de Jolokia de Cassandra. Se usa para autenticar y comunicarse con la API JMX de Cassandra.

cassandra.auth.secret Básico Introducido en la versión: 1.3.3

Valor predeterminado: ninguno

Nombre del archivo almacenado en un secreto de Kubernetes que contiene los usuarios y las contraseñas de Cassandra. Para crear el secreto, sigue estas instrucciones: Crea el secreto.

Consulta también:

cassandra.auth.secretProviderClass Avanzado Introducido en la versión: 1.10.3

Valor predeterminado: ninguno

Política de almacenamiento de secretos de Cassandra. Si se define, debe coincidir con SecretProviderClass que hace referencia al proveedor de secretos externo, como Hashicorp Vault. Si no se define, Apigee hybrid usa los nombres de usuario y las contraseñas almacenados en:

o el secreto de Kubernetes almacenado en:

Consulta Almacenar secretos de Cassandra en HashiCorp Vault para obtener instrucciones sobre cómo crear la política.

cassandra.backup.cloudProvider Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: GCP

El nombre de un proveedor de copias de seguridad. Valores admitidos: GCP, HYBRID y CSI. Asigna el valor:

  • GCP para almacenar archivos de copias de seguridad en Google Cloud Storage.
  • HYBRID para almacenar archivos de copia de seguridad en un servidor SSH remoto.
  • CSI (recomendado) para usar snapshots de volúmenes de CSI de Kubernetes para crear copias de seguridad. Para obtener información sobre la CSIcopia de seguridad y la restauración de plataformas en la nube como Google Cloud, AWS y Azure, consulta Copia de seguridad y restauración de CSI.
cassandra.backup.dbStorageBucket Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio si la copia de seguridad está habilitada y cassandra.backup.cloudProvider tiene el valor GCP.

Nombre de un segmento de Google Cloud Storage que se usará para almacenar archivos de copia de seguridad. Consulta Crear segmentos si necesitas crear uno.

cassandra.backup.enabled Avanzado Introducido en la 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.gsa Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: ninguno

Solo Helm: dirección de correo de la cuenta de servicio de gestión de identidades y accesos de Google (IAM) apigee-cassandra que se asociará a la cuenta de servicio de Kubernetes de la copia de seguridad de Cassandra al habilitar Workload Identity en clústeres de GKE. Define este valor cuando hayas asignado true a gcp.workloadIdentity.enabled y true a cassandra.backup.enabled.

Las direcciones de correo de GSA suelen tener el siguiente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Por ejemplo:

apigee-cassandra@my-hybrid-project.iam.gserviceaccount.com

Consulta Habilitar Workload Identity Federation en GKE.

cassandra.backup.image.pullPolicy Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 1.14.2

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

cassandra.backup.image.url Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

cassandra.backup.keyfile Avanzado Introducido en la versión: 1.3.0

Valor predeterminado: ninguno

Obligatorio si la copia de seguridad está habilitada y cassandra.backup.cloudProvider tiene el valor HYBRID.

Ruta del archivo de clave privada SSH en tu sistema de archivos local.

cassandra.backup.schedule Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 0 2 * * *

La programación de la tarea cron de la copia de seguridad.

Consulta Copia de seguridad y recuperación de Cassandra.

cassandra.backup.server Avanzado Introducido en la versión: 1.3.0

Valor predeterminado: ninguno

Obligatorio si la copia de seguridad está habilitada y cassandra.backup.cloudProvider tiene el valor HYBRID.

La dirección IP de tu servidor de copia de seguridad SSH remoto.

cassandra.backup.serviceAccountPath Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ruta a un archivo de clave de cuenta de servicio de Google que tenga el rol Administrador de objetos de Storage (roles/storage.objectAdmin). Esta cuenta de servicio de Google se usará para subir archivos de copia de seguridad a un cassandra.backup.dbStorageBucket especificado.

Si la copia de seguridad está habilitada y cassandra.backup.cloudProvider está configurado como GCP, se debe cumplir uno de los siguientes requisitos para que Apigee Hybrid pueda acceder al segmento de Google Cloud Storage y subir archivos de copia de seguridad:

cassandra.backup.serviceAccountRef Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Nombre de un secreto de Kubernetes que almacena el contenido de un archivo de claves de cuenta de servicio de Google que tiene el rol Administrador de objetos de almacenamiento (roles/storage.objectAdmin). Esta cuenta de servicio de Google se usará para subir archivos de copia de seguridad a un cassandra.backup.dbStorageBucket especificado.

Si la copia de seguridad está habilitada y cassandra.backup.cloudProvider está configurado como GCP, se debe cumplir uno de los siguientes requisitos para que Apigee Hybrid pueda acceder al segmento de Google Cloud Storage y subir archivos de copia de seguridad:

cassandra.backup.storageDirectory Avanzado Introducido en la versión: 1.3.0

Valor predeterminado: ninguno

Obligatorio si la copia de seguridad está habilitada y cassandra.backup.cloudProvider tiene el valor HYBRID.

Puede ser una ruta absoluta o relativa al directorio principal del usuario apigee.

Nombre del directorio de copia de seguridad en el servidor SSH de copia de seguridad.

cassandra.clusterName Básico Introducido en la versión: 1.0.0

Valor predeterminado: apigeecluster

Especifica el nombre del clúster de Cassandra.

cassandra.datacenter Básico Introducido en la versión: 1.0.0

Valor predeterminado: dc-1

Especifica el centro de datos del nodo de Cassandra.

cassandra.dnsPolicy Básico Introducido en la versión: 1.1.1

Valor predeterminado: ninguno

Si asignas el valor true a hostNetwork, la política de DNS se establecerá en ClusterFirstWithHostNet automáticamente.

cassandra.externalSeedHost Básico Introducido en la 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 Básico Introducido en la versión: 1.0.0

Valor predeterminado: 100M

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

cassandra.hostNetwork Básico Introducido en la versión: 1.1.1

Valor predeterminado: false

Habilita la función de Kubernetes hostNetwork. Apigee usa esta función en instalaciones multirregión para comunicarse entre pods si el espacio de nombres de la red de pods no tiene conectividad entre clústeres (los clústeres se ejecutan en "modo de red aislada"), que es el caso predeterminado en instalaciones que no son de GKE, como Google Distributed Cloud en VMware o bare metal, GKE en AWS, AKS, EKS y OpenShift.

Define cassandra.hostNetwork como false para instalaciones de una sola región y de varias regiones con conectividad entre pods de diferentes clústeres, como las instalaciones de GKE.

Define cassandra.hostNetwork como true para instalaciones multirregión sin comunicación entre pods de diferentes clústeres, como Google Distributed Cloud en VMware o bare metal, GKE en AWS, AKS, EKS e instalaciones de OpenShift. Consulta los requisitos previos para el despliegue multirregional.

Cuando true, política de DNS se establece automáticamente en ClusterFirstWithHostNet.

cassandra.image.pullPolicy Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 1.14.2

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

cassandra.image.url Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

cassandra.maxHeapSize Avanzado Introducido en la 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 Básico Introducido en la 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 Avanzado Introducido en la 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 Configurar grupos de nodos dedicados.

cassandra.nodeSelector.value Avanzado Introducido en la 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 la configuración de nodeSelector.apigeeData.

Consulta nodeSelector.

cassandra.port Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 9042

Número de puerto usado para conectarse a Cassandra.

cassandra.rack Básico Introducido en la versión: 1.0.0

Valor predeterminado: ra-1

Especifica el rack del nodo de Cassandra.

cassandra.readinessProbe.failureThreshold Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Básico Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: GCP

Nombre de un proveedor de restauración. Valores admitidos: GCP, HYBRID y CSI. Asigna el valor:

  • GCP para restaurar datos a partir de una copia de seguridad almacenada en Google Cloud Storage.
  • HYBRID para restaurar datos a partir de una copia de seguridad almacenada en un servidor SSH remoto.
  • CSI (opción recomendada) para usar las instantáneas de volumen de CSI de Kubernetes para la restauración. Para obtener información sobre la CSIcopia de seguridad y la restauración de plataformas en la nube como Google Cloud, AWS y Azure, consulta Copia de seguridad y restauración de CSI.
cassandra.restore.dbStorageBucket Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio si la restauración está habilitada y cassandra.restore.cloudProvider tiene el valor GCP.

Nombre de un segmento de Google Cloud Storage que almacena archivos de copia de seguridad que se usarán para restaurar datos.

cassandra.restore.enabled Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: false

La restauración de datos no está habilitada de forma predeterminada. Para habilitarlo, selecciona true.

Consulta Copia de seguridad y recuperación de Cassandra.

cassandra.restore.gsa Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: ninguno

Solo Helm: dirección de correo de la cuenta de servicio de apigee-cassandra Google IAM que se asociará a la cuenta de servicio de Kubernetes de restauración de Cassandra al habilitar Workload Identity en clústeres de GKE. Define este valor cuando hayas asignado true a gcp.workloadIdentity.enabled y true a cassandra.restore.enabled.

Las direcciones de correo de GSA suelen tener el siguiente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Por ejemplo:

apigee-cassandra@my-hybrid-project.iam.gserviceaccount.com

Consulta Habilitar Workload Identity Federation en GKE.

cassandra.restore.image.pullPolicy Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 1.14.2

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

cassandra.restore.image.url Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

cassandra.restore.serviceAccountPath Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ruta a un archivo de clave de cuenta de servicio de Google que tenga el rol Administrador de objetos de Storage (roles/storage.objectAdmin). Esta cuenta de servicio de Google se usará para descargar archivos de copia de seguridad de un cassandra.restore.dbStorageBucket especificado.

Si la restauración está habilitada y cassandra.restore.cloudProvider está configurado como GCP, se requiere una de las siguientes opciones para asegurarse de que Apigee Hybrid pueda acceder al segmento de Google Cloud Storage para descargar los archivos de copia de seguridad para la restauración:

cassandra.restore.serviceAccountRef Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Nombre de un secreto de Kubernetes que almacena el contenido de un archivo de claves de cuenta de servicio de Google que tiene el rol Administrador de objetos de almacenamiento (roles/storage.objectAdmin). Esta cuenta de servicio de Google se usará para descargar archivos de copia de seguridad de un cassandra.restore.dbStorageBucket especificado.

Si la restauración está habilitada y cassandra.restore.cloudProvider está configurado como GCP, se requiere una de las siguientes opciones para asegurarse de que Apigee Hybrid pueda acceder al segmento de Google Cloud Storage para descargar los archivos de copia de seguridad para la restauración:

cassandra.restore.snapshotTimestamp Avanzado Introducido en la 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.sslCertPath Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Ruta de tu sistema a un archivo de certificado TLS.

cassandra.sslKeyPath Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Ruta de tu sistema al archivo de clave privada TLS.

cassandra.sslRootCAPath Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

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

cassandra.storage.capacity Básico Introducido en la versión: 1.0.0

Valor predeterminado: 10Gi

Obligatorio si se especifica storage.storageclass

Especifica el tamaño de disco necesario en mebibytes (Mi) o gibibytes (Gi).

cassandra.storage.storageclass Básico Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Especifica la clase de almacenamiento local que se está usando.

cassandra.storage.storageSize Básico Introducido en la versión: 1.0.0

Valor predeterminado: 10Gi

Obligatorio si se especifica storage.storageclass

Especifica el tamaño de disco necesario en mebibytes (Mi) o gibibytes (Gi).

cassandra.terminationGracePeriodSeconds Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 300

Tiempo máximo, en segundos, entre una solicitud de eliminación de un pod y el momento en que se elimina. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución. El pod se eliminará cuando hayan finalizado todos los procesos en ejecución o al final del periodo de gracia, lo que suceda primero. Si no hay procesos en ejecución, el pod se cerrará inmediatamente.

cassandra.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

cassandra.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

cassandra.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

cassandra.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

cassandra.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

certManager

Apigee usa cert-manager para validar los certificados.

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

Propiedad Tipo Descripción
certManager.namespace Avanzado Introducido en la versión: 1.9.0

Valor predeterminado: cert-manager

El espacio de nombres de cert-manager.

Consulta Ejecutar cert-manager en un espacio de nombres personalizado.

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.

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

Propiedad Tipo Descripción
connectAgent.annotations Avanzado Introducido en la versión: 1.5.0

Valor predeterminado: ninguno

Mapa de clave-valor opcional que se usa para anotar pods. Para obtener más información, consulta Anotaciones personalizadas.

connectAgent.gsa Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: ninguno

Solo Helm: dirección de correo de la cuenta de servicio de gestión de identidades y accesos de Google (GSA) para que connectAgent se asocie a la cuenta de servicio de Kubernetes correspondiente al habilitar Workload Identity en clústeres de GKE mediante gráficos de Helm. Define este valor cuando hayas asignado el valor true a gcp.workloadIdentity.enabled.

Las direcciones de correo de GSA suelen tener el siguiente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Por ejemplo:

apigee-mart@my-hybrid-project.iam.gserviceaccount.com

Consulta Habilitar Workload Identity en GKE o Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

connectAgent.logLevel Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: 1.14.2

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

connectAgent.image.url Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

connectAgent.replicaCountMax Básico Introducido en la versión: 1.2.0

Valor predeterminado: 5

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

connectAgent.replicaCountMin Básico Introducido en la 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 1 para tener un mayor número de conexiones con el plano de control por motivos de fiabilidad y escalabilidad.

connectAgent.resources.limits.cpu Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 512m

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

connectAgent.resources.limits.memory Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 512Mi

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

connectAgent.resources.requests.cpu Avanzado Introducido en la versión: 1.11.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 Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: 30Mi

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

connectAgent.server Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: apigeeconnect.googleapis.com:443

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

connectAgent.serviceAccountPath Básico Introducido en la versión: 1.1.1

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

Ruta al archivo de clave de la cuenta de servicio de Google de la cuenta de servicio apigee-mart.

En la mayoría de las instalaciones, el valor de connectAgent.serviceAccountPath debe coincidir con el valor de mart.serviceAccountPath.

connectAgent.serviceAccountRef Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

En la mayoría de las instalaciones, el valor de connectAgent.serviceAccountRef debe coincidir con el valor de mart.serviceAccountRef.

connectAgent.targetCPUUtilizationPercentage Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: 75

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

connectAgent.terminationGracePeriodSeconds Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: 600

Tiempo máximo, en segundos, entre una solicitud de eliminación de un pod y el momento en que se elimina. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución. El pod se eliminará cuando hayan finalizado todos los procesos en ejecución o al final del periodo de gracia, lo que suceda primero. Si no hay procesos en ejecución, el pod se cerrará inmediatamente.

connectAgent.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

connectAgent.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

connectAgent.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

connectAgent.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

connectAgent.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

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 Tipo Descripción
defaults.org.kmsEncryptionKey Básico Introducido en la versión: 1.0.0

Valor predeterminado: aWxvdmVhcGlzMTIzNDU2Nw==

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

defaults.org.kvmEncryptionKey Básico Introducido en la versión: 1.0.0

Valor predeterminado: aWxvdmVhcGlzMTIzNDU2Nw==

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

defaults.env.kmsEncryptionKey Básico Introducido en la versión: 1.0.0

Valor predeterminado: aWxvdmVhcGlzMTIzNDU2Nw==

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

defaults.env.kvmEncryptionKey Básico Introducido en la versión: 1.0.0

Valor predeterminado: aWxvdmVhcGlzMTIzNDU2Nw==

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

defaults.env.cacheEncryptionKey Básico Introducido en la versión: 1.0.0

Valor predeterminado: aWxvdmVhcGlzMTIzNDU2Nw==

Clave de cifrado de caché predeterminada del entorno.

diagnostic

Los ajustes de la herramienta Recopilador de diagnóstico.

Consulta Usar el recopilador de Diagnóstico.

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

Propiedad Tipo Descripción
diagnostic.bucket Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Obligatorio

Nombre del segmento de almacenamiento de Google Cloud en el que se depositarán los datos de diagnóstico.

Consulta Crear segmentos de almacenamiento.

diagnostic.container Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Obligatorio

Especifica el tipo de pod del que estás recogiendo datos. Los valores pueden ser uno de los siguientes:

  • "apigee-cassandra" captura datos sobre la base de datos de Cassandra. Los pods de istio-cassandra se ejecutan en el espacio de nombres apigee.
  • "apigee-mart-server" captura datos sobre MART. Los pods de apigee-mart-server se ejecutan en el espacio de nombres apigee.
  • "apigee-runtime" recoge datos sobre el procesador de mensajes. Los pods de apigee-runtime se ejecutan en el espacio de nombres apigee.
  • "apigee-synchronizer" captura datos sobre el sincronizador. Los pods de apigee-synchronizer se ejecutan en el espacio de nombres apigee.
  • "apigee-udca" captura datos sobre UDCA. Los pods de apigee-udca se ejecutan en el espacio de nombres apigee.
  • "apigee-watcher" captura datos sobre Watcher. Los pods apigee-watcher se ejecutan en el espacio de nombres apigee.
  • "istio-proxy" captura datos sobre la pasarela de entrada de Istio. Los pods de istio-proxy se ejecutan en el espacio de nombres istio-system.
diagnostic.loggingDetails.logDuration Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Obligatorio si la operación de recogida de diagnósticos es "LOGGING" (REGISTRO) (se define con operation: "LOGGING").

Duración en milisegundos de los datos de registro recogidos. Un valor habitual es 30000.

Consulta diagnostic.operation.

diagnostic.loggingDetails.loggerNames[] Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Obligatorio si la operación de recogida de diagnósticos es "LOGGING" (REGISTRO) (se define con operation: "LOGGING").

Especifica por nombre de qué registradores se deben recoger los datos. En la versión 1.6.0 de Apigee hybrid, el único valor admitido es ALL, lo que significa que se incluyen todos los registradores. Por ejemplo:

diagnostic:
 loggingDetails:
   loggerNames:
   - ALL
diagnostic.loggingDetails.logLevel Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Obligatorio si la operación de recogida de diagnósticos es "LOGGING" (REGISTRO) (se define con operation: "LOGGING").

Especifica la granularidad de los datos de registro que se van a recoger. En Apigee hybrid 1.6, solo se admite FINE.

diagnostic.namespace Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Obligatorio

El espacio de nombres de Kubernetes en el que residen los pods de los que recoges datos. El espacio de nombres debe ser el correcto para el contenedor que especifiques con diagnostic.container:

apigee para

  • apigee-runtime
  • apigee-synchronizer
  • apigee-udca
  • apigee-watcher
  • apigee-cassandra
  • apigee-mart-server

istio-system para

  • istio-proxy
diagnostic.operation Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Obligatorio

Especifica si se deben recoger todas las estadísticas o solo los registros.

Los valores son los siguientes:

diagnostic.podNames[] Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Obligatorio

Los nombres de los pods de Kubernetes de los que recoge datos. Por ejemplo:

diagnostic:
 podNames:
 - apigee-runtime-eng-hybrid-example-3b2ebf3-150-8vfoj-2wcjn
 - apigee-runtime-eng-hybrid-example-3b2ebf3-150-8vfoj-6xzn2
diagnostic.serviceAccountPath Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Obligatorio

La ruta a un archivo de clave de cuenta de servicio (.json) de la cuenta de servicio con el rol Administrador de almacenamiento (roles/storage.admin). En la mayoría de las instalaciones híbridas de Apigee, se trata de la cuenta de servicio apigee-cassandra.

Consulta Información sobre las cuentas de servicio.

diagnostic.tcpDumpDetails.maxMsgs Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Si usas diagnostic.tcpDumpDetails, debes especificar diagnostic.tcpDumpDetails.maxMsgs o diagnostic.tcpDumpDetails.timeoutInSeconds.

Define el número máximo de mensajes tcpDump que se recogerán. Apigee recomienda un valor máximo que no supere 1000.

diagnostic.tcpDumpDetails.timeoutInSeconds Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Si usas diagnostic.tcpDumpDetails, debes especificar diagnostic.tcpDumpDetails.maxMsgs o diagnostic.tcpDumpDetails.timeoutInSeconds.

Define el tiempo en segundos que se debe esperar a que tcpDump devuelva mensajes.

diagnostic.threadDumpDetails.delayInSeconds Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

diagnostic.threadDumpDetails.delayInSeconds y diagnostic.threadDumpDetails.iterations son obligatorios si usas diagnostic.threadDumpDetails.

El tiempo de espera en segundos entre la recogida de cada volcado de subprocesos.

diagnostic.threadDumpDetails.iterations Básico Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

diagnostic.threadDumpDetails.delayInSeconds y diagnostic.threadDumpDetails.iterations son obligatorios si usas diagnostic.threadDumpDetails.

Número de iteraciones de volcado de subprocesos de jstack que se van a recoger.

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.

Para obtener más información, consulta el artículo Acerca de los entornos.

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

Propiedad Tipo Descripción
envs[].cacheEncryptionKey Básico Introducido en la 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 Básico Introducido en la 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 Básico Introducido en la 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 Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Es obligatorio usar cacheEncryptionKey, cacheEncryptionPath o cacheEncryptionSecret.

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

envs[].components.runtime.replicaCountMax Básico Introducido en la versión: 1.9.3

Valor predeterminado: 4

Número máximo de réplicas para el autoescalado. Anula runtime.replicaCountMax si se especifica.

envs[].components.runtime.replicaCountMin Básico Introducido en la versión: 1.9.3

Valor predeterminado: 1

Número mínimo de réplicas para el autoescalado. Anula runtime.replicaCountMin si se especifica.

envs[].components.synchronizer.replicaCountMax Básico Introducido en la versión: 1.9.3

Valor predeterminado: 4

Número máximo de réplicas para el autoescalado. Anula synchronizer.replicaCountMax si se especifica.

envs[].components.synchronizer.replicaCountMin Básico Introducido en la versión: 1.9.3

Valor predeterminado: 1

Número mínimo de réplicas para el autoescalado. Anula synchronizer.replicaCountMin si se especifica.

envs[].components.udca.replicaCountMax Básico Introducido en la versión: 1.9.3

Valor predeterminado: 4

Número máximo de réplicas para el autoescalado. Anula udca.replicaCountMax si se especifica.

envs[].components.udca.replicaCountMin Básico Introducido en la versión: 1.9.3

Valor predeterminado: 1

Número mínimo de réplicas para el autoescalado. Anula udca.replicaCountMin si se especifica.

envs.gsa.runtime Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: ninguno

Solo Helm: dirección de correo de la cuenta de servicio de Google de IAM del tiempo de ejecución que se asociará a la cuenta de servicio de Kubernetes correspondiente al habilitar Workload Identity en clústeres de GKE mediante gráficos de Helm.

Consulta Habilitar Workload Identity en GKE o Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

envs.gsa.synchronizer Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: ninguno

Solo Helm: dirección de correo de la cuenta de servicio de Google IAM del sincronizador que se va a asociar con la cuenta de servicio de Kubernetes correspondiente al habilitar Workload Identity en clústeres de GKE mediante gráficos de Helm.

Consulta Habilitar Workload Identity en GKE o Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

envs.gsa.udca Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: ninguno

Solo Helm: dirección de correo de la cuenta de servicio de Google de gestión de identidades y accesos de udca con ámbito de entorno que se va a asociar con la cuenta de servicio de Kubernetes correspondiente al habilitar Workload Identity en clústeres de GKE mediante gráficos de Helm.

Consulta Habilitar Workload Identity en GKE o Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

envs[].hostAliases[] Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Deprecated: A partir de la versión 1.4 de Hybrid, el plano de tiempo de ejecución recibe esta información del plano de gestión. Consulta la sección Acerca de los entornos y los grupos de entornos.

envs[].httpProxy.host Básico Introducido en la 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 Básico Introducido en la 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 usarán de forma predeterminada el puerto 80 para HTTP y el puerto 443 para HTTPS.

envs[].httpProxy.scheme Básico Introducido en la versión: 1.2.0

Valor predeterminado: HTTPS

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

envs[].httpProxy.username Básico Introducido en la 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 Básico Introducido en la 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[].name Básico Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Obligatorio

Nombre del entorno de Apigee que se va a sincronizar.

envs[].pollInterval Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Número de puerto TCP para el tráfico HTTPS.

envs[].serviceAccountPaths.runtime Básico Introducido en la versión: 1.4.0

Valor predeterminado: ninguno

Ruta al archivo del sistema local de una clave de cuenta de servicio de Google con el rol Agente de Cloud Trace, que suele ser la cuenta de servicio apigee-runtime. Consulta la sección Acerca de las cuentas de servicio para ver los nombres predeterminados de las cuentas de servicio y los roles que tienen asignados.

envs[].serviceAccountPaths.synchronizer Básico Introducido en la versión: 1.0

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 Básico Introducido en la versión: 1.0

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.

Solo debes definir esta propiedad si orgScopedUDCA tiene el valor false.

envs[].serviceAccountSecretProviderClass Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: ninguno

Nombre de la clase de proveedor de secretos específica del entorno (SecretProviderClass) que se usa para almacenar claves de cuentas de servicio en Vault.

Consulta Almacenar claves de cuentas de servicio en HashiCorp Vault.

envs[].serviceAccountSecretRefs.runtime Básico Introducido en la versión: 1.4.0

Valor predeterminado: ninguno

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

envs[].serviceAccountSecretRefs.synchronizer Básico Introducido en la 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 Básico Introducido en la 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.

Solo debes definir esta propiedad si orgScopedUDCA tiene el valor false.

envs[].sslCertPath Básico Introducido en la 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 Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Se debe especificar sslCertPath/sslKeyPath o sslSecret.

Ruta de tu sistema al archivo de clave privada TLS.

envs[].sslSecret Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Se debe usar sslCertPath/sslKeyPath o sslSecret.

El nombre del archivo almacenado en un secreto de Kubernetes que contiene los usuarios y las contraseñas de Cassandra. Para crear el secreto, sigue estas instrucciones: Crea el secreto.

Consulta también:

gcp

Identifica el ID del proyecto de Google Cloud (obligatorio para todas las instalaciones híbridas), las configuraciones de identidad de carga de trabajo e identidad de carga de trabajo federada, y la región en la que apigee-logger y apigee-metrics envían sus datos.

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

Propiedad Tipo Descripción
gcp.federatedWorkloadIdentity.audience Básico Introducido en la versión: 1.12.0

Valor predeterminado: ninguno

Audiencia permitida del proveedor de identidades de carga de trabajo en plataformas que no son de GKE.

Consulta Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

gcp.federatedWorkloadIdentity.credentialSourceFile Básico Introducido en la versión: 1.12.0

Valor predeterminado: ninguno

Nombre de archivo y ruta del archivo de origen de las credenciales que usa la federación de identidades de carga de trabajo para obtener las credenciales de las cuentas de servicio. Este es el valor que proporciona para credential-source-file cuando configura la federación de identidades de cargas de trabajo con el comando create-cred-config.

Consulta Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

gcp.federatedWorkloadIdentity.enabled Básico Introducido en la versión: 1.12.0

Valor predeterminado: false

Habilita la federación de identidades de cargas de trabajo en plataformas que no son de GKE. No se debe definir true si gcp.workloadIdentity.enabled se define como true en el mismo clúster.

Consulta Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

gcp.federatedWorkloadIdentity.tokenExpiration Básico Introducido en la versión: 1.12.0

Valor predeterminado: 3600

Tiempo de vida del token en segundos.

Consulta Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

gcp.projectID Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Obligatorio

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

gcp.projectIDRuntime Básico Introducido en la 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 Google Cloud de la organización de Apigee como para el proyecto del clúster de K8s de tiempo de ejecución.

gcp.region Básico Introducido en la versión: 1.2.0

Valor predeterminado: us-central1

Obligatorio

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

gcp.workloadIdentity.enabled Básico Introducido en la versión: 1.10.0

Valor predeterminado:false

Solo Helm: habilita el uso de Workload Identity en GKE. Workload Identity permite que las cargas de trabajo de tus clústeres de GKE suplanten la identidad de las cuentas de servicio de Gestión de Identidades y Accesos (IAM) para acceder a los servicios de Google Cloud.

No se debe definir true si gcp.federatedWorkloadIdentity.enabled se define como true en el mismo clúster.

Cuando enabled es false (el valor predeterminado), Apigee usa las cuentas de servicio de IAM de cada componente de Apigee hybrid. Consulta Información sobre las cuentas de servicio.

Cuando workloadIdentityEnabled está true, Apigee usa cuentas de servicio de Kubernetes y las asigna a las cuentas de servicio de gestión de identidades y accesos adecuadas para cada componente. Especifica las cuentas de servicio de gestión de identidades y accesos que se van a asignar a las cuentas de servicio de Kubernetes:

gcp.workloadIdentity.gsa Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: ninguno

Solo Helm: dirección de correo de la cuenta de servicio de Google IAM (GSA) de todos los componentes que se asociarán a la cuenta de servicio de Kubernetes correspondiente al habilitar Workload Identity en clústeres de GKE mediante gráficos de Helm. Define este valor cuando hayas asignado el valor true a gcp.workloadIdentity.enabled.

gcp.workloadIdentity.gsa se aplica a todos los componentes híbridos. Si especifica un valor para gcp.workloadIdentity.gsa, no es necesario que proporcione un GSA para ningún componente híbrido individual. Si proporciona un GSA para un componente concreto, el GSA de ese componente anulará gcp.workloadIdentity.gsa solo para ese componente.

Las direcciones de correo de GSA suelen tener el siguiente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Por ejemplo:

apigee-non-prod@my-hybrid-project.iam.gserviceaccount.com

Consulta Enabling Workload Identity on GKE.

gcp.workloadIdentityEnabled Básico Introducido en la versión: 1.4.0

Valor predeterminado:false

apigeectl solo: habilita el uso de Workload Identity. Workload Identity permite que las cargas de trabajo de tus clústeres de GKE suplanten la identidad de las cuentas de servicio de Gestión de Identidades y Accesos (IAM) para acceder a los servicios de Google Cloud.

Cuando workloadIdentityEnabled es false (el valor predeterminado), Apigee usa las cuentas de servicio de IAM de cada componente de Apigee hybrid. Consulta Información sobre las cuentas de servicio.

Cuando workloadIdentityEnabled es true, Apigee usa cuentas de servicio de Kubernetes en lugar de cuentas de servicio de gestión de identidades y accesos, e ignora las siguientes propiedades de configuración:

httpProxy

httpProxy proporciona parámetros de configuración para un servidor proxy de reenvío HTTP. Cuando se configura en overrides.yaml, todas las comunicaciones de Internet de los componentes Apigee Connect, Logger, MART, Metrics, Synchronizer y UDCA pasan por el servidor proxy.

Consulta también: connectAgent, logger, mart, metrics, synchronizer y udca.

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

Propiedad Tipo Descripción
httpProxy.host Básico Introducido en la versión: 1.1.1

Valor predeterminado: ninguno

Nombre de host del proxy HTTP.

httpProxy.port Básico Introducido en la versión: 1.1.1

Valor predeterminado: ninguno

Puerto del proxy HTTP.

httpProxy.scheme Básico Introducido en la 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.

httpProxy.username Básico Introducido en la versión: 1.1.1

Valor predeterminado: ninguno

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

httpProxy.password Básico Introducido en la versión: 1.1.1

Valor predeterminado: ninguno

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

ingressGateways

Configura cada instancia de la pasarela de entrada de Apigee. Usa estas propiedades cuando quieras gestionar instancias individuales por separado mediante ingressGateways[].name.

Consulta apigeeIngressGateway para aplicar una configuración común a todas las instancias de la pasarela de entrada de Apigee.

Aplica cambios a las propiedades de ingressGateways con el gráfico apigee-org.

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

Propiedad Tipo Descripción
ingressGateways[].name Básico Introducido en la versión: 1.8.0

Valor predeterminado: ninguno

Obligatorio

Nombre de la pasarela de entrada. Otros servicios usarán este nombre para dirigir el tráfico a la pasarela. El nombre debe cumplir los siguientes requisitos:

  • Tener una longitud máxima de 17 caracteres
  • Contener únicamente caracteres alfanuméricos en minúscula, guiones ("-") o puntos (".").
  • Empezar por un carácter alfanumérico
  • terminar con un carácter alfanumérico

Para obtener más información, consulta la sección Nombres de subdominios DNS de la documentación de Kubernetes.

ingressGateways[].resources.limits.cpu Avanzado Introducido en la versión: 1.8.0

Valor predeterminado: 2000m

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

ingressGateways[].resources.limits.memory Avanzado Introducido en la versión: 1.8.0

Valor predeterminado: 1Gi

Límite de memoria del recurso, en mebibytes.

ingressGateways[].resources.requests.cpu Avanzado Introducido en la versión: 1.8.0

Valor predeterminado: 300m

La CPU necesaria para el funcionamiento normal del recurso, en milinúcleos.

ingressGateways[].resources.requests.memory Avanzado Introducido en la versión: 1.8.0

Valor predeterminado: 128Mi

La memoria necesaria para el funcionamiento normal del recurso, en mebibytes.

ingressGateways[].replicaCountMax Básico Introducido en la versión: 1.8.0

Valor predeterminado: 10

El número máximo de pods que puede añadir automáticamente el sistema híbrido para la puerta de enlace de entrada disponible para el autoescalado.

ingressGateways[].replicaCountMin Básico Introducido en la versión: 1.8.0

Valor predeterminado: 2

El número mínimo de pods de la puerta de enlace de entrada disponibles para el autoescalado.

ingressGateways[].svcAnnotations Básico Introducido en la versión: 1.8.0

Valor predeterminado: ninguno

Mapa clave-valor opcional que se usa para anotar la pasarela de entrada en plataformas que admiten anotaciones. Por ejemplo:

ingressGateways:
  svcAnnotations:
    networking.gke.io/load-balancer-type: "Internal"
ingressGateways[].svcLoadBalancerIP Básico Introducido en la versión: 1.8.0

Valor predeterminado: ninguno

En las plataformas que admiten la especificación de la dirección IP del balanceador de carga, este se creará con esa dirección IP. En las plataformas que no permiten especificar la dirección IP del balanceador de carga, esta propiedad se ignora.

ingressGateways[].svcType Básico Introducido en la versión: 1.8.1

Valor predeterminado: LoadBalancer

Se usa para cambiar el tipo de servicio predeterminado de k8s para la implementación de ingress. Asigna el valor ClusterIP si quieres inhabilitar la creación del balanceador de carga predeterminado. Posibles valores:

  • ClusterIP
  • LoadBalancer
ingressGateways[].targetCPUUtilizationPercentage Avanzado Introducido en la versión: 1.10.5, 1.11.2 y 1.12.1

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.

Cuando el uso de la CPU supera este valor, el modo híbrido aumentará gradualmente el número de pods del ReplicaSet hasta ingressGateways[].replicaCountMax.

Para obtener más información sobre el escalado en Kubernetes, consulta el artículo sobre el autoescalado horizontal de pods en la documentación de Kubernetes.

ingressGateways[].tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

ingressGateways[].tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

ingressGateways[].tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

ingressGateways[].tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

ingressGateways[].tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

istiod

Configura el acceso de Apigee.

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

Propiedad Tipo Descripción
istiod.accessLogFile Avanzado Introducido en la versión: 1.8.0

Valor predeterminado: /dev/stdout

La dirección del archivo de registro de acceso de entrada, por ejemplo, /dev/stdout.

Si no se define este valor, se inhabilitará el registro de acceso.

istiod.accessLogFormat Avanzado Introducido en la versión: 1.8.0

Formato del registro de acceso de entrada.

Si no se define este valor, se usará el formato de registro de acceso predeterminado del proxy.

Formato predeterminado del registro de acceso:

'{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'

A continuación, se muestra una copia del formato de registro de acceso predeterminado con saltos de línea para facilitar la lectura.

'{"start_time":"%START_TIME%",
  "remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%",
  "user_agent":"%REQ(USER-AGENT)%",
  "host":"%REQ(:AUTHORITY)%",
  "request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%",
  "request_time":"%DURATION%",
  "status":"%RESPONSE_CODE%",
  "status_details":"%RESPONSE_CODE_DETAILS%",
  "bytes_received":"%BYTES_RECEIVED%",
  "bytes_sent":"%BYTES_SENT%",
  "upstream_address":"%UPSTREAM_HOST%",
  "upstream_response_flags":"%RESPONSE_FLAGS%",
  "upstream_response_time":"%RESPONSE_DURATION%",
  "upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%",
  "upstream_cluster":"%UPSTREAM_CLUSTER%",
  "x_forwarded_for":"%REQ(X-FORWARDED-FOR)%",
  "request_method":"%REQ(:METHOD)%",
  "request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%",
  "request_protocol":"%PROTOCOL%",
  "tls_protocol":"%DOWNSTREAM_TLS_VERSION%",
  "request_id":"%REQ(X-REQUEST-ID)%",
  "sni_host":"%REQUESTED_SERVER_NAME%",
  "apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
istiod.forwardClientCertDetails Avanzado Introducido en la versión: 1.9.2

Valor predeterminado: SANITIZE_SET

Determina cómo gestiona el proxy Envoy (para la pasarela de entrada de Apigee) el encabezado HTTP x-forwarded-client-cert (XFCC).

Los valores posibles son:

  • SANITIZE_SET (opción predeterminada) Cuando la conexión del cliente es mTLS, restablece el encabezado XFCC con la información del certificado del cliente y envíalo al siguiente salto.
  • FORWARD_ONLY Cuando la conexión del cliente sea mTLS (TLS mutuo), reenvía solo el encabezado XFCC en la solicitud.
  • APPEND_FORWARD Cuando la conexión del cliente sea mTLS, añade la información del certificado de cliente al encabezado XFCC de la solicitud y reenvíala.
  • SANITIZE No reenvíes el encabezado XFCC.
  • ALWAYS_FORWARD_ONLY Reenvía siempre el encabezado XFCC en la solicitud, independientemente de si la conexión del cliente es mTLS.

Para obtener más información sobre estos valores, consulta la documentación de Envoy sobre Enum extensions.filters.network.http_connection_manager.v3.HttpConnectionManager.ForwardClientCertDetails.

Si cambias este ajuste después de instalar Hybrid, aplícalo con apigeectl init y, a continuación, reinicia los pods de la puerta de enlace de entrada de Apigee.

istiod.healthCheckUserAgents Avanzado Introducido en la versión: 1.12.0

Valores predeterminados:

- "GoogleStackdriverMonitoring-UptimeChecks(https://cloud.google.com/monitoring)"
- "Edge Health Probe"

Permite que los balanceadores de carga que no sean deGoogle Cloud comprueben los endpoints de comprobación del estado de la puerta de enlace de entrada (/healthz/ingress y /healthz) anulando la lista de permitidos de user-agent predeterminada en el entorno híbrido.

Para anular los agentes de usuario predeterminados especificados, usa la siguiente sintaxis e inserta los agentes de usuario personalizados:

istiod:
  healthCheckUserAgents:
  - "CUSTOM_USER_AGENT_1"
  - "CUSTOM_USER_AGENT_2"

Para quitar el requisito del user-agent, usa lo siguiente:

istiod:
  healthCheckUserAgents: []

istiod.image.pullPolicy Avanzado Introducido en la versión: 1.8.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.

istiod.image.tag Avanzado Introducido en la versión: 1.8.0

Valor predeterminado: 1.14.2

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

istiod.image.url Avanzado Introducido en la versión: 1.8.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

istiod.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

istiod.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

istiod.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

istiod.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

istiod.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

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 Tipo Descripción
k8sCluster.name Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

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

k8sCluster.region Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Identifica la región de Google Cloud 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 Tipo Descripción
kubeRBACProxy.image.pullPolicy Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: 1.14.2

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

kubeRBACProxy.image.url Avanzado Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

kubeRBACProxy.resources.limits.cpu Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 500m

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

kubeRBACProxy.resources.limits.memory Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 128Mi

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

kubeRBACProxy.resources.requests.cpu Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 5m

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

kubeRBACProxy.resources.requests.memory Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 64Mi

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

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 la descripción general de los registros.

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

Propiedad Tipo Descripción
logger.annotations Avanzado Introducido en la versión: 1.5.0

Valor predeterminado: ninguno

Mapa de clave-valor opcional que se usa para anotar pods. Para obtener más información, consulta Anotaciones personalizadas.

logger.bufferChunkSize Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 256 k

Tamaño inicial del búfer para leer archivos de registro.

logger.bufferMaxSize Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 104857600

Límite del tamaño del búfer por archivo monitorizado. Los archivos que superen este límite se eliminarán de la lista de archivos monitorizados.

logger.bufferMemoryLimit Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 150 MB

El límite de memoria que puede consumir el registrador. Si se alcanza el límite, el registrador pausará momentáneamente la lectura de más datos hasta que los datos existentes se vacíen en la memoria.

logger.enabled Básico Introducido en la versión: 1.0.0

Valor predeterminado: false

Habilita o inhabilita el registro en el clúster. En el caso de los clústeres que no sean de GKE, el valor debe ser true. En el caso de GKE en Google Cloud o Google Distributed Cloud, el valor debe ser false.

logger.envVars Básico Introducido en la versión: 1.8.5

Valor predeterminado: ninguno

Le permite incluir la variable de entorno NO_PROXY de Fluent Bit, que especifica las URLs cuyo tráfico no se enruta a través del proxy HTTP. La variable NO_PROXY debe definirse como una cadena de nombres de host separados por comas con el siguiente formato:

logger:
  ...
  envVars:
    NO_PROXY: '<comma-separated-values>'

por ejemplo:

  envVars:
    NO_PROXY: 'kubernetes.default.svc,oauth2.googleapis.com,logging.googleapis.com'

Usa envVars: NO_PROXY de forma opcional cuando tengas habilitado el proxy de reenvío HTTP.

Consulta NO_PROXY en la documentación de Fluent Bit.

logger.flushInterval Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 1

Intervalo de espera antes de invocar el siguiente búfer vaciado, en segundos.

logger.gsa Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: ninguno

Solo Helm: dirección de correo de la cuenta de servicio de gestión de identidades y accesos de Google (IAM) apigee-logger que se asociará a la cuenta de servicio de Kubernetes correspondiente al habilitar Workload Identity en clústeres de GKE mediante gráficos de Helm. Define este valor cuando hayas asignado el valor true a gcp.workloadIdentity.enabled.

Las direcciones de correo de GSA suelen tener el siguiente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Por ejemplo:

apigee-logger@my-hybrid-project.iam.gserviceaccount.com

Consulta Habilitar Workload Identity en GKE o Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

logger.image.pullPolicy Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 1.14.2

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

logger.image.url Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

logger.livenessProbe.failureThreshold Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Básico Introducido en la 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 Configurar grupos de nodos dedicados.

logger.nodeSelector.value Básico Introducido en la 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 Configurar grupos de nodos dedicados.

logger.resources.limits.cpu Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 200m

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

logger.resources.limits.memory Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 500Mi

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

logger.resources.requests.cpu Avanzado Introducido en la 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 Avanzado Introducido en la 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 Básico Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

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

logger.serviceAccountRef Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

logger.storageMaxChunks Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 128

Número máximo de fragmentos que pueden estar en memoria. Los fragmentos que superen el límite se guardarán en el sistema de archivos.

logger.terminationGracePeriodSeconds Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 30

Tiempo máximo, en segundos, entre una solicitud de eliminación de un pod y el momento en que se elimina. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución. El pod se eliminará cuando hayan finalizado todos los procesos en ejecución o al final del periodo de gracia, lo que suceda primero. Si no hay procesos en ejecución, el pod se cerrará inmediatamente.

logger.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

logger.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

logger.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

logger.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

logger.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

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 Tipo Descripción
mart.annotations Avanzado Introducido en la versión: 1.5.0

Valor predeterminado: ninguno

Mapa de clave-valor opcional que se usa para anotar pods. Para obtener más información, consulta Anotaciones personalizadas.

mart.gsa Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: ninguno

Solo Helm: dirección de correo de la cuenta de servicio de gestión de identidades y accesos de Google (IAM) apigee-mart que se asociará a la cuenta de servicio de Kubernetes correspondiente al habilitar Workload Identity en clústeres de GKE mediante gráficos de Helm. Define este valor cuando hayas asignado el valor true a gcp.workloadIdentity.enabled.

Las direcciones de correo de GSA suelen tener el siguiente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Por ejemplo:

apigee-mart@my-hybrid-project.iam.gserviceaccount.com

Consulta Habilitar Workload Identity en GKE o Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

mart.hostAlias Básico Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 1.14.2

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

mart.image.url Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

mart.initCheckCF.resources.requests.cpu Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Básico Introducido en la versión: 1.0.0

Valor predeterminado: /v1/server/metrics

mart.nodeSelector.key Básico Introducido en la 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 especifica una clave para mart.nodeselector, el tiempo de ejecución usará el nodo especificado en el objeto nodeSelector.

Consulta Configurar grupos de nodos dedicados.

mart.nodeSelector.value Básico Introducido en la 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 Configurar grupos de nodos dedicados.

mart.readinessProbe.failureThreshold Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Básico Introducido en la versión: 1.0.0

Valor predeterminado: 5

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

mart.replicaCountMin Básico Introducido en la versión: 1.0.0

Valor predeterminado: 1

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

mart.resources.limits.cpu Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 2000m

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

mart.resources.limits.memory Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 5Gi

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

mart.resources.requests.cpu Avanzado Introducido en la 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 Avanzado Introducido en la 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 Básico Introducido en la versión: 1.1.1

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

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

mart.serviceAccountRef Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

mart.sslCertPath Básico Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Se debe especificar sslCertPath/sslKeyPath o sslSecret.

Ruta del sistema de archivos local para cargar y codificar el certificado SSL en un secreto.

mart.sslKeyPath Básico Introducido en la 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 Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Se debe especificar 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 Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 30

Tiempo máximo, en segundos, entre una solicitud de eliminación de un pod y el momento en que se elimina. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución. El pod se eliminará cuando hayan finalizado todos los procesos en ejecución o al final del periodo de gracia, lo que suceda primero. Si no hay procesos en ejecución, el pod se cerrará inmediatamente.

mart.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

mart.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

mart.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

mart.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

mart.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

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 Tipo Descripción
metrics.adapter.image.pullPolicy Avanzado Introducido en la versión: 1.8.1

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.adapter.image.tag Avanzado Introducido en la versión: 1.8.1

Valor predeterminado: 1.14.2

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

metrics.adapter.image.url Avanzado Introducido en la versión: 1.8.1

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

metrics.adapter.resources.limits.cpu Avanzado Introducido en la versión: 1.14.1

Valor predeterminado: 500m

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

metrics.adapter.resources.limits.memory Avanzado Introducido en la versión: 1.14.1

Valor predeterminado: 4Gi

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

metrics.adapter.resources.requests.cpu Avanzado Introducido en la versión: 1.14.1

Valor predeterminado: 100m

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

metrics.adapter.resources.requests.memory Avanzado Introducido en la versión: 1.14.1

Valor predeterminado: 128Mi

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

metrics.aggregator.resources.requests.cpu Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 500m

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

metrics.aggregator.resources.requests.memory Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 512Mi

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

metrics.aggregator.resources.limits.cpu Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 500m

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

metrics.aggregator.resources.limits.memory Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 3Gi

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

metrics.annotations Avanzado Introducido en la versión: 1.5.0

Valor predeterminado: ninguno

Mapa de clave-valor opcional que se usa para anotar pods. Para obtener más información, consulta Anotaciones personalizadas.

metrics.app.resources.requests.cpu Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 500m

La CPU necesaria para el funcionamiento normal de la aplicación en un contenedor de Kubernetes, en milinúcleos.

metrics.app.resources.requests.memory Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 512Mi

La memoria necesaria para el funcionamiento normal de la aplicación en un contenedor de Kubernetes, en mebibytes.

metrics.app.resources.limits.cpu Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 500m

Límite de CPU para el recurso de aplicación en un contenedor de Kubernetes, en milinúcleos.

metrics.app.resources.limits.memory Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 1Gi

Límite de memoria del recurso de la aplicación en un contenedor de Kubernetes, en gibibytes.

metrics.appStackdriverExporter.resources.limits.cpu Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 500m

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

metrics.appStackdriverExporter.resources.limits.memory Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 1Gi

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

metrics.appStackdriverExporter.resources.requests.cpu Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 128m

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

metrics.appStackdriverExporter.resources.requests.memory Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 512Mi

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

metrics.collector.envVars Básico Introducido en la versión: 1.13

Valor predeterminado: ninguno

Te permite introducir y anular variables de entorno en OpenTelemetry. Por ejemplo, puedes definir HTTP_PROXY, HTTPS_PROXY o NO_PROXY para que sus solicitudes pasen por el servidor proxy.

La variable HTTP_PROXY se puede definir como una cadena que contenga el nombre de host con el siguiente formato:

metrics:
...
  envVars:
    HTTP_PROXY: '<host-name>'

por ejemplo:

  envVars:
    HTTP_PROXY: 'http://1.1.1.1:80'

La variable HTTPS_PROXY se puede definir como una cadena que contenga el nombre de host con el siguiente formato:

metrics:
...
  envVars:
    HTTPS_PROXY: '<host-name>'

por ejemplo:

  envVars:
    HTTPS_PROXY: 'https://1.1.1.1:80'

La variable NO_PROXY debe definirse como una cadena de nombres de host separados por comas con el siguiente formato:

metrics:
...
envVars:
  NO_PROXY: '<comma-separated-values>'

por ejemplo:

envVars:
  NO_PROXY: 'https://1.1.1.1:80, https://1.1.1.1:81'

Usa envVars: HTTP_PROXY, envVars: HTTPS_PROXY o envVars: NO_PROXY de forma opcional cuando tengas habilitado el proxy de reenvío HTTP.

Consulta la sección Compatibilidad con proxies de la documentación de OpenTelemetry.

metrics.collector.imagePullPolicy Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: IfNotPresent

Determina cuándo extrae kubelet 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 Usar un repositorio de imágenes privado con Apigee hybrid .

metrics.collector.image.tag Básico Introducido en la versión: 1.12.0

Valor predeterminado: 1.14.2

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

metrics.collector.image.url Básico Introducido en la versión: 1.12.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

metrics.collector.resources.requests.cpu Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 500m

La CPU necesaria para el funcionamiento normal de la aplicación en un contenedor de Kubernetes, en milinúcleos.

metrics.collector.resources.requests.memory Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 512Mi

La memoria necesaria para el funcionamiento normal de la aplicación en un contenedor de Kubernetes, en mebibytes.

metrics.collector.resources.limits.cpu Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 500m

Límite de CPU para el recurso de aplicación en un contenedor de Kubernetes, en milinúcleos.

metrics.collector.resources.limits.memory Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 1Gi

Límite de memoria del recurso de la aplicación en un contenedor de Kubernetes, en gibibytes.

metrics.collector.livenessProbe.failureThreshold Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 5

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.collector.livenessProbe.initialDelaySeconds Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 30

Número de segundos que transcurren después de iniciar un contenedor antes de que se inicie una prueba de actividad.

metrics.collector.livenessProbe.periodSeconds Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 10

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

metrics.collector.livenessProbe.successThreshold Avanzado Introducido en la versión: 1.12.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.

metrics.collector.livenessProbe.timeoutSeconds Avanzado Introducido en la versión: 1.12.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.

metrics.collector.readinessProbe.failureThreshold Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 3

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.collector.readinessProbe.initialDelaySeconds Avanzado Introducido en la versión: 1.12.0

Valor predeterminado: 30

Número de segundos que deben transcurrir después de iniciar un contenedor para que se inicie una sonda de disponibilidad.

metrics.collector.readinessProbe.periodSeconds Avanzado Introducido en la versión: 1.12.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.

metrics.collector.readinessProbe.successThreshold Avanzado Introducido en la versión: 1.12.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.

metrics.collector.readinessProbe.timeoutSeconds Avanzado Introducido en la versión: 1.12.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.

metrics.disablePrometheusPipeline Básico Introducido en la versión: 1.12.0

Valor predeterminado: true

Las métricas de los recursos monitorizados ProxyV2 y TargetV2 no se emiten cuando se definen como true. En su lugar, usa las métricas de los recursos monitorizados Proxy y Target.

metrics.enabled Básico Introducido en la versión: 1.0.0

Valor predeterminado: true

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.gsa Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: ninguno

Solo Helm: dirección de correo de la cuenta de servicio de gestión de identidades y accesos de Google (IAM) apigee-metrics que se asociará a la cuenta de servicio de Kubernetes correspondiente al habilitar Workload Identity en clústeres de GKE mediante gráficos de Helm. Define este valor cuando hayas asignado el valor true a gcp.workloadIdentity.enabled.

Las direcciones de correo de GSA suelen tener el siguiente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Por ejemplo:

apigee-metrics@my-hybrid-project.iam.gserviceaccount.com

Consulta Habilitar Workload Identity en GKE o Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

metrics.nodeSelector.key Básico Introducido en la 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 Configurar grupos de nodos dedicados.

metrics.nodeSelector.value Básico Introducido en la 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 Configurar grupos de nodos dedicados.

metrics.prometheus.containerPort Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 9090

Puerto para conectarse al servicio de métricas de Prometheus.

metrics.prometheus.image.pullPolicy Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 1.14.2

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

metrics.prometheus.image.url Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

metrics.prometheus.livenessProbe.failureThreshold Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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.resources.limits.cpu Avanzado Introducido en la versión: 1.14.1

Valor predeterminado: 500m

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

metrics.prometheus.resources.limits.memory Avanzado Introducido en la versión: 1.14.1

Valor predeterminado: 4Gi

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

metrics.prometheus.resources.requests.cpu Avanzado Introducido en la versión: 1.14.1

Valor predeterminado: 128m

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

metrics.prometheus.resources.requests.memory Avanzado Introducido en la versión: 1.14.1

Valor predeterminado: 512Mi

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

metrics.prometheus.sslCertPath Básico Introducido en la 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:

metrics.prometheus.sslKeyPath Básico Introducido en la 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.proxy.resources.requests.cpu Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 500m

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

metrics.proxy.resources.requests.memory Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 512Mi

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

metrics.proxy.resources.limits.cpu Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 500m

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

metrics.proxy.resources.limits.memory Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 1Gi

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

metrics.proxyStackdriverExporter.resources.requests.cpu Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 128m

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

metrics.proxyStackdriverExporter.resources.requests.memory Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 512Mi

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

metrics.proxyStackdriverExporter.resources.limits.cpu Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 500m

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

metrics.proxyStackdriverExporter.resources.limits.memory Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 1Gi

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

metrics.proxyURL Básico Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

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

metrics.sdSidecar.containerPort Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 9091

Puerto para conectarse al servicio de métricas de Cloud Monitoring.

metrics.sdSidecar.image.pullPolicy Avanzado Introducido en la 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 extraer una imagen nueva si ya existe
  • Always: siempre se debe extraer la política, aunque ya exista.

    Para obtener más información, consulta el artículo sobre cómo actualizar imágenes.

metrics.sdSidecar.image.tag Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 1.14.2

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

metrics.sdSidecar.image.url Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

metrics.serviceAccountPath Básico Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

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

metrics.serviceAccountRef Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

metrics.stackdriverExporter.resources.requests.cpu Avanzado Introducido en la versión: 1.4.0

Deprecated: a partir de la versión 1.8 de Hybrid, metrics:stackdriverExporter se ha sustituido por metrics:appStackdriverExporter y metrics:proxyStackdriverExporter. Consulta los siguientes artículos:

metrics.stackdriverExporter.resources.requests.memory Avanzado Introducido en la versión: 1.4.0

Deprecated: a partir de la versión 1.8 de Hybrid, metrics:stackdriverExporter se ha sustituido por metrics:appStackdriverExporter y metrics:proxyStackdriverExporter. Consulta los siguientes artículos:

metrics.stackdriverExporter.resources.limits.cpu Avanzado Introducido en la versión: 1.4.0

Deprecated: a partir de la versión 1.8 de Hybrid, metrics:stackdriverExporter se ha sustituido por metrics:appStackdriverExporter y metrics:proxyStackdriverExporter. Consulta los siguientes artículos:

metrics.stackdriverExporter.resources.limits.memory Avanzado Introducido en la versión: 1.4.0

Deprecated: a partir de la versión 1.8 de Hybrid, metrics:stackdriverExporter se ha sustituido por metrics:appStackdriverExporter y metrics:proxyStackdriverExporter. Consulta los siguientes artículos:

metrics.terminationGracePeriodSeconds Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 300

Tiempo máximo, en segundos, entre una solicitud de eliminación de un pod y el momento en que se elimina. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución. El pod se eliminará cuando hayan finalizado todos los procesos en ejecución o al final del periodo de gracia, lo que suceda primero. Si no hay procesos en ejecución, el pod se cerrará inmediatamente.

metrics.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

metrics.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

metrics.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

metrics.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

metrics.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

mintTaskScheduler

mintTaskScheduler es la tarea cron para programar tareas de monetización, como el cálculo periódico de las cuotas recurrentes.

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

Propiedad Tipo Descripción
mintTaskScheduler.image.pullPolicy Avanzado Introducido en la versión: 1.7.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.

mintTaskScheduler.image.tag Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 1.14.2

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

mintTaskScheduler.image.url Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

mintTaskScheduler.resources.limits.cpu Avanzado Introducido en la versión: 1.1.0

Valor predeterminado: 2000m

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

mintTaskScheduler.resources.limits.memory Avanzado Introducido en la versión: 1.1.0

Valor predeterminado: 4Gi

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

mintTaskScheduler.resources.requests.cpu Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 500m

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

mintTaskScheduler.resources.requests.memory Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 512Mi

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

mintTaskScheduler.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

mintTaskScheduler.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

mintTaskScheduler.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

mintTaskScheduler.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

mintTaskScheduler.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

newDataPipeline

newDataPipeline determina si Apigee hybrid usa la nueva canalización de datos para que los componentes del tiempo de ejecución escriban datos directamente en el plano de control.

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

Propiedad Tipo Descripción
newDataPipeline.analytics Avanzado Introducido en la versión: 1.13.1

Valor predeterminado: true

Determina si las analíticas usan la nueva canalización de datos de Pub/Sub. Define esta propiedad como true para usar la nueva canalización de datos si utilizas la versión 1.13 híbrida con la residencia de datos habilitada o si utilizas la versión 1.14 híbrida o una posterior y la has definido como false anteriormente.

Selecciona false para inhabilitar el nuevo flujo de procesamiento de datos. Para obtener más información, consulta Configurar el modo híbrido para usar la nueva canalización de datos.

newDataPipeline.debugSession Avanzado Introducido en la versión: 1.13.1

Valor predeterminado: true (a partir de la versión híbrida 1.14.0)

Determina si el nuevo flujo de procesamiento de datos de Pub/Sub está habilitado. Define esta propiedad como true para usar la nueva canalización de datos si utilizas la versión 1.13 híbrida con la residencia de datos habilitada o si utilizas la versión 1.14 híbrida o una posterior y la has definido como false anteriormente.

Selecciona false para inhabilitar el nuevo flujo de procesamiento de datos. Para obtener más información, consulta Configurar el modo híbrido para usar la nueva canalización de datos.

nodeSelector

El objeto nodeSelector define el nodo de tu instancia de Apigee. Información general Apigee hybrid se encarga de asignar la clave y el valor de la etiqueta de apigeeRuntime y apigeeData a los componentes individuales de Istio y MART cuando instalas o actualizas los gráficos apigee-org y apigee-ingress-manager. Puede anular este valor para objetos concretos en la propiedad mart:nodeSelector.

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

Propiedad Tipo Descripción
nodeSelector.apigeeData.key Avanzado Introducido en la 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 Configurar grupos de nodos dedicados.

nodeSelector.apigeeData.value Avanzado Introducido en la 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 Configurar grupos de nodos dedicados.

nodeSelector.apigeeRuntime.key Avanzado Introducido en la 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 Configurar grupos de nodos dedicados.

nodeSelector.apigeeRuntime.value Avanzado Introducido en la 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 Configurar grupos de nodos dedicados.

nodeSelector.requiredForScheduling Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: true

El valor predeterminado de la propiedad requiredForScheduling es true. Cuando true, significa que, si Kubernetes no encuentra nodos con la clave o el valor de la etiqueta que se ha configurado, los pods subyacentes no se programarán en los nodos de trabajador de la VM.

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

Consulta Configurar grupos de nodos dedicados.

redis

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

Propiedad Tipo Descripción
redis.auth.password Básico Introducido en la versión: 1.6.0

Valor predeterminado: iloveapis123

Obligatorio

Contraseña del administrador de Redis. El usuario administrador se usa para cualquier actividad administrativa que se realice en el clúster de Redis.

redis.auth.secret Básico Introducido en la versión: 1.9.1

Valor predeterminado: ninguno

Nombre del archivo almacenado en un secreto de Kubernetes que contiene la contraseña del administrador de Redis. El archivo secreto debe contener la clave:

data:
    redis.auth.password: encoded_value

Consulta también:

redis.envoy.image.pullPolicy Avanzado Introducido en la versión: 1.6.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.

redis.envoy.image.tag Avanzado Introducido en la versión: 1.6.0

Valor predeterminado: 1.14.2

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

redis.envoy.image.url Avanzado Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

redis.image.pullPolicy Avanzado Introducido en la versión: 1.6.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.

redis.image.tag Avanzado Introducido en la versión: 1.6.0

Valor predeterminado: 1.14.2

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

redis.image.url Avanzado Introducido en la versión: 1.6.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

redis.replicaCount Básico Introducido en la versión: 1.6.0

Valor predeterminado: 2

Redis es un almacenamiento replicado. Esta propiedad especifica el número de nodos de Redis empleados como StatefulSet.

redis.resources.requests.cpu Avanzado Introducido en la versión: 1.6.0

Valor predeterminado: 500m

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

redis.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

redis.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

redis.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

redis.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

redis.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

runtime

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

Propiedad Tipo Descripción
runtime.annotations Avanzado Introducido en la versión: 1.5.0

Valor predeterminado: ninguno

Mapa de clave-valor opcional que se usa para anotar pods. Para obtener más información, consulta Anotaciones personalizadas.

runtime.envVars Básico Introducido en la versión: 1.13.1

Valor predeterminado: ninguno

Te permite proporcionar variables de entorno adicionales al componente de tiempo de ejecución en un par clave-valor:

runtime:
  envVars:
    KEY_1: VALUE_N
    ... ...
    KEY_N: VALUE_N

por ejemplo:

runtime:
  envVars:
    RUNTIME_ENV_VAR1: "value of runtime env-var 1"
    RUNTIME_ENV_VAR2: "value of runtime env-var 2"
runtime.image.pullPolicy Avanzado Introducido en la 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.hpaBehavior.scaleDown.percent.periodSeconds Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 60

El periodo durante el cual la política debe ser válida al reducir el número de instancias de tiempo de ejecución en un porcentaje.

runtime.hpaBehavior.scaleDown.percent.value Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 20

Cantidad de cambio que permite la política al reducir el tamaño de un porcentaje de instancias de tiempo de ejecución.

runtime.hpaBehavior.scaleDown.pods.periodSeconds Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 60

El periodo durante el cual la política debe ser válida al reducir el número de instancias de tiempo de ejecución.

runtime.hpaBehavior.scaleDown.pods.value Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 20

La cantidad de cambio que permite la política al reducir el número de instancias de tiempo de ejecución.

runtime.hpaBehavior.scaleDown.selectPolicy Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: Min

La decisión que toma la herramienta de adaptación dinámica entre varias políticas de autoescalado. Si se define el valor Min, se permite el cambio más pequeño en la reducción de la escala de las instancias de tiempo de ejecución. Si asigna el valor Máximo, se permite el mayor cambio en el escalado de las instancias de tiempo de ejecución.

runtime.hpaBehavior.scaleDown.stabilizationWindowSeconds Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 120

Número de segundos durante los que se deben tener en cuenta las recomendaciones anteriores al reducir la escala.

runtime.hpaBehavior.scaleUp.percent.periodSeconds Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 60

El periodo durante el cual la política debe ser válida al aumentar un porcentaje de las instancias de tiempo de ejecución.

runtime.hpaBehavior.scaleUp.percent.value Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 20

El periodo durante el cual la política debe ser válida al aumentar un porcentaje de las instancias de tiempo de ejecución.

runtime.hpaBehavior.scaleUp.pods.periodSeconds Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 60

El periodo durante el cual debe cumplirse la política al aumentar el número de instancias de tiempo de ejecución.

runtime.hpaBehavior.scaleUp.pods.value Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 4

La cantidad de cambio que permite la política al aumentar el número de instancias de tiempo de ejecución.

runtime.hpaBehavior.scaleUp.selectPolicy Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: Máximo

La decisión que toma la herramienta de adaptación dinámica entre varias políticas de autoescalado. Si se define el valor Mín., se permite el cambio más pequeño en el escalado de las instancias del tiempo de ejecución. Si asigna el valor Máximo, se permite el mayor cambio en el escalado de las instancias de tiempo de ejecución.

runtime.hpaBehavior.scaleUp.stabilizationWindowSeconds Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 30

Número de segundos durante los que se deben tener en cuenta las recomendaciones anteriores al aumentar el número de instancias de tiempo de ejecución.

runtime.hpaMetrics.serverMainTaskWaitTime Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 400 M

Tiempo de espera medio deseado (en ms) de la cola de procesamiento en instancias de tiempo de ejecución para solicitudes de proxy en la capa http.

runtime.hpaMetrics.serverNioTaskWaitTime Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 400 M

Tiempo de espera medio deseado (en milisegundos) de la cola de procesamiento en instancias de tiempo de ejecución para que las solicitudes de proxy procesen las políticas.

runtime.hpaMetrics.targetCPUUtilizationPercentage Avanzado Introducido en la versión: 1.7.0

Valor predeterminado: 75

El porcentaje de uso de CPU deseado en todas las instancias del tiempo de ejecución.

runtime.image.tag Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 1.14.2

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

runtime.image.url Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

runtime.livenessProbe.failureThreshold Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Básico Introducido en la 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 Básico Introducido en la 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 Configurar grupos de nodos dedicados.

runtime.readinessProbe.failureThreshold Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Básico Introducido en la versión: 1.0.0

Valor predeterminado: 4

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

Si usas los límites de proxy mejorados por entorno, se aplicará a todos los conjuntos de réplicas del entorno. Cada replicaset seguirá escalando automáticamente de forma independiente.

runtime.replicaCountMin Básico Introducido en la versión: 1.0.0

Valor predeterminado: 1

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

Si usas los límites de proxy mejorados por entorno, se aplicará a todos los conjuntos de réplicas del entorno. Cada replicaset seguirá escalando automáticamente de forma independiente.

runtime.resources.limits.cpu Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 4000m

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

runtime.resources.limits.memory Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 6Gi

Límite de memoria del recurso en un contenedor de Kubernetes, en mebibytes (Mi) o gibibytes (Gi).

runtime.resources.requests.cpu Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 3600

Tiempo máximo, en segundos, entre una solicitud de eliminación de un pod y el momento en que se elimina. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución. El pod se eliminará cuando hayan finalizado todos los procesos en ejecución o al final del periodo de gracia, lo que suceda primero. Si no hay procesos en ejecución, el pod se cerrará inmediatamente.

runtime.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

runtime.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

runtime.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

runtime.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

runtime.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

synchronizer

Asegura que los procesadores de mensajes estén actualizados con los últimos paquetes de proxy 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. De forma predeterminada, Synchronizer almacena los datos de configuración del entorno en Cassandra.

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

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

Propiedad Tipo Descripción
synchronizer.annotations Avanzado Introducido en la versión: 1.5.0

Valor predeterminado: ninguno

Mapa de clave-valor opcional que se usa para anotar pods. Para obtener más información, consulta Anotaciones personalizadas.

synchronizer.image.pullPolicy Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 1.14.2

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

synchronizer.image.url Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

synchronizer.livenessProbe.failureThreshold Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Básico Introducido en la 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 Básico Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Básico Introducido en la versión: 1.0.0

Deprecated: A partir de la versión híbrida 1.2, puedes gestionar el número de réplicas de Synchronizer con: synchronizer.replicaCountMax y synchronizer.replicaCountMin

synchronizer.replicaCountMax Básico Introducido en la versión: 1.2.0

Valor predeterminado: 4

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

synchronizer.replicaCountMin Básico Introducido en la versión: 1.2.0

Valor predeterminado: 1

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

synchronizer.resources.limits.cpu Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 2000m

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

synchronizer.resources.limits.memory Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 5Gi

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

synchronizer.resources.requests.cpu Avanzado Introducido en la 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 Avanzado Introducido en la 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 Básico Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

Ruta al archivo de clave de la cuenta de servicio de Google con el rol Gestor de sincronización de Apigee.

synchronizer.serviceAccountRef Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

synchronizer.serviceAccountSecret Básico Introducido en la versión: 1.1.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.

synchronizer.targetCPUUtilizationPercentage Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 30

Tiempo máximo, en segundos, entre una solicitud de eliminación de un pod y el momento en que se elimina. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución. El pod se eliminará cuando hayan finalizado todos los procesos en ejecución o al final del periodo de gracia, lo que suceda primero. Si no hay procesos en ejecución, el pod se cerrará inmediatamente.

synchronizer.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

synchronizer.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

synchronizer.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

synchronizer.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

synchronizer.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

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 Tipo Descripción
udca.annotations Avanzado Introducido en la versión: 1.5.0

Valor predeterminado: ninguno

Mapa de clave-valor opcional que se usa para anotar pods. Para obtener más información, consulta Anotaciones personalizadas.

udca.fluentd.image.pullPolicy Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 1.14.2

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

udca.fluentd.image.url Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent

Ubicación de la imagen Docker de este servicio.

udca.fluentd.resources.limits.cpu Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 1000m

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

udca.fluentd.resources.limits.memory Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 500Mi

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

udca.fluentd.resources.requests.cpu Avanzado Introducido en la 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.resources.requests.memory Avanzado Introducido en la 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.gsa Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: ninguno

Solo Helm: dirección de correo de la cuenta de servicio de gestión de identidades y accesos de Google (IAM) apigee-udca que se asociará a la cuenta de servicio de Kubernetes correspondiente al habilitar Workload Identity en clústeres de GKE mediante gráficos de Helm. Define este valor cuando hayas asignado el valor true a gcp.workloadIdentity.enabled.

Las direcciones de correo de GSA suelen tener el siguiente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Por ejemplo:

apigee-udca@my-hybrid-project.iam.gserviceaccount.com

Consulta Habilitar Workload Identity en GKE o Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

udca.image.pullPolicy Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 1.14.2

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

udca.image.url Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

udca.jvmXms Avanzado Introducido en la versión: 1.0.0

Deprecated: a partir de la versión 1.8 de Hybrid, udca.jvmXms ya no se usa.

udca.jvmXmx Avanzado Introducido en la versión: 1.0.0

Deprecated: a partir de la versión 1.8 de Hybrid, udca.jvmXmx ya no se usa.

udca.livenessProbe.failureThreshold Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Avanzado Introducido en la 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 Básico Introducido en la 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 Configurar grupos de nodos dedicados.

udca.nodeSelector.value Básico Introducido en la 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 Configurar grupos de nodos dedicados.

udca.pollingIntervalInSec Avanzado Introducido en la 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 Básico Introducido en la versión: 1.0.0

Valor predeterminado: 4

Número máximo de pods que puede añadir automáticamente la opción híbrida para la implementación de UDCA. Como UDCA se implementa como ReplicaSet, los pods son réplicas.

Se recomienda definir udca.replicaCountMax en un número máximo de réplicas por entorno multiplicado por el número de entornos de tu organización de Apigee. Por ejemplo, si quieres permitir un máximo de 4 réplicas por entorno y tienes 3 entornos, define udca.replicaCountMax: 12.

udca.replicaCountMin Básico Introducido en la 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.resources.limits.cpu Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 1000m

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

udca.resources.limits.memory Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 2Gi

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

udca.resources.requests.cpu Avanzado Introducido en la 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.resources.requests.memory Avanzado Introducido en la 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.revision Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: v1

Valor estático que se rellena en una etiqueta para habilitar las implementaciones canary.

udca.serviceAccountPath Básico Introducido en la versión: 1.0.0

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

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

udca.serviceAccountRef Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

udca.targetCPUUtilizationPercentage Avanzado Introducido en la 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 Avanzado Introducido en la versión: 1.0.0

Valor predeterminado: 600

Tiempo máximo, en segundos, entre una solicitud de eliminación de un pod y el momento en que se elimina. Durante este periodo, se ejecutarán los hooks prestop y se cerrará correctamente cualquier proceso en ejecución. El pod se eliminará cuando hayan finalizado todos los procesos en ejecución o al final del periodo de gracia, lo que suceda primero. Si no hay procesos en ejecución, el pod se cerrará inmediatamente.

udca.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

udca.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

udca.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

udca.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

udca.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

virtualhosts

La propiedad virtualhosts es una propiedad de configuración obligatoria. Los hosts virtuales permiten que Apigee hybrid gestione las solicitudes de API a un grupo de entornos específico.

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 Tipo Descripción
virtualhosts[].additionalGateways Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

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

virtualhosts[].cipherSuites[] Avanzado Introducido en la versión: 1.9.2

Valor predeterminado: ninguno

Esta propiedad configura los cifrados TLS que se usan en la pasarela de entrada. A continuación, se muestra una lista de los cifrados habilitados de forma predeterminada en formato OpenSSL. Puedes consultar más información sobre las cifrados admitidos en la documentación de la compilación Boring FIPS de Envoy. Si se deja en blanco, se usarán los conjuntos de cifrado compatibles con la compilación Boring FIPS de Envoy.

Habilitado de forma predeterminada para TLS v.1.3 (no puedes anular los conjuntos de cifrado de TLS 1.3):

  • TLS_AES_128_GCM_SHA256
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256

Habilitado de forma predeterminada para TLS v.1.2:

  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES256-GCM-SHA384

Si quieres habilitar versiones anteriores de TLS en tu implementación de la puerta de enlace de entrada de Apigee, usa virtualhosts.minTLSProtocolVersion junto con la propiedad virtualhosts.cipherSuites.

Por ejemplo, para habilitar TLS v.1.1, haz lo siguiente:

virtualhosts:
- name: ENV_GROUP_NAME
  minTLSProtocolVersion: "1.1"
  cipherSuites:
  - "ECDHE-ECDSA-AES128-GCM-SHA256"
  - "ECDHE-RSA-AES128-GCM-SHA256"
  - "ECDHE-ECDSA-AES256-GCM-SHA384"
  - "ECDHE-RSA-AES256-GCM-SHA384"
  - "ECDHE-ECDSA-CHACHA20-POLY1305"
  - "ECDHE-RSA-CHACHA20-POLY1305"
  - "ECDHE-ECDSA-AES128-SHA"
  - "ECDHE-RSA-AES128-SHA"
  - "ECDHE-ECDSA-AES256-SHA"
  - "ECDHE-RSA-AES256-SHA"
...
virtualhosts[].name Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Obligatorio

Nombre del host virtual.

virtualhosts[].maxTLSProtocolVersion Básico Introducido en la versión: 1.3.0

Valor predeterminado: ninguno

La versión máxima del protocolo TLS que puede seleccionar Envoy. Envoy usa automáticamente la versión óptima del protocolo TLS entre virtualhosts[].minTLSProtocolVersion y virtualhosts[].maxTLSProtocolVersion.

El valor debe ser un número. Por ejemplo:

virtualhosts:
  - name: default
    maxTLSProtocolVersion: "1.3"

El número representa el número de versión de TLS con el formato #.#. En el ejemplo anterior, "1.3" representa la versión de TLS de Istio TLSV1_3.

Consulta también ServerTLSSettings.TLSProtocol en la documentación de Istio.

virtualhosts[].minTLSProtocolVersion Básico Introducido en la versión: 1.3.0

Valor predeterminado: ninguno

Versión mínima del protocolo TLS que puede seleccionar Envoy. Envoy usa automáticamente la versión óptima del protocolo TLS entre virtualhosts[].minTLSProtocolVersion y virtualhosts[].maxTLSProtocolVersion.

El valor debe ser un número. Por ejemplo:

virtualhosts:
  - name: default
    minTLSProtocolVersion: "1.2"

El número representa el número de versión de TLS con el formato #.#. En el ejemplo anterior, 1.2 representa la versión de TLS de Istio TLSV1_2.

Consulta también ServerTLSSettings.TLSProtocol en la documentación de Istio.

virtualhosts[].selector Básico Introducido en la versión: 1.2.0

Valor predeterminado: app: apigee-ingressgateway

Obligatorio

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

  • apigee-ingressgateway: para instalaciones de Apigee hybrid que usen la pasarela de entrada de Apigee.
  • istio-ingressgateway: para instalaciones de Apigee Hybrid que usen Cloud Service Mesh (versiones 1.8 y anteriores de Apigee Hybrid).

Si no se proporciona ninguna etiqueta de selector, la configuración se proporciona a la pasarela de entrada de Apigee.

virtualhosts[].sslCertPath Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Se debe especificar sslCertPath/sslKeyPath o sslSecret.

Ruta de tu sistema a un archivo de certificado TLS.

virtualhosts[].sslKeyPath Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Se debe especificar sslCertPath/sslKeyPath o sslSecret.

Ruta de tu sistema al archivo de clave privada TLS.

virtualhosts[].sslSecret Básico Introducido en la versión: 1.2.0

Valor predeterminado: ninguno

Se debe usar sslCertPath/sslKeyPath o sslSecret.

El nombre del archivo almacenado en un secreto de Kubernetes que contiene los usuarios y las contraseñas de Cassandra. Para crear el secreto, sigue estas instrucciones: Crea el secreto.

Consulta también:

watcher

La propiedad watcher es una propiedad de configuración obligatoria. El observador es un proceso que monitoriza los cambios en la configuración y activa su aplicación en el plano de tiempo de ejecución.

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

Propiedad Tipo Descripción
watcher.annotations Avanzado Introducido en la versión: 1.5.0

Valor predeterminado: ninguno

Mapa de clave-valor opcional que se usa para anotar pods. Para obtener más información, consulta Anotaciones personalizadas.

watcher.args.enableIssueScanning Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: true

Habilita o inhabilita la detección automática de problemas. Cuando true, Watcher analiza automáticamente el plano de control y el estado del servidor de la API de Kubernetes para determinar si hay problemas de configuración.

Selecciona false para inhabilitar la detección automática de problemas. Para obtener más información, consulte Detección automática de problemas.

watcher.args.enableLeaderElect Avanzado Introducido en la versión: 1.13.0

Valor predeterminado: true

Cuando true (valor predeterminado) watcher.args.enableLeaderElect selecciona un solo pod de observador para gestionar y registrar la información de enrutamiento. Es necesario limitar esta opción a un solo pod para evitar el tiempo de inactividad durante las actualizaciones o las restauraciones. Durante estos eventos, pueden ejecutarse varias versiones de watcher simultáneamente. Cada instancia de Watcher puede tener una lógica de creación de rutas diferente, lo que puede provocar un tiempo de inactividad.watcher.replicaCountMax.

watcher.args.issueScanInterval Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: 60

Intervalo en segundos que indica la frecuencia con la que Watcher analiza el plano de ejecución para detectar problemas automáticamente. Para obtener más información, consulte Detección automática de problemas.

watcher.gsa Avanzado Introducido en la versión: 1.10.0

Valor predeterminado: ninguno

Solo Helm: dirección de correo de la cuenta de servicio de gestión de identidades y accesos de Google (IAM) apigee-watcher que se asociará a la cuenta de servicio de Kubernetes correspondiente al habilitar Workload Identity en clústeres de GKE mediante gráficos de Helm. Define este valor cuando hayas asignado el valor true a gcp.workloadIdentity.enabled.

Las direcciones de correo de GSA suelen tener el siguiente formato:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

Por ejemplo:

apigee-watcher@my-hybrid-project.iam.gserviceaccount.com

Consulta Habilitar Workload Identity en GKE o Habilitar la federación de identidades de cargas de trabajo en AKS y EKS.

watcher.image.pullPolicy Avanzado Introducido en la versión: 1.4.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.

watcher.image.tag Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: 1.14.2

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

watcher.image.url Avanzado Introducido en la versión: 1.4.0

Valor predeterminado: ninguno

Ubicación de la imagen Docker de este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.

watcher.replicaCountMax Básico Introducido en la versión: 1.3.0

Valor predeterminado: 1

Número máximo de réplicas de observador. Debe mantenerse en 1 para evitar conflictos.

Apigee hybrid usa un pod de observador por instalación. La elección de líder selecciona automáticamente un pod de observador. Se forzará que las réplicas de pods de observador adicionales pasen a un estado inestable. Consulta watcher.args.enableLeaderElect.

watcher.replicaCountMin Básico Introducido en la versión: 1.3.0

Valor predeterminado: 1

Número mínimo de réplicas de observador.

watcher.resources.limits.cpu Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 1000m

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

watcher.resources.limits.memory Avanzado Introducido en la versión: 1.11.0

Valor predeterminado: 2Gi

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

watcher.serviceAccountPath Básico Introducido en la versión: 1.3.0

Valor predeterminado: ninguno

Obligatorio.

Ruta al archivo de clave de la cuenta de servicio de Google con el rol Agente de tiempo de ejecución de Apigee.

watcher.serviceAccountRef Avanzado Introducido en la versión: 1.3.0

Valor predeterminado: ninguno

Es obligatorio usar serviceAccountPath o serviceAccountRef.

watcher.tolerations.effect Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

effect especifica el efecto que tendrá la coincidencia de una tolerancia con un taint. Los valores de effect pueden ser:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Para obtener más información, consulta Taints y tolerancias: conceptos.

watcher.tolerations.key Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

key identifica los pods a los que se puede aplicar la tolerancia.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

watcher.tolerations.operator Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: "Equal"

Es necesario para usar la función Tolerancias e intolerancias de Kubernetes.

operator especifica la operación que se usa para activar effect. Los valores de operator pueden ser:

  • Equal coincide con el valor definido en value.
  • Exists ignora el valor definido en value.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

watcher.tolerations.tolerationSeconds Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo permanece un pod enlazado a un nodo que falla o no responde.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).

watcher.tolerations.value Avanzado Introducido en la versión: 1.10.1

Valor predeterminado: ninguno

Usada por la función Tolerancias e intolerancias de Kubernetes.

value es el valor que activa el effect cuando operator se define como Equal.

Para obtener más información, consulta Taints and Tolerations: Concepts (Taints y tolerancias: conceptos).