Introducción a Git en Azure Repos

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Empiece a desarrollar código mediante Azure Repos y repositorios Git Puede usar comandos de Visual Studio o de Git para clonar un repositorio, definir ramas locales, confirmar y enviar cambios y sincronizar con otros usuarios. Si necesita crear o importar un repositorio, vea Creación de un repositorio Git en el proyecto o Importación de un repositorio Git.

Nota:

En este artículo se describe cómo usar Visual Studio para administrar repositorios Git de Azure Repos. Con unos procedimientos similares, se puede usar Visual Studio para administrar repositorios de GitHub. Para clonar un repositorio de GitHub, obtenga la dirección URL como se describe en Clonación de un repositorio.

Para obtener información general sobre el flujo de trabajo de Git, vea Tutorial de Git de Azure Repos.

Nota:

Visual Studio 2019, versión 16.8 y versiones posteriores, proporcionan un nuevo menú de Git para administrar el flujo de trabajo de Git con menos cambio de contexto que en Team Explorer. Los procedimientos de este artículo en la pestaña Visual Studio proporcionan información para usar la experiencia de Git, así como Team Explorer. Para obtener más información, consulte Comparación en paralelo de Git y Team Explorer.

Requisitos previos

• Repos debe estar habilitado en la configuración del proyecto de Azure DevOps. Si el centro de Repos y las páginas asociadas no se muestran, vea Activación o desactivación de un servicio de Azure DevOps para volver a habilitar Repos.

• Para ver el código en proyectos privados, debe ser miembro de un proyecto de Azure DevOps con el nivel de acceso Básico o superior. En el caso de los proyectos públicos, cualquiera puede ver el código.

  • Si no tiene un proyecto, cree uno o regístrese de forma gratuita.

  • Si no es miembro del proyecto, agréguese.

• Para clonar o contribuir al código de un proyecto privado, debe ser miembro del grupo de seguridad Colaboradores o tener el conjunto de permisos correspondientes. En el caso de los proyectos públicos, cualquiera puede clonar y contribuir código. Para obtener más información, consulte ¿Qué es un proyecto público?

  Nota:

  En el caso de los proyectos públicos, los usuarios con acceso de parte interesada tienen acceso total a Azure Repos.

Para obtener más información sobre los permisos y el acceso, consulte Permisos predeterminados de repositorios y ramas de Git y Acerca de los niveles de acceso.

Obtener el código

Puede clonar un repositorio Git remoto para crear una copia local del mismo. La clonación crea una copia del código fuente para poder trabajar con información de control de versiones, de forma que Git pueda administrar el código fuente.

Si prefiere crear un repositorio local sin clonación, vea Creación de un repositorio de Git. Tras crear el repositorio local, puede continuar y confirmar, compartir y sincronizar su trabajo.

Visual Studio 2022

Visual Studio 2022 proporciona una experiencia de control de versiones de Git mediante el menú Git, Cambios de Git y los menús contextuales del Explorador de soluciones. En Visual Studio 2019, versión 16.8, también se ofrece la interfaz de usuario de Git Team Explorer. Parar obtener más información, vea la pestaña Visual Studio 2019: Team Explorer.

1. En el menú Git de la barra de menús, seleccione Clonar repositorio...

   

2. En la ventana Clonar un repositorio, escriba la ubicación del repositorio remoto y la ruta de acceso de la carpeta del repositorio clonado. Si no conoce la ubicación del repositorio remoto, seleccione Azure DevOps de entre las opciones que se muestran en Examinar un repositorio.

   

3. Seleccione Clonar. Después de clonar un repositorio Git, Visual Studio detecta el repositorio y lo agrega a la lista de repositorios locales en el menú de Git.

   

Nota:

Con Azure DevOps Services, el formato de la dirección URL del proyecto es dev.azure.com/{your organization}/{your project}. Pero todavía se admite el formato anterior que hace referencia al formato visualstudio.com. Para obtener más información, vea la sección Cambio de las organizaciones existentes para usar la nueva dirección URL de nombre de dominio de Introducción a Azure DevOps.

Visual Studio 2019: menú Git

Visual Studio 2019 proporciona una experiencia de control de versiones de Git mediante el menú Git, Cambios de Git y los menús contextuales del Explorador de soluciones.

1. En el menú Git de la barra de menús, seleccione Clonar repositorio...

   

2. En la ventana Clonar un repositorio, escriba la ubicación del repositorio remoto y la ruta de acceso de la carpeta del repositorio clonado. Si no conoce la ubicación del repositorio remoto, seleccione Azure DevOps de entre las opciones que se muestran en Examinar un repositorio.

   

3. Seleccione Clonar. Después de clonar un repositorio Git, Visual Studio detecta el repositorio y lo agrega a la lista de repositorios locales en el menú de Git.

   

Nota:

Con Azure DevOps Services, el formato de la dirección URL del proyecto es dev.azure.com/{your organization}/{your project}. Pero todavía se admite el formato anterior que hace referencia al formato visualstudio.com. Para obtener más información, vea la sección Cambio de las organizaciones existentes para usar la nueva dirección URL de nombre de dominio de Introducción a Azure DevOps.

Visual Studio 2019: Team Explorer

Visual Studio 2019 versión 16.8 y las versiones posteriores proporciona una experiencia de control de versiones de Git, al tiempo que mantiene la interfaz de usuario de Git de Team Explorer. Puede usar ejecutar características de Git indistintamente desde cualquier interfaz.

Nota:

Una de las ventajas de conectarse a un proyecto desde Team Explorer es obtener acceso al centro de elementos de trabajo. Para obtener información general sobre las características de Team Explorer, vea Navegación en Team Explorer de Visual Studio.

1. En Team Explorer, seleccione Conectar para abrir la página Conectar y, después, seleccione Administrar conexiones>Conectarse al proyecto.

   

2. En la ventana Conectar a un proyecto, seleccione el repositorio que quiera clonar y, seguidamente, Clonar. Si no ve el repositorio, seleccione Agregar una instancia de Azure DevOps Server para agregar un servidor que hospede un repositorio. Puede filtrar la lista para encontrar el repositorio.

   

3. Verifique la ubicación del repositorio clonado en el equipo y, después, seleccione Clonar.

Nota:

Con Azure DevOps Services, el formato de la dirección URL del proyecto es dev.azure.com/{your organization}/{your project}. Pero todavía se admite el formato anterior que hace referencia al formato visualstudio.com. Para obtener más información, vea la sección Cambio de las organizaciones existentes para usar la nueva dirección URL de nombre de dominio de Introducción a Azure DevOps.

Línea de comandos de Git

1. Descargue e instale Git y el Administrador de credenciales de Git de su plataforma.

2. Abra el portal web de Azure DevOps Services en el explorador; para ello, vaya a https://<your account name>.visualstudio.com.

3. Abra el portal web de Azure DevOps Services en el explorador yendo a https://<your account name>.visualstudio.com y busque el repositorio Git. Copie la dirección URL de clonación del elemento emergente Clonar.

   

   Nota:

   Con Azure DevOps Services, el formato de la dirección URL del proyecto es dev.azure.com/{your organization}/{your project}. Pero todavía se admite el formato anterior que hace referencia al formato visualstudio.com. Para obtener más información, vea la sección Cambio de las organizaciones existentes para usar la nueva dirección URL de nombre de dominio de Introducción a Azure DevOps.

4. En el símbolo del sistema, vaya a la carpeta donde quiera almacenar el código en el equipo local.

5. En el símbolo del sistema, ejecute git clone seguido de la dirección URL de clonación, como se muestra en el siguiente ejemplo.

    > git clone https://dev.azure.com/fabrikam-fiber/_git/FabrikamFiber
   

   Git descarga y crea su propia copia del código en una carpeta nueva.

Confirmación del trabajo

Las ramas Git aíslan los cambios del resto de trabajo del proyecto. El flujo de trabajo de Git recomendado es usar una nueva rama por cada característica o corrección de errores con los que se trabaje. Las confirmaciones se realizan en el repositorio Git local para guardar los cambios en esa rama.

Visual Studio 2022

1. En el menú Git de la barra de menús, seleccione Nueva rama... para abrir la ventana Crear una rama nueva.

   

2. En la ventana Crear una rama nueva, escriba un nombre de rama descriptivo para que otros usuarios sepan qué trabajo contiene la rama. Visual Studio crea la rama a partir de la rama actual de forma predeterminada. La casilla Desproteger rama le lleva automáticamente a la rama recién creada. Seleccione Crear.

   

3. Agregue un archivo README.md al repositorio clonado. En Explorador de soluciones, puede examinar el contenido del repositorio mediante la Vista de carpetas o abrir soluciones de Visual Studio en el repositorio. Git lleva un seguimiento de los cambios realizados dentro y fuera de Visual Studio.

4. Cuando esté satisfecho con los cambios, guárdelos en Git mediante una confirmación. En la ventana Cambios de GIT, escriba un mensaje que describa los cambios y, después, seleccione Confirmar todo. Confirmar todo confirma los cambios "unstaged" y omite el área de adición al "stage". Puede elegir agregar al "stage" todos los archivos antes de la confirmación seleccionando el botón + Agregar todo al "stage" situado en la parte superior de la sección Cambios en la ventana Cambios de Git.

   

   Seleccione el vínculo de información de confirmación para obtener más detalles sobre la confirmación.

   

Nota:

Si tiene varios archivos y no quiere confirmarlos todos, puede hacer clic con el botón derecho en cada uno de ellos y elegir Agregar al "stage". Cuando haya agregado al "stage" todos los archivos que quiera confirmar, seleccione Hacer "commit" de cambios "staged". Hacer "commit" de cambios "staged" reemplaza a Confirmar todo cuando los cambios se agregan al "stage" manualmente.

Visual Studio 2019: menú Git

1. En el menú Git de la barra de menús, seleccione Nueva rama... para abrir la ventana Crear una rama nueva.

   

2. En la ventana Crear una rama nueva, escriba un nombre de rama descriptivo para que otros usuarios sepan qué trabajo contiene la rama. Visual Studio crea la rama a partir de la rama actual de forma predeterminada. La casilla Desproteger rama le lleva automáticamente a la rama recién creada. Seleccione Crear.

   

3. Agregue un archivo README.md al repositorio clonado. En Explorador de soluciones, puede examinar el contenido del repositorio mediante la Vista de carpetas o abrir soluciones de Visual Studio en el repositorio. Git lleva un seguimiento de los cambios realizados dentro y fuera de Visual Studio.

4. Cuando esté satisfecho con los cambios, guárdelos en Git mediante una confirmación. En la ventana Cambios de GIT, escriba un mensaje que describa los cambios y, después, seleccione Confirmar todo. Confirmar todo confirma los cambios "unstaged" y omite el área de adición al "stage". Puede elegir agregar al "stage" todos los archivos antes de la confirmación seleccionando el botón + Agregar todo al "stage" situado en la parte superior de la sección Cambios en la ventana Cambios de Git.

   

   Seleccione el vínculo de información de confirmación para obtener más detalles sobre la confirmación.

   

Nota:

Si tiene varios archivos y no quiere confirmarlos todos, puede hacer clic con el botón derecho en cada uno de ellos y elegir Agregar al "stage". Cuando haya agregado al "stage" todos los archivos que quiera confirmar, seleccione Hacer "commit" de cambios "staged". Hacer "commit" de cambios "staged" reemplaza a Confirmar todo cuando los cambios se agregan al "stage" manualmente.

Visual Studio 2019: Team Explorer

1. En Team Explorer, seleccione el botón Inicio y seleccione Ramas.

   

2. Haga clic con el botón derecho en la rama predeterminada, a menudo denominada main, y seleccione Nueva rama local de…

   

3. Escriba un nombre de rama descriptivo para que otros usuarios sepan qué trabajo contiene la rama. Seleccione Crear rama.

   

4. Agregue un archivo README.md al repositorio clonado. En la vista Inicio de Team Explorer, puede examinar el contenido del repositorio mediante la Vista de carpetas o abrir soluciones de Visual Studio en el repositorio. Git lleva un seguimiento de los cambios realizados dentro y fuera de Visual Studio.

5. Cuando esté satisfecho con los cambios, guárdelos en Git mediante una confirmación. Para abrir la vista Cambios de Team Explorer, seleccione el botón Inicio y, luego, Cambios.

   

6. Escriba un mensaje que describa la confirmación y seleccione Confirmar todo.

   

Nota:

Si tiene varios archivos y no quiere confirmarlos todos, puede hacer clic con el botón derecho en cada uno de ellos y elegir Agregar al "stage". Cuando haya agregado al "stage" todos los archivos que quiera confirmar, seleccione Hacer "commit" de cambios "staged". Hacer "commit" de cambios "staged" reemplaza a Confirmar todo cuando los cambios se agregan al "stage" manualmente.

Línea de comandos de Git

1. Cree una rama en la que realizar los cambios en el código. Si está colaborando con alguien que usa una rama que ha creado, puede ir directamente al paso de git checkout siguiente.

    > git branch ReadMeFix
   

   Elija un nombre de rama descriptivo para su trabajo, para recordarle a usted y a los demás qué tipo de trabajo hay en la rama.

2. Desproteja la rama para poder empezar a trabajar en ella.

    > git checkout ReadMeFix
   

   También puede usar el comando checkout para empezar a trabajar en una rama en la que ya trabajan otros miembros del equipo.

3. Haga cambios en el código con las herramientas de su preferencia.

4. Cuando esté satisfecho con los cambios, y aunque no esté listo para compartir el trabajo, guárdelos en Git mediante una confirmación. Los cambios no se compartirán hasta que se envíen, como se describe en la sección siguiente.

    > git commit -a -m "Descriptive message"
   

   Este comando guarda los cambios localmente en una nueva confirmación en Git. Asegúrese de incluir un breve mensaje en la confirmación en el que se describan los cambios después de -m.

Compartir los cambios

Una vez que hayan agregado una o varias confirmaciones a una rama y esté todo listo para compartir esos cambios con otros usuarios, inserte las confirmaciones para que los demás puedan verlas.

Una vez insertadas las confirmaciones, puede crear una solicitud de incorporación de cambios. Una solicitud de incorporación de cambios sirve para que otros usuarios sepan que queremos que los cambios se revisen. Tras aprobar los cambios, una solicitud de incorporación de cambios suele agregarlos a la rama predeterminada del repositorio remoto.

Visual Studio 2022

1. En la ventana Cambios de Git, seleccione el botón de inserción de flecha arriba para insertar la confirmación.

   

   Los cambios también se pueden enviar desde la ventana Repositorio Git. Para abrir la ventana Repositorio Git, seleccione el vínculo de elementos salientes/entrantes de la ventana Cambios de Git.

   

   Los cambios también se pueden enviar desde el menú Git de la barra de menús.

   

2. Cree una solicitud de incorporación de cambios para que otros puedan revisar los cambios. Si acaba de enviar los cambios desde la ventana Cambios de Git, puede seleccionar el vínculo Crear una solicitud de incorporación de cambios para abrir un explorador web, donde puede crear una PR en el portal web de Azure Repos.

   

   Si acaba de enviar los cambios desde la ventana Repositorio Git, también puede seleccionar el vínculo Crear una solicitud de incorporación de cambios en la parte superior de esa ventana.

   

   También puede hacer clic con el botón derecho en cualquier rama en la ventana Repositorio Git y seleccionar Crear solicitud de incorporación de cambios.

   

Cuando se abra la PR en el portal web de Azure Repos, confirme las ramas de origen y de destino. En este ejemplo, queremos combinar confirmaciones de la rama add-readme-file en la rama main. Escriba un título y una descripción opcional, especifique los revisores, asocie elementos de trabajo (opcional) y seleccione Crear.

Para obtener más información sobre las solicitudes de incorporación de cambios, vea el tutorial Solicitud de incorporación de cambios.

Visual Studio 2019: menú Git

1. En la ventana Cambios de Git, seleccione el botón de flecha arriba de envío de cambios para insertar la confirmación.

   

   Los cambios también se pueden enviar desde la ventana Repositorio Git. Para abrir la ventana Repositorio Git, seleccione el vínculo de elementos salientes/entrantes de la ventana Cambios de Git.

   

   Los cambios también se pueden enviar desde el menú Git de la barra de menús.

   

2. Cree una solicitud de incorporación de cambios para que otros puedan revisar los cambios. Si acaba de enviar los cambios desde la ventana Cambios de Git, puede seleccionar el vínculo Crear una solicitud de incorporación de cambios para abrir un explorador web, donde puede crear una PR en el portal web de Azure Repos.

   

   Si acaba de enviar los cambios desde la ventana Repositorio Git, también puede seleccionar el vínculo Crear una solicitud de incorporación de cambios en la parte superior de esa ventana.

   

   También puede hacer clic con el botón derecho en cualquier rama en la ventana Repositorio Git y seleccionar Crear solicitud de incorporación de cambios.

   

Cuando se abra la PR en el portal web de Azure Repos, confirme las ramas de origen y de destino. En este ejemplo, queremos combinar confirmaciones de la rama add-readme-file en la rama main. Escriba un título y una descripción opcional, especifique los revisores, asocie elementos de trabajo (opcional) y seleccione Crear.

Para obtener más información sobre las solicitudes de incorporación de cambios, vea el tutorial Solicitud de incorporación de cambios.

Visual Studio 2019: Team Explorer

1. En Team Explorer, seleccione Inicio y, luego, Sincronización para abrir Sincronización.

   

   También puede ir a la vista Sincronización desde Cambios si selecciona Sincronizar inmediatamente después de realizar una confirmación.

   

2. En la vista Sincronización, seleccione Insertar para cargar la confirmación en el repositorio remoto. Si es su primera inserción en el repositorio, verá el mensaje: The current branch does not track a remote branch..., que le informa de que la confirmación se ha insertado en una nueva rama del repositorio remoto y de que las confirmaciones futuras insertadas desde la rama actual se cargarán en esa rama remota.

   

3. Cree una solicitud de incorporación de cambios para que otros puedan revisar los cambios. Abra Solicitudes de incorporación de cambios en Team Explorer; para ello, seleccione Inicio y, luego, Solicitudes de incorporación de cambios.

   

4. En Solicitudes de incorporación de cambios, puede ver las solicitudes de incorporación de cambios que haya abierto o que se le hayan asignado. También puede crear nuevas solicitudes de incorporación de cambios. Seleccione Nueva solicitud de incorporación de cambios para abrir un explorador web, donde puede crear una PR en el portal web de Azure Repos.

   

Cuando se abra la PR en el portal web de Azure Repos, confirme las ramas de origen y de destino. En este ejemplo, queremos combinar confirmaciones de la rama add-readme-file en la rama main. Escriba un título y una descripción opcional, especifique los revisores, asocie elementos de trabajo (opcional) y seleccione Crear.

Para obtener más información sobre las solicitudes de incorporación de cambios, vea el tutorial Solicitud de incorporación de cambios.

Línea de comandos de Git

1. Envíe los cambios a la rama para que los demás puedan ver los cambios que ha guardado.

    > git push -u origin ReadMeFix
   

2. Abra el proyecto en el portal web y vaya al repositorio en la pestaña Código. Seleccione Crear una solicitud de incorporación de cambios para crear una solicitud de incorporación de cambios para la rama a la que acaba de enviar cambios.

   

3. Compruebe las ramas. En este ejemplo, queremos combinar las confirmaciones de la rama ReadMeFix en la rama main. Escriba un título y una descripción opcional, especifique los revisores, asocie elementos de trabajo (opcional) y seleccione Crear.

   

4. Una vez aprobados los cambios, complete la solicitud de incorporación de cambios. Una solicitud de incorporación de cambios completa agrega los cambios de la rama a la rama principal del código.

   Para obtener más información sobre las solicitudes de incorporación de cambios, vea el tutorial Solicitud de incorporación de cambios.

Sincronización con otros usuarios

Puede mantener sincronizadas las ramas locales con sus homólogas remotas mediante la incorporación de cambios de confirmaciones creadas por otros usuarios. Aunque Git es bueno a la hora de combinar los cambios entrantes con los suyos, a veces es posible que tenga que resolver un conflicto de combinación. Mientras trabaja en su rama de características, es recomendable cambiar periódicamente a la rama main e incorporar los cambios de las nuevas confirmaciones para mantenerla actualizada con la rama main remota.

Visual Studio 2022

En la ventana Cambios de Git, puede mantener la rama local actualizada con su homólogo remoto usando los botones Recuperar cambios, Incorporar cambios, Enviar cambios y Sincronizar.

En la captura de pantalla anterior, los controles de botón son, de izquierda a derecha:

• Recuperar cambios, que descarga las confirmaciones remotas que no están en la rama local, pero no las fusiona mediante combinación.
• Incorporar cambios, que realiza una recuperación de cambios y fusiona mediante combinación las confirmaciones descargadas en la rama local.
• Enviar cambios, que carga las confirmaciones no insertadas en el repositorio remoto, donde se agregan a la rama remota correspondiente.
• Sincronizar, que realiza una incorporación de cambios y, luego, un envío de cambios.

También puede seleccionar Recuperar cambios, Incorporar cambios, Enviar cambios y Sincronizar en el menú de Git.

Visual Studio 2019: menú Git

En la ventana Cambios de Git, puede mantener la rama local actualizada con su homólogo remoto usando los botones Recuperar cambios, Incorporar cambios, Enviar cambios y Sincronizar.

En la captura de pantalla anterior, los controles de botón son, de izquierda a derecha:

• Recuperar cambios, que descarga las confirmaciones remotas que no están en la rama local, pero no las fusiona mediante combinación.
• Incorporar cambios, que realiza una recuperación de cambios y fusiona mediante combinación las confirmaciones descargadas en la rama local.
• Enviar cambios, que carga las confirmaciones no insertadas en el repositorio remoto, donde se agregan a la rama remota correspondiente.
• Sincronizar, que realiza una incorporación de cambios y, luego, un envío de cambios.

También puede seleccionar Recuperar cambios, Incorporar cambios, Enviar cambios y Sincronizar en el menú de Git.

Visual Studio 2019: Team Explorer

1. En Team Explorer, seleccione Inicio y, luego, Sincronización para abrir Sincronización.

   

2. Puede descargar los cambios más recientes realizados en la rama usando el vínculo Incorporar cambios. Hay dos vínculos Incorporar cambios, uno cerca de la parte superior y otro en la sección Confirmaciones entrantes. Puede usar cualquiera, porque ambos hacen lo mismo.

   

Línea de comandos de Git

1. Cambie a la rama donde quiera descargar los cambios realizados por otros usuarios.

    > git checkout ReadMeFix
   

   En este ejemplo, incorporaremos los cambios realizados por otros usuarios del equipo en la rama ReadMeFix a la copia local de la rama.

2. Incorpore los cambios realizados por otros usuarios a la rama local.

    > git pull
   

   Git descarga los cambios y los fusiona mediante combinación con los cambios que usted haya realizado en la rama local.

Artículos relacionados

• Preguntas más frecuentes sobre Git
• Experiencia de Git en Visual Studio
• Comparación en paralelo de Git y Team Explorer