Variables de entorno de Cloud Manager

Las variables de entorno estándar se pueden configurar y administrar mediante Cloud Manager. Se proporcionan al entorno del tiempo de ejecución y se pueden utilizar en configuraciones OSGi. Las variables de entorno pueden ser valores específicos del entorno o secretos del entorno, según lo que se vaya a cambiar.

Información general

Las variables de entorno ofrecen una serie de ventajas a los usuarios de AEM as a Cloud Service:

  • Permiten que el comportamiento del código y de la aplicación varíe según el contexto y el entorno. Por ejemplo, se pueden utilizar para habilitar distintas configuraciones en el entorno de desarrollo en comparación con los entornos de producción o ensayo para evitar errores costosos.
  • Solo deben configurarse una vez, y pueden actualizarse y eliminarse cuando sea necesario.
  • Sus valores se pueden actualizar en cualquier momento y entrar en vigor inmediatamente sin necesidad de realizar cambios o implementaciones de código.
  • Pueden separar el código de la configuración y eliminar la necesidad de incluir información confidencial en el control de versiones.
  • Mejoran la seguridad de la aplicación de AEM as a Cloud Service ya que viven fuera del código.

Los casos de uso habituales para usar variables de entorno incluyen:

  • Conexión de la aplicación de AEM con diferentes extremos externos
  • Uso de una referencia al almacenar contraseñas en lugar de directamente en la base de código
  • Cuando existen varios entornos de desarrollo en un programa y algunas configuraciones difieren de un entorno a otro

Agregar variables de entorno

NOTA

Debe ser miembro del rol de Administrador de implementación para agregar o modificar variables de entorno.

  1. Inicie sesión en Adobe Cloud Manager en my.cloudmanager.adobe.com.

  2. Cloud Manager enumera los distintos programas disponibles. Seleccione el que desee administrar.

  3. Seleccione la pestaña Entornos para el programa elegido, seleccione el entorno para el que desea crear una variable de entorno en el panel de navegación izquierdo.

  4. En los detalles del entorno, seleccione la pestaña Configuración y a continuación, seleccione Agregar para abrir el cuadro de diálogo Configuración del entorno.

    • Si agrega una variable de entorno por primera vez, verá el botón Agregar configuración en el centro de la página. Puede utilizar este botón o Agregar para abrir el cuadro de diálogo Configuración del entorno.

    Pestaña Configuración

  5. Introduzca los detalles de la variable.

    • Nombre
    • Valor
    • Servicio aplicado: Define para qué servicio (autor/publicación/vista previa) se aplica la variable o si se aplica a todos los servicios
    • Tipo: Define si la variable es una variable normal o un secreto

    Agregar una variable

  6. Después de introducir la nueva variable, debe seleccionar Agregar en la última columna de la fila que contiene la nueva variable.

    • Puede introducir varias variables a la vez al introducir una línea nueva y seleccionar Agregar.

    Guardar variables

  7. Seleccione Guardar para mantener las variables.

Un indicador con el estado Actualizando se muestra en la parte superior de la tabla y junto a la variable recién agregada para indicar que el entorno se está actualizando con la configuración. Una vez completada, la nueva variable de entorno se podrá ver en la tabla.

Actualizar variables

SUGERENCIA

Si desea agregar varias variables, se recomienda agregar la primera variable y luego usar el botón Agregar del cuadro de diálogo Configuración del entorno para agregar las variables adicionales. De este modo, puede agregarlas con una actualización al entorno.

Actualizar variables de entorno

Una vez creadas las variables de entorno, puede actualizarlas con el botón Agregar/actualizar para iniciar el cuadro de diálogo Configuración del entorno.

  1. Inicie sesión en Adobe Cloud Manager en my.cloudmanager.adobe.com.

  2. Cloud Manager enumera los distintos programas disponibles. Seleccione el que desee administrar.

  3. Seleccione la pestaña Entornos para el programa elegido, seleccione el entorno para el que desea crear una variable de entorno en el panel de navegación izquierdo.

  4. En los detalles del entorno, seleccione la pestaña Configuración a continuación, seleccione Agregar/actualizar en la parte superior derecha para abrir el cuadro de diálogo Configuración del entorno.

    Botón Agregar/actualizar para variables

  5. Con el botón de los tres puntos de la última columna de la fila de la variable que desea modificar, seleccione Editar o Eliminar.

    Variable Editar o eliminar

  6. Edite la variable de entorno según sea necesario.

    • Al editar, el botón de los tres puntos cambia a Opciones para volver al valor original o confirmar el cambio.
    • Al editar secretos, los valores solo se pueden actualizar, no ver.

    Editar variable

  7. Una vez que haya realizado todos los cambios de configuración necesarios, seleccione Guardar.

Al igual que cuando se agregan variables, se muestra un indicador con el estado Actualizando en la parte superior de la tabla y junto a las variables recién actualizadas para indicar que el entorno se está actualizando con la configuración. Una vez finalizada, las variables de entorno actualizadas se podrán ver en la tabla.

SUGERENCIA

Si desea actualizar varias variables, se recomienda usar el cuadro de diálogo Configuración del entorno para actualizar todas las variables necesarias a la vez antes de pulsar o hacer clic en Guardar. De este modo, puede agregarlas con una actualización al entorno.

Utilizar variables de entorno

Las variables de entorno pueden hacer que las pom.xml configuraciones sean más seguras y flexibles. Por ejemplo, las contraseñas no tienen que estar codificadas y la configuración se puede adaptar según los valores de las variables de entorno.

Puede acceder a las variables y los secretos de entorno a través de XML de la siguiente manera.

  • ${env.VARIABLE_NAME}

Consulte el documento Configurar un proyecto para ver un ejemplo de cómo utilizar ambos tipos de variables en un pom.xml archivo.

Consulte la documentación oficial de Maven para obtener más información.

En esta página