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 |
|
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.
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.
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
Inicie sesión en la consola de EDAS.
En la barra de navegación superior, seleccione una región. En la parte superior de la página, seleccione un namespace.
En la esquina superior izquierda, haga clic en Create Application.
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.
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.
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.
Haga clic en Create Application.
En la página Creation Completed, revise la configuración en Basic Information, Configurations y Advanced Settings, luego haga clic en Create Application.
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.
Inicie sesión en la consola de EDAS.
En la barra de navegación superior, seleccione una región. En la parte superior de la página, seleccione un namespace.
En la lista desplegable Cluster Type, seleccione Container Service or Serverless Kubernetes Cluster.
Busque la aplicación objetivo y haga clic en su nombre.
En la página Overview o Basic information, seleccione Deploy > Deploy en la esquina superior derecha.
En la página Select Deployment Mode, seleccione un modo de despliegue y haga clic en Start Deployment.
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.
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.

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 |
|
|
Sí |
Establece la contraseña root de MySQL |
|
|
No |
Crea una cuenta de usuario adicional con contraseña |
|
|
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). |
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 |