Esta guía te mostrará cómo configurar tu cuenta de GitHub y cómo iniciar con las características de colaboración y comunitarias de GitHub Enterprise Server.
Parte 1: Configurar tu cuenta de GitHub
Los primeros pasos para comenzar con GitHub Enterprise Server son acceder a tu cuenta, configurar la autenticación bifactorial y ver tu perfil.
Todo aquél que utilice GitHub Enterprise Server tiene su propia cuenta personal, la cual puede ser parte de varias organizaciones y equipos. Tu cuenta personal es tu identidad en tu instancia de GitHub Enterprise Server y te representa como individuo.
1. Acceder a tu cuenta
El administrador de tu instancia de GitHub Enterprise Server te notificará sobre cómo autenticarte y acceder a tu cuenta. El proceso varía dependiendo del modo de autenticación que tienen configurado para la instancia.
2. Configurar la autenticación bifactorial
La autenticación de dos factores, o 2FA, es una capa extra de seguridad que se usa cuando se inicia sesión en sitios web o aplicaciones. Insistimos en que configures la 2FA por seguridad de tu cuenta. Para obtener más información, consulta "Acerca de la autenticación de dos factores".
3. Ver tu perfil de GitHub y gráfica de contribuciones
Tu perfil de GitHub les dice a las personas la historia de tu trabajo a través de los repositorios y gists que hayas fijado, las membrecías que hayas elegido publicitar, las contribuciones que hayas hecho y los proyectos que hayas creado. Para obtener más información, consulta las secciones "Acerca de tu perfil" y "Ver las contribuciones en tu perfil".
Parte 2: Utilizar las herramientas y procesos de GitHub Enterprise Server
Para utilizar GitHub Enterprise Server de la mejor forma, necesitarás configurar Git. Git es responsable de todo lo relacionado con GitHub que suceda de forma local en tu computadora. Para colaborar de forma efectiva en GitHub Enterprise Server, 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 Server para que las vean, recuperen y actualicen otras personas utilizando Git. Para obtener más información sobre Git, consulta la guía del "Manual de Git". Para obtener más información sobre cómo se utiliza Git en GitHub Enterprise Server, consulta la sección "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, consulta "Configurar 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, consulta "Comenzar con GitHub Desktop".
Una vez que instalaste Git, puedes conectarte a los repositorios de GitHub Enterprise Server 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 tu instancia de GitHub Enterprise Server desde Git, necesitarás autenticarte con GitHub Enterprise Server utilizando ya sea HTTPS o SSH. Para obtener más información, consulta la sección "Acerca de los repositorios remotos".
3. Elegir cómo interactuar con GitHub Enterprise Server
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 cómo autenticarte en GitHub Enterprise Server con cada uno de estos métodos, consulta la sección "Sobre la autenticación en GitHub".
| Método | Descripción | Casos de Uso |
|---|---|---|
| Navega a GitHub.com | Si no necesitas trabajar con archivos localmente, GitHub Enterprise Server 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 obtener más información sobre cómo iniciar con GitHub Desktop, consulta la sección "Iniciar 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 Enterprise Server. |
| IDE o editor de texto | Puedes configurar un editor de texto predeterminado, como Atom o Visual Studio Code para abrir y editar tus archivos con Git, utilizar extensiones y ver la estructura del proyecto. Para obtener más información, consulta la sección "Asociar los 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 CLI de GitHub | Para la mayoría de los controles granulares y personalización de cómo utilizas Git e interactúas con GitHub Enterprise Server, puedes utilizar la línea de comandos. Para obtener más información sobre cómo utilizar los comandos de Git, consulta la sección "Hoja de comandos de Git". El CLI de GitHub es una herramienta de línea de comandos por separado que puedes instalar, la cual agrega solicitudes de cambio, propuestas, GitHub Actions y otras características de GitHub a tu terminal para que puedas hacer todo tu trabajo desde un solo lugar. Para obtener más información, consulta la sección "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 Enterprise Server | GitHub Tiene una API de REST y una de GraphQL que puedes utilizar para interactuar con GitHub Enterprise Server. Para obtener más información, consulta la sección "Comenzar con la API". | La API de GitHub Enterprise Server tendrá la mayor utilidad si quisieras automatizar tareas comunes, respaldar tus datos o crear integraciones que se extiendan a GitHub. |
4. Escribir en GitHub Enterprise Server
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, consulta "Acerca de la escritura y el formato en GitHub."
Puedes aprender el lenguaje de marcado enriquecido de GitHub con el curso de "Comunícate utilizando el lenguaje de marcado" que está en Habilidades de GitHub.
5. Buscar en GitHub Enterprise Server
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 Server. Puedes buscar globalmente a través de todo GitHub Enterprise Server o limitar tu búsqueda a un repositorio u organización en particular. Para obtener más información sobre los tipos de búsqueda que puedes hacer en GitHub Enterprise Server, consulta la sección "Acerca de buscar en GitHub".
Nuestra sintaxis de búsqueda te permite construir consultas utilizando calificadores para especificar lo que quieres buscar. Para obtener más información sobre la sintaxis de búsqueda a utilizar, consulta la sección "Buscar en GitHub".
6. Administrar los archivos en GitHub Enterprise Server
Con GitHub Enterprise Server, 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, consulta la sección "Administrar archivos en GitHub".
Parte 3: Colaborar en GitHub Enterprise Server
Cualquier cantidad de personas pueden trabajar juntas en los repositorios a lo largo de GitHub Enterprise Server. 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 privados y públicos 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, consulta la sección "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, consulta la sección "Crear un nuevo repositorio."
Clonar un repositorio
Puedes clonar un repositorio existente desde GitHub Enterprise Server 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. Clonar un repositorio extrae una copia integral de todos los datos del mismo que GitHub tiene en ese momento, incluyendo todas las versiones para cada archivo y carpeta para el proyecto. Para obtener 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 obtener más información, consulta la sección "Trabajar con las bifurcaciones".
2. Importar tus proyectos
Si tienes proyectos existentes que quisieras mover a GitHub Enterprise Server, puedes importarlos utilizando el importador de GitHub, la línea de comandos o herramientas de migración externas. Para obtener más información, consulta la sección, "Importar el código fuente a GitHub"-
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. Puedes invitar a otras personas para que sean colaboradores en tu repositorio desde la pestaña de Colaboradores en los ajustes de repositorio. Para obtener más información, consulta la sección "Invitar colaboradores a un repositorio personal".
Eres el propietario de cualquier repositorio que crees en tu cuenta personal y tienes el control total del repositorio. Los colaboradores tiene acceso de escritura a tu repositorio, lo cual limita sus permisos. Para obtener más información, consulta "Niveles de permiso para un repositorio de cuenta de usuario".
4. Administrar configuraciones de repositorios
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, consulta la sección "Administrar la configuración de los repositorios".
5. Configurar tu proyecto para contribuciones saludables
Al agregar archivos como lineamientos de contribución, un código de conducta y tener compatibilidad con los recursos para tu repositorio, puedes crear un ambiente en donde sea más fácil para los colaboradores realizar contribuciones significativas y útiles. Para encontrar más información, visita la sección " Configurar tu proyecto para tener contribuciones saludables."
6. Utilizar las propuestas y tableros de proyecto de GitHub
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, consulta las secciones "Acerca de las propuestas" y Acerca de los tableros de proyecto".
7. Administrar notificaciones
Las notificaciones proporcionan actualizaciones sobre la actividad en GitHub a la cual estás suscrito o en la cual participas. 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, consulta la sección "Acerca de las notificaciones".
8. Trabajar con Páginas de GitHub
Puedes utilizar Páginas de GitHub para crear y hospedar un sitio web directamente desde un repositorio de tu instancia de GitHub Enterprise Server. Para obtener más información, consulta la sección "Acerca de Páginas de GitHub".
Parte 4: Personalizar y automatizar tu trabajo en GitHub Enterprise Server
Puedes utilizar las herramientas del GitHub Marketplace, la API de GitHub Enterprise Server y características existentes de GitHub Enterprise Server para personalizar y automatizar tu trabajo.
1. Utilizar la API de GitHub Enterprise Server
Hay dos versiones de la API de GitHub Enterprise Server: la API de REST y la API de GraphQL. Puedes utilizar las API de GitHub Enterprise Server para automatizar las tareas comunes, respaldar tus datos o crear integraciones que extiendan a GitHub Enterprise Server. Para obtener más información, consulta la sección "Acerca de las API de GitHub".
2. Crear GitHub Actions
Con las GitHub Actions, puedes automatizar y personalizar el flujo de desarrollo de tu instancia de GitHub Enterprise Server en GitHub Enterprise Server. Puedes crear tus propias acciones y usar y personalizar acciones compartidas por la comunidad GitHub. Para obtener más información, consulta la sección "Aprende sobre GitHub Actions".
3. Publicar y administrar el Registro del paquete de GitHub
Registro del paquete de GitHub 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, consulta la sección "Introducción a las Registro del paquete de GitHub".
Parte 5: Compilar de forma segura en GitHub Enterprise Server
GitHub Enterprise Server 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 ver un resumen de las características de seguridad de GitHub Enterprise Server, consulta la sección "características de seguridad de GitHub".
1. Asegurar tu 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 obtener más información sobre los pasos que debes tomar para proteger tus repositorios, consulta la sección "Proteger 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 Soporte de la Comunidad de GitHub o aprender con Habilidades de GitHub.
1. Contribuir con 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 la sección "Cómo contribuir con el código abierto" en las Guías de código abierto.
Puedes encontrar recomendaciones personalizadas para los proyectos y buenas primeras propuestas con base en tus contribuciones anteriores, marcas de favoritos y otras actividades en Explorar.
2. Interactuar con Soporte de la Comunidad de GitHub
Puedes conectarte con los desarrolladores de todo el mundo para responder y hacer preguntas, aprender e interactuar directamente con el personal de GitHub Enterprise Server. Para iniciar la conversación, consulta la sección "Soporte de la Comunidad de GitHub".
3. Leer sobre GitHub Enterprise Server en GitHub Docs
Puedes leer la documentación que refleje las características disponibles para ti en GitHub Enterprise Server. Para obtener más información, consulta la sección "Acerca de las versiones de GitHub Docs".
4. Aprender con Habilidades de GitHub
Puedes aprender habilidades nuevas completando proyectos divertidos y realistas en tu propio repositorio de GitHub con Habilidades de GitHub. Cada curso es una lección interactiva que creó la comunidad de GitHub, la cual imparte un bot amigable.
Para obtener más información, consulta la sección "Recursos de aprendizaje de Git y de GitHub".