Iniciar con tu cuenta de GitHub

Esta guía le guiará por la configuración de la cuenta de GitHub y la introducción a las características de GitHub Enterprise Cloud para la colaboración y la comunidad.

Parte 1: Configurar tu cuenta de GitHub

Los primeros pasos para comenzar con GitHub Enterprise Cloud son crear una cuenta, elegir un producto que se adapte mejor a sus necesidades, comprobar el correo electrónico, configurar la autenticación en dos fases y ver el perfil.

Hay varios tipos de cuentas en GitHub. Cualquier usuario que utilice GitHub Enterprise Cloud tiene su propia cuenta personal, que puede formar parte de varias organizaciones y equipos. Tu cuenta personal es tu identidad en GitHub.com y te representa como individuo.

1. Crear una cuenta

Para registrarse en una cuenta, vaya a https://github.com/ y siga las indicaciones.

Para mantener tu cuenta de GitHub protegida, debes utilizar una contraseña fuerte y única. Para más información, consulta Crear una contraseña segura.

2. Elegir el producto GitHub

Puedes elegir GitHub Free o GitHub Pro para obtener acceso a diversas características de tu cuenta personal. Puedes mejorarlas en cualquier momento si no estás seguro de qué producto quieres inicialmente.

Para más información sobre todos los planes de GitHub, consulta Planes de GitHub.

3. Comprobar su dirección de correo electrónico

Para garantizar que puedes utilizar todas las características en tu plan de GitHub Enterprise Cloud, verifica tu dirección de correo electrónico después de registrarte para obtener una cuenta nueva. Para más información, consulta Verificar tu dirección de correo electrónico.

Configurar la autenticación en dos fases

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 paso.

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 más información, consulta Acerca de tu perfil y Ver contribuciones en tu perfil.

Parte 2: Utilizar las herramientas y procesos de GitHub Enterprise Cloud

Para utilizar GitHub Enterprise Cloud 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 Enterprise Cloud, 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 Enterprise Cloud para que las vean, recuperen y actualicen otras personas utilizando Git. Para obtener más información sobre Git, consulta la guía Manual de Git. Para más información sobre cómo se usa Git en GitHub Enterprise Cloud, 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 más información, consulta 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 más información, consulta Comenzar con GitHub Desktop.

Una vez que instalaste Git, puedes conectarte a los repositorios de GitHub Enterprise Cloud desde tu computadora local, ya sea que se trate de tu propio repositorio o de la bifurcación del de otro usuario. Cuando se conecte a un repositorio GitHub.com desde Git, deberá autenticarse con GitHub Enterprise Cloud mediante HTTPS o SSH. Para más información, consulta Acerca de los repositorios remotos.

3. Elegir cómo interactuar con GitHub Enterprise Cloud

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 obtener más información sobre los distintos enfoques para interactuar con GitHub y una comparación de las herramientas que puedes usar, consulta Conexión a GitHub.

4. Escribir en GitHub Enterprise Cloud

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 más información, consulta 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 Enterprise Cloud

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 Enterprise Cloud. Puedes buscar globalmente a través de todo GitHub Enterprise Cloud 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 Enterprise Cloud, 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 Enterprise Cloud

Con GitHub Enterprise Cloud, 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 más información, consulta Administrar archivos.

Parte 3: Colaborar en GitHub Enterprise Cloud

Cualquier cantidad de personas pueden trabajar juntas en los repositorios a lo largo de GitHub Enterprise Cloud. 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

Puedes clonar un repositorio existente desde GitHub Enterprise Cloud 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 más información, consulta 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 más información, consulta Trabajar con bifurcaciones.

2. Importar los proyectos

Si tienes proyectos existentes que quisieras mover a GitHub Enterprise Cloud, puedes importar proyectos utilizando GitHub Importer, la línea de comandos o herramientas de migración externas. Para más información, consulta Importación de código fuente.

3. Administrar colaboradores y permisos

Puedes colaborar en tu proyecto con otros usando las solicitudes de extracción, las propuestas de tu repositorio y projects. 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 tiene acceso de escritura a tu repositorio, lo cual limita sus permisos. 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 Administrar la configuración y características de tu repositorio.

5. Configurar el proyecto para contribuciones correctas

Para motivar a los colaboradores en el repositorio, necesita una comunidad que anime a las personas a que usen el proyecto, contribuyan en él y lo evangelicen. Para obtener más información, consulta Creación de comunidades de bienvenida en las Guías de código abierto.

Al agregar archivos como lineamientos de contribución, un código de conducta y una licencia para tu repositorio, puedes crear un ambiente en donde sea más fácil para los colaboradores realizar contribuciones significativas y útiles. Para más información, consulta Configurar tu proyecto para contribuciones saludables.

6. Usar GitHub Issues y Projects

Puede usar GitHub Issues para organizar el trabajo con problemas y solicitudes de cambios y administrar el flujo de trabajo con Projects. Para más información, consulta Acerca de las propuestas y Acerca de Projects.

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 más información, consulta Acerca de las notificaciones.

8. Trabajar con GitHub Pages

Puede utilizar GitHub Pages para crear y hospedar un sitio web directamente desde un repositorio en GitHub.com. Para más información, consulta Acerca de GitHub Pages.

9. Usar GitHub Discussions

Puedes habilitar los GitHub Discussions en tu repositorio para ayudar a crear una comunidad al rededor de tu 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 Enterprise Cloud

Puedes utilizar las herramientas del GitHub Marketplace, la API de GitHub y características existentes de GitHub Enterprise Cloud para personalizar y automatizar tu trabajo.

1. Usar GitHub Marketplace

GitHub Marketplace contiene integraciones que agregan funcionalidad y mejoran tu flujo de trabajo. En GitHub Marketplace, puede descubrir, buscar e instalar herramientas gratuitas y de pago, incluidas GitHub Apps, OAuth apps y GitHub Actions.

2. Utilizar la API de GitHub

Hay dos versiones de la API de GitHub: la API de REST y la API de GraphQL. Puede usar las API de GitHub para automatizar tareas comunes, realizar copias de seguridad de los datos o crear integraciones que amplíen GitHub Enterprise Cloud. Para obtener más información, vea «Comparación de la API REST de GitHub y la API de GraphQL».

Crear GitHub Actions

Con las GitHub Actions, puedes automatizar y personalizar el flujo de desarrollo de GitHub.com en GitHub Enterprise Cloud. Puedes crear tus propias acciones y usar y personalizar acciones compartidas por la comunidad GitHub. Para obtener más información, vea «Escritura de flujos de trabajo».

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 Enterprise Cloud

GitHub Enterprise Cloud 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 Enterprise Cloud, 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 Inicio rápido para proteger el repositorio.

2. Administrar las dependencias

Una parte grande de compilar de forma segura es mantener las dependencias de tu proyecto para asegurarte de que todos los paquetes y aplicaciones de las cuales dependes estén actualizadas y seguras. Puedes administrar las dependencias de tu repositorio en GitHub Enterprise Cloud si exploras la gráfica de dependencias para este utilizando el Dependabot para levantar solicitudes de cambio automáticamente para mantener tus dependencias actualizadas y recibiendo alertas del Dependabot y actualizaciones de seguridad para las dependencias vulnerables.

Para más información, consulta Asegurar la cadena de suministro de tu software.

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 sus contribuciones anteriores, estrellas y otras actividades en Explorar GitHub. Para más información, consulta "Encontrar maneras para colaborar con el código abierto en GitHub".