En esta lección se explica cómo empezar a trabajar en un repositorio git desde Visual Studio Code. Aunque podemos crear el repositorio con Visual Studio Code en nuestro ordenador y después subirlo a GitHub, en esta lección se explica cómo clonar en nuestro ordenador un repositorio ya existente en GitHub.
Requisitos
Para poder trabajar repositorios en GitHub con Visual Studio Code necesitamos:
Para clonar localmente con Visual Studio Code un repositorio de GitHub:
Cree un directorio donde se guardarán los repositorios:
Abra ese directorio en Visual Studio Code (menú Archivo > Abrir carpeta ...):
Para clonar el repositorio necesitará la URL de repositorio, que se puede copiar desde el propio repositorio haciendo clic en el botón "Code" y en el icono de copia situado a la derecha de la URL del repositorio.
En la captura de ejemplo, la URL de origen es https://github.com/NumaNigerio/prueba-2022-05.git
Esta URL es la misma URL que aparece en el navegador pero terminada en .git.
En Visual Studio abra la ventana de comandos con Ctrl+Mayús+p o con F1:
Escriba el comando git clone y pulse Intro:
Pegue la URL del repositorio de origen y pulse Intro:
Seleccione el directorio que contendrá la copia del repositorio ( en este caso el directorio Documentos > GitHub) y pulse "Seleccione la ubicación del repositorio":
En unos segundos Visual Studio Code ofrecerá la posibilidad de abrir la carpeta del repositorio clonado. Haga clic en "Abrir".
Visual Studio Code abrirá la carpeta del repositorio clonado, mostrando su contenido (en el ejemplo, el repositorio contiene únicamente el archivo README.md.
Crear archivo .gitignore
El archivo .gitignore contiene la lista de archivos que no van a formar parte del repositorio en GitHub aunque sí de nuestra copia local. Por ejemplo, los archivos de configuración de Visual Studio Code.
Cree el archivo .gitignore en la raíz del área de trabajo. Puede usar el siguiente ejemplo como plantilla:
# https://git-scm.com/docs/gitignore
# https://help.github.com/articles/ignoring-files
# Example .gitignore files: https://github.com/github/gitignore
/.vscode/
Realizar commits en el repositorio remoto
En git, un commit es un conjunto de cambios que se realizan en los archivos del repositorio (modificar, añadir, eliminar, mover, renombrar, etc).
En Visual Studio Code podemos realizar commits, que se guardan en el repositorio local. Para sincronizar nuestros cambios en el repositorio, debemos identificarnos como usuario del repositorio.
Como ejemplo de commit, añadiremos el archivo .gitignore al repositorio.
En Windows esa identificación se guarda como credencial de Windows, por lo que si estamos utilizando un ordenador al que tienen acceso otras personas, es muy importante que eliminemos la credencial antes de abandonar el ordenador o nos arriesgamos a que otro usuario nos suplante y acceda a los repositorios remotos.
El proceso en Visual Studio Code sería el siguiente:
Abra una ventana de Terminal e indique a git su nombre de usuario en GitHub y la dirección de correo del usuario vinculada a su cuenta en GitHub:
En Windows, esta información se guarda en el archivo C:\Users\UsuarioDeWindows\.gitconfig.
Visual Studio Code avisa de varias maneras de los cambios en los archivos con respecto al repositorio remoto.
El icono Control de código fuente nos indica el número de archivos con cambios (en este caso, 1)
En la barra del Explorador, VSCode indica qué archivos son nuevos (con la letra U), se han modificado (con la letra M) o eliminado (con la letra D) y los muestra con diferentes colores.
Si tenemos alguno de esos archivos abierto en el editor, la pestaña muestra también la letra U/M/D junto al nombre del archivo, también con diferentes colores.
Abra la barra lateral de Control de código fuente haciendo clic en el icono correspondiente. Se mostrará la lista de archivos con cambios:
Seleccione los archivos cuyos cambios formarán parte del commit (puede elegir todos los archivos modificados o sólo una parte) haciendo clic en el icono +:
Los archivos seleccionados se muestran en un apartado "Cambios almacenados provisionalmente" ("staged").
Escriba el mensaje descriptivo del commit en la caja superior y pulse Ctrl+Intro
Los archivos incluidos en el commit dejan de mostrarse en la barra lateral y en el contador del icono Control de código fuente:
Tanto en la barra lateral de Control de código fuente como en la barra inferior, Visual Studio Code nos avisa que el repositorio local ya no está sincronizado con el repositorio remoto y nos indica el número de commits de diferencia:
Haga clic en cualquiera de los dos sitios para sincronizar el repositorio remoto con el local.
Visual Studio Code mostrará un aviso indicando que al sincronizar se producirán cambios en el repositorio remoto. Para no volver a ver este aviso, haga clic en "De acuerdo, no volver a ver este mensaje":
Para poder modificar el repositorio remoto, debemos identificarnos. En Windows, a través del navegador GitHub nos solicita nuestro nombre y contraseña de usuario y los guarda en las credenciales de Windows para no tener que estar continuamente identificándonos.
Se abrirá una ventana que nos da opción de realizar este proceso. Haga clic en "Sign in with your browser".
El gestor de credenciales de Git nos muestra el nombre y correo electrónico del usuario. Haga clic en "Authorize GitCredentialManager":
Confirme la contraseña del usuario de GitHub:
Si todo funciona correctamente, se mostrará el mensaje correspondiente (la pestaña del navegador se puede cerrar).
Puede comprobar visitando el repositorio remoto en el navegador que se han realizado los cambios.
En el repositorio remoto se ha creado el fichero .gitignore.
El contador de commits aumenta.
Haciendo clic en el contador de commits se pueden ver todos los commits realizados en el repositorio (su fecha de realización, ficheros afectados, etc.)
Borrar credencial de Windows
La identificación en GitHub que utiliza Visual Studio Code se guarda como credencial de Windows, por lo que si estamos utilizando un ordenador al que tienen acceso otras personas, es muy importante que eliminemos la credencial antes de abandonar el ordenador o nos arriesgamos a que otro usuario nos suplante y acceda a los repositorios remotos.
Para borrar la credencial en Windows:
Haga clic en el menú de inicio y escriba "credenciales" para mostrar el icono de acceso al Administrador de credenciales. Haga clic en el icono:
Se abrirá el Administrador de credenciales. Haga clic en el icono "Credenciales de Windows":
En la lista de credenciales genéricas se mostrará la credencial de github. Haga clic en el icono derecho para mostrar sus detalles:
Para eliminar la credencial, haga clic en el enlace "Quitar"
En Windows esa identificación se guarda como credencial de Windows, por lo que si estamos utilizando un ordenador al que tienen acceso otras personas, es muy importante que eliminemos la credencial antes de abandonar el ordenador o nos arriesgamos a que otro usuario nos suplante y acceda a los repositorios remotos.
