Esta guía le guiará en la configuración de su cuenta de GitHub y en cómo empezar a usar las funciones de colaboración y comunidad de GitHub.
Parte 1: Configuración de la GitHub cuenta
Los primeros pasos para comenzar con GitHub son acceder a su cuenta, configurar la autenticación en dos fases y ver el perfil.
Cada persona que usa GitHub tiene su propia cuenta personal, que puede formar parte de varias organizaciones y equipos. Su cuenta personal es su identidad en tu instancia de GitHub Enterprise Server y le representa como individuo.
1. Acceder a la cuenta
El administrador de la GitHub Enterprise Server instancia le notificará sobre cómo autenticarse y acceder a su cuenta. El proceso varía dependiendo del modo de autenticación que tienen configurado para la instancia.
2. Configurar la autenticación de dos factores
La autenticación en dos fases, o 2FA, es una capa de seguridad adicional que se usa al iniciar sesión en sitios web o aplicaciones. Insistimos en que configures la 2FA por seguridad de tu cuenta. Para más información, consulta Acerca de la autenticación de dos factores.
Opcionalmente, después de configurar 2FA, agrega una clave de paso a tu cuenta para habilitar un inicio de sesión seguro sin contraseña. Consulta Administración de claves de acceso.
3. Ver tu GitHub perfil y gráfico de contribuciones
Tu GitHub perfil cuenta la historia de tu trabajo a través de los repositorios y gists que has fijado, las organizaciones de las que formas parte que has elegido hacer públicas, las contribuciones que has realizado y los proyectos que has creado. Para más información, consulta Acerca de tu perfil y Ver contribuciones en tu perfil.
Parte 2: Uso de las herramientas y procesos de GitHub
Para aprovechar al máximo GitHub, tendrá que configurar Git. Git es responsable de todo lo relacionado con GitHub que ocurre localmente en tu equipo. Para colaborar eficazmente en GitHub, escribirá problemas y solicitudes de incorporación de cambios mediante GitHub Flavored Markdown.
1. Aprender a usar Git
El enfoque colaborativo de GitHub para el desarrollo depende de publicar commits de tu repositorio local en GitHub para que otras personas puedan verlos, obtenerlos y actualizarlos con Git. Para obtener más información sobre Git, consulta la guía Manual de Git. Para obtener más información sobre cómo se usa Git en GitHub, consulte flujo de trabajo de GitHub.
2. Configurar Git
Si planeas utilizar Git localmente en tu computadora, ya sea a través de la línea de comandos, de un IDE o de un editor de texto, necesitarás instalar y configurar Git. Para más información, consulta Configuración de Git.
Si prefiere usar una interfaz visual, puede descargar y usar GitHub Desktop. GitHub Desktop viene empaquetado con Git, por lo que no es necesario instalar Git por separado. Para más información, consulta Comenzar con GitHub Desktop.
Una vez que instales Git, podrás conectarte a los repositorios de GitHub desde tu equipo, tanto a tu propio repositorio como al fork de otro usuario. Al conectarse a un repositorio desde tu instancia de GitHub Enterprise Server Git, deberá autenticarse mediante GitHub HTTPS o SSH. Para más información, consulta Acerca de los repositorios remotos.
3. Elección de cómo interactuar con GitHub
Todos tienen su propio flujo de trabajo único para interactuar con GitHub; las interfaces y los métodos que usa dependen de sus preferencias y de lo que funciona mejor para sus necesidades.
Para obtener más información sobre los distintos enfoques para interactuar con GitHuby una comparación de las herramientas que puede usar, consulte Conexión a GitHub.
4. Escribir en GitHub
Para que la comunicación sea clara y organizada en problemas y solicitudes de incorporación de cambios, puede usar GitHub Flavored Markdown para dar formato, que combina una sintaxis fácil de leer y fácil de escribir con alguna funcionalidad personalizada. Para más información, consulta Acerca de la escritura y el formato en GitHub.
Puede aprender GitHub Flavored Markdown con el curso Comunicar mediante Markdown en GitHub Skills.
5. Buscar en GitHub
Nuestra búsqueda integrada le permite encontrar lo que busca entre los muchos repositorios, usuarios y líneas de código en GitHub. Puede buscar globalmente en todo GitHub o limitar la búsqueda a un repositorio o organización determinado. Para obtener más información sobre los tipos de búsquedas que puede hacer en GitHub, vea Acerca de la búsqueda en GitHub.
Nuestra sintaxis de búsqueda te permite construir consultas utilizando calificadores para especificar lo que quieres buscar. Para más información sobre la sintaxis de búsqueda que se va a usar en las búsquedas, consulta Buscar en GitHub.
6. Administrar archivos en GitHub
Con GitHub, puede crear, editar, mover y eliminar archivos en el repositorio o en cualquier repositorio al que tenga acceso de escritura. También puedes rastrear el historial de cambios en un archivo, línea por línea. Para más información, consulta Administrar archivos.
Parte 3: Colaborar en GitHub
Cualquier cantidad de personas puede trabajar juntas en repositorios de GitHub. Puede configurar los ajustes, crear proyectos y administrar sus notificaciones para motivar una colaboración efectiva.
1. Trabajar con repositorios
Crear un repositorio
Un repositorio es como una carpeta para tu proyecto. Puedes tener cualquier cantidad de repositorios públicos y privados en tu cuenta personal. Los repositorios pueden contener archivos y carpetas, imágenes, videos, hojas de cálculo y juegos de datos, así como el historial de revisión de todos los archivos en el repositorio. Para más información, consulta Acerca de los repositorios.
Cuando creas un repositorio nuevo, debes inicializarlo con un archivo README para que las personas sepan sobre tu proyecto. Para más información, consulta Crear un repositorio nuevo.
Clonar un repositorio
Puede clonar un repositorio existente desde GitHub a su equipo local, lo que facilita añadir o eliminar archivos, resolver conflictos de fusión o realizar confirmaciones de cambios complejas. La clonación de un repositorio extrae una copia completa de todos los datos del repositorio que GitHub tiene en ese momento, incluidas todas las versiones de cada archivo y carpeta del proyecto. Para más información, consulta Clonar un repositorio.
Clonar un repositorio
Una bifurcación es una copia de un repositorio que administres, en donde cualquier cambio que hagas no afectará el repositorio a menos de que emitas una solicitud de cambios del propietario del proyecto. Casi siempre, los forks se utilizan para proponer cambios en el proyecto de otro o para usar el proyecto de otro como base de tu propia idea. Para más información, consulta Trabajar con bifurcaciones.
2. Importar los proyectos
Si tiene proyectos existentes que le gustaría migrar a GitHub, puede importarlos mediante GitHub Importer, la línea de comandos o herramientas externas de migración. Para más información, consulta Importación de código fuente.
3. Administrar colaboradores y permisos
Puede colaborar en el proyecto con otros usuarios mediante los problemas del repositorio, las solicitudes de incorporación de cambios y proyectos. Puede invitar a otras personas al repositorio como colaboradores desde la pestaña Collaborators (Colaboradores), en la configuración del repositorio. Para más información, consulta Invitar colaboradores a un repositorio personal.
Eres el propietario de cualquier repositorio que crees en tu cuenta personal y tienes control total sobre este. Los colaboradores tienen acceso de escritura a tu repositorio, pero limitando lo que pueden hacer. Para más información, consulta Niveles de permisos para un repositorio de una cuenta personal.
4. Administrar la configuración del repositorio
Como propietario de un repositorio, puedes configurar varios ajustes, incluyendo la visibilidad del repositorio, los temas y la vista previa de redes sociales. Para más información, consulta Administración de la configuración y las características del repositorio.
5. Preparar tu proyecto para contribuciones saludables
Al agregar archivos como directrices de contribución, un código de conducta y recursos de soporte técnico al repositorio, puede crear un entorno en el que sea más fácil que los colaboradores realicen contribuciones significativas y útiles. Para más información, consulta Configurar tu proyecto para contribuciones saludables.
6. Uso de GitHub Issues y Projects
Puede usar GitHub Issues para organizar el trabajo con problemas y solicitudes de incorporación de cambios y administrar el flujo de trabajo con Projects. Para más información, consulta Acerca de los problemas y Acerca de Projects.
7. Administrar notificaciones
Las notificaciones proporcionan actualizaciones sobre la actividad en GitHub a la que se ha suscrito o en la que ha participado. Si ya no te interesa alguna conversación, te puedes dar de baja, dejar de seguir o personalizar los tipos de notificaciones que recibirás en el futuro. Para más información, consulta Acerca de las notificaciones.
8. Trabajar con GitHub Pages
Puede usar GitHub Pages para crear y hospedar un sitio web directamente desde un repositorio en tu instancia de GitHub Enterprise Server. Para más información, consulta ¿Qué es GitHub Pages?.
9. Uso de GitHub Discussions
Puede habilitar GitHub Discussions en el repositorio para ayudar a crear una comunidad en torno a su proyecto. Los mantenedores, contribuyentes y visitantes pueden utilizar los debates para compartir anuncios, hacer y responder preguntas y participar en conversaciones sobre las metas. Para más información, consulta Acerca de los debates.
Parte 4: Personalizar y automatizar tu trabajo en GitHub
Puedes utilizar las herramientas del GitHub Marketplace, la API de GitHub y características existentes de GitHub para personalizar y automatizar tu trabajo.
1. Uso de la GitHub API
Hay dos versiones de la API de GitHub: la API REST y la API de GraphQL. Puedes usar las API GitHub para automatizar tareas comunes, hacer copias de seguridad de los datos o crear integraciones que amplíen GitHub. Para más información, consulta Comparación de la API REST de GitHub y GraphQL API.
2. Edificio GitHub Actions
Con GitHub Actions, puedes automatizar y personalizar el flujo de desarrollo de tu empresa en GitHub. Puedes crear tus propias acciones y usar y personalizar acciones compartidas por la comunidad de GitHub. Para más información, consulta Escritura de flujos de trabajo.
3. Publicación y administración GitHub Packages
GitHub Packages es un servicio de alojamiento de paquete de software que te permite alojar tus paquetes de software de forma privada o pública y usar paquetes como dependencias en tus proyectos. Para más información, consulta Introducción a los paquetes de GitHub.
Parte 5: Desarrollo seguro en GitHub
GitHub tiene una variedad de características de seguridad que ayudan a proteger el código y los secretos en los repositorios. Algunas características están disponibles para todos los repositorios, mientras que otras solo están disponibles para repositorios públicos y repositorios con una GitHub Code Security licencia o GitHub Secret Protection . Para obtener información general sobre las características de seguridad, consulta Características de seguridad de GitHub.
1. Proteger el repositorio
Como administrador de un repositorio, puedes proteger tus repositorios si configuras los ajustes de seguridad de estos. Estos incluyen el administrar el acceso a tu repositorio, configurar una política de seguridad y administrar las dependencias. En el caso de los repositorios públicos y de los repositorios privados que pertenecen a organizaciones con licencias para las características, también puede configurar el análisis de código y secretos para identificar automáticamente vulnerabilidades y asegurarse de que no se exponen los tokens y las claves.
Para más información sobre los pasos que puedes seguir para proteger los repositorios, consulta Inicio rápido para proteger el repositorio.
Parte 6: Participar en la comunidad de GitHub
Hay muchas formas de participar en la comunidad de GitHub. Puedes contribuir con los proyectos de código abierto, interactuar con las personas en GitHub Community Support o aprender con GitHub Skills.
1. Contribución a proyectos de código abierto
El contribuir con proyectos de código abierto en GitHub puede ser una forma gratificante de aprender, enseñar y crear una experiencia sobre cualquier habilidad que te puedas imaginar. Para obtener más información, consulta Procedimiento para contribuir al código abierto en las Guías de código abierto.
Puedes encontrar recomendaciones personalizadas para proyectos y primeras incidencias adecuadas en función de tus contribuciones anteriores, estrellas y otras actividades en Explorar GitHub.
2. Interactuar con GitHub Community Support
Puedes contactar con desarrolladores de todo el mundo para hacer preguntas o responder a ellas, aprender e interactuar directamente con el personal de GitHub. Para comenzar la conversación, consulta GitHub Community Support.
3. Leer sobre GitHub en GitHub Docs
Puedes leer la documentación que refleja el producto GitHub que estás utilizando actualmente. Para más información, consulta Acerca de las versiones de GitHub Docs.
4. Aprendizaje con GitHub Skills
Puede aprender aptitudes nuevas si completa proyectos divertidos y realistas en un repositorio de GitHub propio con GitHub Skills. Cada curso es una lección práctica que ha creado la comunidad de GitHub y lo imparte un simpático bot.
Para más información, consulta Recursos de aprendizaje de Git y GitHub.