Создание и запуск командного файла развертывания

Статья
07/13/2023

В этом разделе описывается, как создать командный файл, который позволит запускать развертывание с помощью файлов проекта Microsoft Build Engine (MSBuild) в виде одношагового повторяемого процесса.

Этот раздел является частью серии учебников, основанных на требованиях к развертыванию на предприятии вымышленной компании Fabrikam, Inc. В этой серии учебников используется пример решения диспетчера контактов для представления веб-приложения с реалистичным уровнем сложности, включая приложение ASP.NET MVC 3, службу Windows Communication Foundation (WCF) и проект базы данных.

Метод развертывания в основе этих учебников основан на подходе с разделением файлов проекта, описанном в разделе Основные сведения о процессе сборки, в котором процесс сборки управляется двумя файлами проектов: один содержит инструкции сборки, которые применяются к каждой целевой среде, а второй содержит параметры сборки и развертывания для конкретной среды. Во время сборки файл проекта для конкретной среды объединяется с файлом проекта, не зависящим от среды, чтобы сформировать полный набор инструкций по сборке.

Обзор процесса

В этом разделе вы узнаете, как создать и запустить командный файл, который использует эти файлы проекта для выполнения повторяемого развертывания в целевой среде. По сути, командный файл просто должен содержать команду MSBuild, которая:

Указывает MSBuild выполнить файл Publish.proj , не зависящий от среды.
Сообщает файлу Publish.proj , какой файл содержит параметры проекта для конкретной среды и где его найти.

Создание команды MSBuild

Как описано в разделе Основные сведения о процессе сборки, файл проекта для конкретной среды, например Env-Dev.proj, предназначен для импорта в файл Publish.proj , независимый от среды, во время сборки. Вместе эти два файла предоставляют полный набор инструкций по сборке и развертыванию решения в MSBuild.

Файл Publish.proj использует элемент Import для импорта файла проекта, относящегося к среде.

<Import Project="$(TargetEnvPropsFile)"/>

Таким образом, при использовании MSBuild.exe для сборки и развертывания решения Диспетчера контактов необходимо:

Запустите MSBuild.exe в файле Publish.proj .
Укажите расположение файла проекта для конкретной среды, указав параметр командной строки с именем TargetEnvPropsFile.

Для этого команда MSBuild должна выглядеть следующим образом:

msbuild.exe Publish.proj /p:TargetEnvPropsFile=EnvConfig\Env-Dev.proj

Теперь это простой шаг для перехода к повторяемому одношаговому развертыванию. Все, что нужно сделать, — это добавить команду MSBuild в CMD-файл. В решении Диспетчера контактов папка Publish содержит файл с именем Publish-Dev.cmd , который выполняет именно это.

%windir%\Microsoft.NET\Framework\v4.0.30319\msbuild.exe Publish.proj /fl /p:TargetEnvPropsFile=EnvConfig\Env-Dev.proj
echo 
pause

Примечание

Параметр /fl указывает MSBuild создать файл журнала с именем msbuild.log в рабочем каталоге, в котором был вызван MSBuild.exe.

Чтобы развернуть или повторно развернуть решение Диспетчера контактов, достаточно запустить файл Publish-Dev.cmd . При запуске файла MSBuild:

Выполните сборку всех проектов в решении.
Создание развертываемых веб-пакетов для проектов веб-приложений.
Создайте dbschema и deploymanifest-файлы для проектов базы данных.
Разверните веб-пакеты на веб-сервере.
Разверните базу данных на сервере базы данных.

Запуск развертывания

Создав командный файл для целевой среды, вы сможете завершить все развертывание, просто запустив файл.

Развертывание решения Диспетчера контактов в тестовой среде

На рабочей станции разработчика откройте windows Обозреватель и перейдите к расположению файла Publish-Dev.cmd.
Дважды щелкните файл, чтобы запустить его.
Если откроется диалоговое окно Открытие файла — предупреждение системы безопасности , нажмите кнопку Выполнить.
Если параметры конфигурации и тестовые серверы настроены правильно, в окне командной строки появится сообщение Сборка выполнена успешно , когда MSBuild завершит обработку файлов проекта.
Если решение развертывается в этой среде впервые, необходимо добавить учетную запись компьютера тестового веб-сервера в db_datawriter и db_datareader роли в базе данных ContactManager . Эта процедура описана в разделе Настройка сервера базы данных для публикации веб-развертывания.

Примечание

Эти разрешения необходимо назначить только при создании базы данных. По умолчанию процесс сборки не будет повторно создавать базу данных при каждом развертывании, а сравнивает существующую базу данных с последней схемой и вносит только необходимые изменения. В результате необходимо сопоставить эти роли базы данных только при первом развертывании решения.
Откройте интернет-Обозреватель и перейдите по URL-адресу приложения Диспетчера контактов (например, http://testweb1:85/ContactManager/).
Убедитесь, что приложение работает должным образом и вы можете добавлять контакты.

Заключение

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

msbuild.exe Publish.proj /p:TargetEnvPropsFile=EnvConfig\Env-Dev.proj

Файл команды для публикации в промежуточной среде может содержать следующую команду MSBuild:

msbuild.exe Publish.proj /p:TargetEnvPropsFile=EnvConfig\Env-Stage.proj

Примечание

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

Вы также можете настроить процесс сборки для каждой среды, переопределив свойства или задав различные другие параметры в команде MSBuild. Дополнительные сведения см. в справочнике по командной строке MSBuild.

Назад Вперед

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