Acerca de los repositorios
Un repositorio es el elemento más básico de GitHub. Es un lugar donde puedes almacenar el código, los archivos y el historial de revisiones de cada archivo. Los repositorios pueden contar con múltiples colaboradores y pueden ser públicos, internos, como privados.
Para crear un nuevo repositorio, ve a https://github.com/new. Para instrucciones, consulta Inicio rápido para repositorios.
Terminología de los repositorios
Antes de empezar a trabajar con repositorios, debes aprender acerca de estos términos importantes.
| Término | Definición |
|---|---|
| Sucursal | Una versión paralela del código contenido en el repositorio, pero que no afecta a la rama principal. |
| Clonar | Para descargar una copia completa de los datos de un repositorio de GitHub.com, incluidas todas las versiones de cada archivo y carpeta. |
| Bifurcar | Un nuevo repositorio que comparte la configuración de visibilidad y código con el repositorio «ascendente» original. |
| Merge | Para aplicar los cambios de una rama y en otra. |
| Solicitud de incorporación de cambios | Una solicitud para combinar los cambios de una rama en otra. |
| Control remoto | Un repositorio almacenado en GitHub, no en el equipo. |
| Ascendente | La rama de un repositorio original que se ha bifurcado o clonado. La rama correspondiente del repositorio clonado o bifurcado se denomina "descendente". |
Acerca de la propiedad del repositorio
Puedes ser propietario de repositorios individualmente o puedes compartir la propiedad de los repositorios con otras personas en una organización.
En cualquier caso, los permisos administran el acceso a los repositorios. Para más información, consulta Niveles de permisos para un repositorio de una cuenta personal y Roles de repositorio para una organización.
Acerca de la colaboración
Puedes utilizar repositorios para administrar tu trabajo y colaborar con otros.
- Puedes utilizar propuestas para recolectar la retroalimentación de los usuarios, reportar errores de software y organizar las tareas que te gustaría realizar. Para más información, consulta Acerca de las propuestas.
- Puedes utilizar los GitHub Discussions para hacer y responder preguntas, compartir información, hacer anuncios y conducir o participar en las conversaciones sobre un proyecto. Para más información, consulta Acerca de los debates.
- Puedes utilizar las solicitudes de cambios para proponer cambios a un repositorio. Para más información, consulta Acerca de las solicitudes de incorporación de cambios.
- Puede usar Projects para organizar y priorizar los problemas y las solicitudes de cambios. Para más información, consulta Acerca de Projects.
Gracias a GitHub Free para cuentas personales y organizaciones, puedes trabajar con colaboradores ilimitados en repositorios públicos ilimitados con un conjunto completo de características, o en repositorios privados ilimitados con un conjunto limitado de características. Para obtener herramientas avanzadas para repositorios privados, puedes mejorar tu plan a GitHub Pro, GitHub Team, o GitHub Enterprise Cloud. Para más información, consulta Planes de GitHub.
Acerca de la visibilidad de un repositorio
Puedes restringir quién tiene acceso a un repositorio eligiendo la visibilidad de este: público, interno o privado.
Cuando creas un repositorio, puedes elegir si lo quieres hacer público o privado. Si estás creando el repositorio en una organización que le pertenezca a una cuenta empresarial, también puedes elegir hacerlo interno.
- Si la cuenta no es un cuenta de usuario administrada, puede crear repositorios públicos. Los repositorios públicos son accesibles para todo el mundo en Internet.
- Solo tú, las personas con las que compartes el acceso explícitamente y, para los repositorios de organizaciones, algunos miembros de la organización, pueden acceder a los repositorios privados.
- Todos los miembros de la empresa pueden acceder a los repositorios internos. Para más información, consulta Acerca de los repositorios internos.
Consideraciones de seguridad para la visibilidad del repositorio
Los repositorios públicos exponen el código base a todos los usuarios, lo que aumenta el riesgo de que los atacantes puedan aprovechar vulnerabilidades o acceder a información confidencial. Para mitigar estos riesgos, habilita las características de seguridad GitHub como Dependabot, secret scanning, protección push y code scanning para el repositorio. Además, debes agregar una directiva de seguridad (un archivo SECURITY.md) al repositorio, que describe cómo se deben notificar las vulnerabilidades, para asegurarse de que las posibles amenazas se abordan de forma eficaz.
Aunque los repositorios privados restringen el acceso a los usuarios autorizados, sigue siendo esencial implementar controles de acceso seguros, autenticación multifactor y auditorías periódicas para mitigar los riesgos.
Para más información, consulta Inicio rápido para proteger el repositorio.
Los propietarios de la organización siempre tiene acceso a todos los repositorios creados en la misma. Para más información, consulta Roles de repositorio para una organización.
Las personas con permisos de administrador para un repositorio pueden cambiar la visibilidad de los repositorios existentes. Para más información, consulta Configurar la visibilidad de un repositorio.
Acerca de los repositorios internos
Si tu organización pertenece a una cuenta empresarial, puedes utilizar repositorios internos para practicar el "innersource" dentro de tu empresa. Los miembros de tu empresa pueden colaborar utilizando metodologías de código abierto sin compartir información propietaria al público. Para obtener más información acerca de InnerSource, consulta las notas del producto de GitHubIntroducción a InnerSource.
Nota:
Solo puedes crear repositorios internos si usas GitHub Enterprise Cloud con una cuenta de empresa. Una cuenta de empresa es un tipo independiente de cuenta que permite un punto central de administración para varias organizaciones. Para más información, consulta Tipos de cuentas de GitHub.
Todos los miembros de las empresas tienen permiso de lectura para los repositorios internos, pero las personas externas a la empresa, incluyendo los colaboradores externos en los repositorios organizacionales, no pueden verlos. Para más información, consulta Roles en una empresa y Roles de repositorio para una organización.
Los repositorios internos son la configuración predeterminada de todos los repositorios que se creen en una organización que pertenezca a una cuenta de empresa.
De forma predeterminada, los miembros empresariales pueden bifurcar un repositorio interno en cualquier organización donde el usuario pueda crear repositorios. Los propietarios de la organización también pueden permitir que los usuarios creen una bifurcación propiedad de una cuenta de usuario y pueden administrar la directiva de bifurcación para una organización. Los propietarios de empresas pueden administrar la directiva de bifurcación para algunas o todas las organizaciones de una empresa. Para más información, consulta Administrar la política de bifurcación para tu organización y Requerir políticas de administración de repositorios en tu empresa.
Pasos siguientes
Estos son algunos recursos útiles para que completes los pasos siguientes con los repositorios:
- Procedimientos recomendados para repositorios: descubre cómo utilizar los repositorios de la manera más efectiva.
- Crear un repositorio nuevo: crea un repositorio.
- Crear y eliminar ramas en tu repositorio: aprende a crear y eliminar ramas dentro del repositorio.
- Crear una solicitud de incorporación de cambios: crea una solicitud de incorporación de cambios para proponer cambios en un repositorio y colaborar.