Tutorial: Trabajar con el control de versiones de Team Foundation desde la línea de comandos

Artículo
10/07/2008

Actualización: noviembre 2007

En este tutorial se describe cómo utilizar el cliente de línea de comandos de Visual Studio Team System Team Foundation Server, tf.exe, para realizar operaciones de control de versiones.

Durante este tutorial, realizará las tareas siguientes:

Cree el área de trabajo donde residirá su copia personal de archivos en el servidor del control de versiones y, a continuación, obtenga una copia del código fuente del servidor.
Agregue un archivo al servidor y, a continuación, desproteja el archivo del servidor y edítelo en el área de trabajo.
Proteger los cambios pendientes y crear un conjunto de cambios.
Devolver el área de trabajo a un estado concreto recuperando el código fuente del servidor tal como estaba en el momento en que se creó un conjunto de cambios determinado.

Requisitos previos

Si puede establecer una conexión con un servidor Team Foundation Server y dispone de los permisos necesarios, puede ejecutar comandos de control de versiones en un símbolo del sistema, un archivo por lotes o un archivo de script. Para ello, deberá usar la utilidad Símbolo del sistema de Visual Studio 2008 o bien establecer varias variables de entorno en el símbolo del sistema actual utilizando vsvars32 como se describe en el ejemplo siguiente. Para obtener más información sobre cómo unirse a un proyecto de equipo, vea Tutorial: Unirse a un proyecto de equipo.

Para abrir el símbolo del sistema de Visual Studio 2008

Haga clic en Inicio, en Todos los programas, elija Microsoft Visual Studio 2008, Visual Studio Tools y haga clic en Símbolo del sistema de Visual Studio 2008.

O ejecute vsvars32 en la ruta de instalación de Visual Studio, que suele ser Unidad:\Archivos de programa\Microsoft Visual Studio 9.0\Common7\Tools.

Permisos necesarios

Para realizar este tutorial, debe tener los permisos CreateWorkspace, Checkin y PendChange.

Crear un área de trabajo

Para empezar a trabajar con el control de versiones, debe establecer un área de trabajo. Un área de trabajo es una copia local de los archivos y carpetas del servidor. Al agregar, editar, eliminar, mover, cambiar el nombre o modificar de algún modo cualquier elemento bajo control de versiones, los cambios se aíslan en el área de trabajo, donde se pueden generar y probar de forma segura. Cuando se realiza una protección, estos cambios se confirman en el servidor y están disponibles fuera del área de trabajo.

Un área de trabajo se compone de una serie de asignaciones. Cada asignación asocia una carpeta del servidor junto a una carpeta local en el disco. Para obtener una copia local de los archivos del servidor, cree una nueva área de trabajo y especifique las asignaciones para la misma. A continuación, utilice el comando get para rellenar el área de trabajo con archivos de código fuente.

Para poder ejecutar cualquier comando de Control de versiones de Team Foundation en el equipo, debe crear un área de trabajo. El área de trabajo conserva los resultados de las operaciones y permite confirmarlos en el servidor protegiéndolos.

Para crear un área de trabajo a fin de administrar los archivos bajo control de versiones

Haga clic en Inicio, en Todos los programas, elija Microsoft Visual Studio 2008, Visual Studio Tools y haga clic en Símbolo del sistema de Visual Studio 2008.
Escriba mkdir c:\projects.
Escriba cd c:\projects.
Escriba tf workspace /new /s:servername, donde servername es el nombre del servidor Team Foundation Server, por ejemplo, tf workspace /new /s:/team1server y presione ENTRAR.

Nota:

Si es la primera vez que se conecta al servidor, debe especificar la dirección URL completa. Por ejemplo, especifique "http://servidorTeam1:8080".
En el cuadro de diálogo Crear área de trabajo, escriba un nombre para la nueva área de trabajo como, por ejemplo, "tutorialcmd".
En la columna Carpeta de control de código fuente, seleccione un proyecto de equipo del servidor.

Puede hacer clic en los puntos suspensivos (...) para examinar las carpetas de servidor.

La carpeta que seleccione se asignará a la carpeta c:\projects que se muestra en la columna Carpeta local.
Haga clic en Aceptar.

Nota:
Si es la primera vez que se conecta al servidor, debe especificar la dirección URL completa. Por ejemplo, especifique "http://servidorTeam1:8080".

Puede ver todas las áreas de trabajo creadas en el equipo actual escribiendo tf workspaces en el símbolo del sistema. Para obtener más información, vea Comando workspaces.

Al crear un área de trabajo, el sistema mantiene una definición del área de trabajo para esa área de trabajo. Team Foundation Server almacena la definición del área de trabajo y muestra todos los archivos del área de trabajo, la versión en la que se basa cada uno, así como su estado actual. Como el servidor almacena las definiciones de las áreas de trabajo, los usuarios que tengan los permisos correctos pueden duplicar en su equipo el entorno de trabajo exacto de otro usuario, excepto los cambios pendientes. Para obtener más información sobre cómo hacerlo, vea Comando get.

Agregar y editar un archivo

Después de crear un área de trabajo, puede especificar qué archivos desea agregar al control de versiones. A continuación, puede editarlos antes de proteger los cambios.

Para preparar un archivo para agregarlo al control de versiones

En el símbolo del sistema, escriba notepad 314.cs y presione ENTRAR.
Cuando el Bloc de notas le formule la pregunta ¿Desea crear un nuevo archivo?, haga clic en Sí.
En el Bloc de notas, escriba using System.IO;, guarde los cambios y cierre el programa.
En el símbolo del sistema, escriba tf add 314.cs para agregar el archivo a la lista de cambios pendientes.
Escriba tf status para confirmar la adición pendiente de 314.cs.

Este comando se puede utilizar para ver todos los cambios pendientes en el área de trabajo actual.

En Team Foundation no se puede agregar un elemento al servidor del control de versiones en un único paso. Primero, debe agregar un archivo al conjunto de cambios pendientes del área de trabajo. A continuación, debe enviar todos los cambios pendientes al servidor del control de versiones como una única unidad.

Team Foundation exige este proceso de adición del archivo en dos pasos para asegurarse de que se puede probar y compilar el código en el contexto antes de protegerlo en el servidor. También significa que si, por alguna razón, Team Foundation no pueden confirmar alguno de los cambios en el servidor, no se confirmará ninguno de ellos.

Proteger los cambios pendientes

Cuando se protege un conjunto de cambios pendientes, Team Foundation crea un conjunto de cambios.

Para proteger todos los cambios pendientes del área de trabajo

En el símbolo del sistema, escriba tf checkin.
En el cuadro de diálogo Proteger, escriba un comentario que describa la naturaleza de los cambios en el cuadro Comentario y haga clic en Proteger.

Un conjunto de cambios es un contenedor lógico en el que Team Foundation asocia todo lo relacionado con una sola operación de protección. La mayoría de las protecciones presentan mayor complejidad que el sencillo ejemplo que aquí se proporciona. Con frecuencia, una protección implica cambios en varios archivos y carpetas. Por lo tanto, un conjunto de cambios representa un paquete completo de trabajo que se puede llevar al área de trabajo como una sola unidad.

Un conjunto de cambios se compone de:

Revisiones del código fuente y las carpetas, como por ejemplo, adiciones, cambios de nombre, ediciones, eliminaciones y traslados.
Elementos de trabajo relacionados, como por ejemplo, errores.
Metadatos del sistema, como por ejemplo, el número, el autor, y la fecha y hora del conjunto de cambios, entre otros.
Notas y comentarios relativos a la protección.

A continuación, creará una segunda versión del archivo 314.cs para examinar cómo se almacenan las distintas versiones de un archivo en el servidor del control de versiones.

Para crear una nueva versión de un archivo bajo control de versiones

En el símbolo del sistema, escriba tf checkout 314.cs.
Escriba notepad 314.cs.
En el Bloc de notas, agregue una nueva línea después de using System.IO; y, a continuación, escriba using System.Windows;.

Nota:

Este paso produce un error de forma intencionada. En un paso posterior se muestra cómo revertir la versión sin error del archivo.
Guarde los cambios y cierre el Bloc de notas.
En el símbolo del sistema, escriba tf checkin.
En el cuadro de diálogo Proteger, escriba un comentario en el cuadro Comentario y haga clic en Proteger.

El cambio pendiente en el archivo 314.cs se protege en el servidor como un nuevo conjunto de cambios. También se crea la versión 2 del archivo 314.cs en el servidor del control de versiones.

Nota:
Este paso produce un error de forma intencionada. En un paso posterior se muestra cómo revertir la versión sin error del archivo.

Devolver un archivo a una versión anterior

Con frecuencia, a los desarrolladores de software se les pide que devuelvan sus entornos de trabajo a la forma en que éstos estaban hace dos meses y solucionen un determinado problema de una generación concreta. Los números del conjunto de cambios ayudan a identificar conjuntos de cambios concretos protegidos a lo largo del tiempo.

El número del conjunto de cambios es un identificador único de un conjunto de revisiones de archivos y carpetas relacionados. El número del conjunto de cambios también es un número de versión para todo el servidor de control de versiones en una fecha y una hora concretas.

Por lo tanto, es posible recuperar el área de trabajo con el estado exacto que tenía el servidor al proteger la línea de código problemática, using System.Windows;.

Para sincronizar el área de trabajo con un conjunto de cambios

En el símbolo del sistema, escriba tf get /version:C<##>, donde <##> es el número del conjunto de cambios que contiene la versión original de 314.cs.

Nota:

El conjunto de cambios correcto puede determinarse utilizando el comando del historial con el archivo 314.cs; por ejemplo, en la línea de comandos, escriba tf history 314.cs.

Nota:
El conjunto de cambios correcto puede determinarse utilizando el comando del historial con el archivo 314.cs; por ejemplo, en la línea de comandos, escriba tf history 314.cs.

El comando Get recupera una copia de trabajo de todas las subcarpetas y archivos asignados del servidor en el área de trabajo local. Los archivos se recuperan tal y como estaban en el momento en que se creó el conjunto de cambios <##>. Si abre ahora 314.cs en el Bloc de notas, verá que sólo aparece una línea, "using System.IO;."

Vea también

Compartir a través de