Todos los productos
Search
Centro de documentos

Enterprise Distributed Application Service:Configuración de variables de entorno

Última actualización: Sep 03, 2026

Las variables de entorno separan la configuración del código de la aplicación, lo que permite personalizar el comportamiento en tiempo de ejecución según el entorno sin necesidad de volver a desplegar. También mantienen los datos confidenciales, como las credenciales de bases de datos y las claves de API, fuera del código fuente.

Contexto

EDAS admite tres tipos de variables de entorno para aplicaciones desplegadas en clústeres de Kubernetes:

Tipo

Descripción

Caso de uso

Personalizada

Pares clave-valor definidos directamente

Configuraciones específicas de la aplicación, como JAVA_HOME, APP_PORT

ConfigMap

Referencias a entradas de ConfigMap de Kubernetes

Configuración compartida y no confidencial entre varias aplicaciones

Secret

Referencias a entradas de Secret de Kubernetes

Contraseñas, certificados, claves de API

Los ConfigMaps y Secrets deben estar en la misma región, clúster y namespace de Kubernetes que la aplicación que los referencia.

Nota

Para crear un ConfigMap, consulte Create a configuration item. Para crear un Secret, consulte Create a Secret.

Requisitos previos

Antes de empezar, asegúrese de contar con lo siguiente:

  • Una cuenta de EDAS con acceso a la consola de EDAS

  • Un clúster de Kubernetes creado en EDAS

  • (Opcional) Un ConfigMap o Secret en la misma región, clúster y namespace de Kubernetes que su aplicación

Agregar variables de entorno

Es posible configurar variables de entorno al crear una aplicación o al desplegar una existente. En ambos casos, las variables se pasan al contenedor durante el inicio.

Importante

Guardar cambios en las variables de entorno reinicia la aplicación. Configure las variables de entorno fuera del horario pico para minimizar el impacto.

Agregar variables durante la creación de la aplicación

  1. Inicie sesión en la consola de EDAS.

  2. En el panel de navegación izquierdo, seleccione Application Management > Applications.

  3. En la barra de navegación superior, seleccione una región. En la parte superior de la página, seleccione un namespace.

  4. En la esquina superior izquierda, haga clic en Create Application.

  5. En el paso Basic Information, establezca Cluster Type en Kubernetes Clusters y seleccione su Application Runtime Environment (consulte Opciones de entorno de ejecución de la aplicación), luego haga clic en Next.

  6. En el paso Configurations, configure la información del entorno, la información básica, el método de despliegue y los parámetros de recursos, luego haga clic en Next.

  7. En el paso Advanced Settings, haga clic en Environment Variables y agregue variables mediante cualquiera de los métodos descritos en Métodos de configuración de variables.

  8. Haga clic en Create Application.

  9. En la página Creation Completed, revise la configuración en Basic Information, Configurations y Advanced Settings, luego haga clic en Create Application.

  10. En la página Application Overview, haga clic en View Details. En la página Change List, supervise el progreso del despliegue. Una vez completado el cambio, compruebe que el estado del pod en la sección Basic Information muestre que el pod está en ejecución.

Agregar variables durante el despliegue de la aplicación

Si no configuró variables de entorno durante la creación de la aplicación, agréguelas al desplegar o volver a desplegar la aplicación.

  1. Inicie sesión en la consola de EDAS.

  2. En el panel de navegación izquierdo, seleccione Application Management > Applications.

  3. En la barra de navegación superior, seleccione una región. En la parte superior de la página, seleccione un namespace.

  4. En la lista desplegable Cluster Type, seleccione Container Service or Serverless Kubernetes Cluster.

  5. Busque la aplicación objetivo y haga clic en su nombre.

  6. En la página Overview o Basic information, seleccione Deploy > Deploy en la esquina superior derecha.

  7. En la página Select Deployment Mode, seleccione un modo de despliegue y haga clic en Start Deployment.

  8. Configure el entorno de ejecución y el paquete de despliegue, luego haga clic en Environment Variables para agregar variables mediante cualquiera de los métodos descritos en Métodos de configuración de variables.

  9. Haga clic en OK.

Métodos de configuración de variables

Puede agregar variables de forma individual o masiva.

Agregar una sola variable

Elija uno de los siguientes métodos según el tipo de variable:

Variable personalizada

Introduzca directamente un nombre y un valor para la variable.

Custom - Environment variable 1

Nota

Para configurar la memoria heap de JVM, las propiedades de JVM o los parámetros del agente de Java, establezca lo siguiente:

  • Nombre de la variable: CATALINA_OPTS

  • Valor de la variable: [Parámetro a agregar] $(EDAS_CATALINA_OPTS)

Variables de entorno comunes para imágenes de MySQL:

Variable

Obligatorio

Descripción

MYSQL_ROOT_PASSWORD

Sí

Establece la contraseña root de MySQL

MYSQL_USER y MYSQL_PASSWORD

No

Crea una cuenta de usuario adicional con contraseña

MYSQL_DATABASE

No

Especifica una base de datos para crear al iniciar el contenedor

Para otros tipos de imagen, configure las variables de entorno según la documentación de la imagen.

Referencia a ConfigMap

Seleccione un ConfigMap de la lista desplegable Variable Value/Variable Reference y luego seleccione un par clave-valor del ConfigMap.

Referencia a Secret

Seleccione un Secret de la lista desplegable Variable Value/Variable Reference y luego seleccione un par clave-valor del Secret.

Agregar varias variables de forma masiva

Para inyectar variables de entorno de forma masiva desde un ConfigMap o Secret, configure los siguientes parámetros:

Parámetro

Descripción

Type

Seleccione Configuration Items (ConfigMap) o Secret. Las variables personalizadas no son compatibles con el modo masivo.

Configuration Mode

env: Seleccione pares clave-valor específicos del ConfigMap o Secret. envFrom: Inyecte todos los pares clave-valor del ConfigMap o Secret.

Configuration Items

Seleccione un ConfigMap de la lista desplegable.

Reference Environment Variable

Seleccione los pares clave-valor a inyectar (disponible solo en el modo env).

Nota

Puede agregar un máximo de 100 variables de entorno a la vez. Después de agregar las variables, establezca los nombres según sus necesidades.

Verificar el resultado

Confirme que las variables de entorno están activas mediante cualquiera de los siguientes métodos:

  • Registros de cambios: En el panel de navegación izquierdo de la página de detalles de la aplicación, haga clic en Change Records. Si la columna Change Status muestra Success, la configuración está vigente.

  • Estado del pod: En la página Application Overview, haga clic en Running Pods (Click View) junto a Running Status. En la sección Pod, revise la columna Status. Un punto verde indica que la aplicación se ejecuta con la configuración actualizada.

Opciones de entorno de ejecución de la aplicación

Seleccione el entorno de ejecución que corresponda a su tipo de aplicación:

Entorno de ejecución

Descripción

Java > Custom

Despliegue mediante una imagen personalizada en un clúster de Kubernetes

Java > Java

Despliegue una aplicación Dubbo o Spring Boot mediante un paquete JAR. Configurable: Java Environment.

Java > Tomcat

Despliegue una aplicación Dubbo o Spring mediante un paquete WAR. Configurable: Java Environment, Container Version.

Java > EDAS-Container (HSF)

Despliegue una aplicación HSF mediante un paquete WAR o FatJar. Configurable: Java Environment, Pandora Version, Ali-Tomcat Version.

PHP

Despliegue una aplicación PHP que se ejecute en Apache HTTP Server

Node.js, C++, Go y otros lenguajes

Despliegue mediante una imagen personalizada en un clúster de Kubernetes