Пошаговое руководство. Управление версиями в Team Foundation с помощью командной строки

Статья
11/05/2008

Обновлен: Ноябрь 2007

В этом пошаговом руководстве описывается использование клиента командной строки Visual Studio Team System Team Foundation Server, tf.exe, для управления версиями.

В ходе этого пошагового руководства будут выполнены следующие задачи.

Создание рабочей области, в которой будет находиться ваша копия файлов с сервера управления версиями с последующим получением копии файлов с сервера.
Добавление файла на сервер, извлечение файла с сервера и изменение этого файла в рабочей области.
Возврат ожидающих изменений и создание набора изменений.
Возврат рабочей области к состоянию на определенный момент в прошлом путем получения с сервера файлов, отправленных туда при создании набора изменений.

Обязательные компоненты

Если можно подключиться к серверу Team Foundation Server и для этого имеются соответствующие разрешения, то управлять версиями можно с помощью командной строки, пакетного фала или файла сценария. Для этого необходимо воспользоваться служебной программой Командная строка Visual Studio 2008 или задать несколько переменных среды в текущей командной строке с помощью vsvars32, как описано в следующем примере. Дополнительные сведения о присоединении к командному проекту см. в разделе Пошаговое руководство. Присоединение к командному проекту.

Чтобы открыть командную строку Visual Studio 2008

Нажмите кнопку Пуск, последовательно выберите Все программы, Microsoft Visual Studio 2008, Набор средств Visual Studio и щелкните пункт Командная строка Visual Studio 2008.

Также можно запустить командный файл vsvars32, которых находится в каталоге установки Visual Studio; обычно это буква_диска:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools.

Необходимые разрешения

Для выполнения инструкций данного пошагового руководства требуются разрешения CreateWorkspace, Checkin и PendChange.

Создание рабочей области

Чтобы приступить к работе с системой управления версиями, нужно создать рабочую область. Рабочая область — это локальная копия файлов и папок с сервера. При добавлении, изменении, удалении, перемещении, переименовании и прочих изменениях любого элементы, находящегося в системе управления версиями, изменения происходят только в рабочей области, где можно безопасно проверить изменения и выполнить построение. При возврате изменения передаются на сервер и становятся доступными за пределами рабочей области.

Рабочая область состоит из нескольких сопоставлений. Каждое сопоставление связывает папку на сервере с папкой на диске локального компьютера. Чтобы получить с сервера локальную копию файлов, создайте новую рабочую область и укажите сопоставления для нее. Затем используйте команду get для наполнения рабочей области файлами.

Перед выполнением каких-либо команд Team Foundation (подсистема контроля версий) на компьютере необходимо создать рабочую область. Рабочая область позволяет передать все изменения на сервер путем возврата файлов.

Чтобы создать рабочую область для управления файлами, находящимися в системе управления версиями

Нажмите кнопку Пуск, последовательно выберите Все программы, Microsoft Visual Studio 2008, Набор средств Visual Studio и выберите пункт Командная строка Visual Studio 2008.
Введите mkdir c:\projects.
Введите cd c:\projects.

Введите tf workspace /new /s:servername, где servername — имя сервера Team Foundation Server, например, tf workspace /new /s:/team1server, и нажмите клавишу ВВОД.

Примечание.
Если подключение к этому серверу устанавливается впервые, нужно указать полный URL-адрес. Например, введите "http://team1server:8080".

В диалоговом окне Создать рабочую область, введите для новой рабочей области имя "cmdwalkthrough".
В столбце Папка в системе управления версиями выберите на сервере командный проект.

Для просмотра папок щелкните кнопку с многоточием (...).

Выбранная папка будет сопоставлена с папкой c:\projects, указанной в столбце Локальная папка.
Нажмите кнопку ОК.

Для просмотра всех рабочих областей, созданных на данном компьютере, введите в командной строке tf workspaces. Дополнительные сведения см. в разделе Команда "workspaces".

При создании рабочей области в системе сохраняется определение рабочей области. Определение рабочей области хранится на сервере Team Foundation Server, в определении перечислены все содержащиеся в рабочей области файлы, их версии и текущее состояние. Поскольку определения рабочих областей хранятся на сервере, любой пользователь, обладающий необходимыми разрешениями, может в точности воссоздать рабочую среду на своем компьютере, исключая ожидающие изменения. Дополнительные сведения см. в разделе Команда "get".

Добавьте и измените файл

После создания рабочей области можно указать, какие файлы нужно добавить в систему управления версиями. Можно изменить файлы перед возвратом изменений.

Чтобы подготовить файл для добавления в систему управления версиями

В командной строке введите notepad 314.cs, затем нажмите клавишу ВВОД.
При появлении в Блокноте запроса Создать новый файл? нажмите кнопку Да.
В Блокноте введите using System.IO;, сохраните изменения и закройте Блокнот.
В командной строке введите tf add 314.cs для добавления файла в список ожидающих изменений.
Введите tf status для подтверждения добавления файла 314.cs.

Эту команду можно использовать для просмотра всех ожидающих изменений в текущей рабочей области.

В Team Foundation нельзя добавить элемент на сервер управления версиями за один шаг. Сначала нужно добавить файл в набор ожидающих изменений в рабочей области. Затем следует передать все ожидающие изменения на сервер управления версиями.

Такой двухступенчатый процесс применяется в Team Foundation для того, чтобы обеспечить возможность проверки и компиляции кода перед его возвращением на сервер. Это также означает, что если Team Foundation не удается по какой-либо причине передать на сервер одно из изменений, но никакие изменения не будут переданы.

Возврат ожидающих изменений

При возврате набора ожидающих изменений в Team Foundation создается набор изменений.

Для возврата всех ожидающих изменений в рабочей области

В командной строке введите tf checkin.
В диалоговом окне Возврат в поле Примечание введите описание изменений и щелкните Вернуть.

Набор изменений — это логический контейнер, в который в Team Foundation помещается все, что связано с одной операцией возврата. Как правило, возвраты намного сложнее, чем в представленном здесь примере. Чаще всего возврат содержит множество файлов и папок. Таким образом, набор изменений представляет собой полный пакет работы, который можно загрузить в рабочую область как одно целое.

В набор изменений входят следующие компоненты.

Изменения исходных файлов и папок: дополнения, переименования, изменения, удаления и перемещения.
Связанные рабочие элементы, такие как ошибки.
Системные метаданные: номер набора изменений, автор, дата, время и т.д.
Примечания при возврате.

Затем мы создадим вторую версию файла 314.cs, чтобы узнать, как различные версии одного и того же файла хранятся на сервере управления версиями.

Чтобы создать новую версию файла, находящегося в системе управления версиями

В командной строке введите tf checkout 314.cs.
Введите notepad 314.cs.

В Блокноте добавьте новую строку после using System.IO;, затем введите using System.Windows;.

Примечание.
Здесь мы намеренно вносим в файл ошибку. Позднее мы узнаем, как вернуть файл в состояние, когда в нем еще не было ошибки.

Сохраните изменения и закройте Блокнот.
В командной строке введите tf checkin.
В диалоговом окне Возврат в поле Примечание введите примечание и щелкните Вернуть.

Ожидающее изменение в файле 314.cs возвращается на сервер в виде нового набора изменений. При этом на сервере управления версиями создается версия 2 файла 314.cs.

Возврат файла к предыдущей версии

Разработчикам программного обеспечения довольно часто приходится возвращать свою рабочую среду в состояние, например, двухмесячной давности, чтобы внести исправление в определенное построение. Имена наборов изменений помогают определять наборы, которые были возвращены в прошлом.

Номер набора изменений — это уникальный идентификатор связанных версий файлов и папок. Также номер набора изменений является номером версии для сервера управления версиями.

Поэтому можно вернуть рабочую область в точности в то же самое состояние, в котором она была при возврате неверной строки кода: using System.Windows;.

Для синхронизации рабочей области с набором изменений

В командной строке введите tf get /version:C<##>, где <##> — номер набора изменений, содержащего исходную версию файла 314.cs.

Примечание.
Для получения нужного набора изменений можно использовать команду history для файла 314.cs в командной строке: tf history 314.cs.

Команда Get получает рабочую копию всех сопоставленных файлов и вложенных папок с сервера в локальную рабочую область. Файлы принимаются именно в таком состоянии, в каком они были при создании набора изменений <##>. Если открыть файл 314.cs в Блокноте, там будет только одна строка: "using System.IO;".

См. также

Поделиться через