Команда Start (Team Foundation Build)
Команда start используется для запуска настроенного определения построения для Team Foundation Build.
Необходимые разрешения
Чтобы использовать команду start, необходимо иметь разрешения безопасности Постановка построений в очередь и Просмотр определения построения в Visual Studio Team Foundation Server со значением Разрешить. Кроме того, учетная запись службы уровня приложений и учетная запись службы Team Foundation Build должны иметь разрешения на чтение и запись в папке размещения построений. Дополнтельную информацию см. в разделе Разрешения Team Foundation Server
TFSBuild start /collection:teamProjectCollectionUrl
/builddefinition:definitionSpec [/droplocation:droplocation] [/getoption:getoption]
[/customgetversion:versionSpec] [/priority:priority] [/requestedfor:userName]
[/msbuildarguments:args] [/shelveset:shelvesetName [/checkin]]
[/silent] [/queue]
TFSBuild start teamProjectCollectionUrl teamProject definitionName
[/droplocation:droplocation] [/getoption:getoption] [priority:priority]
[/customgetversion:versionSpec] [/requestedfor:userName]
[/shelveset:shelvesetName [/checkin]]
[/msbuildarguments:args] [/silent] [/queue]
Параметры
Аргумент |
Описание |
|---|---|
teamProjectCollectionUrl |
URL-адрес коллекции командного проекта, содержащей решения и проекты, для которых выполняется построение. |
teamProject |
Имя командного проекта, содержащего решения и проекты, для которых выполняется построение. |
definitionName |
Имя определения построения в командном проекте, которое должно использоваться для построения. |
droplocation |
Путь к общедоступной папке, в которой двоичные файлы построений и файлы журналов сохраняются после завершения построения. Например, папка \\server\share. Используется с параметром /droplocation. |
getoption |
Используется с параметром /getoption. Допустимые значения — LatestOnQueue, LatestOnBuild и Custom. |
versionSpec |
|
priority |
Приоритет очереди для определения построения. Данный аргумент можно использовать с параметром /priority. Допустимые значения — Low, BelowNormal, Normal, AboveNormal и High. |
userName |
Имя пользователя, которого требуется связать с завершенным построением. |
args |
Аргументы командной строки, которые передаются в MSBuild. |
shelvesetName |
Укажите имя набора отложенных изменений при запуске частного построения или построения, которое определено с использованием триггера условного возврата. |
Параметр |
Описание |
|---|---|
/collection |
Указывает коллекцию командных проектов. |
/droplocation |
Необязательный. Задает каталог для процесса построения. Может использоваться сокращение /d. По умолчанию используется каталог построения, указанный в определении построения. .gif "Примечание") Примечание
При выборе каталога построения следует убедиться в наличии достаточного пространства для построения, так как недостаток места приведет к отмене построения.
|
/getoption |
Необязательный. Указывает файлы, которые требуется получить из системы управления версиями. |
/customgetversion |
Необязательный. Задает пользовательскую версию файлов, которую нужно получить, если параметру /getoption присвоить значение Custom. |
/priority |
Необязательный. Задает приоритет очереди построения. |
/requestedfor |
Необязательный. Указывает пользователя, для которого было запрошено построение. |
/msbuildarguments |
Необязательный. Указывает аргументы командной строки, которые передаются в MSBuild. Общий формат имеет следующий вид: /msbuildarguments:"/p:SomeProperty=SomeValue /t:MySpecialTarget" |
/shelveset |
Необязательный. Укажите имя набора отложенных изменений при запуске частного построения или построения, которое определено с использованием триггера условного возврата. |
/checkin |
Необязательный. Этот параметр применяется только в случае запуска построения, определенного с триггером условного возврата. Задайте этот параметр, если требуется, чтобы система возвращала файлы, если построение выполнено успешно. |
/silent |
Необязательный. При указании данного параметра данные вывода не записываются в окне командной строки, пока выполняется построение. |
/queue |
Вставляет запрос на запуск построения в очередь построения и сразу же возвращает. |
Заметки
Команда командной строки Team Foundation TFSBuild start может использоваться со службой планировщика заданий, чтобы выполнять периодические или ночные построения.
Если строится несколько решений, то при определении порядка построения следует учитывать зависимости решений друг от друга. Например, настройте, чтобы Решение1 строилось раньше Решения2, если Решение2 зависит от Решения1.
По умолчанию транзитный каталог не создается автоматически как общедоступная папка. Таким образом, в нем нельзя публиковать построения и результаты тестов. Необходимо вручную настроить общедоступную папку и добавить разрешения на запись для каталога Windows и разрешения на совместное использование для учетной записи, которая запускает службу Team Build Service для сохранения построения, и для учетной записи инженера-испытателя для публикации результатов теста.
Пример
Следующий пример создает тип построения Nightlies в командном проекте AdventureWorks в коллекции командных проектов по адресу http://myserver:8080/DefaultCollection. Итоговое построение располагается в каталоге BuildDrop.
>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"
Следующий пример создает тип построения Nightlies в командном проекте AdventureWorks в коллекции по адресу http://myserver:8080/DefaultCollection. Итоговое построение располагается в каталоге BuildDrop. Параметр /msbuildarguments используется для передачи уровня детализации MSBuild диагностики. Дополнительные сведения см. в разделе Справочные сведения о командной строке MSBuild.
>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"
См. также
Задачи
Создание базового определения построения