Cada proyecto en Esadax es una instancia abstracta que representa su aplicación o carga de trabajo, ya sea una implementación de CI / CD conectada a Git, una aplicación de pila completa orquestada a través de One Click Apps o un proyecto de pago por uso de corta duración.
La configuración del proyecto controla cómo se compila, implementa y sirve la aplicación, adaptándose a las necesidades específicas de cada tipo de proyecto. Comprender estos ajustes le permite optimizar el rendimiento, agilizar los flujos de trabajo y mantener la coherencia en todos los entornos.
Tabla de contenidos
- Directorio raíz
- Ajustes preestablecidos del marco
- [Configuración de compilación] (./12.build-settings.mdx)
- Variables de entorno
- Versión de Node.js
- [Configurar encabezados] (./21.configure-headers.mdx)
A. Panorama general
El panel Configuración del proyecto en tu panel de Esadax se adapta al tipo de proyecto que estás gestionando, lo que te permite configurar tu aplicación para compilación y tiempo de ejecución con facilidad.
Proyectos CI/CD conectados a Git (estilo Netlify)
- Por lo general, el código fuente vive en un repositorio Git.
- Especifique el directorio raíz para el origen de su aplicación, especialmente útil para monorepos o carpetas anidadas.
- Defina su marco preestablecido (Next.js, Astro, SvelteKit, etc.) para compilaciones optimizadas.
- Configurar comandos de compilación y carpetas de salida.
- Administre variables de entorno para diferentes etapas de implementación.
- Selecciona versiones de Node.js para compilaciones y tiempos de ejecución de funciones sin servidor.
- Personalice los encabezados HTTP para el almacenamiento en caché, la seguridad y el rendimiento.
Aplicaciones con un solo clic y proyectos de pago por uso (Full-Stack y corto plazo)
- Project se basa en cargas de trabajo en contenedores u orquestadas.
- No se requiere un directorio raíz Git tradicional.
- Concéntrese en configurar nombre del proyecto y definir las variables de entorno necesarias (por ejemplo, credenciales, URL de servicio).
- Implemente rápidamente sin pasos de compilación complejos.
- La configuración en tiempo de ejecución es clave: todas las variables de entorno se transmiten directamente a los contenedores o servicios orquestados.
- Los proyectos de pago por uso permiten el control de inicio/parada con facturación basada en el tiempo de ejecución activo.
Directorio raíz
Para proyectos conectados a Git, especialmente aquellos que usan monorepos, especificar el directorio raíz es esencial para localizar correctamente el código fuente de tu aplicación.
Los proyectos One Click Apps y Pay-as-You-Go no requieren una configuración de directorio raíz, ya que la aplicación se implementa a través de imágenes de contenedor o servicios orquestados.
Obtenga más información en Configuración del directorio raíz.
Presets de Framework
Los ajustes preestablecidos de framework optimizan los pasos de compilación e implementación en función de la tecnología front-end. Esto es principalmente para proyectos CI/CD conectados a Git.
Los proyectos de One Click Apps y Pay-as-You-Go normalmente no requieren ajustes preestablecidos de framework, ya que se basan en imágenes de contenedor preconstruidas.
Consulte Ajustes preestablecidos del marco para obtener más información.
Configuración de compilación
Personalice los comandos de compilación, las carpetas de salida y los pasos de instalación para proyectos basados en código fuente mediante canalizaciones de CI/CD.
Para proyectos basados en contenedores, el proceso de compilación ocurre fuera de Esadax, por lo que la configuración de compilación generalmente no es aplicable.
Más información en Configuración de compilación.
Variables de entorno
Las variables de entorno son vitales para todos los tipos de proyectos:
- Para proyectos conectados a Git, defina variables con alcance a entornos de compilación y tiempo de ejecución.
- Para One Click Apps y Pay-as-You-Go, las variables de entorno configuran los servicios en contenedores y el comportamiento en tiempo de ejecución.
Administre de forma segura a través del panel o CLI. Aprenda cómo en Variables de entorno.
Versión de Node.js
Configura la versión de tiempo de ejecución de Node.js para compilaciones y funciones sin servidor en proyectos conectados a Git.
No se aplica a proyectos de One Click Apps o de pago por uso orquestados en contenedores, a menos que los contenedores especifiquen versiones de Node.js internamente.
Consulte Configurar la versión de Node.js.
Configurar los encabezados
Establezca encabezados HTTP personalizados para políticas de almacenamiento en caché, mejoras de seguridad y controles de enrutamiento, principalmente relevantes para proyectos frontend implementados a través de Git.
One Click Apps puede admitir encabezados basados en la configuración de contenedores o servicios, pero esto varía según la aplicación.
Obtenga más información en Configurar encabezados.
IV. Conclusión
La configuración de proyectos en Esadax está diseñada para admitir de manera flexible su estilo de implementación, desde flujos de trabajo CI/CD totalmente integrados con Git hasta aplicaciones de pila completa basadas en contenedores instantáneos e implementaciones rentables de pago por uso.
Adapte la configuración de su proyecto en función de la arquitectura subyacente para maximizar la eficiencia, el control y la fiabilidad.
Explore las guías vinculadas para cada configuración para ajustar sus proyectos y desbloquear todo el potencial de la plataforma de Esadax.
