Cómo crear un archivo ZIP o TAR con git archive

¿Qué es git archive y para qué se usa?

git archive genera un archivo comprimido que contiene una instantánea del proyecto en un momento específico. A diferencia de un clon estándar de Git, este archivo no incluye el historial del repositorio (.git), solo el contenido de los archivos rastreados en la rama o el commit seleccionados. Esto lo hace ideal para compartir el código fuente o empaquetar versiones de lanzamiento de manera eficiente.

Puedes elegir qué rama, etiqueta o commit específico deseas exportar y en qué formato (por ejemplo, .zip o .tar). Además, es posible utilizar opciones para personalizar el contenido del archivo, como incluir solo ciertos directorios o excluir archivos no deseados.

Ejemplos de uso de git archive

Crear un archivo ZIP del repositorio

Este comando crea un archivo llamado proyecto.zip con el contenido de la rama actual (HEAD).

Exportar una rama específica como archivo TAR

Esto genera un archivo TAR llamado rama-feature.tar con el contenido de la rama nombre-de-la-rama.

Crear un archivo comprimido a partir de una etiqueta

Si deseas empaquetar el proyecto en un estado etiquetado (por ejemplo, una versión estable):

Esto crea un archivo version1.0.zip con el contenido de la etiqueta v1.0.

Exportar solo un subdirectorio del proyecto

Si necesitas crear un archivo con solo un subdirectorio específico:

Esto genera un archivo ZIP que contiene solo los archivos del subdirectorio subdirectorio/ en la rama actual.

Excluir archivos específicos durante la exportación

Puedes excluir archivos o carpetas no deseadas utilizando la opción --exclude:

Esto crea un archivo sin-documentacion.tar sin los archivos con extensión .md.

Referencia oficial

Para más información sobre git archive, consulta la documentación oficial de Git.