Saltar al contenido principal

Esquema de Captain Definition

El archivo captain-definition, situado en la raíz del paquete de despliegue, indica a CapRover qué debe desplegar. La interfaz de código fuente incluye schemaVersion y cuatro opciones para definir el despliegue.

CampoTipoDescripción
schemaVersionnumberObligatorio. El parser actual acepta 2.
imageNamestringDescarga y despliega una imagen Docker existente.
dockerfilePathstringRuta a un Dockerfile dentro del archivo de despliegue. No se admiten rutas que suban al directorio padre.
dockerfileLinesstring[]Líneas de un Dockerfile inline.
templateIdstringUtiliza una plantilla Dockerfile integrada.

Debes indicar exactamente una de las cuatro opciones. El parser rechaza definiciones con ninguna o más de una.

{"schemaVersion": 2, "imageName": "nginx:stable-alpine"}

Para un despliegue con imageName, necesitas otra definición si quieres reconstruir la imagen desde el código fuente. Para un ejemplo con Dockerfile, consulta Estáticos y React.

Plantillas integradas y versiones​

templateId sigue el formato NAME/VERSION, por ejemplo:

{"schemaVersion":2,"templateId":"node/24"}

Las definiciones de plantillas de CapRover generan Dockerfiles con estas etiquetas de imágenes oficiales:

NAMEImagen base para NAME/VERSION
nodenode:VERSION-alpine
phpphp:VERSION-apache
python-djangopython:VERSION-alpine
ruby-rackruby:VERSION-alpine
  • Para node/24, la imagen base resultante es node:24-alpine.
  • La etiqueta debe existir en el registry de origen. Las etiquetas basadas solo en la versión principal pueden apuntar a imágenes distintas con el tiempo.
  • Las instrucciones específicas de cada plantilla están en el directorio dockerfiles de CapRover.
  • Revísalas antes de asumir qué frameworks admite la plantilla o de cambiar las versiones.
  • Un Dockerfile incluido en tu propio repositorio permite fijar una etiqueta o digest exacto y controlar el build para otros frameworks.