Pasos
1
Haz un fork y añade una carpeta
Haz un fork del repositorio y añade una carpeta con el nombre de tu plantilla, por ejemplo
discord-bot-tickets/, con:2
Valida el manifiesto
Ejecuta la comprobación desde la carpeta. Compara el manifiesto con el esquema y las reglas de la plataforma y no crea nada:Añade la línea del esquema al principio del manifiesto para tener ayuda en el editor: consulta el esquema del manifiesto. Las plantillas públicas tienen algunas reglas adicionales, más abajo.
3
Pruébala como plantilla privada
Créala como plantilla privada en tu propia cuenta y úsala de verdad; es el mismo motor que el del catálogo público. Consulta Validar y probar.
4
Abre el pull request
La CI valida el manifiesto, construye la imagen si hay un Dockerfile, busca file capabilities en ella (un binario con una de ellas no se ejecuta en la plataforma) y comprueba la licencia declarada.
5
Revisión
Vertra Cloud ejecuta la plantilla en la plataforma y revisa el cambio en cuanto a seguridad (sin miners, telemetría oculta ni secretos en el código), una licencia que permita la distribución pública y la calidad del README. Corrige lo que se pida y vuelve a hacer push.
6
Merge y publicación
Al hacer merge, la carpeta de ese commit se empaqueta como una versión de la plantilla y se publica con la insignia Comunidad y tu nombre como autor. Nadie depende de tu cuenta: el código vive en Vertra Cloud, y una plantilla de imagen pasa a ser una imagen mantenida por la plataforma.
Reglas adicionales para plantillas públicas
Los ids de plantilla son únicos en todo el catálogo. Escribe el
README.md como lo necesita un usuario: qué crea la plantilla, qué hacer después del despliegue y dónde viven los datos. Declara la licencia del software original en links.license.
Después del merge
- Vertra Cloud mantiene la plantilla. Las actualizaciones del software llegan mediante versiones nuevas; quienes usan la plantilla ven Nueva versión disponible y deciden cuándo actualizar.
- Una plantilla que ya no se mantiene se marca como obsoleta y sale de la galería. Las apps ya creadas siguen en ejecución y se les avisa. Una imagen que una plantilla todavía usa solo se elimina con aviso previo y una vía de migración para quienes la usan.
Relacionado
Tutorial: de privado a público
Todo el camino, de una plantilla privada a un pull request.
Buenas prácticas
Léelo antes de abrir el PR.