Действия по выпуску для развертывания приложения в Release Management
Для определения последовательности развертывания для каждого этапа выпуска необходимо добавить действия выпуска. Каждое действие предполагает использование определенного инструмента для выполнения команды с набором аргументов.
Если вы еще не создали путь выпуска, пройдите по данной ссылке, чтобы сделать это.
Перетащите действие выпуска из области элементов, чтобы добавить его в свою последовательность развертывания. Можно использовать любые из стандартных действий выпуска, перечисленных в области элементов, или создавать собственные пользовательские действия выпуска.
.png "Вкладка \"Настроить приложения\", вкладка \"Шаблоны выпуска\"")
После добавления действия выпуска в последовательность можно требуемым образом отредактировать переменные конфигурации. Дополнительные сведения о стандартных действиях выпуска и их переменных конфигурации см. здесь. Узнайте о средствах, используемых действиями выпуска, здесь.
Добавление пользовательского действия выпуска
Добавьте новое действие выпуска и выберите инструмент, который будет использоваться в этом действии. Также можно скопировать существующее действие и использовать его в качестве основы для создания пользовательского действия выпуска. Отредактировать существующее действие выпуска нельзя.
Из клиента управления выпусками откройте страницу "Инвентаризация". (Если страница не отображается, запросите разрешение Можно управлять инвентаризацией.)
Скопируйте действие, которое требуется отредактировать, или добавьте новое действие.
.png "Копирование действия выпуска")
Выберите инструмент, который требуется использовать, в зависимости из предъявляемых к действию требований. Выберите Создать, чтобы добавить собственный пользовательский инструмент, если ни один из стандартных инструментов не решает задачи, необходимые на данном этапе в последовательности развертывания.
В разделе Выполнение введите требуемые аргументы с токенами их в необходимом формате. К каждому параметру необходимо добавлять следующие префикс и суффикс:__. При удалении или добавлении аргументов вместе с их токенами они отображаются в списке Параметры.
Например, добавьте следующие аргументы с токенами: -servername __servername__ -switch __onoff__. Теперь servername и onoff присутствуют в списке параметров.
Деактивация действия выпуска
- Если какие-либо из действий команда использовать не должна, деактивируйте эти действия. Откройте действие со страницы "Инвентаризация" и нажмите кнопку Деактивировать.
Активация деактивированного действия выпуска
Откройте список "Неактивно", откройте действие и выберите Активировать.
.png "Список \"Неактивные\" на странице \"Инвентаризация\"")
Вопросы и ответы
.gif "Ff425471.collapse_all(ru-ru,VS.120).gif")
В. Какие разрешения необходимо иметь для редактирования действий выпуска?
О. Для редактирования или добавления действий выпуска необходимо иметь разрешение Можно управлять инвентаризацией. Если это разрешение не включено, страница "Инвентаризация" не отображается.
При выборе варианта "Нет инструмента", поля Команда и Аргументы недоступны для изменения, если у вас нет разрешения Можно использовать специальный инструмент в действиях и компонентах. На вкладке Настроить приложения, Компоненты, если у пользователя нет разрешения Можно использовать специальный инструмент в действиях и компонентах, при выборе варианта "Нет инструмента", поля Команда и Аргументы будут недоступны для изменения.
Действия и переменные конфигурации для действий выпуска
Управление пулами приложений и веб-сайтами
Создание или изменение INI-файлов
Управление базами данных SQL Server
Настройка серверов
Управление службами Windows
Управление пулами приложений и веб-сайтами
В этих действиях используется стандартный инструмент IIS Deployer для управления пулами приложений, веб-сайтами, веб-приложениями и виртуальными каталогами. Эти действия поддерживаются в IIS 7.0, 7.5, 8.0 и 8.5. Дополнительные сведения об этом средстве приведены здесь.
Действие |
Использование и условия сбоя развертывания |
|---|---|
.png "пробел") |
Создать пул приложений: это действие создает новый пул приложений в IIS. Для IIS 7.0, 7.5, 8.0 и 8.5. Если пул приложений уже существует, он будет перенастроен в соответствии со значениями заданных переменных конфигурации (переменные конфигурации, значения которых не заданы, на фактическую конфигурацию пула приложений влиять не будут). В версиях IIS до 7.0 если пул приложений уже существует, развертывание заканчивается сбоем. Настроить пул приложений, Повторно использовать пул приложений, Запустить пул приложений и Остановить пул приложений: эти действия перенастраивают, повторно используют, запускают или останавливают пул приложений. Если пул приложений не существует, развертывание заканчивается сбоем. |
|
Создать веб-сайт: создает новый веб-сайт в IIS. Для IIS 7.0, 7.5, 8.0 и 8.5. Если веб-сайт уже существует, он будет перенастроен в соответствии со значениями заданных переменных конфигурации (переменные конфигурации, значения которых не заданы, на фактическую конфигурацию веб-сайта влиять не будут). В версиях IIS до 7.0 если пул приложений уже существует, развертывание заканчивается сбоем. Настроить веб-сайт, Перезапустить веб-сайт, Запустить веб-сайт, Остановить веб-сайт: эти действия перенастраивают, перезапускают, запускают или останавливают веб-сайт. Если веб-сайт не существует, развертывание заканчивается сбоем. |
|
Создать веб-приложение: создает новое веб-приложение в IIS. Для IIS 7.0, 7.5, 8.0 и 8.5. Если веб-приложение уже существует, оно будет перенастроено в соответствии со значениями заданных переменных конфигурации (переменные конфигурации, значения которых не заданы, на фактическую конфигурацию веб-приложения влиять не будут). В версиях IIS до 7.0 если пул приложений уже существует, развертывание заканчивается сбоем. Настроить веб-приложение: перенастраивает веб-приложение. Если веб-приложение не существует, развертывание заканчивается сбоем. |
|
Создать виртуальный каталог: создает виртуальный каталог в IIS. Для IIS 7.0, 7.5, 8.0 и 8.5. Если виртуальный каталог уже существует, он переконфигурируется в соответствии с заданными значениями переменных конфигурации (опущенные переменные конфигурации не влияют на фактическую конфигурацию виртуального каталога). Настроить виртуальный каталог: перенастраивает виртуальный каталог. Если виртуальный каталог не существует, развертывание заканчивается сбоем. |
Переменные конфигурации
Параметры |
Обязательно |
Описание |
|---|---|---|
AppPoolName |
Да [действия с пулом приложений] Нет [действия с веб-сайтом] |
Имя пула приложений, который требуется настроить, создать, использовать повторно, удалить, запустить или остановить. [действие с пулом приложений] Имя пула приложений, используемого для нового или измененного веб-сайта. [действие с веб-сайтом] |
DotNetVersion |
Нет |
Версия платформы .NET Framework, используемая для пула приложений. Этот параметр допустим только для IIS 7.5, 8.0 и 8.5. Допустимые значения: v1.0, v1.1, v2.0 или v4.0. |
IdentityUserDomain |
Нет |
Домен пользователя, используемый для идентификации пула приложений. Если этот параметр не задан, но задан параметр "IdentityUserName", пользователь считается локальным (т. е., .\localuser). |
IdentityUserName |
Нет |
Имя пользователя, используемое для идентификации пула приложений. Если этот параметр не задан, параметры IdentityUserDomain и IdentityUserPassword игнорируются и используется значение по умолчанию, принятое в IIS (т. е. ApplicationPoolIdentity). |
IdentityUserPassword |
Нет |
Пароль пользователя, используемый для идентификации пула приложений. |
Is32BitsAllowed |
Нет |
Флаг, который разрешает или запрещает 32-разрядным приложениям выполняться в пуле приложений. Допустимые значения:
|
IsAutoStart |
Нет |
Флаг, указывающий, должен ли пул приложений или веб-сайт запускаться автоматически при загрузке Windows. Допустимые значения:
|
IsPreloadEnabled |
Нет |
Флаг, указывающий, включена ли функция предварительной загрузки для веб-сайта или веб-приложения. Допустимые значения:
|
PhysicalPath |
Да [действие создания] Нет [все остальные действия с виртуальными каталогами, веб-сайтами, и веб-приложениями] |
Полный физический путь к виртуальному каталогу, веб-сайту или веб-приложению. |
PipeLineMode |
Нет |
Режим управляемого конвейера для использования в пуле приложений. Допустимые значения:
|
PortNumber |
Да [только создание] |
Номер порта, используемого для нового или измененного веб-сайта. |
ProcessIdleTimeOut |
Нет |
Время в минутах, в течение которого может простаивать процесс в пуле приложений. |
RecycleAfterMinutes |
Нет |
Фиксированное время в минутах, по истечении которого производится повторное использование пула приложений. |
RecycleFixedTime |
Нет |
Фиксированное время выполнения повторного использования пула приложений. Должен использоваться формат ЧЧ:ММ, например 23:58 или 01:23. |
RecycleKbMemory |
Нет |
Максимальный объем памяти (в килобайтах), используемый, прежде чем пул приложений будет использоваться повторно. |
SiteName |
Да [действие с веб-сайтом] Нет [действие с виртуальным каталогом] |
Имя веб-сайта, который требуется создать, настроить, удалить, запустить или остановить. [действие с веб-сайтом] Имя веб-сайта, на котором размещается виртуальный каталог. Если этот параметр не задан, используется веб-сайт по умолчанию. [действие с виртуальным каталогом] |
StartMode |
Нет |
Режим запуска, используемый для пула приложений. Допустимые значения:
|
VirtualDirectoryName |
Да |
Имя виртуального каталога, который требуется создать, настроить или удалить. |
WebApplicationName |
Нет |
Имя веб-приложения, в котором размещается виртуальный каталог. Если этот параметр не задан, используется корневое веб-приложение веб-сайта. |
WebAppName |
Да |
Имя веб-приложения, которое требуется настроить, создать или удалить. |
WebSiteName |
Да [действие с веб-сайтом] Нет [действие с веб-приложением] |
Имя веб-сайта, который требуется настроить, создать, удалить, запустить или остановить. [действие с веб-сайтом] Имя веб-сайта, на котором размещается веб-приложение. Если этот параметр не задан, используется веб-сайт по умолчанию. [действие с веб-приложением] |
Создание или изменение INI-файлов
Действия с INI-файлами предполагают использование инструмента Диспетчер INI-файлов для добавления, изменения или удаления разделов и ключей из файла. Дополнительные сведения об этом средстве приведены здесь.
Действие |
Описание |
|---|---|
Создать ключ |
Создает новый ключ со значением в указанном разделе INI-файла. Если указанный файл не существует, действие его создает. Если указанный раздел не существует, действие его создает. Если ключ уже существует в указанном разделе, действие заменяет его значение. |
Изменить ключ |
Изменяет существующий ключ в указанном разделе INI-файла. Если указанный файл не существует, действие его создает. Если указанный раздел не существует, действие его создает. Если ключ уже существует в указанном разделе, действие добавляет этот ключ. |
Изменить значение |
Изменяет значение существующего ключа в указанном разделе INI-файла. Если указанный файл не существует, действие его создает. Если указанный раздел не существует, действие его создает. Если ключ не существует в указанном разделе, действие добавляет его. |
Удалить ключ |
Удаляет ключ и его значения из указанного раздела INI-файла. Если указанный файл не существует, действие заканчивается сбоем. Если указанный раздел или ключ не существует, действие все равно заканчивается успешно. При удалении всех ключей из раздела действие удаляет также сам раздел. |
Изменить раздел |
Изменяет имя раздела внутри INI-файла. Если указанный файл не существует, действие его создает. Если указанный раздел не существует, действие все равно заканчивается успешно. |
Удалить раздел |
Удаляет раздел и все его ключи и значения из INI-файла. Если указанный файл не существует, действие заканчивается сбоем. Если указанный раздел не существует, действие все равно заканчивается успешно. |
Переменные конфигурации
Параметры |
Обязательно |
Описание |
|---|---|---|
INIFile |
Да |
Имя и путь (если требуется) INI-файла, который требуется изменить. |
KeyName |
Да |
Имя ключа, который требуется создать, изменить или удалить. |
KeyValue |
Нет |
Новое значение, присваиваемое ключу. Если этот параметр не задан, но задан параметр NewKeyName, система будет использовать фактическое значение. Если этот параметр не задан, но задан параметр NewKeyName, будет присвоено пустое значение. |
NewKeyName |
Нет |
Новое имя, присваиваемое ключу. Если не задано, имя ключа не изменяется. |
NewSectionName |
Нет |
Новое имя, присваиваемое разделу. Если не указано, ключи из старого раздела будут помещены в корневой раздел (все ключи, находящиеся в начале файла до первого раздела, считаются корневыми). |
SectionName |
Нет |
[действие создания или изменения ключа] Имя раздела, в котором добавляется или изменяется ключ. Если этот параметр не задан, действие обновляет корневой раздел. .gif "Примечание") Примечание
Все ключи, находящиеся в начале файла до первого раздела, считаются корневыми.
[действие переименования] Имя раздела, который требуется переименовать. Если этот параметр не задан, ключи старого раздела помещаются в корневой раздел. [действие удаления] Имя раздела, который требуется удалить. Если этот параметр не задан, удаляется корневой раздел. |
Управление базами данных SQL Server
Эти действия предполагают использование инструмента Средство развертывания баз данных - выполнить скрипт для создания, удаления, резервного копирования и восстановления базы данных SQL Server. Дополнительные сведения об этом средстве приведены здесь.
Действия |
Описание |
|---|---|
Создать базу данных SQL |
Создает новую базу данных. Если база данных уже существует, действие заканчивается сбоем. |
Удалить базу данных SQL |
Удаляет базу данных. Если база данных не существует, действие заканчивается сбоем. |
Резервное копирование базы данных SQL |
Создает резервную копию существующей базы данных по указанному пути. |
Восстановить базу данных SQL |
Восстанавливает базу данных из указанного источника. |
Переменные конфигурации
Параметры |
Обязательно |
Описание |
|---|---|---|
DatabaseName |
Да |
Имя базы данных SQL Server, которую необходимо создать, удалить, копировать для создания резервной копии или восстановить. |
Path |
Да |
Путь и имя файла, который будет использоваться для хранения резервной копии. Например, \\сервер\имя_файла.bak. |
ServerName |
Да |
Имя сервера, на котором требуется создать, скопировать для создания резервной копии, восстановить или удалить базу данных SQL. |
Source |
Да |
Путь и имя файла резервной копии, который будет использоваться для восстановления базы данных. |
Настройка серверов
Эти действия можно использовать для настройки компьютера сервера, если на нем запущена какая-либо из операционных систем Windows. Можно выполнять команды и завершать процессы, а также управлять файлами, папками, переменными среды и разделами и ключами реестра Windows. Система выполняет эти действия с помощью нескольких стандартных инструментов управления выпусками, включая Средство запуска командной строки, Процесс Windows и Средство развертывания XCOPY. Дополнительные сведения об этих средствах приведены здесь.
Действие |
Примечания и условия сбоя развертывания |
|---|---|
|
Действие Запуск командной строки используется для запуска команды с удостоверением агента развертывания. Действие Запуск командной строки от имени пользователя позволяет выполнить команду с конкретными учетными данными пользователя. |
|
Эти действия поддерживают создание, изменение и удаление файлов, папок и некоторых атрибутов. При создании файлов или папок также создаются все несуществующие родительские каталоги создаваемой папки. |
|
Эти действия поддерживают создание, изменение и удаление переменных среды. |
|
Эти действия поддерживают создание, изменение и удаление разделов и ключей реестра. Последовательность развертывания заканчивается сбоем только при попытке изменить раздел реестра, который не существует. |
Переменные конфигурации для выполнения команд или завершения процесса
Параметры |
Обязательно |
Описание |
|---|---|---|
Arguments |
Нет |
Аргументы, необходимые для запуска командной строки. |
command |
Да |
Фиксированное значение ./WindowsProcess.ps1. |
FilePath |
Нет |
Домен пользователя, используемый для идентификации пула приложений. Если этот параметр не задан, но задан параметр IdentityUserName, пользователь считается локальным (т. е., .\localuser). |
IsKillProcessTree |
Нет |
Указывает, требуется ли завершить дерево процесса. Допустимые значения:
|
ProcessName |
Да |
Имя завершаемого процесса Windows. |
UserDomain |
Нет |
Домен пользователя, используемый для запуска исполняемого файла. Если этот параметр не задан, присваивается .\localuser. |
UserName |
Да [действие выполнения команды] Нет [действие завершения процесса] |
Имя пользователя, используемое для запуска исполняемого файла. Учетная запись пользователя, под которой выполняется процесс. Если не указана, процесс будет завершен для всех пользователей. |
UserPassword |
Нет |
Пароль пользователя, используемый для запуска исполняемого файла. |
Переменные конфигурации для управления файлами и папками
Параметры |
Обязательно |
Описание |
|---|---|---|
Archive |
Нет |
Устанавливает или сбрасывает атрибут "архивный" для файлов или папки.
|
DestinationFileFolder |
Версия платформы .NET Framework, используемая для пула приложений. Этот параметр допустим только для IIS 7.5, 8.0 и 8.5. Допустимые значения: v1.0, v1.1, v2.0 или v4.0. |
|
DestinationName |
Да |
Конечный путь, куда требуется скопировать или переместить файлы или папки. Или новое имя, которое требуется присвоить переименовываемым файлу или папке. |
FileFolderName |
Да |
Исходные файлы или папка, которые требуется удалить, изменить, переместить или переименовать. Для действия удаления можно использовать подстановочные знаки, например c:, temp или *.log. |
FolderName |
Да |
Имя и путь создаваемой папки. |
Hidden |
Нет |
Устанавливает или сбрасывает атрибут "скрытый" для файлов или папки.
|
OwnerDomain |
Нет |
Домен нового владельца файлов или папки. Если этот параметр не задан, присваивается .\localuser. |
OwnerDomain |
Да |
Имя нового владельца файлов или папки. |
ReadOnly |
Устанавливает или сбрасывает атрибут "только для чтения" для файлов или папки.
|
|
SourceFileFolder |
Да |
Копируемые исходные файлы или папка. Можно использовать подстановочные знаки, например c:, temp или *.log. |
System |
Устанавливает или сбрасывает атрибут "системный" для файлов или папки.
|
Переменные конфигурации для действий с переменными среды
Параметры |
Обязательно |
Описание |
|---|---|---|
VariableName |
Да |
Имя переменной, которую требуется создать, изменить или удалить. |
VariableValue |
Нет |
Значение, присваиваемое добавляемой или изменяемой переменной. Если значение не задано, переменная удаляется. |
Переменные конфигурации для действий с реестром Windows
Параметры |
Обязательно |
Описание |
|---|---|---|
NewRegistryKey |
Да |
Полное имя конечного раздела реестра, например HKLM, Software или NEWKEY. |
OperatingSystemType |
Нет |
Тип операционной системы, в которой требуется создать раздел реестра. Допустимые значения:
|
RegistryData |
Нет |
Данные, влияющие на значение реестра. |
RegistryKey |
Да |
Полное имя раздела реестра, который требуется создать, изменить или удалить. Например, HKLM, Software или NEWKEY. |
RegistryValue |
Да |
Имя добавляемого или изменяемого значения реестра. |
ValueType |
Нет |
Тип данных значения реестра. Допустимые значения:
|
Управление службами Windows
Эти действия предполагают использование стандартного инструмента Диспетчер служб Windows для создания, настройки, удаления, перезапуска, запуска и остановки служб Windows. Дополнительные сведения об этом средстве приведены здесь.
Действие |
Использование и условия сбоя развертывания |
|---|---|
|
Действие Создать службу используется для создания новой службы. Если служба уже существует, последовательность развертывания заканчивается сбоем. Действие Настроить службу используется для настройки существующей службы. Если служба не существует, последовательность развертывания заканчивается сбоем. Действие Настроить учетные данные службы используется, чтобы настроить существующую службу с новыми учетными данными. Если служба не существует, последовательность развертывания заканчивается сбоем. Кроме того, последовательность развертывания заканчивается сбоем, если при запуске, остановке или перезапуске службы указанное ServiceName не существует. Если служба уже запущена или остановлена, сбоя не произойдет. |
Переменные конфигурации
Параметры |
Обязательно |
Описание |
|---|---|---|
BinPath |
Нет |
Двоичные путь и имя службы. |
Description |
Да |
Описание службы, которую требуется создать или настроить. |
DisplayName |
Нет |
Имя службы, которую требуется создать или настроить. |
Password |
Нет |
Пароль имени пользователя, указанного для запуска службы. |
ServiceName |
Да |
Имя службы, которую требуется создать, настроить, удалить, использовать повторно, запустить или остановить. |
StartMode |
Нет |
Режим запуска службы. Допустимые значения:
|
UserName |
Да |
Имя пользователя, используемое для учетных данных, с которыми запускается служба. Используйте формат ДОМЕН\ПОЛЬЗОВАТЕЛЬ, например: NT AUTHORITY\NETWORK SERVICE. При задании параметра UserName необходимо также задать параметр Password. Для сброса учетных данных на LocalSystem введите LocalSystem в качестве пользователя и "" в качестве пароля. |