Variables de entorno de Cloud Manager environment-variables

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 overview

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 add-variables

NOTE
Tiene que estar abonado a la función de Administrador de implementación para agregar o modificar las variables de entorno.
  1. Inicie sesión en Adobe Cloud Manager en my.cloudmanager.adobe.com.

  2. En el Mis programas , 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, puede ver un 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 finalizada, la nueva variable de entorno se puede ver en la tabla.

Actualizar variables

TIP
Si desea agregar varias variables, se recomienda agregar la primera variable y luego usar el Añadir botón en el Configuración del entorno para añadir las variables adicionales. De este modo, puede agregarlas con una actualización al entorno.

Actualizar variables de entorno update-variables

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. Después de realizar 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 finalizadas, las variables de entorno actualizadas se pueden ver en la tabla.

TIP
Si desea actualizar varias variables, se recomienda utilizar la variable 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 using

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.

Disponibilidad de variables de entorno availability

Las variables de entorno se pueden utilizar en varios lugares.

Creación, previsualización y publicación author-preview-publish

Tanto las variables de entorno normales como los secretos se pueden usar en los entornos de creación, previsualización y publicación.

Dispatcher dispatcher

Con Dispatcher solo se pueden usar variables de entorno normales. Los secretos no se pueden usar.

Sin embargo, las variables de entorno no se pueden usar en IfDefine directivas.

TIP
Debe validar el uso de variables de entorno con Dispatcher localmente antes de la implementación.

Configuraciones de OSGi osgi

Tanto las variables de entorno normales como los secretos se pueden utilizar en las configuraciones OSGi.

Variables de canalización pipeline

Además de las variables de entorno, también hay variables de canalización que se exponen durante la fase de compilación. Obtenga más información acerca de las variables de canalización aquí.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab