Действия по выпуску для развертывания приложения в Release Management

Для определения последовательности развертывания для каждого этапа выпуска необходимо добавить действия выпуска. Каждое действие предполагает использование определенного инструмента для выполнения команды с набором аргументов.

Если вы еще не создали путь выпуска, пройдите по данной ссылке, чтобы сделать это.

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

После добавления действия выпуска в последовательность можно требуемым образом отредактировать переменные конфигурации. Дополнительные сведения о стандартных действиях выпуска и их переменных конфигурации см. здесь. Узнайте о средствах, используемых действиями выпуска, здесь.

Добавление пользовательского действия выпуска

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

1. Из клиента управления выпусками откройте страницу "Инвентаризация". (Если страница не отображается, запросите разрешение Можно управлять инвентаризацией.)

2. Скопируйте действие, которое требуется отредактировать, или добавьте новое действие.

   

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

4. В разделе Выполнение введите требуемые аргументы с токенами их в необходимом формате. К каждому параметру необходимо добавлять следующие префикс и суффикс:__. При удалении или добавлении аргументов вместе с их токенами они отображаются в списке Параметры.

   Например, добавьте следующие аргументы с токенами: -servername __servername__ -switch __onoff__. Теперь servername и onoff присутствуют в списке параметров.

Деактивация действия выпуска

• Если какие-либо из действий команда использовать не должна, деактивируйте эти действия. Откройте действие со страницы "Инвентаризация" и нажмите кнопку Деактивировать.

Активация деактивированного действия выпуска

• Откройте список "Неактивно", откройте действие и выберите Активировать.

  

Вопросы и ответы

В. Какие разрешения необходимо иметь для редактирования действий выпуска?

О. Для редактирования или добавления действий выпуска необходимо иметь разрешение Можно управлять инвентаризацией. Если это разрешение не включено, страница "Инвентаризация" не отображается.

При выборе варианта "Нет инструмента", поля Команда и Аргументы недоступны для изменения, если у вас нет разрешения Можно использовать специальный инструмент в действиях и компонентах. На вкладке Настроить приложения, Компоненты, если у пользователя нет разрешения Можно использовать специальный инструмент в действиях и компонентах, при выборе варианта "Нет инструмента", поля Команда и Аргументы будут недоступны для изменения.

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

• Управление пулами приложений и веб-сайтами

• Создание или изменение INI-файлов

• Управление базами данных SQL Server

• Настройка серверов

• Управление службами Windows

Управление пулами приложений и веб-сайтами

В этих действиях используется стандартный инструмент IIS Deployer для управления пулами приложений, веб-сайтами, веб-приложениями и виртуальными каталогами. Эти действия поддерживаются в IIS 7.0, 7.5, 8.0 и 8.5. Дополнительные сведения об этом средстве приведены здесь.

Действие	Использование и условия сбоя развертывания
Создать пул приложений Настроить пул приложений Повторно использовать пул приложений Удалить пул приложений Запустить пул приложений Остановить пул приложений	Создать пул приложений: это действие создает новый пул приложений в 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-разрядным приложениям выполняться в пуле приложений. Допустимые значения: 1 или True: 32-разрядные приложения разрешены. 0 или False: 32-разрядные приложения запрещены.
IsAutoStart	Нет	Флаг, указывающий, должен ли пул приложений или веб-сайт запускаться автоматически при загрузке Windows. Допустимые значения: 1 или True: запускать пул приложений или веб-сайт автоматически при запуске Windows. 0 или False: не запускать пул приложений или веб-сайт автоматически при запуске Windows.
IsPreloadEnabled	Нет	Флаг, указывающий, включена ли функция предварительной загрузки для веб-сайта или веб-приложения. Допустимые значения: 1 или True: предварительная загрузка включена. 0 или False: предварительная загрузка отключена.
PhysicalPath	Да [действие создания] Нет [все остальные действия с виртуальными каталогами, веб-сайтами, и веб-приложениями]	Полный физический путь к виртуальному каталогу, веб-сайту или веб-приложению.
PipeLineMode	Нет	Режим управляемого конвейера для использования в пуле приложений. Допустимые значения: Classic Integrated
PortNumber	Да [только создание]	Номер порта, используемого для нового или измененного веб-сайта.
ProcessIdleTimeOut	Нет	Время в минутах, в течение которого может простаивать процесс в пуле приложений.
RecycleAfterMinutes	Нет	Фиксированное время в минутах, по истечении которого производится повторное использование пула приложений.
RecycleFixedTime	Нет	Фиксированное время выполнения повторного использования пула приложений. Должен использоваться формат ЧЧ:ММ, например 23:58 или 01:23.
RecycleKbMemory	Нет	Максимальный объем памяти (в килобайтах), используемый, прежде чем пул приложений будет использоваться повторно.
SiteName	Да [действие с веб-сайтом] Нет [действие с виртуальным каталогом]	Имя веб-сайта, который требуется создать, настроить, удалить, запустить или остановить. [действие с веб-сайтом] Имя веб-сайта, на котором размещается виртуальный каталог. Если этот параметр не задан, используется веб-сайт по умолчанию. [действие с виртуальным каталогом]
StartMode	Нет	Режим запуска, используемый для пула приложений. Допустимые значения: OnDemand AlwaysRunning
VirtualDirectoryName	Да	Имя виртуального каталога, который требуется создать, настроить или удалить.
WebApplicationName	Нет	Имя веб-приложения, в котором размещается виртуальный каталог. Если этот параметр не задан, используется корневое веб-приложение веб-сайта.
WebAppName	Да	Имя веб-приложения, которое требуется настроить, создать или удалить.
WebSiteName	Да [действие с веб-сайтом] Нет [действие с веб-приложением]	Имя веб-сайта, который требуется настроить, создать, удалить, запустить или остановить. [действие с веб-сайтом] Имя веб-сайта, на котором размещается веб-приложение. Если этот параметр не задан, используется веб-сайт по умолчанию. [действие с веб-приложением]

Создание или изменение INI-файлов

Действия с INI-файлами предполагают использование инструмента Диспетчер INI-файлов для добавления, изменения или удаления разделов и ключей из файла. Дополнительные сведения об этом средстве приведены здесь.

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

Переменные конфигурации

Параметры	Обязательно	Описание
INIFile	Да	Имя и путь (если требуется) INI-файла, который требуется изменить.
KeyName	Да	Имя ключа, который требуется создать, изменить или удалить.
KeyValue	Нет	Новое значение, присваиваемое ключу. Если этот параметр не задан, но задан параметр NewKeyName, система будет использовать фактическое значение. Если этот параметр не задан, но задан параметр NewKeyName, будет присвоено пустое значение.
NewKeyName	Нет	Новое имя, присваиваемое ключу. Если не задано, имя ключа не изменяется.
NewSectionName	Нет	Новое имя, присваиваемое разделу. Если не указано, ключи из старого раздела будут помещены в корневой раздел (все ключи, находящиеся в начале файла до первого раздела, считаются корневыми).
SectionName	Нет	[действие создания или изменения ключа] Имя раздела, в котором добавляется или изменяется ключ. Если этот параметр не задан, действие обновляет корневой раздел. Примечание Все ключи, находящиеся в начале файла до первого раздела, считаются корневыми. [действие переименования] Имя раздела, который требуется переименовать. Если этот параметр не задан, ключи старого раздела помещаются в корневой раздел. [действие удаления] Имя раздела, который требуется удалить. Если этот параметр не задан, удаляется корневой раздел.

Управление базами данных SQL Server

Эти действия предполагают использование инструмента Средство развертывания баз данных - выполнить скрипт для создания, удаления, резервного копирования и восстановления базы данных SQL Server. Дополнительные сведения об этом средстве приведены здесь.

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

Переменные конфигурации

Параметры	Обязательно	Описание
DatabaseName	Да	Имя базы данных SQL Server, которую необходимо создать, удалить, копировать для создания резервной копии или восстановить.
Path	Да	Путь и имя файла, который будет использоваться для хранения резервной копии. Например, \\сервер\имя_файла.bak.
ServerName	Да	Имя сервера, на котором требуется создать, скопировать для создания резервной копии, восстановить или удалить базу данных SQL.
Source	Да	Путь и имя файла резервной копии, который будет использоваться для восстановления базы данных.

Настройка серверов

Эти действия можно использовать для настройки компьютера сервера, если на нем запущена какая-либо из операционных систем Windows. Можно выполнять команды и завершать процессы, а также управлять файлами, папками, переменными среды и разделами и ключами реестра Windows. Система выполняет эти действия с помощью нескольких стандартных инструментов управления выпусками, включая Средство запуска командной строки, Процесс Windows и Средство развертывания XCOPY. Дополнительные сведения об этих средствах приведены здесь.

Действие	Примечания и условия сбоя развертывания
Запуск командной строки Запуск командной строки от имени пользователя Закрыть процесс Windows	Действие Запуск командной строки используется для запуска команды с удостоверением агента развертывания. Действие Запуск командной строки от имени пользователя позволяет выполнить команду с конкретными учетными данными пользователя.
Копировать файл или папку Создать папку Удалить файлы или папку Переместить файл или папку Переименовать файл или папку Изменить атрибуты файлов или папки Изменить владельца файлов или папки	Эти действия поддерживают создание, изменение и удаление файлов, папок и некоторых атрибутов. При создании файлов или папок также создаются все несуществующие родительские каталоги создаваемой папки.
Создать переменную среды Изменить переменную среды Удалить переменную среды	Эти действия поддерживают создание, изменение и удаление переменных среды.
Создать раздел реестра Windows Удалить раздел реестра Windows Изменить раздел реестра Windows Создать значение реестра Windows Удалить значение реестра Windows Изменить значение реестра Windows	Эти действия поддерживают создание, изменение и удаление разделов и ключей реестра. Последовательность развертывания заканчивается сбоем только при попытке изменить раздел реестра, который не существует.

Переменные конфигурации для выполнения команд или завершения процесса

Параметры	Обязательно	Описание
Arguments	Нет	Аргументы, необходимые для запуска командной строки.
command	Да	Фиксированное значение ./WindowsProcess.ps1.
FilePath	Нет	Домен пользователя, используемый для идентификации пула приложений. Если этот параметр не задан, но задан параметр IdentityUserName, пользователь считается локальным (т. е., .\localuser).
IsKillProcessTree	Нет	Указывает, требуется ли завершить дерево процесса. Допустимые значения: 1: завершить дерево процесса. 0 (или пусто): не завершать дерево процесса.
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	Нет	Тип операционной системы, в которой требуется создать раздел реестра. Допустимые значения: 32: (по умолчанию) создает 32-разрядный раздел реестра. 64: создает 64-разрядный раздел реестра.
RegistryData	Нет	Данные, влияющие на значение реестра.
RegistryKey	Да	Полное имя раздела реестра, который требуется создать, изменить или удалить. Например, HKLM, Software или NEWKEY.
RegistryValue	Да	Имя добавляемого или изменяемого значения реестра.
ValueType	Нет	Тип данных значения реестра. Допустимые значения: REG_SZ: (по умолчанию): строка. REG_QWORD_LITTLE_ENDIAN: 64-разрядное число в формате с прямым порядком байтов. REG_QWORD: 64-разрядное число. REG_NONE: без значения. REG_MULTI_SZ: строковое значение с несколькими строками (разделенными символами \0). REG_LINK : символическая ссылка. REG_EXPAND_SZ: строка с неразвернутыми ссылками на переменные среды. REG_DWORD_BIG_ENDIAN: 32-разрядное число в формате с обратным порядком байтов. REG_DWORD_LITTLE_ENDIAN: 32-разрядное число в формате с прямым порядком байтов. REG_DWORD: 32-разрядное число. REG_BINARY: двоичные данные в любой форме.

Управление службами Windows

Эти действия предполагают использование стандартного инструмента Диспетчер служб Windows для создания, настройки, удаления, перезапуска, запуска и остановки служб Windows. Дополнительные сведения об этом средстве приведены здесь.

Действие

Использование и условия сбоя развертывания

Настроить службу Настроить учетные данные службы Создать службу Удалить службу Перезапуск службы Запуск службы Остановка службы

Действие Создать службу используется для создания новой службы. Если служба уже существует, последовательность развертывания заканчивается сбоем. Действие Настроить службу используется для настройки существующей службы. Если служба не существует, последовательность развертывания заканчивается сбоем. Действие Настроить учетные данные службы используется, чтобы настроить существующую службу с новыми учетными данными. Если служба не существует, последовательность развертывания заканчивается сбоем. Кроме того, последовательность развертывания заканчивается сбоем, если при запуске, остановке или перезапуске службы указанное ServiceName не существует. Если служба уже запущена или остановлена, сбоя не произойдет.

Переменные конфигурации

Параметры	Обязательно	Описание
BinPath	Нет	Двоичные путь и имя службы.
Description	Да	Описание службы, которую требуется создать или настроить.
DisplayName	Нет	Имя службы, которую требуется создать или настроить.
Password	Нет	Пароль имени пользователя, указанного для запуска службы.
ServiceName	Да	Имя службы, которую требуется создать, настроить, удалить, использовать повторно, запустить или остановить.
StartMode	Нет	Режим запуска службы. Допустимые значения: Automatic: (по умолчанию) служба автоматически запускается при следующей перезагрузке компьютера. Disabled: служба отключена. Manual: служба запускается только вручную.
UserName	Да	Имя пользователя, используемое для учетных данных, с которыми запускается служба. Используйте формат ДОМЕН\ПОЛЬЗОВАТЕЛЬ, например: NT AUTHORITY\NETWORK SERVICE. При задании параметра UserName необходимо также задать параметр Password. Для сброса учетных данных на LocalSystem введите LocalSystem в качестве пользователя и "" в качестве пароля.