Submódulos de Git y paquetes compartidos en equipos

Los submódulos de Git son útiles para repositorios compartidos con ciclo de vida propio. Eso incluye design systems, herramientas internas, plantillas o paquetes sin un flujo de publicación separado.

  • un proyecto usa otra versión del código compartido que el siguiente
  • las actualizaciones quedan difíciles de seguir en el proyecto principal
  • faltan subdirectorios importantes tras clonar
  • la entrega se detiene porque el módulo falta en la automatización

Preparar un proyecto existente con submódulos

bash

Este paso carga el contenido faltante del submódulo directamente durante el clonado o después en el proyecto.

Añadir un repositorio compartido como submódulo

bash

Esto fija dónde vive el submódulo en el proyecto y qué rama sirve como referencia. El proyecto principal siempre guarda un commit concreto del submódulo.

  • los cambios quedan trazables
  • las actualizaciones se hacen de forma consciente y controlada
  • el proyecto principal debe adoptar cada nuevo estado de forma explícita

Mantener los estados del submódulo en el equipo

bash

Este flujo mantiene proyecto principal y submódulo en el mismo estado y hace que los cambios sean trazables dentro del equipo.

Cargar submódulos en la automatización

bash

Casos de uso para submódulos

Los submódulos encajan con repositorios compartidos que tienen ciclo de vida propio y una separación clara respecto al proyecto principal.

  • herramientas internas
  • plantillas y esqueletos
  • colecciones compartidas de configuración
  • design systems o recursos privados con ciclo de vida propio

Beneficio en el trabajo diario del equipo

Estados claros del submódulo hacen trazables las dependencias compartidas y mantienen una relación verificable entre proyecto principal y repositorio hijo.