Skip to main content

Agregar un archivo a un repositorio

Puedes cargar y confirmar un archivo existente a un repositorio de GitHub o utilizando la línea de comandos.

Platform navigation

Agregar un archivo a un repositorio en GitHub

Los archivos que agregues a un repositorio mediante un navegador están limitados a 25 MiB por archivo. Puedes agregar archivos más grandes, de hasta 100 MiB cada uno, mediante la línea de comando. Para obtener más información,consulta Adición de un archivo a un repositorio mediante la línea de comandos. Para agregar archivos mayores que 100 MiB, debes usar Almacenamiento de archivos de gran tamaño de Git. Para más información, consulta Acerca de los archivos grandes en GitHub.

Puedes cargar múltiples archivos en GitHub a la vez.

Si un repositorio cuenta con alguna rama protegida, no podrás editar o cargar archivos en ésta utilizando GitHub. Puedes utilizar GitHub Desktop para mover tus cambios a una rama nueva y confirmarlos. Para obtener más información, vea «Acerca de las ramas protegidas» y «Confirmación y revisión de cambios en el proyecto de GitHub Desktop».

Es posible que el repositorio tenga habilitados conjuntos de reglas de inserción. Los conjuntos de reglas de inserción pueden bloquear la creación de un nuevo archivo en el repositorio en función de determinadas restricciones. Los conjuntos de reglas de inserción se aplican a toda la red de bifurcación del repositorio. Esto significa que los conjuntos de reglas de inserción configurados en el repositorio raíz también se aplicarán a cada bifurcación del repositorio. Para obtener más información, vea «Acerca de los conjuntos de reglas».

El repositorio puede protegerse mediante la protección de inserción. Con la protección de inserción, GitHub bloqueará la carga de un archivo en el repositorio si dicho archivo contiene un secreto admitido, como un token. Debe eliminar el secreto de los archivos antes de intentar cargarlos de nuevo. Para más información, consulta Trabajar con protección de inserción en la interfaz de usuario de GitHub y Trabajar con protección de inserción en la interfaz de usuario de GitHub.

Note

La protección de inserción para las cargas de archivos en la interfaz de usuario web se encuentra actualmente en versión preliminar pública y está sujeta a cambios.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. Encima de la lista de archivos, seleccione el menú de lista desplegable Cargar archivos y haga clic en Agregar archivos. Como alternativa, puede arrastrar y colocar archivos en el explorador.

    Captura de pantalla de la página principal del repositorio. Encima de la lista de archivos, un botón con la etiqueta "Agregar archivo", aparece resaltado en naranja oscuro.

  3. Para seleccionar los archivos que desea cargar, arrastre y coloque el archivo o carpeta, o haga clic en elegir los archivos.

  4. En el campo de "Mensaje de confirmación", escriba un mensaje de confirmación corto y significativo que describa la modificación que hizo en el archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para obtener más información, vea «Crear una confirmación con distintos autores».

  5. Debajo de los campos para el mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. Si tu rama actual es la rama predeterminada, debes elegir crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para obtener más información, vea «Crear una solicitud de incorporación de cambios».

    Captura de pantalla de una solicitud de cambios de GitHub en la que se muestra un botón de radio para confirmar directamente en la rama principal o para crear una nueva rama. Aparece seleccionada la opción de rama nueva.

  6. Haz clic en Proponer cambios.

Agregar un archivo a un repositorio utilizando la línea de comando

Puede cargar un archivo existente a un repositorio de GitHub mediante la línea de comandos.

Este procedimiento supone que ya has:

Warning

Nunca uses los comandos git add, commit o push con información confidencial, por ejemplo, contraseñas y claves de API, en un repositorio remoto. Si ya ha agregado esta información, consulte «Eliminación de datos confidenciales de un repositorio».

  1. En tu computadora, mueve el archivo que deseas cargar a GitHub en el directorio local que se creó cuando clonaste el repositorio.

  2. Abra TerminalTerminalGit Bash.

  3. Cambia el directorio de trabajo actual por tu repositorio local.

  4. Agregue el archivo al "stage" para confirmarlo en el repositorio local.

    $ git add .
    # Adds the file to your local repository and stages it for commit. Para sacar del "stage" un archivo, use "git reset HEAD EL_ARCHIVO".
    
  5. Confirme el archivo que ha agregado al "stage" en el repositorio local.

    $ git commit -m "Add existing file"
    # Commits the tracked changes and prepares them to be pushed to a remote repository. Para eliminar esta confirmación y modificar el archivo, usa 'git reset --soft HEAD~1' y confirma y agrega nuevamente el archivo.
    
  6. Inserta los cambios en el repositorio local en GitHub.com.

    $ git push origin YOUR_BRANCH
    # Pushes the changes in your local repository up to the remote repository you specified as the origin
    

Información adicional