Referencia de propiedad de configuración

En esta sección, se enumeran todas las propiedades de configuración que puedes usar para personalizar el plano de entorno de ejecución de tu implementación híbrida de Apigee.

Filtra esta página

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

Visualización   propiedades de configuración de esta página.

Propiedades de nivel superior

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

Propiedad Tipo Descripción
axHashSalt Avanzado

Presentado en la versión: 1.3.0

Valor predeterminado: iloveapis123

Optional

El nombre de un Secret de Kubernetes que contiene un valor de sal que se usa cuando se calculan hashes para ofuscar datos del usuario antes de enviarlos a las estadísticas de Apigee. Si no especificas un valor de sal, se usa iloveapis123 de forma predeterminada. Crea el Secret con el valor de sal como su entrada. Puedes usar el mismo valor de sal en varios clústeres para garantizar resultados de hashing coherente entre los clústeres.

Apigee usa SHA512 para aplicar un hash al valor original antes de enviar datos del plano de entorno de ejecución al plano de control.

Consulta: Ofusca datos del usuario para las estadísticas.
contractProvider Avanzado Presentado en la versión: 1.0.0

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

Define la ruta de acceso de la API para todas las API de tu instalación.

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

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

En el ejemplo anterior, CONTROL_PLANE_LOCATION es la ubicación en la que se almacenan los datos del plano de control, como los paquetes de proxy. Para obtener una lista, consulta Regiones del plano de control de la API de Apigee disponibles.

Por ejemplo:

contractProvider: https://us-apigee.googleapis.com
gcpProjectID Avanzado Deprecated: Para v1.2.0 y versiones posteriores, usa gcp.projectID en su lugar.

Presentado 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 apigee-logger y apigee-metrics envían sus datos.
gcpRegion Avanzado Deprecated: Para v1.2.0 y versiones posteriores, usa gcp.region en su lugar.

Presentado 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 apigee-logger y apigee-metrics envían sus datos.
hub Avanzado Presentado en la versión: 1.11.0

Valor predeterminado: Ninguno

La 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, usa hub para configurar la URL del repositorio de todos los componentes, en lugar de usar la propiedad individual image.url para cada componente. Solo configura URLs individuales si usas un repositorio independiente para un componente específico.

La ruta de la imagen para cada componente individual será el valor de hub más el nombre de la imagen y la etiqueta 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:

## an example of internal component vs 3rd party
containers:
- name: apigee-udca
  image: private-docker-host.example.com/apigee-udca:1.12.4
  imagePullPolicy: IfNotPresent

containers:
- name: apigee-ingressgateway
  image: private-docker-host.example.com/apigee-asm-ingress:1.18.7-asm.4-distroless
  imagePullPolicy: IfNotPresent

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

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

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

Puedes anular la URL de imagen de los componentes de forma individual con las siguientes propiedades:
imagePullSecrets.name Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

Nombre del secreto de Kubernetes configurado como tipo de Docker de registro se usa para extraer imágenes del repositorio privado.
instanceID Básico Presentado en la versión: 1.3.0

Valor predeterminado: Ninguno

Obligatorio

Un identificador único para esta instalación.

Una string única para identificar esta instancia. Puede ser cualquier combinación de letras y números de hasta 63 caracteres.
k8sClusterName Avanzado Deprecated: Para v1.2.0 y versiones posteriores, usa k8sCluster.name y k8sCluster.region en su lugar.

Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

Nombre del clúster Pro 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 apigee-logger y apigee-metrics envían sus datos.
kmsEncryptionKey Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: defaults.org.kmsEncryptionKey

Opcional. Usa solo uno de estos valores: kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

Ruta de acceso del sistema de archivos local para la clave de encriptación de datos KMS de Apigee.
kmsEncryptionPath Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: Ninguno

Opcional. Usa solo uno de estos valores: kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

La ruta de acceso a un archivo que contiene una clave de encriptación codificada en base64. Consulta Encriptación de datos.
kmsEncryptionSecret.key Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: Ninguno

Opcional. Usa solo uno de estos valores: kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

La clave de un secret de Kubernetes que contiene una clave de encriptación codificada en Base64. Consulta Encriptación de datos.
kmsEncryptionSecret.name Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: Ninguno

Opcional. Usa solo uno de estos valores: kmsEncryptionKey, kmsEncryptionPath o kmsEncryptionSecret.

El nombre de un secret de Kubernetes que contiene una clave de encriptación codificada en Base64. Consulta Encriptación de datos.
kvmEncryptionKey Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: defaults.org.kmsEncryptionKey

Opcional. Usa solo uno de estos valores: kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

Ruta de acceso del sistema de archivos local para la clave de encriptación de datos de KMS de Apigee.
kvmEncryptionPath Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: Ninguno

Opcional. Usa solo uno de estos valores: kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

La ruta de acceso a un archivo que contiene una clave de encriptación codificada en base64. Consulta Encriptación de datos.
kvmEncryptionSecret.key Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: Ninguno

Opcional. Usa solo uno de estos valores: kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

La clave de un secret de Kubernetes que contiene una clave de encriptación codificada en Base64. Consulta Encriptación de datos.
kvmEncryptionSecret.name Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: Ninguno

Opcional. Usa solo uno de estos valores: kvmEncryptionKey, kvmEncryptionPath o kvmEncryptionSecret.

El nombre de un secret de Kubernetes que contiene una clave de encriptación codificada en Base64. Consulta Encriptación de datos.
multiOrgCluster Avanzado Presentado en la versión: 1.10.0

Valor predeterminado: false

Para los clústeres multiorganización, esta propiedad permite que las métricas de la organización se exporten al proyecto enumerado en la propiedad gcp.projectID. Aplica esta configuración en el archivo de anulación para cada organización en un clúster multiorganización. Para obtener más información, consulta Agrega varias organizaciones híbridas a un clúster.

namespace Básico Presentado 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

Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

Obligatorio

La organización con entornos híbridos habilitados que se aprovisionó en Apigee durante la instalación híbrida. Una organización es el contenedor de nivel superior en Apigee. Contiene todos los proxies de API y los recursos relacionados. Si el valor está vacío, debes actualizarlo con el nombre de tu organización una vez que lo hayas creado.
orgScopedUDCA Avanzado Presentado en la versión: 1.8.0

Valor predeterminado: true

Habilita el servicio de agente de recopilación de datos universal (UDCA) a nivel de la organización, que extrae estadísticas, monetización y depuración (seguimiento) y las envía a la plataforma de estadísticas unificada (UAP) que reside en el plano de control.

El UDCA con permiso de la organización usa una sola cuenta de servicio de Google para todos los entornos de Apigee. La cuenta de servicio debe tener el rol de agente de estadísticas de Apigee (roles/apigee.analyticsAgent).

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

Si prefieres usar un agente de UDCA separado para cada entorno, configura orgScopedUDCA: false y establece los valores de envs[].serviceAccountPaths.udca y envs[].serviceAccountSecretRefs.udca.

Consulta también: udca.

revision Avanzado Presentado en la versión: 1.0.0

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

Apigee híbrido admite actualizaciones progresivas de Kubernetes, que permiten que las actualizaciones de implementación se realicen sin tiempo de inactividad mediante la actualización incremental de instancias de pods con nuevas.

Cuando se actualizan ciertas anulaciones de YAML que dan como resultado un cambio subyacente en el PodTemplateSpec de Kubernetes, la propiedad de anulación revision también debe cambiarse en override.yaml del cliente. Esto es necesario para que el controlador subyacente de Kubernetes ApigeeDeployment (AD) realice una actualización progresiva segura de la versión anterior a la nueva. Puedes usar cualquier valor de texto en minúscula, p. ej.: blue, a, 1.0.0.

Cuando se cambie y aplique la propiedad revision, se producirá una actualización progresiva para todos los componentes

Los cambios en las propiedades de los siguientes objetos requieren una actualización a revision:

Para obtener más información, consulta Actualizaciones progresivas.
serviceAccountSecretProviderClass Avanzado Presentado en la versión: 1.12.0

Valor predeterminado: Ninguno

El nombre de la clase de proveedor de secretos específico de la organización (SecretProviderClass) que se usa para almacenar claves de cuentas de servicio en Vault.

Consulta Almacena claves de cuentas de servicio en Hashicorp Vault

validateOrg Avanzado Presentado en la versión: 1.8.0

Valor predeterminado: true

Habilita una validación estricta del vínculo entre la organización de Apigee y el proyecto de Google Cloud y verifica la existencia de grupos de entornos.

Consulta también org
validateServiceAccounts Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: true

Habilita la validación estricta de los permisos de la cuenta de servicio. Esto usa el método testIamPermissions de la API de Cloud Resource Manager para verificar que la cuenta de servicio proporcionada tenga los permisos necesarios. En el caso de las cuentas de servicio para una organización de Apigee, la verificación del ID del proyecto es la que se asigna a la organización. Para las métricas y Logger, el proyecto verificado se basa en la configuración gcpProjectID overrides.yaml.

Consulta también gcpProjectID

ao

Los operadores de Apigee (AO) crean y actualizan los recursos de Istio y Kubernetes de bajo nivel necesarios para implementar y mantener la AD. Por ejemplo, el controlador lleva a cabo la actualización de procesadores de mensajes.

En la siguiente tabla, se describen las propiedades del objeto ao de los operadores de apigee:

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

Valor predeterminado: true

Evita que Apigee proporcione una configuración a Cloud Service Mesh instalado por el cliente.

  • Se establece en true para instalaciones híbridas mediante la puerta de enlace de entrada de Apigee.
  • Configúralo como false para las instalaciones híbridas usando Anthos Service Mesh (versiones 1.8 y anteriores de Apigee Hybrid).
ao.args.disableManagedClusterRoles Avanzado Presentado en la versión: 1.10.0

Valor predeterminado: true

Cuando es true (la opción predeterminada), Apigee Hybrid no administra ClusterRole y ClursterRoleBinding de Kubernetes directamente. Si tienes un proceso que requiere la administración de estos recursos, un usuario debe realizar el proceso con los permisos correctos para hacerlo.

ao.image.pullPolicy Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: IfNotPresent

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

  • IfNotPresent: No extraigas una imagen nueva si ya existe.
  • Always: Extrae la imagen siempre, sin importar si ya existe.

Para obtener más información, consulta Actualiza imágenes.
ao.image.tag Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: 1.12.4

La etiqueta de versión para la imagen de Docker de este servicio.
ao.image.url Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: Ninguno

La ubicación de la imagen de Docker para este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.
ao.resources.limits.cpu Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: 250m

El límite de CPU del recurso en un contenedor de Kubernetes, en milicores.
ao.resources.limits.memory Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: 256Mi

El límite de memoria para el recurso en un contenedor de Kubernetes, en mebibytes.
ao.resources.requests.cpu Avanzado Presentado 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 milicores.
ao.resources.requests.memory Avanzado Presentado 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 Presentado en la versión: 1.10.1

Valor predeterminado: Ninguno

Se requiere para usar la función de Taints y tolerancias de Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
ao.tolerations.key Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: Ninguno

Se requiere para usar la función de Taints y tolerancias de Kubernetes.

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

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
ao.tolerations.operator Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: "Equal"

Se requiere para usar la función de Taints y tolerancias de Kubernetes.

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

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

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
ao.tolerations.tolerationSeconds Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: Ninguno

Lo usa la función de Taints y tolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo un Pod permanece vinculado a un nodo con errores o que no responde.

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
ao.tolerations.value Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: Ninguno

Lo usa la función de Taints y tolerancias de Kubernetes.

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

Consulta Taints y tolerancias: Conceptos para obtener más detalles.

apigeeIngressGateway

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

Consulta ingressGateways para configurar instancias individuales de manera inequívoca.

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

En la siguiente tabla, se describen los campos del objeto apigeeIngressGateway.

Propiedad Tipo Descripción
apigeeIngressGateway.image.pullPolicy Avanzado Presentado en la versión: 1.11.0

Valor predeterminado: IfNotPresent

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

  • IfNotPresent: No extraigas una imagen nueva si ya existe.
  • Always: Extrae la imagen siempre, sin importar si ya existe.

Para obtener más información, consulta Actualiza imágenes.
apigeeIngressGateway.image.tag Avanzado Presentado en la versión: 1.11.0

Valor predeterminado: 1.18.7-asm.4-distroless

La etiqueta de versión para la imagen de Docker de este servicio.
apigeeIngressGateway.image.url Avanzado Presentado en la versión: 1.11.0

Valor predeterminado: Ninguno

La ubicación de la imagen de Docker para este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.
apigeeIngressGateway.nodeSelector.key Avanzado Presentado 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 dedicados de Kubernetes a los servicios de puerta de enlace de entrada.

Consulta Configura grupos de nodos dedicados.
apigeeIngressGateway.nodeSelector.value Avanzado Presentado en la versión: 1.11.0

Valor predeterminado: Ninguno

El valor opcional de etiqueta del selector de nodo que se usa para orientar nodos de Kubernetes dedicados para servicios de puerta de enlace de entrada y anular la configuración nodeSelector.apigeeData.

Consulta nodeSelector.
apigeeIngressGateway.replicaCountMax Básico Presentado en la versión: 1.11.0

Valor predeterminado: 4

Cantidad máxima de pods que el híbrido puede agregar automáticamente a la puerta de enlace de entrada disponible para el ajuste de escala automático.
apigeeIngressGateway.replicaCountMin Básico Presentado en la versión: 1.11.0

Valor predeterminado: 2

Cantidad mínima de pods para la puerta de enlace de entrada disponible para el ajuste de escala automático.
apigeeIngressGateway.targetCPUUtilizationPercentage Avanzado Presentado en la versión: 1.10.5, 1.11.2, 1.12.1

Valor predeterminado: 75

El umbral de uso de la CPU para escalar la cantidad de Pods en ReplicaSet, como un porcentaje del total de recursos de CPU disponibles.

Cuando el uso de CPU supere este valor, el híbrido aumentará gradualmente la cantidad de pods en ReplicaSet, hasta apigeeIngressGateway.replicaCountMax.

Para obtener más información sobre el escalamiento en Kubernetes, consulta Ajuste automático de escala horizontal de Pods en la documentación de Kubernetes.

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

Valor predeterminado: Ninguno

Se requiere para usar la función de Taints y tolerancias de Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
apigeeIngressGateway.tolerations.key Avanzado Presentado en la versión: 1.11.0

Valor predeterminado: Ninguno

Se requiere para usar la función de Taints y tolerancias de Kubernetes.

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

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
apigeeIngressGateway.tolerations.operator Avanzado Presentado en la versión: 1.11.0

Valor predeterminado: "Equal"

Se requiere para usar la función de Taints y tolerancias de Kubernetes.

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

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

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
apigeeIngressGateway.tolerations.tolerationSeconds Avanzado Presentado en la versión: 1.11.0

Valor predeterminado: Ninguno

Lo usa la función de Taints y tolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo un Pod permanece vinculado a un nodo con errores o que no responde.

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
apigeeIngressGateway.tolerations.value Avanzado Presentado en la versión: 1.11.0

Valor predeterminado: Ninguno

Lo usa la función de Taints y tolerancias de Kubernetes.

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

Consulta Taints y tolerancias: Conceptos para obtener más detalles.

cassandra

Define el servicio híbrido que administra el repositorio de datos de entorno de ejecución. Este repositorio almacena configuraciones de aplicaciones, contadores de cuotas distribuidas, claves de API y tokens de OAuth para aplicaciones que se ejecutan en la puerta de enlace.

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 Presentado en la versión: 1.5.0

Valor predeterminado: Ninguno

Mapa de par clave-valor opcional que se usa para anotar pods. Para obtener más información, consulta la sección Anotaciones personalizadas.
cassandra.auth.admin.password Básico Presentado en la versión: 1.0.0

Valor predeterminado: iloveapis123

Obligatorio

Contraseña para el administrador de Cassandra. El usuario administrador se usa para todas las actividades administrativas que se realizan en el clúster de Cassandra, como la copia de seguridad y el restablecimiento.
cassandra.auth.ddl.password Básico Presentado en la versión: 1.0.0

Valor predeterminado: iloveapis123

Obligatorio

Contraseña para el usuario de lenguaje de definición de datos (DDL) de Cassandra. Lo usa MART para cualquiera de las tareas de definición de datos, como la creación, actualización y eliminación de espacios de claves.
cassandra.auth.default.password Básico Presentado en la versión: 1.0.0

Valor predeterminado: iloveapis123

Obligatorio

La contraseña para el usuario predeterminado de Cassandra que se creó cuando la autenticación está habilitada. Esta contraseña se debe restablecer cuando se configura la autenticación de Cassandra. Consulta Cómo configurar TLS para Cassandra.
cassandra.auth.dml.password Básico Presentado en la versión: 1.0.0

Valor predeterminado: iloveapis123

Obligatorio

Contraseña para el usuario de lenguaje de manipulación de datos (DML) de Cassandra. La comunicación del cliente usa el usuario de DML para leer y escribir datos en Cassandra.
cassandra.auth.image.pullPolicy Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: IfNotPresent

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

  • IfNotPresent: No extraigas una imagen nueva si ya existe.
  • Always: Extrae la imagen siempre, sin importar si ya existe.

Para obtener más información, consulta Actualiza imágenes.
cassandra.auth.image.tag Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 1.12.4

La etiqueta de versión para la imagen de Docker de este servicio.
cassandra.auth.image.url Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

La ubicación de la imagen de Docker para este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.
cassandra.auth.jmx.password Básico Presentado en la versión: 1.4.0

Valor predeterminado: iloveapis123

Obligatorio

Contraseña para el usuario de operaciones de Cassandra JMX. Se usa para autenticar y comunicarse con la interfaz de Cassandra JMX.
cassandra.auth.jmx.username Básico Presentado en la versión: 1.4.0

Valor predeterminado: jmxuser

Obligatorio

Nombre de usuario para el usuario de operaciones de Cassandra JMX. Se usa para autenticar y comunicarse con la interfaz de Cassandra JMX.
cassandra.auth.jolokia.password Básico Presentado en la versión: 1.4.0

Valor predeterminado: iloveapis123

Obligatorio

Contraseña para el usuario de operaciones Cassandra Jolokia JMX. Se usa para autenticar y comunicarse con la API de Cassandra JMX.
cassandra.auth.jolokia.username Básico Presentado en la versión: 1.4.0

Valor predeterminado: apigee

Obligatorio

Nombre de usuario para el usuario de operaciones de Cassandra Jolokia JMX. Se usa para autenticar y comunicarse con la API de Cassandra JMX.
cassandra.auth.secret Básico Presentado en la versión: 1.3.3

Valor predeterminado: Ninguno

El nombre del archivo almacenado en un Secret de Kubernetes que contiene los usuarios y las contraseñas de Cassandra. Puedes crear el Secret con las siguientes instrucciones: Crea el Secret.

También consulta lo siguiente:
cassandra.auth.secretProviderClass Avanzado Presentado en la versión: 1.10.3

Valor predeterminado: Ninguno

La política de almacenamiento de secrets de Cassandra. Cuando se establece, debe coincidir con el SecretProviderClass que hace referencia al proveedor de Secrets externo, como Hashicorp Vault. Cuando no se configura, Apigee Hybrid usa los nombres de usuario y las contraseñas almacenados en:

o el objeto Secret de Kubernetes almacenado en:

Consulta Almacena Secrets de Cassandra en Hashicorp Vault para obtener instrucciones para crear la política.
cassandra.backup.cloudProvider Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: GCP

El nombre de un proveedor de copia de seguridad. Valores admitidos: GCP, HYBRID y CSI. Establece el valor como:

  • GCP para almacenar archivos de copia de seguridad en Google Cloud Storage.
  • HYBRID para almacenar archivos de copia de seguridad en un servidor SSH remoto.
  • CSI (recomendado) para usar las instantáneas de volumen de CSI de Kubernetes para la copia de seguridad. Para obtener información sobre las copias de seguridad y el restablecimiento de CSI en plataformas en la nube, como Google Cloud, AWS y Azure, consulta Copias de seguridad y restablecimiento de CSI.
cassandra.backup.dbStorageBucket Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

Obligatorio si la copia de seguridad está habilitada y cassandra.backup.cloudProvider se configura como GCP.

Debe tener el formato gs://BUCKET_NAME (se requiere el prefijo gs://).

Es el nombre de un bucket de Google Cloud Storage existente que se usará para almacenar los archivos de copia de seguridad. Consulta Crea buckets si necesitas crear uno.
cassandra.backup.enabled Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: false

La copia de seguridad de datos no está habilitada de forma predeterminada. Para habilitarla, configúrala como true.

Consulta Copia de seguridad y recuperación de Cassandra.
cassandra.backup.image.pullPolicy Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: IfNotPresent

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

  • IfNotPresent: No extraigas una imagen nueva si ya existe.
  • Always: Extrae la imagen siempre, sin importar si ya existe.

Para obtener más información, consulta Actualiza imágenes.
cassandra.backup.image.tag Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 1.12.4

La etiqueta de versión para la imagen de Docker de este servicio.
cassandra.backup.image.url Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

La ubicación de la imagen de Docker para este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.
cassandra.backup.keyfile Avanzado Presentado en la versión: 1.3.0

Valor predeterminado: Ninguno

Obligatorio si la copia de seguridad está habilitada y cassandra.backup.cloudProvider se configura como HYBRID.

La ruta de tu sistema de archivos local al archivo de claves privadas SSH.
cassandra.backup.schedule Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 0 2 * * *

El programa para el trabajo cron de copia de seguridad.

Consulta Copia de seguridad y recuperación de Cassandra.
cassandra.backup.server Avanzado Presentado en la versión: 1.3.0

Valor predeterminado: Ninguno

Obligatorio si la copia de seguridad está habilitada y cassandra.backup.cloudProvider se configura como HYBRID.

La dirección IP de tu servidor de copia de seguridad de SSH remoto.
cassandra.backup.serviceAccountPath Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

Ruta de acceso a un archivo de claves de la cuenta de servicio de Google que tenga el rol de 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á configurada en GCP, se requiere una de las siguientes opciones para garantizar que Apigee Hybrid pueda acceder al bucket de Google Cloud Storage para subir archivos de copia de seguridad:

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

Valor predeterminado: Ninguno

Es el nombre de un secreto de Kubernetes existente que almacena el contenido de un archivo de claves de la cuenta de servicio de Google que tiene el rol de 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á configurada en GCP, se requiere una de las siguientes opciones para garantizar que Apigee Hybrid pueda acceder al bucket de Google Cloud Storage para subir archivos de copia de seguridad:

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

Valor predeterminado: Ninguno

Obligatorio si la copia de seguridad está habilitada y cassandra.backup.cloudProvider se configura como HYBRID.

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

El nombre del directorio de copia de seguridad de tu servidor de SSH de copia de seguridad.
cassandra.clusterName Básico Presentado en la versión: 1.0.0

Valor predeterminado: apigeecluster

Especifica el nombre del clúster de Cassandra.
cassandra.datacenter Básico Presentado en la versión: 1.0.0

Valor predeterminado: dc-1

Especifica el centro de datos del nodo de Cassandra.
cassandra.dnsPolicy Básico Presentado en la versión: 1.1.1

Valor predeterminado: Ninguno

Cuando configuras hostNetwork como verdadero, la política de DNS se configura como ClusterFirstWithHostNet.

cassandra.externalSeedHost Básico Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

Nombre de host o IP de un nodo del clúster de Cassandra. Si no se configura, se utiliza el servicio local de Kubernetes.
cassandra.heapNewSize Básico Presentado en la versión: 1.0.0

Valor predeterminado: 100M

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

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

Valor predeterminado: false

Habilita la función hostNetwork de Kubernetes. Apigee usa esta función en instalaciones multirregionales para comunicarse entre Pods si el espacio de nombres de la red del Pod no tiene conectividad entre los clústeres (los clústeres se ejecutan en el "modo de red de isla"), que es el caso predeterminado en las instalaciones que no son de GKE, incluida Google Distributed Cloud en VMware o Bare Metal, GKE en AWS, AKS, EKS y OpenShift.

Establece cassandra.hostNetwork en false para las instalaciones de una sola región y las instalaciones multirregionales con conectividad entre Pods en clústeres diferentes, por ejemplo, instalaciones de GKE.

Establece cassandra.hostNetwork en true para las instalaciones multirregionales sin comunicación entre los Pods en diferentes clústeres, por ejemplo, las instalaciones de Google Distributed Cloud en VMware o Bare Metal, GKE en AWS, AKS, EKS y OpenShift. Consulta Implementación multirregional: requisitos previos.

Cuando está establecido en true, la política de DNS se establece automáticamente en ClusterFirstWithHostNet.
cassandra.image.pullPolicy Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: IfNotPresent

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

  • IfNotPresent: No extraigas una imagen nueva si ya existe.
  • Always: Extrae la imagen siempre, sin importar si ya existe.

Para obtener más información, consulta Actualiza imágenes.
cassandra.image.tag Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 1.12.4

La etiqueta de versión para la imagen de Docker de este servicio.
cassandra.image.url Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

La ubicación de la imagen de Docker para este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.
cassandra.maxHeapSize Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 512M

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

cassandra.multiRegionSeedHost Básico Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

La dirección IP de un clúster existente de Cassandra que se usa para expandir el clúster existente a una región nueva. Consulta Configura el host de origen de varias regiones.

cassandra.nodeSelector.key Avanzado Presentado 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 dedicados de Kubernetes a los servicios de datos cassandra.

Consulta Configura grupos de nodos dedicados.
cassandra.nodeSelector.value Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

Valor opcional de la etiqueta del selector de nodos que se usa a fin de orientar nodos de Kubernetes dedicados para servicios de datos cassandra y anular la configuración nodeSelector.apigeeData.

Consulta nodeSelector.
cassandra.port Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 9042

Número de puerto utilizado para conectarse a Cassandra.
cassandra.rack Básico Presentado en la versión: 1.0.0

Valor predeterminado: ra-1

Especifica el bastidor del nodo de Cassandra.
cassandra.readinessProbe.failureThreshold Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 2

La cantidad de veces que Kubernetes verificará que fallen las pruebas de disponibilidad antes de marcar el pod como no listo. El valor mínimo es 1.
cassandra.readinessProbe.initialDelaySeconds Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 0

La cantidad de segundos luego de que se inicia un contenedor antes de que se inicie un sondeo de preparación.
cassandra.readinessProbe.periodSeconds Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 10

Determina la frecuencia en segundos con la que se realiza una prueba de disponibilidad. El valor mínimo es 1.
cassandra.readinessProbe.successThreshold Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 1

Los resultados consecutivos mínimos necesarios para que una prueba de disponibilidad se considere exitoso después de un error. El valor mínimo es 1.
cassandra.readinessProbe.timeoutSeconds Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 5

La cantidad de segundos después de que se agota el tiempo de espera de un sondeo en funcionamiento. El valor mínimo es 1.
cassandra.replicaCount Básico Presentado en la versión: 1.0.0

Valor predeterminado: 1

Cassandra es una base de datos replicada. Esta propiedad especifica la cantidad de nodos de Cassandra usados como StatefulSet.
cassandra.resources.requests.cpu Avanzado Presentado 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 milicores.
cassandra.resources.requests.memory Avanzado Presentado 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 Presentado en la versión: 1.0.0

Valor predeterminado: GCP

El nombre de un proveedor de restablecimiento. Valores admitidos: GCP, HYBRID y CSI. Establece el valor como:

  • GCP para restablecer datos de una copia de seguridad almacenada en Google Cloud Storage.
  • HYBRID para restablecer datos de una copia de seguridad almacenada en un servidor SSH remoto.
  • CSI (recomendado) para usar las instantáneas de volumen de CSI de Kubernetes para el restablecimiento. Para obtener información sobre las copias de seguridad y el restablecimiento de CSI en plataformas en la nube, como Google Cloud, AWS y Azure, consulta Copias de seguridad y restablecimiento de CSI.
cassandra.restore.dbStorageBucket Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

Obligatorio si el restablecimiento está habilitado y cassandra.restore.cloudProvider se configura como GCP.

Debe tener el formato gs://BUCKET_NAME (se requiere el prefijo gs://).

El nombre de un bucket de Google Cloud Storage que almacena archivos de copia de seguridad para usar en el restablecimiento de los datos.
cassandra.restore.enabled Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: false

El restablecimiento de datos no está habilitado de forma predeterminada. Para habilitarla, configúrala como true.

Consulta Copia de seguridad y recuperación de Cassandra.
cassandra.restore.image.pullPolicy Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: IfNotPresent

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

  • IfNotPresent: No extraigas una imagen nueva si ya existe.
  • Always: Extrae la imagen siempre, sin importar si ya existe.

Para obtener más información, consulta Actualiza imágenes.
cassandra.restore.image.tag Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 1.12.4

La etiqueta de versión para la imagen de Docker de este servicio.
cassandra.restore.image.url Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

La ubicación de la imagen de Docker para este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.
cassandra.restore.serviceAccountPath Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

Ruta de acceso a un archivo de claves de la cuenta de servicio de Google que tenga el rol de 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 específico.

Si el restablecimiento está habilitado y cassandra.restore.cloudProvider se configura como GCP, se requiere una de las siguientes opciones para garantizar que Apigee Hybrid pueda acceder al bucket de Google Cloud Storage para descargar archivos de copia de seguridad para su restablecimiento:

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

Valor predeterminado: Ninguno

Es el nombre de un secreto de Kubernetes existente que almacena el contenido de un archivo de claves de la cuenta de servicio de Google que tiene el rol de 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 específico.

Si el restablecimiento está habilitado y cassandra.restore.cloudProvider se configura como GCP, se requiere una de las siguientes opciones para garantizar que Apigee Hybrid pueda acceder al bucket de Google Cloud Storage para descargar archivos de copia de seguridad para su restablecimiento:

cassandra.restore.snapshotTimestamp Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

Obligatorio si el restablecimiento está habilitado.

Marca de tiempo de la copia de seguridad que debe restablecerse.
cassandra.sslCertPath Básico Presentado en la versión: 1.2.0

Valor predeterminado: Ninguno

La ruta de acceso de tu sistema a un archivo de certificado TLS.
cassandra.sslKeyPath Básico Presentado en la versión: 1.2.0

Valor predeterminado: Ninguno

La ruta de tu sistema al archivo TLS de clave privada.
cassandra.sslRootCAPath Básico Presentado en la versión: 1.2.0

Valor predeterminado: Ninguno

La cadena de certificados de la CA (autoridad certificada) raíz.
cassandra.storage.capacity Básico Presentado en la versión: 1.0.0

Valor predeterminado: 10Gi

Obligatorio si se especifica storage.storageclass

Especifica el tamaño del disco requerido, en mebibytes (Mi) o gibibytes (Gi).
cassandra.storage.storageclass Básico Presentado en la versión: 1.0.0

Valor predeterminado: Ninguno

Especifica la clase de almacenamiento local que se usa.
cassandra.storage.storageSize Básico Presentado en la versión: 1.11.0

Valor predeterminado: 10Gi

Obligatorio si se especifica storage.storageclass

Especifica el tamaño del disco requerido, en mebibytes (Mi) o gibibytes (Gi).
cassandra.terminationGracePeriodSeconds Avanzado Presentado en la versión: 1.0.0

Valor predeterminado: 300

El tiempo entre una solicitud de eliminación de pod y el momento en que se elimina el pod, en segundos. Durante este período, se ejecutarán todos los hooks previos y cualquier proceso en ejecución debe finalizar de manera correcta.
cassandra.tolerations.effect Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: Ninguno

Se requiere para usar la función de Taints y tolerancias de Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
cassandra.tolerations.key Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: Ninguno

Se requiere para usar la función de Taints y tolerancias de Kubernetes.

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

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
cassandra.tolerations.operator Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: "Equal"

Se requiere para usar la función de Taints y tolerancias de Kubernetes.

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

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

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
cassandra.tolerations.tolerationSeconds Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: Ninguno

Lo usa la función de Taints y tolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo un Pod permanece vinculado a un nodo con errores o que no responde.

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
cassandra.tolerations.value Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: Ninguno

Lo usa la función de Taints y tolerancias de Kubernetes.

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

Consulta Taints y tolerancias: Conceptos para obtener más detalles.

certManager

Apigee usa cert-manager para la validación del certificado.

En la siguiente tabla, se describen los campos del objeto certManager.

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

Valor predeterminado: cert-manager

El espacio de nombres para cert-manager.

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

connectAgent

Apigee Connect permite que el plano de administración híbrido de Apigee se conecte de forma segura al servicio MART en el plano del entorno de ejecución sin necesidad de exponer el extremo de MART en Internet.

En la siguiente tabla, se describen los campos del objeto connectAgent.

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

Valor predeterminado: Ninguno

Mapa de par clave-valor opcional que se usa para anotar pods. Para obtener más información, consulta la sección Anotaciones personalizadas.
connectAgent.gsa Avanzado Presentado en la versión: 1.10.0

Valor predeterminado: Ninguno

Solo para Helm: la dirección de correo electrónico de la cuenta de servicio de Google IAM (GSA) para que connectAgent se asocie con la cuenta de servicio de Kubernetes correspondiente cuando se habilita Workload Identity en clústeres de GKE con los gráficos de Helm. Configura esto cuando hayas configurado gcp.workloadIdentity.enabled como true.

Las direcciones de correo electrónico 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 Habilita Workload Identity en GKE o Habilita la federación de identidades para cargas de trabajo en AKS y EKS.
connectAgent.logLevel Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: INFO

El nivel de los informes de registros. Los valores pueden ser:

  • INFO: Mensajes informativos además de mensajes de advertencia, de error y fatal. Es más útil para depurar.
  • WARNING: Advertencias recuperables, además de mensajes de error y fatales.
  • ERROR: errores internos y errores que no se muestran al usuario además de los mensajes fatales.
  • FATAL: errores y eventos irrecuperables que hacen que Apigee Connect falle.
connectAgent.image.pullPolicy Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: IfNotPresent

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

  • IfNotPresent: No extraigas una imagen nueva si ya existe.
  • Always: Extrae la imagen siempre, sin importar si ya existe.

Para obtener más información, consulta Actualiza imágenes.
connectAgent.image.tag Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: 1.12.4

La etiqueta de versión para la imagen de Docker de este servicio.
connectAgent.image.url Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: Ninguno

La ubicación de la imagen de Docker para este servicio.

Usa apigee-pull-push --list para ver la URL del repositorio actual de este componente.
connectAgent.replicaCountMax Básico Presentado en la versión: 1.2.0

Valor predeterminado: 5

Cantidad máxima de réplicas disponibles para el ajuste de escala automático.
connectAgent.replicaCountMin Básico Presentado en la versión: 1.2.0

Valor predeterminado: 1

Cantidad mínima de réplicas disponibles para el ajuste de escala automático.

En producción, es posible que desees aumentar replicaCountMin a 1 para tener una mayor cantidad de conexiones al plano de control de confiabilidad y escalabilidad.
connectAgent.resources.limits.cpu Avanzado Presentado en la versión: 1.11.0

Valor predeterminado: 512m

El límite de CPU del recurso en un contenedor de Kubernetes, en milicores.
connectAgent.resources.limits.memory Avanzado Presentado en la versión: 1.11.0

Valor predeterminado: 512Mi

El límite de memoria para el recurso en un contenedor de Kubernetes, en mebibytes.
connectAgent.resources.requests.cpu Avanzado Presentado 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 milicores.
connectAgent.resources.requests.memory Avanzado Presentado 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 Presentado en la versión: 1.2.0

Valor predeterminado: apigeeconnect.googleapis.com:443

La ubicación del servidor y el puerto para este servicio.
connectAgent.serviceAccountPath Básico Presentado en la versión: 1.1.1

Valor predeterminado: Ninguno

Se requiere serviceAccountPath o serviceAccountRef.

Ruta de acceso al archivo de claves de la cuenta de servicio de Google para 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 Presentado en la versión: 1.2.0

Valor predeterminado: Ninguno

Se requiere 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 Presentado en la versión: 1.2.0

Valor predeterminado: 75

Uso de CPU objetivo para el agente de conexión de Apigee Connect en el pod. El valor de este campo permite a Apigee Connect conectarse con el ajuste de escala automático cuando el uso de CPU alcanza este valor, hasta replicaCountMax.
connectAgent.terminationGracePeriodSeconds Avanzado Presentado en la versión: 1.2.0

Valor predeterminado: 600

El tiempo entre una solicitud de eliminación de pod y el momento en que se elimina el pod, en segundos. Durante este período, se ejecutarán todos los hooks previos y cualquier proceso en ejecución debe finalizar de manera correcta.
connectAgent.tolerations.effect Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: Ninguno

Se requiere para usar la función de Taints y tolerancias de Kubernetes.

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

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
connectAgent.tolerations.key Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: Ninguno

Se requiere para usar la función de Taints y tolerancias de Kubernetes.

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

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
connectAgent.tolerations.operator Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: "Equal"

Se requiere para usar la función de Taints y tolerancias de Kubernetes.

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

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

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
connectAgent.tolerations.tolerationSeconds Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: Ninguno

Lo usa la función de Taints y tolerancias de Kubernetes.

tolerationSeconds define en segundos cuánto tiempo un Pod permanece vinculado a un nodo con errores o que no responde.

Consulta Taints y tolerancias: Conceptos para obtener más detalles.
connectAgent.tolerations.value Avanzado Presentado en la versión: 1.10.1

Valor predeterminado: Ninguno

Lo usa la función de Taints y tolerancias de Kubernetes.

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

Consulta Taints y tolerancias: Conceptos para obtener más detalles.

defaults

Las claves de encriptación predeterminadas para la instalación híbrida de Apigee.

En la siguiente tabla, se describen los campos del objeto defaults.

Propiedad Tipo Descripción
defaults.org.kmsEncryptionKey Básico Presentado en la versión: 1.0.0

Valor predeterminado: aWxvdmVhcGlzMTIzNDU2Nw==

Clave de encriptación predeterminada para la organización en KMS.

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

Valor predeterminado: aWxvdmVhcGlzMTIzNDU2Nw==

Clave de encriptación predeterminada para la organización en KVM.

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

Valor predeterminado: aWxvdmVhcGlzMTIzNDU2Nw==

Clave de encriptación predeterminada para el entorno (env) en KMS.

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

Valor predeterminado: aWxvdmVhcGlzMTIzNDU2Nw==

Clave de encriptación predeterminada para el entorno (env) en KVM.

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

Valor predeterminado: aWxvdmVhcGlzMTIzNDU2Nw==

La clave de encriptación de caché predeterminada para el entorno (env).

diagnostic

La configuración para la herramienta de recopilación de diagnóstico.

Consulta Usa el colector de diagnóstico

En la siguiente tabla, se describen los campos del objeto diagnostic.

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

Valor predeterminado: Ninguno

Obligatorio

El nombre del bucket de Google Cloud Storage en el que se depositarán tus datos de diagnóstico.

Consulta Crea buckets de almacenamiento.
diagnostic.container Básico Presentado en la versión: 1.6.0

Valor predeterminado: Ninguno

Obligatorio

Esto especifica desde qué tipo de Pod estás capturando datos. Los valores pueden ser uno de los siguientes:

  • "apigee-cassandra" captura los datos sobre el conjunto de datos de Cassandra. Los pods istio-cassandra se ejecutan en el espacio de nombres de Apigee.
  • "apigee-mart-server" captura datos sobre MART. Los pods apigee-mart-server se ejecutan en el espacio de nombres de Apigee.
  • "apigee-runtime" captura datos sobre el procesador de mensajes. Los pods del entorno de ejecución de Apigee se ejecutan en el espacio de nombres de Apigee.
  • "apigee-synchronizer" captura los datos sobre el sincronizador. Los pods de apigee-synchronizer se ejecutan en el espacio de nombres de apigee.
  • "apigee-udca" captura los datos sobre el UDCA. Los pods apigee-udca se ejecutan en el espacio de nombres de Apigee.
  • "apigee-watcher" captura datos sobre el agente de observación. Los pods de apigee-watcher se ejecutan en el espacio de nombres de Apigee.
  • "istio-proxy" captura los datos sobre la puerta de enlace de entrada de Istio. Los pods istio-proxy se ejecutan en el espacio de nombres istio-system.
diagnostic.loggingDetails.logDuration Básico Presentado en la versión: 1.6.0

Valor predeterminado: Ninguno

Obligatorio si la operación de recopilación de diagnóstico es "LOGGING" (configurada con operation: "LOGGING")

La duración en milisegundos de los datos de registro recopilados. Un valor típico es 30000.

Consulta diagnostic.operation

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

Valor predeterminado: Ninguno

Obligatorio si la operación de recopilación de diagnóstico es "LOGGING" (configurada con operation: "LOGGING")

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

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

Valor predeterminado: Ninguno

Obligatorio si la operación de recopilación de diagnóstico es "LOGGING" (configurada con operation: "LOGGING")

Especifica el nivel de detalle de los datos de registro que se recopilarán. En Apigee Hybrid 1.6, solo se admite FINE.
diagnostic.namespace Básico Presentado en la versión: 1.6.0

Valor predeterminado: Ninguno

Obligatorio

El espacio de nombres de Kubernetes en el que residen los pods en los que recopilas datos. El espacio de nombres debe ser el correcto para el contenedor que especificas 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 Presentado en la versión: 1.6.0

Valor predeterminado: Ninguno

Obligatorio

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

Estos son los valores:
diagnostic.podNames[] Básico Presentado en la versión: 1.6.0

Valor predeterminado: Ninguno

Obligatorio

Los nombres de los pods de Kubernetes para los que recopilas 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 Presentado en la versión: 1.6.0

Valor predeterminado: Ninguno

Obligatorio

La ruta a un archivo de claves de la cuenta de servicio (.json) para la cuenta de servicio con el rol de administrador de almacenamiento (roles/storage.admin). En la mayoría de las instalaciones híbridas de Apigee, esta es la cuenta de servicio apigee-cassandra.

Consulta Acerca de las cuentas de servicio.
diagnostic.tcpDumpDetails.maxMsgs Básico Presentado en la versión: 1.6.0

Valor predeterminado: Ninguno

Uno de cualquiera de diagnostic.tcpDumpDetails.maxMsgs o diagnostic.tcpDumpDetails.timeoutInSeconds es Obligatorio si usasdiagnostic.tcpDumpDetails.

Establece la cantidad máxima de mensajes tcpDump que se recopilarán. Apigee recomienda un valor máximo no mayor que 1000.
diagnostic.tcpDumpDetails.timeoutInSeconds Básico Presentado en la versión: 1.6.0

Valor predeterminado: Ninguno

Uno de cualquiera de diagnostic.tcpDumpDetails.maxMsgs o diagnostic.tcpDumpDetails.timeoutInSeconds es Obligatorio si usasdiagnostic.tcpDumpDetails.

Establece la cantidad de tiempo en segundos que se espera para que tcpDump muestre los mensajes.
diagnostic.threadDumpDetails.delayInSeconds Básico Presentado en la versión: 1.6.0

Valor predeterminado: Ninguno