Desplegar una aplicación estática o React
- Compila tu aplicación React u otro sitio estático localmente y sirve los archivos resultantes desde una imagen NGINX ligera.
- Así evitas instalar las dependencias de build en el host CapRover.
- Este ejemplo usa el directorio
disthabitual de Vite; sustitúyelo porbuildsi es el directorio de salida de tu proyecto.
-
Ejecuta
npm ci && npm run builden el proyecto. Comprueba que existedist/index.html. -
Crea un
Dockerfileen la raíz:FROM nginx:stable-alpineCOPY dist/ /usr/share/nginx/html/ -
Crea un archivo
captain-definitionen el mismo directorio con{"schemaVersion":2,"dockerfilePath":"./Dockerfile"}. -
Empaqueta el Dockerfile, la definición y los archivos compilados y despliega el tar:
tar -cf deploy.tar captain-definition Dockerfile distcaprover deploy --tarFile ./deploy.tarAntes debes crear la aplicación web en CapRover y seleccionarla cuando lo pida la CLI. También puedes subir
deploy.tardesde la pestaña Deployment. Configura el puerto HTTP del contenedor en80. -
Abre la dirección HTTP de la aplicación, activa HTTPS y comprueba el dominio público. En cada nuevo despliegue debes volver a compilar y empaquetar.
- El despliegue Git de la CLI utiliza
git archivey excluye archivos sin commit o ignorados por Git. - Como los archivos compilados suelen ignorarse, elige el método tar anterior; ejecutar directamente
caprover deploysin--tarFilepodría omitirlos.
Para soportar rutas del frontend como /settings, añade el siguiente archivo nginx.conf en la raíz del proyecto, para que el navegador cargue la aplicación al refrescar:
server {
listen 80;
root /usr/share/nginx/html;
index index.html;
location / { try_files $uri $uri/ /index.html; }
}
Añade COPY nginx.conf /etc/nginx/conf.d/default.conf al Dockerfile e incluye nginx.conf en el comando tar -cf anterior. Vuelve a compilar y desplegar. No pongas secretos en variables de build: el JavaScript compilado es público. Si tu aplicación utiliza una API, despliega el backend por separado y configura su URL HTTPS en el frontend.