¿Qué es GitHub?

Completado

En esta unidad, vamos a revisar los siguientes objetivos de aprendizaje:

  • Información general breve de la plataforma GitHub Enterprise
  • Creación de un repositorio
  • Adición de archivos a un repositorio
  • Búsqueda de repositorios
  • Introducción a gists y wikis

GitHub

Antes de explorar la plataforma de GitHub con detalle, es importante comprender lo que se basa en: Git.

Git es un sistema de control de versiones distribuido que permite a los desarrolladores realizar un seguimiento de los cambios, colaborar en el código y administrar revisiones a lo largo del tiempo. GitHub se basa en Git agregando herramientas de colaboración, características de automatización y una interfaz web fácil de usar. Comprender los conceptos básicos de Git, como confirmaciones, ramas y combinación, le ayudará a usar GitHub de forma más eficaz.

Una imagen conceptual de la plataforma de GitHub con capas de arriba a abajo: inteligencia artificial, colaboración, productividad, seguridad y escala.

GitHub es una plataforma basada en la nube que usa Git, un sistema de control de versiones distribuido, en su núcleo. La plataforma GitHub simplifica el proceso de colaborar en proyectos y proporciona un sitio web, herramientas de línea de comandos y un flujo global que permite a los desarrolladores y usuarios trabajar juntos.

Como hemos aprendido anteriormente, GitHub proporciona una plataforma para desarrolladores con tecnología de inteligencia para crear, escalar y ofrecer software seguro. Vamos a desglosar cada uno de los pilares básicos de la plataforma GitHub Enterprise, inteligencia artificial, colaboración, productividad, seguridad y escala.

INTELIGENCIA ARTIFICIAL

La inteligencia artificial generativa está transformando drásticamente el desarrollo de software. La plataforma GitHub Enterprise mejora la colaboración a través de solicitudes y problemas de extracción con tecnología de inteligencia artificial, productividad a través de copilot, chat de Copilot y agentes de Copilot, y la seguridad proporcionando comentarios más rápidos para mejorar la seguridad.

Colaboración

La colaboración es la base de todo lo que hace GitHub. GitHub ofrece herramientas que ayudan a los equipos a trabajar conjuntamente de forma eficaz, lo que reduce los retrasos y simplifica los flujos de trabajo.

Los repositorios, los problemas, las solicitudes de incorporación de cambios y otras herramientas ayudan a admitir una colaboración más rápida entre roles, acortar los ciclos de aprobación y mejorar la velocidad de entrega.

Productividad

La productividad se acelera con la automatización que proporciona la plataforma GitHub Enterprise. Con las herramientas integradas de CI/CD (integración continua y entrega continua) integradas en el proceso de desarrollo, la plataforma permite a los usuarios automatizar tareas repetitivas y acelerar el trabajo diario. Esto permite a los desarrolladores centrarse más en la codificación y la resolución de problemas.

Seguridad

GitHub integra la seguridad directamente en el proceso de desarrollo desde el principio y en cada fase. GitHub Enterprise incluye características nativas y de primera entidad, como CodeQL, análisis de secretos, Dependabot y información general de seguridad para minimizar los riesgos. El código sigue siendo privado, a la vez que se beneficia de comprobaciones de seguridad integradas.

GitHub sigue invirtiendo en seguridad y cumplimiento de nivel empresarial. Con confianza de Microsoft y organizaciones en sectores altamente regulados, GitHub cumple los estándares de cumplimiento globales, lo que lo convierte en una opción confiable para el desarrollo seguro a escala.

Escala

GitHub es la comunidad de desarrolladores más grande de su tipo, con datos en tiempo real de más de 100 millones de desarrolladores, 420 millones de repositorios e innumerables implementaciones. GitHub aprende y evoluciona continuamente sus productos. Su base de usuarios de gran tamaño proporciona una perspectiva diversa de lo que necesitan los desarrolladores, lo que impulsa la innovación continua para satisfacer esas necesidades. Al mismo tiempo, GitHub es una plataforma extensible: los desarrolladores de código abierto de todo el mundo contribuyen y mejoran las características que hacen que GitHub sea excepcional.

Esto se ha traducido en una escala increíble que no tiene parangón ni comparación con ninguna otra empresa del planeta. Las conclusiones de esta base de desarrolladores de gran tamaño ayudan a GitHub a evolucionar continuamente la plataforma.

En esencia, la plataforma GitHub Enterprise se centra en la experiencia del desarrollador. Proporciona herramientas de colaboración, automatización y características controladas por ia que admiten la productividad, la seguridad y la escalabilidad en una experiencia unificada para desarrolladores.

Ahora vamos a entrar en la columna vertebral de GitHub, los repositorios.

Introducción a los repositorios

Repasemos primero:

  • ¿Qué es un repositorio?
  • Creación de un repositorio
  • Adición de archivos a un repositorio
  • Búsqueda de repositorios
  • Introducción a gists, wikis y páginas de GitHub

¿Qué es un repositorio?

Un repositorio contiene todos los archivos de tu proyecto y el historial de revisiones de cada uno de ellos. Es una de las partes esenciales que le ayuda a colaborar con personas. Puede utilizar repositorios para administrar el trabajo, realizar un seguimiento de los cambios, almacenar el historial de revisiones y trabajar con otras personas. Antes de profundizar demasiado, empecemos por cómo crear un repositorio.

Creación de un repositorio

Puedes crear un repositorio nuevo en tu cuenta personal o la cuenta de cualquier organización en la que tengas los permisos suficientes.

Veamos cómo crear un repositorio a partir de github.com.

  1. En la esquina superior derecha de cualquier página, utilice el menú desplegable y seleccione Nuevo repositorio.

    Captura de pantalla del menú desplegable del signo más en la esquina superior derecha de GitHub.com, con Nuevo repositorio como primera opción.

  2. Use el menú desplegable Propietario para seleccionar la cuenta quequiere que sea propietaria del repositorio.

    Captura de pantalla del menú desplegable de quién debe ser el propietario del nuevo repositorio.

  3. Teclea el nombre de tu repositorio, y una descripción opcional.

    Imagen del cuadro de texto del nombre del repositorio resaltado.

  4. Elige la visibilidad del repositorio.

    • Los repositorios públicos son accesibles para todo el mundo en Internet.

    • A los repositorios privados solo pueden acceder usted, las personas con las que comparta explícitamente el acceso y, en el caso de los repositorios de organizaciones, determinados miembros de la organización.

  5. Seleccione Crear repositorio y ¡enhorabuena! Acaba de crear un repositorio.

Cómo clonar un repositorio

La clonación de un repositorio permite crear una copia local de un repositorio en el equipo. Esto resulta útil para realizar cambios localmente y sincronizarlos de nuevo con el repositorio remoto.

  1. En GitHub.com, vaya a la página principal del repositorio que desea clonar.

  2. Encima de la lista de archivos, haga clic en el botón Código .

    Captura de pantalla del menú desplegable del botón Código con las opciones de clonación.

  3. Copie la dirección URL del repositorio mediante la opción HTTPS, SSH o la CLI de GitHub.

  4. Abra el terminal y vaya al directorio donde desea clonar el repositorio.

  5. Ejecute el siguiente comando y reemplace <repository-url> por la dirección URL que copió:

    git clone <repository-url>
    
  6. Una vez completado el proceso de clonación, vaya a la carpeta del repositorio:

    cd <repository-name>
    

¡Felicidades! Ahora tiene una copia local del repositorio.

A continuación, vamos a repasar cómo agregar archivos al repositorio.

Adición de un archivo al repositorio

Los archivos en GitHub pueden hacer algunas cosas, pero su propósito principal es almacenar datos e información sobre su proyecto. Para agregar un archivo a un repositorio, necesita al menos acceso de escritura .

Vamos a repasar cómo agregar un archivo al repositorio.

  1. En GitHub.com, vaya a la página principal del repositorio.

  2. En su repositorio, vaya a la carpeta donde quiere crear un archivo seleccionando el vínculo crear un nuevo archivo o cargar un archivo existente.

  3. Una vez agregado, encima de la lista de archivos seleccione el menú desplegable Agregar archivo ᐁ. Después seleccione Crear nuevo archivo.

    Recorte de pantalla de la opción para agregar un archivo a su nuevo repositorio resaltada en rojo con el botón de agregar archivo hacia la derecha de la pantalla.

  4. En el campo de nombre, teclea el nombre y la extensión del archivo. Para crear subdirectorios, escriba el separador de directorios /.

  5. En el cuadro de texto de contenido del archivo, escriba contenido para el archivo.

  6. Para revisar el nuevo contenido, encima del contenido del archivo, seleccione Vista previa.

    Captura de pantalla en la que se muestra un archivo yml con el botón de vista previa resaltado en la parte superior izquierda.

  7. Seleccione Commit changes (Confirmar cambios).

  8. En el campo Confirmar mensaje, escriba un mensaje de confirmación breve y significativo que describa el cambio realizado en el archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo.

  9. Si tiene más de una dirección de correo electrónico asociada a su cuenta en GitHub.com, seleccione el menú desplegable de dirección de correo electrónico. Después, seleccione la dirección de correo electrónico que desea usar como dirección de autor de Git. Únicamente las direcciones de correo electrónico verificadas aparecen en el menú desplegable. Si ha habilitado la privacidad de la dirección de correo electrónico, entonces [nombreDeUsuario]@usuarios.noreply.github.com es la dirección de correo electrónico predeterminada del autor de la confirmación.

    Captura de pantalla en la que se muestra un cambio de confirmación con un cuadro de descripción y el menú desplegable del correo electrónico para seleccionar como autor de la confirmación.

  10. Debajo de los campos Mensaje de confirmación, decida si desea agregar la confirmación a la rama actual o a una nueva rama. Si su rama actual es la rama predeterminada, deberá elegir crear una nueva rama para su confirmación y después crear una solicitud de cambios.

    Captura de pantalla en la que se muestra cómo crear una rama a partir de una opción de confirmación seleccionada con el cuadro de texto de la nueva rama debajo.

  11. Seleccione Confirmar cambios o Proponer cambios.

¡Enhorabuena, acaba de crear un nuevo archivo en el repositorio! También ha creado una nueva rama y ha realizado una confirmación.

Antes de revisar las ramas y confirmaciones en la siguiente unidad, vamos a revisar rápidamente gists, wikis y páginas de GitHub porque son similares a los repositorios.

¿Qué son los Gists?

Gists es una característica de GitHub que permite a los usuarios compartir fragmentos de código, notas u otros pequeños fragmentos de información de una manera ligera y cómoda. Básicamente, son repositorios de Git pequeños, lo que significa que puede bifurcar, clonar y controlar versiones como un repositorio completo. Los Gists son especialmente útiles para compartir soluciones rápidas, archivos de configuración o ejemplos sin necesidad de crear un repositorio completo.

Características clave de Gists:

  1. Gists públicos y secretos:

    • Gists públicos: son visibles para todos los usuarios y se pueden detectar a través de la funcionalidad de búsqueda de GitHub. Son ideales para compartir fragmentos de código o soluciones que desea poner a disposición de la comunidad más amplia.
    • Gists secretos: no se pueden buscar ni enumerar públicamente, pero no son completamente privados. Cualquier persona con la dirección URL puede acceder a ellas. Son útiles para compartir código con un público limitado, como colaboradores o amigos.
  2. Control de versiones:

    • Se realiza un seguimiento de todos los cambios realizados en un gist, lo que le permite ver el historial de ediciones. Esto facilita la reversión a una versión anterior o ver cómo ha evolucionado el fragmento de código a lo largo del tiempo.
  3. Bifurcación y clonación:

    • Al igual que los repositorios, los gists se pueden bifurcar y clonar. Esto permite a los demás construir sobre su trabajo o adaptarlo a sus necesidades.
  4. Inserción:

    • Los Gists se pueden insertar en sitios web o blogs, lo que les convierte en una excelente herramienta para compartir ejemplos de código en tutoriales o documentación.
  5. Compatibilidad con Markdown:

    • Los Gists admiten el formato Markdown, lo que significa que puede incluir texto enriquecido, encabezados, vínculos e incluso imágenes junto con el código. Esto resulta especialmente útil para agregar contexto o explicaciones a los fragmentos de código.
  6. Collaboration:

    • Aunque los gists se usan normalmente para fragmentos de código individuales, también pueden compartirse y colaborar en ellos varios usuarios. La bifurcación y el comentario sobre gists permiten la colaboración ligera.

Casos de uso para Gists:

  • Uso compartido de ejemplos de código rápidos o soluciones.
  • Almacenar archivos de configuración o scripts para su uso personal.
  • Creación de plantillas para patrones de código usados habitualmente.
  • Uso compartido de registros de errores o información de depuración con otros usuarios.
  • Insertar fragmentos de código en blogs, foros o documentación.

[!IMPORTANTE]

Nunca use gists para almacenar datos confidenciales o confidenciales, como contraseñas, secretos o claves de API, incluso en scripts o archivos de configuración.
Los Gists no son totalmente privados: cualquier persona con el vínculo puede acceder a los gists secretos. Revise siempre el contenido cuidadosamente antes de compartirlo.

Limitaciones de Gists:

  • Los Gists no son completamente privados, incluso si están marcados como secretos. Cualquier persona con la dirección URL puede acceder a ellas, por lo que no debe usarse para información confidencial o confidencial.
  • Son más adecuados para fragmentos pequeños o archivos únicos. Para proyectos más grandes o estructuras de varios archivos, un repositorio completo es más adecuado.

Para obtener más información sobre cómo crear y administrar gists, consulte la documentación de GitHub en la sección Recursos de este módulo o visite la documentación de Gists de GitHub.

Bifurcación y clonación de Gists

Puede bifurcar un gist para crear una copia del gist de otra persona en su cuenta.

  1. Vaya al gist que desea bifurcar.
  2. Seleccione Bifurcar en la parte superior derecha de la página gist.

Para clonar un gist localmente:

git clone https://gist.github.com/your-gist-id.git

Para obtener más información sobre gists, consulte el artículo vinculado de nuestra sección Recursos, al final de este módulo, titulado Creación de gists.


¿Qué son las wikis?

Cada repositorio de GitHub.com incluye una sección para hospedar documentación, denominada wiki. Puedes usar la wiki de tu repositorio para compartir contenido en forma completa acerca de tu proyecto, como por ejemplo cómo usarlo, cómo lo diseñaste o sus principios básicos. Aunque un archivo LÉAME indica rápidamente lo que puede hacer el proyecto, puede usar una wiki para proporcionar documentación adicional.

Vale la pena recordar que si su repositorio es privado solo los usuarios que tengan al menos acceso de lectura a su repositorio tendrán acceso a la wiki.

Creación, edición y eliminación de páginas wiki

Puede usar la wiki de GitHub para crear y administrar documentación para el proyecto.

Para crear una página wiki:

  1. Vaya al repositorio.
  2. Seleccione la pestaña Wiki .
  3. Seleccione Crear la primera página si no existen páginas o Nueva página para agregar una página.
  4. Escriba un título y contenido y, a continuación, seleccione Guardar página.

Para editar una página wiki:

  1. Vaya a la página wiki que desea editar.
  2. Seleccione Editar en la parte superior derecha.
  3. Realice cambios y seleccione Guardar página.

Para eliminar una página wiki:

  • La eliminación de una página wiki requiere el uso de Git. Clone el repositorio wiki, quite el archivo e inserte el cambio.

Más información sobre cómo administrar wikis en Documentos de GitHub: adición o edición de páginas wiki.

¿Qué son las versiones preliminares de características?

Las versiones preliminares de características permiten probar características experimentales en GitHub antes de que se publiquen oficialmente. Estas versiones preliminares proporcionan acceso anticipado a la nueva funcionalidad y le permiten proporcionar comentarios para ayudar a dar forma al producto final.

Para habilitar o deshabilitar una vista previa de características:

  1. Vaya a la cuenta de GitHub seleccionando la imagen de perfil en la esquina superior derecha de GitHub.com.
  2. Seleccione Vista previa de características en el menú desplegable.
  3. Examine la lista de versiones preliminares disponibles y active las características que desea probar.

Las versiones preliminares de características son una excelente manera de mantenerse al día de la curva y explorar nuevas herramientas que pueden mejorar la experiencia de GitHub.

Sugerencia

GitHub agrega con frecuencia nuevas características experimentales para que los usuarios exploren, por lo que debe tener en cuenta la revisión de características para detectar nuevas herramientas y mejoras.