CI/CD
Tokens de despliegue
-
Un token de despliegue permite a CI desplegar una aplicación concreta de CapRover sin utilizar la contraseña del dashboard.
-
Crea la aplicación, abre la pestaña Deployment, habilita el token de la app y guárdalo como secreto en tu sistema de CI.
-
Trata el token y cualquier URL de Git webhook como credenciales sensibles.
-
En CI, utiliza la URL HTTPS del dashboard y el nombre exacto de la aplicación.
-
Con la CLI, proporciona
--appTokeno defineCAPROVER_APP_TOKENcomo variable de entorno, junto con la URL del servidor y el nombre de la aplicación. -
La GitHub Action oficial acepta el token en el input
token. -
Si se filtra el token, sustitúyelo o desactívalo en los ajustes de la aplicación y actualiza el secreto de CI.
-
Si despliegas imágenes privadas, configura también las credenciales del registry. Un token de despliegue no concede al servidor CapRover acceso a un registry privado.
GitHub Actions
Utiliza caprover/deploy-from-github, que mantiene los workflows para desplegar desde código fuente, imágenes Docker, archivos preparados y monorepos.
- Habilita un token de despliegue para la aplicación y guárdalo en los Secrets de GitHub Actions.
- Configura los inputs
server,appytokende la Action. - Si la imagen es privada, añade en CapRover las credenciales necesarias para hacer pull del registry.
- Cuando la Action termine, verifica el despliegue y el estado de salud de la aplicación.
GitLab CI
Puedes construir la imagen en GitLab CI, publicarla en GitLab Container Registry y desplegar exactamente ese tag en CapRover. Así evitas consumir recursos del servidor CapRover durante el build.
-
Crea la aplicación en CapRover y habilita su token de despliegue.
-
Guarda la URL HTTPS de CapRover, el nombre de la app y el token como variables protegidas de GitLab CI/CD. Marca el token como Masked cuando sea posible.
-
Construye la imagen y haz push a GitLab Container Registry usando un tag asociado al commit, por ejemplo
$CI_COMMIT_SHA. -
Si la imagen es privada, configura en CapRover el registry
registry.gitlab.com, credenciales con permisos de lectura y el prefijo correcto de imagen. Consulta registros privados. El login del runner de GitLab por sí solo no permite que CapRover descargue la imagen. -
Configura el GitLab runner para utilizar Docker-in-Docker con el volumen de certificados TLS. En un repositorio que contenga un Dockerfile, añade este archivo
.gitlab-ci.yml:stages: [build, deploy]build:stage: buildimage: docker:27.4.1services:- docker:27.4.1-dindvariables:DOCKER_HOST: tcp://docker:2376DOCKER_TLS_CERTDIR: /certsscript:- echo "$CI_REGISTRY_PASSWORD" | docker login "$CI_REGISTRY" -u "$CI_REGISTRY_USER" --password-stdin- docker build -t "$CI_REGISTRY_IMAGE:$CI_COMMIT_SHA" .- docker push "$CI_REGISTRY_IMAGE:$CI_COMMIT_SHA"rules:- if: '$CI_COMMIT_BRANCH == "main"'deploy:stage: deployimage: node:24-alpinescript:- npm install -g caprover- caprover deploy --caproverUrl "$CAPROVER_URL" --caproverApp "$CAPROVER_APP" --appToken "$CAPROVER_APP_TOKEN" --imageName "$CI_REGISTRY_IMAGE:$CI_COMMIT_SHA"rules:- if: '$CI_COMMIT_BRANCH == "main"'
- Configura
CAPROVER_URL,CAPROVER_APPyCAPROVER_APP_TOKENcomo variables de GitLab CI/CD. Protege y oculta el token. - GitLab proporciona las variables
CI_REGISTRY_*y las variables del commit cuando está habilitado Container Registry. - Cambia
mainsi publicas desde otra rama.
- Tras el job de CI, comprueba el tag de la imagen y el estado del servicio en CapRover. Que la CLI confirme el despliegue significa que CapRover ha aceptado la actualización; además, el contenedor debe estar saludable y escuchar en el puerto HTTP correcto.
- Si el build no puede conectarse a Docker, consulta la configuración de Docker-in-Docker de GitLab.
- Evita guardar la contraseña del dashboard en el pipeline o usar el tag mutable
latestcomo identificador de una release. - También puedes usar un webhook de push de GitLab si prefieres que CapRover construya el código fuente.
CI genérico
-
Cualquier sistema CI puede desplegar en CapRover si tiene acceso al dashboard mediante HTTPS y un token de despliegue.
-
Puedes enviar un archivo de código fuente con
captain-definitiono una imagen preconstruida accesible desde el servidor. -
Un flujo reproducible es: construir una imagen, asignarle un tag inmutable de commit o release, publicarla en un registry, configurar el acceso de CapRover para hacer pull y desplegar ese tag exacto mediante la CLI o API.
-
Guarda el token y las credenciales del registry en los Secrets del sistema CI, evita imprimirlos en los logs y comprueba que la aplicación funciona después del despliegue.
Si envías el código fuente, el servidor CapRover realizará el build y necesitará memoria y disco suficientes. Consulta Builds y logs si algo falla.