Información general sobre los archivos de código fuente
Puede descargar una instantánea de cualquier rama, etiqueta o confirmación específica desde GitHub. Estas instantáneas las genera el comando git archive
en uno de dos formatos: tarball o zipball. Las instantáneas no contienen todo el historial del repositorio. Si quieres todo el historial, puedes clonar el repositorio. Para obtener más información, vea «Clonar un repositorio».
Descarga de archivos de código fuente
Puedes descargar los archivos de código fuente de tres maneras.
Descarga de archivos de código fuente desde la vista del repositorio
-
En GitHub, navegue hasta la página principal del repositorio.
-
Encima de la lista de archivos, haz clic en Código.
-
Haz clic en Descargar el archivo ZIP.
Descarga de archivos de código fuente desde una versión
-
En GitHub, navegue hasta la página principal del repositorio.
-
A la derecha de la lista de archivos, haga clic en Releases.
-
Desplázate hacia abajo hasta la sección "Recursos" de la versión.
-
Para descargar el código fuente, haz clic en Código fuente (zip) o en Código fuente (tar.gz) .
Descarga de archivos de código fuente desde una etiqueta
-
En GitHub, navegue hasta la página principal del repositorio.
-
A la derecha de la lista de archivos, haga clic en Releases.
-
En la parte superior de la página Versiones, haga clic en Etiquetas.
-
Para descargar el código fuente, haz clic en zip o tar.gz.
Direcciones URL de archivo de código fuente
Los archivos de código fuente están disponibles en direcciones URL específicas para cada repositorio. Por ejemplo, considere el repositorio github/codeql
. Hay diferentes direcciones URL para descargar una rama, una etiqueta o un identificador de confirmación específico.
Tipo de archivo | Ejemplo | Resolución |
---|---|---|
Rama | main | https://github.com/github/codeql/archive/refs/heads/main.tar.gz |
Etiqueta | codeql-cli/v2.12.0 | https://github.com/github/codeql/archive/refs/tags/codeql-cli/v2.12.0.zip |
Commit | aef66c4 | https://github.com/github/codeql/archive/aef66c462abe817e33aad91d97aa782a1e2ad2c7.zip |
Note
Puedes usar .zip
o .tar.gz
en las URL anteriores para solicitar un elemento zipball o tarball respectivamente.
Estabilidad de los archivos de código fuente
Los archivos de código fuente se generan a petición, se almacenan en caché durante un tiempo y, a continuación, se eliminan. Si se vuelve a solicitar el mismo archivo en el futuro, se volverá a generar. Es importante entender qué garantías ofrece GitHub sobre los archivos de código fuente.
- Un archivo de un identificador de confirmación siempre tendrá el mismo contenido de archivo siempre que se solicite, suponiendo que el identificador de confirmación todavía esté en el repositorio y el nombre del repositorio no haya cambiado.
- Dado que las ramas y etiquetas pueden moverse a diferentes identificadores de confirmación, las descargas futuras de un archivo pueden tener un contenido diferente al de los archivos descargados previamente de la misma rama o etiqueta. Suponiendo que la rama o la etiqueta siga apuntando al mismo identificador de confirmación, tendrá el mismo contenido de archivo.
- La configuración de compresión exacta que se usa para generar un zipball o tarball puede cambiar con el tiempo. El contenido extraído no cambiará si la rama o la etiqueta no cambian, pero el archivo comprimido externo puede tener una distribución de bytes diferente. GitHub avisará con al menos seis meses de antelación antes de cambiar la configuración de compresión.
- El nombre del repositorio forma parte de la estructura de directorios dentro del archivo. Por lo tanto, si cambia el nombre del repositorio, también cambiará el nombre del directorio raíz.
Si confías en la estabilidad de los archivos de código fuente para la reproducibilidad (asegurándote de que siempre obtienes archivos idénticos dentro del archivo), se recomienda usar la API REST de archivos con un identificador de confirmación para :ref
. El uso del identificador de confirmación garantiza que siempre obtendrás el mismo contenido de archivo dentro del archivo y serás inmune a los repositorios que vuelvan a escribir etiquetas o mover encabezados de rama.
Si confías en la estabilidad de los archivos por motivos de seguridad (por ejemplo, para asegurarte de que no intentas descomprimir un archivo malintencionado), te recomendamos que utilices versiones en lugar de descargas de código fuente. Para obtener más información, vea «Acerca de los lanzamientos».
Puedes usar algo parecido a esta acción de terceros GitHub para crear e insertar estos archivos como parte del proceso de lanzamiento. La API REST de recursos de versión se puede usar más adelante para recuperarlos.