Variables de entorno en 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.
Acerca de las variables de entorno overview
Las variables de entorno ofrecen una serie de ventajas a los usuarios de AEM as a Cloud Service, como las siguientes:
- 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 diferentes 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 son los siguientes:
- 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 una variable de entorno add-variables
Si desea agregar varias variables, Adobe recomienda que agregue la primera variable y, a continuación, use
Para agregar, actualizar o eliminar variables de entorno, debe ser miembro del rol Administrador de implementación.
Para agregar una variable de entorno:
-
Inicie sesión en Cloud Manager en my.cloudmanager.adobe.com y seleccione la organización adecuada.
-
En la consola Mis programas, seleccione el que desee administrar.
-
En el menú lateral, haga clic en Entornos.
-
En la página Entornos, seleccione una fila de la tabla que tenga el entorno para el que desea agregar una variable de entorno.
-
En la página de detalles del entorno, haga clic en la ficha Configuración.
-
Haga clic en
Si agrega una variable de entorno por primera vez, haga clic en Agregar configuración en el centro de la página.
-
En el cuadro de diálogo Configuración del entorno, escriba los detalles en la primera fila de la tabla.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Campo Descripción Nombre Un nombre único de la variable de configuración. Identifica la variable específica que se utiliza en el entorno. Debe cumplir las siguientes convenciones de nomenclatura:
- Las variables solo pueden contener caracteres alfanuméricos y el guion bajo (
_). - Hay un límite de 200 variables por entorno.
- Cada nombre debe tener 100 caracteres o menos.
Valor El valor que contiene la variable. Paso aplicado Seleccione el servicio al que se aplica la variable. Seleccione Todos para que la variable se aplique a todos los servicios.
- Todos
- Autor
- Publish
- Previsualizar
Tipo Seleccione si la variable es normal o un secreto. 
- Las variables solo pueden contener caracteres alfanuméricos y el guion bajo (
-
Haga clic en
Añada variables adicionales según sea necesario.
-
Haga clic en Guardar.
Se muestra un control de número con el estado Actualizando en la esquina superior derecha de la tabla. También aparecerá un control de número a la izquierda de las variables recién agregadas. Estos estados indican que el entorno se está actualizando con la configuración. Una vez finalizada, la nueva variable de entorno se puede ver en la tabla.
Actualización de una variable de entorno update-variables
Una vez que haya creado variables de entorno, puede actualizarlas con
Si desea actualizar varias variables, el Adobe recomienda que utilice el cuadro de diálogo Configuración del entorno para actualizar todas las variables necesarias a la vez antes de hacer clic en Guardar. De este modo, puede agregarlas con una actualización al entorno.
Para actualizar una variable de entorno:
-
Inicie sesión en Cloud Manager en my.cloudmanager.adobe.com y seleccione la organización adecuada.
-
En la consola Mis programas, seleccione el que desee administrar.
-
En el menú lateral, haga clic en Entornos.
-
En la página Entornos, seleccione una fila de la tabla que tenga el entorno para el que desea actualizar una variable.
-
En la página de detalles del entorno, haga clic en la ficha Configuración.
-
Haga clic en
-
En el cuadro de diálogo Configuración del entorno, haga clic en
-
En el menú desplegable, haga clic en Editar.
-
Actualice el valor de la variable de entorno según sea necesario.
Al editar un secreto, el valor solo se puede actualizar, no ver.
-
Realice una de las siguientes acciones:
- Haga clic en
- Haga clic en
- Haga clic en
-
Haga clic en Guardar.
Se muestra un control de número con el estado Actualizando en la esquina superior derecha de la tabla. También aparece un control de número a la izquierda de las variables actualizadas. Estos estados indican que el entorno se está actualizando con la configuración. Una vez finalizada, la variable de entorno actualizada se puede ver en la tabla.
Eliminar una variable de entorno delete-env-variable
- Inicie sesión en Cloud Manager en my.cloudmanager.adobe.com y seleccione la organización adecuada.
- En la consola Mis programas, seleccione el que desee administrar.
- En el menú lateral, haga clic en Entornos.
- En la página Entornos, seleccione una fila de la tabla que tenga el entorno para el que desea actualizar una variable.
- En la página de detalles del entorno, haga clic en la ficha Configuración.
- Haga clic en
- En el cuadro de diálogo Configuración del entorno, haga clic en
- En el menú desplegable, haga clic en Eliminar para quitar la variable inmediatamente.
- Haga clic en Guardar.
Uso de 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 mediante XML de la siguiente manera:
${env.VARIABLE_NAME}
Vea Configurar el proyecto para ver un ejemplo de cómo usar ambos tipos de variables en un archivo pom.xml.
Consulte también 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 de la siguiente manera:
Solo se pueden usar variables de entorno normales con Dispatcher.
- Los secretos no se pueden usar.
- No se pueden usar variables de entorno en directivas
IfDefine. - Debe validar el uso de variables de entorno con Dispatcher localmente antes de la implementación.