Esta guía le guiará por la configuración de la cuenta de GitHub y la introducción a las características de GitHub AE para la colaboración y la comunidad.
Parte 1: Configurar tu cuenta de GitHub
Los primeros pasos para comenzar con GitHub AE son acceder a su cuenta y ver el perfil.
Cualquier usuario que utilice GitHub AE tiene su propia cuenta personal, que puede formar parte de varias organizaciones y equipos. Tu cuenta personal es tu identidad en tu empresa y te representa como individuo.
1. Acceder a la cuenta
Recibirás una notificación de correo electrónico cuando el propietario de la empresa de GitHub AE haya configurado tu cuenta, lo cual te permitirá autenticarte con el inicio de sesión único (SSO) de SAML y acceder a tu cuenta.
2. Ver el perfil y el gráfico de contribución de GitHub
El perfil de GitHub indica a los usuarios la historia de su trabajo mediante los repositorios y gists que ha anclado, las pertenencias a la organización que ha elegido publicar, las contribuciones que ha realizado y los proyectos que ha creado. Para obtener más información, vea «Acerca de tu perfil» y «Ver contribuciones en tu perfil».
Parte 2: Utilizar las herramientas y procesos de GitHub AE
Para utilizar GitHub AE de la mejor forma, necesitarás configurar Git. Git es responsable de todo lo relacionado con GitHub que ocurra localmente en el equipo. Para colaborar de forma efectiva en GitHub AE, necesitarás escribir en propuestas y solicitudes de cambio utilizando el Lenguaje de Marcado Enriquecido de GitHub.
1. Aprender a usar Git
El enfoque colaborativo de GitHub para el desarrollo depende de las confirmaciones de publicación desde tu repositorio local hacia GitHub AE para que las vean, recuperen y actualicen otras personas utilizando Git. Para obtener más información sobre Git, vea la guía "Manual de Git". Para más información sobre cómo se usa Git en GitHub AE, consulta "Flujo 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 obtener más información, vea «Configuración de Git».
Si prefieres utilizar una interfaz virtual, puedes descargar y utilziar GitHub Desktop. GitHub Desktop viene en un paquete con Git, así que no hay necesidad de instalar Git por separado. Para obtener más información, vea «Comenzar con GitHub Desktop».
Una vez que instalaste Git, puedes conectarte a los repositorios de GitHub AE desde tu computadora local, ya sea que se trate de tu propio repositorio o de la bifurcación del de otro usuario. Cuando te conectas a un repositorio de GitHub AE desde Git, necesitarás autenticarte con GitHub AE utilizando HTTPS o SSH. Para obtener más información, vea «Acerca de los repositorios remotos».
3. Elegir cómo interactuar con GitHub AE
Cada quién tiene su propio flujo de trabajo único para interactuar con GitHub; las interfaces y métodos que utilices dependen de tu preferencia y de lo que funcione mejor para cubrir tus necesidades.
Para más información sobre cómo autenticarse en GitHub AE con cada uno de estos métodos, consulta "Acerca de la autenticación en GitHub".
| Método | Descripción | Casos de uso |
|---|---|---|
| Navega a GitHub.com | Si no necesitas trabajar con archivos localmente, GitHub AE te permite completar la mayoría de las acciones relacionadas con Git en el buscador, desde crear y bifurcar repositorios hasta editar archivos y abrir solicitudes de cambios. | Este método es útil si quieres tener una interfaz virtual y necesitas realizar cambios rápidos y simples que no requieran que trabajes localmente. |
| GitHub Desktop | GitHub Desktop se extiende y simplifica tu flujo de trabajo GitHub.com, usando una interfaz visual en lugar de comandos de texto en la línea de comandos. Para más información sobre cómo a empezar a trabajar en GitHub Desktop, consulta "Comenzar con GitHub Desktop". | Este método es le mejor si necesitas o quieres trabajar con archivos localmente, pero prefieres utilizar una interfaz visual para utilizar Git e interactuar con GitHub AE. |
| IDE o editor de texto | Puedes establecer un editor de texto predeterminado, como Visual Studio Code para abrir y editar los archivos con Git, usar extensiones y ver la estructura del proyecto. Para obtener más información, vea «Asociar editores de texto con Git». | Es conveniente si estás trabajando con archivos y proyectos más complejos y quieres todo en un solo lugar, ya que los editores o IDE a menudo te permiten acceder directamente a la línea de comandos en el editor. |
| Línea de comandos, con o sin GitHub CLI | Para la mayoría de los controles granulares y personalización de cómo utilizas Git e interactúas con GitHub AE, puedes utilizar la línea de comandos. Para más información sobre el uso de comandos de Git, consulta "Hoja introductoria de Git". GitHub CLI es una herramienta de línea de comandos independiente que puede instalar y que aporta solicitudes de incorporación de cambios, problemas, GitHub Actions, y otras características de GitHub al terminal, por lo que puede realizar todo el trabajo en un solo lugar. Para obtener más información, vea «Acerca del CLI de GitHub». | Esto es lo más conveniente si ya estás trabajando desde la línea de comandos, lo cual te permite evitar cambiar de contexto o si estás más cómodo utilizando la línea de comandos. |
| API de GitHub AE | GitHub Tiene una API de REST y una de GraphQL que puedes utilizar para interactuar con GitHub AE. Para obtener más información, vea «Acerca de las API de GitHub». | La API de GitHub AE tendrá la mayor utilidad si quisieras automatizar tareas comunes, respaldar tus datos o crear integraciones que se extiendan a GitHub. |
4. Escribir en GitHub AE
Para que tus comunicaciones sean más claras y organizadas en propuestas y solicitudes de cambios, puedes utilizar el Lenguaje de Marcado Enriquecido de GitHub para formatearlas, el cual combina una sintaxis fácil de escribir y de leer con algunas funcionalidades personalizadas. Para obtener más información, vea «Acerca de escritura y formato en GitHub».
Puedes aprender Markdown de tipo GitHub con el curso "Comunicación mediante Markdown" en GitHub Skills.
5. Buscar en GitHub AE
Nuestra búsqueda integrada te permite encontrar lo que estás buscando de entre los muchos repositorios, usuarios y líneas de código que hay en GitHub AE. Puedes buscar globalmente a través de todo GitHub AE o limitar tu búsqueda a un repositorio u organización en particular. Para obtener más información sobre los tipos de búsquedas que puedes realizar en GitHub AE, consulta "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 AE
Con GitHub AE, puedes crear, editar, mover y borrar los archivos en tu repositorio o en cualquier repositorio en el que tengas acceso de escritura. También puedes rastrear el historial de cambios en un archivo, línea por línea. Para obtener más información, vea «Administrar archivos».
Parte 3: Colaborar en GitHub AE
Cualquier cantidad de personas pueden trabajar juntas en los repositorios a lo largo de GitHub AE. Puedes configurar los ajustes, crear tableros de proyecto y administrar tus 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 obtener más información, vea «Acerca de los repositorios».
Cuando creas un repositorio nuevo, debes inicializarlo con un archivo README para que las personas sepan sobre tu proyecto. Para obtener más información, vea «Crear un repositorio nuevo».
Clonar un repositorio
Puedes clonar un repositorio existente desde GitHub AE hacia tu computadora local, haciendo que sea más fácil el agregar o eliminar archivos, corregir conflictos de fusión o hacer confirmaciones 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 todos los archivos y carpetas del proyecto. Para obtener más información, vea «Clonar un repositorio».
Bifurcar 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 las bifurcaciones se usan para proponer cambios al proyecto de otra persona o para usar el proyecto de otra persona como inicio de tu propia idea. Para obtener más información, vea «Trabajar con bifurcaciones».
2. Importar los proyectos
Si tienes proyectos existentes que quisieras mover a GitHub AE, puedes importarlos utilizando el importador de GitHub, la línea de comandos o herramientas de migración externas. Para obtener más información, vea «Importación de código fuente».
3. Administrar colaboradores y permisos
Puedes colaborar en tu proyecto con otros usando los tableros de proyecto, las solicitudes de extracción y las propuestas de tu repositorio. Puede invitar a otras personas al repositorio como colaboradores desde la pestaña Collaborators (Colaboradores), en la configuración del repositorio. Para obtener más información, vea «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 tiene acceso de escritura a tu repositorio, lo cual limita sus permisos. Para obtener más información, vea «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 obtener más información, vea «Administrar la configuración y características de tu repositorio».
5. Configurar el proyecto para contribuciones correctas
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 para los colaboradores realizar contribuciones significativas y útiles. Para obtener más información, vea «Configurar tu proyecto para contribuciones saludables».
6. Usar incidencias de GitHub y paneles de proyecto
Puedes utilizar las propuestas de GiHub para organizar tu trabajo con las propuestas y solicitudes de trabajo y administrar tu flujo de trabajo con tableros de proyecto. Para obtener más información, vea «Acerca de las propuestas» y «Acerca de project boards».
7. Administrar notificaciones
Las notificaciones proporcionan actualizaciones sobre la actividad en GitHub en las que se ha suscrito o 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 obtener más información, vea «Acerca de las notificaciones».
8. Trabajar con GitHub Pages
Puedes utilizar GitHub Pages para crear y hospedar un sitio web directamente desde un repositorio de GitHub AE. Para obtener más información, vea «Acerca de GitHub Pages».
Parte 4: Personalizar y automatizar tu trabajo en GitHub AE
Puedes utilizar las herramientas del GitHub Marketplace, la API de GitHub AE y características existentes de GitHub AE para personalizar y automatizar tu trabajo.
1. Utilizar la API de GitHub AE
Hay dos versiones de la API de GitHub AE: la API de REST y la API de GraphQL. Puede usar las API de GitHub AE para automatizar tareas comunes, realizar copias de seguridad de los datos o crear integraciones que amplíen GitHub AE. Para obtener más información, vea «Acerca de las API de GitHub».
2. Crear GitHub Actions
Con las GitHub Actions, puedes automatizar y personalizar el flujo de desarrollo de tu empresa en GitHub AE. Puedes crear tus propias acciones y usar y personalizar acciones compartidas por la comunidad GitHub. Para obtener más información, vea «Más información sobre las Acciones de GitHub».
3. Publicar y administrar 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 obtener más información, vea «Introducción a los paquetes de GitHub».
Parte 5: Compilar de forma segura en GitHub AE
GitHub AE tiene características de seguridad diversas que ayudan a mantener la seguridad del código y de los secretos en los repositorios. Algunas de las características se encuentran disponibles para todos los repositorios, mientras que otras solo están disponibles para los repositorios públicos o para aquellos con una licencia de GitHub Advanced Security. Para obtener un resumen de las características de seguridad de GitHub AE, 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. Para los repositorios públicos y para los privados que pertenezcan a las organizaciones en donde se haya habilitado la GitHub Advanced Security, también puedes configurar el escaneo de código y de secretos para que identifiquen las vulnerabilidades automáticamente y garanticen que los tokens y las llaves no se expongan.
Para más información sobre los pasos que puedes seguir para proteger los repositorios, consulta "Asegurar tu 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. Contribuir 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 más información, vea "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 colaboraciones anteriores, estrellas y otras actividades en Explorar.
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 AE. Para comenzar la conversación, consulta "GitHub Community Support".
3. Información sobre GitHub AE en GitHub Docs
Puedes leer la documentación que refleje las características disponibles para ti en GitHub AE. Para obtener más información, vea «Acerca de las versiones de GitHub Docs».
4. Aprender 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 obtener más información, vea «Recursos de aprendizaje de Git y GitHub».