Практическое руководство. Запуск модульных тестов SQL Server из построения Team Foundation
Сборку Team Foundation можно использовать для запуска модульных тестов SQL Server в составе теста проверки сборки. Модульные тесты можно настроить так, чтобы сначала выполнялось развертывание базы данных, формировались тестовые данные, а затем запускались выбранные тесты. Если вы раньше не работали с построением Team Foundation Build, то перед выполнением процедур данного раздела ознакомьтесь со следующими сведениями.
Перед использованием этих процедур сначала следует настроить рабочую среду, выполнив следующие действия.
Установка построения Team Foundation Build и управления версиями Team Foundation Вероятно, вам необходимо будет установить построение Team Foundation Build и управление версиями Team Foundation на разные компьютеры.
Установите служебные программы сборки microsoft SQL Server Data Tools на том же компьютере, что и Team Foundation Build. Чтобы установить SQL Server Data Tools Build Utilities, сначала создайте административную точку установки. Дополнительные сведения об административной точке установки см. в статье, посвященной установке SQL Server Data Tools. Затем установите на сервер построения SSDTBuildUtilties.msi из расположения (/расположение), которое используется в качестве административной точки установки.
Подключитесь к экземпляру Visual Studio Team Foundation Server.
После настройки рабочей среды выполните следующие действия.
Создайте проект базы данных.
Импортируйте или создайте схему и объекты для проекта базы данных.
Настройте свойства построения и развертывания проекта базы данных.
Создайте один или несколько модульных тестов.
Добавьте решение, содержащее проект базы данных и проект модульных тестов, в систему управления версиями и поместите в нее все файлы.
В приведенных в этом разделе инструкциях описывается создание определения построения для запуска модульных тестов в рамках автоматизированного выполнения теста.
Выполнение модульных тестов SQL Server на компьютере сборки
При выполнении модульных тестов на компьютере построения возможна ситуация, когда модульные тесты не могут найти файлы проектов базы данных (SQLPROJ-файлы). Такая ошибка возникает из-за того, что файл app.config ссылается на эти файлы с помощью относительных путей. Также запуск модульных тестов может завершиться неудачей, если не будет найден экземпляр SQL Server, который задан в качестве средства запуска модульных тестов. Такая ошибка может возникнуть, если строки подключения, хранимые в файле app.config, не являются действительными при запуске на компьютере построения.
Для устранения этих проблем нужно указать раздел переопределения в файле app.config, который переопределяет файл app.config файлом конфигурации для вашей среды Team Foundation Build. Дополнительные сведения см. далее в разделе Изменение тестового проекта.
Настройка параметров тестирования для запуска модульных тестов SQL Server в 64-разрядном агенте сборки
Перед запуском модульных тестов в 64-разрядном агенте построения следует изменить параметр теста «Платформа хост-процесса».
Задание платформы хост-процесса
Откройте решение, содержащее проект тестов, для которого нужно настроить параметры.
В папке Элементы решения в обозревателе решений дважды щелкните файл Local.testsettings.
Откроется диалоговое окно Параметры тестирования.
Щелкните в списке элемент Хосты.
В области сведений в разделе Host Process Platform (Платформа хост-процесса) выберите MSIL, чтобы тесты запускались в 64-разрядном агенте сборки.
Щелкните Применить.
Назначение категорий тестам (необязательно)
Обычно при создании определения построения для запуска модульных тестов указывается одна или несколько категорий тестов. При запуске построения выполняются все тесты из заданных категорий.
Назначения категорий тестам
Откройте окно Представление теста.
Выберите тест.
На панели свойств выберите Категории тестов, а затем нажмите кнопку с многоточием (…) в столбце справа.
В поле Добавление новой категории окна Категория теста введите имя новой категории.
Нажмите кнопку Добавить, а затем кнопку ОК.
Тесту будет назначена новая категория. Также она будет доступна для выбора в свойствах других тестов.
Изменение тестового проекта
По умолчанию при построении проекта модульных тестов Team Foundation Build создает файл конфигурации на основе файла проекта app.config. Путь к проекту базы данных сохраняется как относительный путь в файле app.config. Относительные пути, работающие в Visual Studio, работать не будут, так как сборка Team Foundation помещает скомпилированные файлы в другие расположения в зависимости от того, где запускаются модульные тесты. Также файл app.config содержит строки подключения, определяющие тестируемую базу данных. Если модульные тесты должны подключаться к базе данных, отличной от той, что была указана при создании проекта тестов, вам также потребуется отдельный файл app.config для Team Foundation Build. Внеся изменения в последующую процедуру, можно настроить проект тестов и сервер построения так, чтобы Team Foundation Build использовал другую конфигурацию.
Внимание
Эту процедуру необходимо выполнить для каждого проекта тестов (файл с расширением VBPROJ или VSPROJ).
Задание файла app.config для службы построения Team Foundation Build
В обозревателе решений щелкните правой кнопкой мыши файл app.config и выберите пункт Копировать.
Щелкните правой кнопкой мыши тестовый проект и выберите команду Вставить.
Щелкните правой кнопкой мыши файл с именем Копия app.config и выберите пункт "Переименовать".
Введите BuildComputer.sqlunitttest.config и нажмите клавишу ВВОД, где BuildComputer — имя компьютера, на котором запущен агент сборки.
Дважды щелкните BuildComputer.sqlunitttest.config.
Файл конфигурации откроется в редакторе.
Измените относительный путь к файлу с расширением SQLPROJ, добавив папку Sources и вложенную в нее папку с именем, совпадающим с именем решения. Например, если изначально файл конфигурации содержит следующую запись:
<DatabaseDeployment DatabaseProjectFileName="..\..\..\Database3\Database3.sqlproj" Configuration="Debug" />Измените файл следующим образом:
<DatabaseDeployment DatabaseProjectFileName="..\..\..\Database3\Database3.sqlproj" Configuration="Debug" />По окончании ваш файл BuildComputer.sqlunitttest.config должен стать похожим на приведенный далее пример для Visual Studio 2010
<SqlUnitTesting_VS2010> <DatabaseDeployment DatabaseProjectFileName="..\..\..\Database4\Database4.sqlproj" Configuration="Debug" /> <DataGeneration ClearDatabase="true" /> <ExecutionContext Provider="System.Data.SqlClient" ConnectionString="Data Source=(localdb)\Projects;Initial Catalog=Database4;Integrated Security=True;Pooling=False" CommandTimeout="30" /> <PrivilegedContext Provider="System.Data.SqlClient" ConnectionString="Data Source=(localdb)\Projects;Initial Catalog=Database4;Integrated Security=True;Pooling=False" CommandTimeout="30" /> </SqlUnitTesting_VS2010>Или если вы используете Visual Studio 2012:
<SqlUnitTesting_VS2012> <DatabaseDeployment DatabaseProjectFileName="..\..\..\Database4\Database4.sqlproj" Configuration="Debug" /> <DataGeneration ClearDatabase="true" /> <ExecutionContext Provider="System.Data.SqlClient" ConnectionString="Data Source=(localdb)\Projects;Initial Catalog=Database4;Integrated Security=True;Pooling=False" CommandTimeout="30" /> <PrivilegedContext Provider="System.Data.SqlClient" ConnectionString="Data Source=(localdb)\Projects;Initial Catalog=Database4;Integrated Security=True;Pooling=False" CommandTimeout="30" /> </SqlUnitTesting_VS2012>Измените атрибут ConnectionString для контекстов ExecutionContext и PrivilegedContext, чтобы указать подключения к целевой базе данных, в которой нужно выполнять развертывание.
В меню File (Файл) выберите команду Save All (Сохранить все).
В обозревателе решений дважды щелкните файл app.config.
В редакторе для каждого узла <SqlUnitTesting_версия_Visual_Studio> добавьте
AllowConfigurationOverride="true". Например:-- Update SqlUnitTesting_VS2010 node to: <SqlUnitTesting_VS2010 AllowConfigurationOverride="true"> -- Update SqlUnitTesting_VS2012 node to: <SqlUnitTesting_VS2012 AllowConfigurationOverride="true">Подобное изменение позволяет Team Foundation Build использовать созданный переопределяющий файл конфигурации.
В меню File (Файл) выберите команду Save All (Сохранить все).
Далее следует включить в файл Local.testsettings измененный файл конфигурации.
Изменение файла Local.testsettings для развертывания пользовательского файла конфигурации
В обозревателе решений дважды щелкните файл Local.testsettings.
Откроется диалоговое окно Параметры тестирования.
В списке категорий выберите пункт Развертывание.
Установите флажок Включить развертывание.
Щелкните Добавить файл.
В диалоговом окне Добавление файлов развертывания укажите созданный вами файл BuildComputer.sqlunitttest.config.
Щелкните Применить.
Нажмите кнопку Закрыть.
В меню File (Файл) выберите команду Save All (Сохранить все).
Далее внесите решение в систему управления версиями.
Запись решения после изменения
В этой процедуре все файлы решения вносятся в систему управления версиями. К этим файлам относится файл метаданных теста для решения, который содержит тесты и взаимосвязи с категориями тестов. При добавлении, удалении, реорганизации и изменении содержимого тестов файл метаданных обновляется автоматически с учетом внесенных изменений.
Примечание.
В этой процедуре описываются шаги, которые выполняются при использовании управления версиями Team Foundation. Если используется другая система управления версиями, то необходимо выполнить действия, соответствующие этой системе.
Внесение решения в систему управления версиями
Подключитесь к компьютеру, на котором работает Team Foundation Server.
Дополнительные сведения см. в статье Использование обозревателя управления исходным кодом.
Добавьте решение в систему управления версиями, если оно еще туда не добавлено.
Дополнительные сведения см. в статье Добавление файлов в систему управления версиями.
В меню Вид выберите пункт Извлеченные элементы.
Внесите в систему все файлы решения.
Дополнительные сведения см. в статье Возврат ожидающих изменений.
Примечание.
Возможно, у вас есть определенный процесс, который определяет действия по созданию автоматизированных тестов и управлению ими. Например, согласно процессу может требоваться локальная проверка построения перед внесением этого кода вместе с тестами, которые его проверяют.
В обозревателе решений рядом с каждым файлом отобразится значок замка, указывающий, что он записан после изменения. Дополнительные сведения см. в статье Просмотр свойств файлов и папок в системе управления версиями.
Ваши тесты доступны для Team Foundation Build. Теперь можно создать определение построения, содержащее тесты, которые должны запускаться.
Создание определения сборки
Создание определения построения
В Team Explorer выберите проект группы, щелкните правой кнопкой мыши узел Сборки и выберите команду Создать определение сборки.
Откроется окно Создание определения сборки.
В поле Имя определения сборки введите подходящее имя.
На панели навигации выберите Параметры сборки по умолчанию.
В поле Copy build output to the following drop folder (UNC path, such as \\server\share) (Копировать выходные данные сборки в следующую папку сброса (UNC-путь, например \\сервер\общий_ресурс)) укажите папку, куда будут помещаться результаты сборки.
Можно указать общую папку на локальном компьютере или сетевое расположение, к которому у процесса построения есть разрешения.
На панели навигации выберите Обработать.
В группе Обязательные рядом с полем Элементы для сборки нажмите кнопку обзора (…).
В диалоговом окне Build Project List Editor (Редактор списка сборки проекта) нажмите кнопку Добавить.
Укажите файл решения (с расширением SLN), который был ранее добавлен в систему управления версиями, и нажмите кнопку ОК.
Решение появится в списке Project or solution files to build (Файлы проектов и решений для сборки).
Щелкните OK.
В группе Базовые раздела Автоматизированные тесты укажите тесты, которые нужно выполнить. По умолчанию будут выполняться тесты, содержащиеся в файлах с именем *test*.dll из решения.
В меню Файл выберите команду Сохранить имя_проекта.
Процесс создания определения построения завершен. Далее следует изменить проект тестов.
Запуск нового определения сборки
Запуск нового типа построения
В командном обозревателе разверните узел проекта группы, разверните узел «Построения», щелкните правой кнопкой мыши запускаемое определение построения и выберите команду «Поставить новую сборку в очередь».
Откроется диалоговое окно Поставить сборку в очередь {TeamProjectName} со списком всех имеющихся типов сборки.
При необходимости выберите новое определение сборки в поле Определение сборки.
Проверьте правильность значений в полях Определение сборки , Агент сборки и Папка сброса для этой сборки и щелкните Поставить в очередь.
Откроется вкладка В очередиобозревателя сборок. Дополнительные сведения об управлении завершенными сборками см. в статьях для Visual Studio 2010 или Visual Studio 2012.
См. также
Выполнение модульных тестов SQL Server
Создание базового определения построения
Помещение построения в очередь
Наблюдение за ходом построения