Gestionar componentes del plano del entorno de ejecución

En este tema se explica cómo configurar y gestionar los componentes del plano de tiempo de ejecución de Apigee hybrid. Para ver una lista de los componentes del plano de tiempo de ejecución que puedes configurar, consulta Información general sobre la configuración del servicio del entorno de ejecución.

Acerca del archivo de anulaciones

La primera vez que instales el entorno de ejecución híbrido en un clúster, debes crear un archivo de anulaciones de configuración. Este archivo le permite anular los valores de configuración predeterminados según sea necesario, configurar entornos, hacer referencia a certificados TLS y claves de cuentas de servicio, asignar grupos de nodos de Kubernetes a componentes híbridos específicos, etc.

En los pasos de instalación de la versión híbrida se explica cómo crear un archivo de anulaciones y aplicar la configuración a un clúster. Si quieres cambiar la configuración más adelante, modifica el archivo de anulaciones que has creado y vuelve a aplicarlo.

Hacer un cambio de configuración

Para cambiar la configuración de un componente del plano de tiempo de ejecución híbrido, edita el archivo de anulaciones y aplica los cambios con apigeectl.

Por ejemplo, para cambiar el número de réplicas del procesador de mensajes, sigue estos pasos:

1. Abre el archivo YAML de sustituciones. Asegúrate de usar el mismo archivo de anulaciones que se usó para instalar el tiempo de ejecución híbrido en el clúster.
2. Busca el elemento runtime en el archivo. Por ejemplo:

   ...
   runtime:
     nodeSelector:
       key: cloud.google.com/gke-nodepool
       value: apigee-runtime
     replicaCountMin: 1
     replicaCountMax: 2
   ...

3. Cambia las propiedades de recuento de réplicas según sea necesario. Por ejemplo:

   ...
   runtime:
     nodeSelector:
       key: cloud.google.com/gke-nodepool
       value: apigee-runtime
     replicaCountMin: 2
     replicaCountMax: 4
   ...

4. Usa apigeectl para aplicar el cambio al clúster:

   apigeectl apply -f ./my_overrides.yaml -c runtime

   .

¿Qué propiedades de configuración puede modificar?

Puede consultar la lista completa de propiedades configurables en la referencia de propiedades de configuración. En la referencia solo se indican las propiedades que puede modificar. Si intenta modificar una propiedad que no aparece en la referencia, el cambio se ignorará.

Cómo usar la referencia de configuración

La referencia de la propiedad de configuración usa la notación de puntos para describir los elementos de configuración. El primer elemento es el nombre del elemento de nivel superior, seguido de las propiedades y las propiedades secundarias. Por ejemplo:

authz.image.pullPolicy

En el archivo de anulaciones, las propiedades tienen el formato YAML adecuado. En el ejemplo anterior, el elemento authz de nivel superior tiene una sangría a la izquierda y las propiedades de los subelementos tienen una sangría debajo. Además, YAML requiere dos puntos al final de cada elemento y subelemento.

Por ejemplo, para asignar el valor Always a la propiedad authz.image.pullPolicy, busca esta estrofa YAML en el archivo de anulaciones y asígnale el valor:

authz:
  image:
    pullPolicy: Always

Otro ejemplo es la propiedad cassandra.auth.admin.password (tal como se indica en la referencia de la propiedad de configuración), que se usa para definir la contraseña de administrador de Cassandra. Para cambiarlo, busca el siguiente YAML en el archivo de anulaciones y configúralo:

cassandra:
  auth:
    admin:
      password: abc123

Recuerda que en la referencia de la propiedad de configuración se describen todas las propiedades que puedes definir en los componentes del plano de tiempo de ejecución híbrido. Sigue el patrón explicado anteriormente para modificar estos elementos en tu archivo de anulaciones antes de aplicar los cambios al clúster.

Usar archivos de anulaciones de ejemplo predefinidos

Cuando instales el tiempo de ejecución híbrido por primera vez, Apigee te recomienda que uses uno de los archivos de anulaciones de ejemplo preconfigurados. Estos ejemplos proporcionan un conjunto completo de propiedades de configuración para casos de instalación específicos, como la configuración de una instalación de producción o de prueba. Solo tienes que proporcionar los valores adecuados para las propiedades y aplicar el archivo de anulaciones a tu clúster. Para obtener más información, consulta el artículo Crear un archivo de anulaciones.

Acerca de los valores predeterminados de configuración

Apigee mantiene la configuración predeterminada de sus componentes en el archivo hybrid_root_dir/config/values.yaml. Los archivos de anulaciones siguen la misma estructura YAML que values.yaml.

Un archivo de anulaciones suele incluir solo un subconjunto de las propiedades de configuración que se encuentran en values.yaml. Recuerda que no todas las propiedades se pueden editar. Cuando aplicas una configuración a un clúster, tus anulaciones se combinan con los valores predeterminados para crear la configuración completa del clúster de Kubernetes. Consulta también Salida de la configuración combinada.

El siguiente código muestra la configuración predeterminada del componente mart tal como se encuentra en values.yaml. Tenga en cuenta que algunos valores tienen valores predeterminados, mientras que otros, como sslCertPath y sslKeyPath, no. Debes proporcionar estos valores que faltan en el archivo de anulaciones, tal como se explica en los pasos de instalación. Si quieres cambiar alguno de los valores predeterminados, comprueba que se puedan editar en la referencia de la propiedad de configuración.

...
mart:
  replicaCountMin: 2
  replicaCountMax: 4
  targetCPUUtilizationPercentage: 75
  terminationGracePeriodSeconds: 30
  sslCertPath:
  sslKeyPath:
  hostAlias:
  nodeSelector:
    key:
    value:
  revision: blue
  image:
    url: "google/apigee-mart-server"
    tag: "1.0.0"
    pullPolicy: IfNotPresent
  resources:
    requests:
      cpu: 500m
      memory: 512Mi
  initCheckCF:
    resources:
      requests:
        cpu: 10m
  livenessProbe:
    timeoutSeconds: 1
    failureThreshold: 12
    periodSeconds: 5
    initialDelaySeconds: 15
  readinessProbe:
    timeoutSeconds: 1
    successThreshold: 1
    failureThreshold: 2
    periodSeconds: 5
    initialDelaySeconds: 15
  metricsURL: "/v1/server/metrics"
  cwcAppend: |
...

Si quieres modificar los valores predeterminados de un componente y este aún no está en tu archivo de anulaciones, puedes copiar su YAML de values.yaml en tu archivo de anulaciones y modificarlo ahí.

Archivos de anulaciones de ejemplo

Apigee proporciona un conjunto de archivos de anulaciones de ejemplo para ayudarte a configurar tu implementación híbrida. Te recomendamos que copies y modifiques el archivo de anulaciones que mejor se adapte a los requisitos de tu instalación.

Los siguientes ejemplos se incluyen en el directorio hybrid_root_dir/examples:

Generar la configuración combinada

Por ejemplo:

apigeectl apply -f ./my_overrides.yaml --dry-run --print-yaml > apigee-hybrid.yaml

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

Crear varios archivos de anulaciones según sea necesario

Puedes crear tantos archivos de anulaciones como quieras, donde cada uno cumpla un requisito específico. Por ejemplo, puede tener un archivo de anulaciones que ajuste su clúster para la producción y otro para crear un clúster de pruebas. Después, puedes mantener estos archivos en tu sistema de control de versiones.

Usa la opción -f con apigeectl para especificar la ubicación y el nombre de un archivo de anulaciones. Por ejemplo:

apigeectl apply  -f ./test_env_override.yaml

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

Eliminar componentes del plano del entorno de ejecución específicos de la configuración híbrida

Para eliminar los componentes del plano de tiempo de ejecución específicos de la versión híbrida de tu clúster, usa el comando apigeectl delete. Entre estos componentes se incluyen el sincronizador, el mart, el tiempo de ejecución, Cassandra y udca. Asegúrate de especificar el mismo archivo de anulaciones que usaste para instalar los componentes del entorno de ejecución:

Por ejemplo:

apigeectl delete -f ./my_overrides.yaml

Puedes usar el comando apigeectl apply para volver a crear un componente o varios componentes específicos:

apigeectl apply -c synchronizer -f ./my_overrides.yaml

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

Eliminar un componente específico

Si solo quieres eliminar un componente específico, usa la opción -c con apigeectl delete. Asegúrate de especificar el mismo archivo de anulaciones que usaste para instalar los componentes del tiempo de ejecución.

Por ejemplo, para eliminar el componente Synchronizer, usa este comando:

apigeectl delete -c synchronizer -f ./my_overrides.yaml

A continuación, puedes usar el comando apigeectl apply para volver a crear el componente:

apigeectl apply -c synchronizer -f ./my_overrides.yaml

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

Eliminar todos los componentes

Para eliminar todos los componentes híbridos de tu clúster, incluidos los creados con el comando apigeectl init, usa el comando apigeectl delete con la marca --all. Asegúrate de especificar el mismo archivo de anulaciones que usaste para instalar los componentes del entorno de ejecución:

Por ejemplo:

apigeectl delete -f ./my_overrides.yaml --all

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