用于为发布管理部署应用程序的发布操作
你添加发布操作,为发布的每个阶段定义部署序列。 每个操作使用特定工具运行包含一组参数的命令。
如果尚未发布创建路径,请转到 此处 执行此操作。
从工具箱中拖出一个发布操作,将其添加到部署序列中。 使用工具箱中列出的任意预定义的发布操作,或创建你自己的自定义发布操作。
向序列中添加发布操作后,你可以根据需要编辑配置变量。 有关预定义的发布操作及其配置变量的详细信息,请转到此处。 找出有关发布操作 此处使用的工具。
添加自定义发布操作
添加新发布操作并选择你希望此操作使用的工具 你也可复制现有操作并在此基础上创建自定义发布操作。 你无法编辑现有发布操作。
从 Release Management 客户端打开“库存”页(如果不显示该页面,则申请**“可以管理库存”**权限)。
复制你要编辑的操作或添加新操作。
根据你对操作的要求,选择要使用的工具。 选择 New 添加你自己的自定义工具。如果在你的部署序列中 预定义工具 不能执行你需要的单步执行。
在**“执行”部分中,按要求的格式输入需要的任意参数及其标记。 你必须向每个参数添加此前缀和后缀:__。 无论何时删除或添加参数及其标记,它们都会显示在“参数”**列表中。
例如,添加以下参数及标记:-servername __servername__ -switch __onoff__。 现在 servername 和 onoff 显示在参数列表中。
停用发布操作
- 如果你不希望你的团队使用某些操作,请停用它们。 从“库存”页面打开操作,并选择**“停用”**按钮。
重新激活发布操作
打开“非活动”列表,再打开操作并选择**“激活”**。
问 &答
问:我需要哪些权限才能编辑发布操作?
**答:要编辑或添加发布操作,用户必须拥有“可以管理库存”**权限。 如果该权限未启用,则不显示“库存”页面。
选择“无工具”选项时,除非你拥有**“可以在操作和组件中使用自定义工具”权限,否则无法编辑“命令”和“参数”字段。 在“配置应用程序”>“组件”中,当用户没有“可以在操作和组件中使用自定义工具”权限时,“命令”和“参数”**字段在选择“无工具”选项时将不可编辑。
发布操作的操作和配置变量
管理应用程序池和网站
创建或修改 .ini 文件
管理 SQL Server 数据库
设置服务器
管理 Windows 服务
管理应用程序池和网站
这些操作使用预定义的 IIS Deployer 工具管理应用程序池、网站、Web 应用程序和虚拟目录。 IIS 7.0、7.5、8.0 和 8.5 支持这些操作。 有关本工具的信息,请转到 此处。
操作 |
用法和部署失败条件 |
---|---|
|
“创建应用程序池”:此操作可在 IIS 下创建新的应用程序池。 对于 IIS 7.0、7.5、8.0 和 8.5,如果应用程序池已存在,将重新配置以与定义的配置变量值相匹配(未定义的配置变量将不会影响应用程序池的实际配置)。 在低于 7.0 的 IIS 版本下,如果应用程序池已存在,则部署将失败。 “配置应用程序池”、“回收应用程序池”、“启动应用程序池”或“停止应用程序池”:这些操作将重新配置、回收、启动或停止应用程序池。 如果应用程序池不存在,部署将失败。 |
|
“创建网站”:在 IIS 下创建一个新网站。 对于 IIS 7.0、7.5、8.0 和 8.5, 如果网站已存在,将重新配置以与定义的配置变量值相匹配(未定义的配置变量将不会影响网站的实际配置)。 在低于 7.0 的 IIS 版本下,如果应用程序池已存在,则部署将失败。 “配置网站”、“重新启动网站”、“启动网站”、“停止网站”:这些操作将重新配置、重新启动、启动或停止网站。 如果网站不存在,部署将失败。 |
|
“创建 Web 应用程序”:在 IIS 下创建新的 Web 应用程序。 对于 IIS 7.0、7.5、8.0 和 8.5, 如果 Web 应用程序已存在,将重新配置以与定义的配置变量值相匹配(未定义的配置变量将不会影响 Web 应用程序的实际配置)。 在低于 7.0 的 IIS 版本下,如果应用程序池已存在,则部署将失败。 “配置 Web 应用程序”将重新配置 Web 应用程序。 如果 Web 应用程序不存在,部署将失败。 |
|
“创建虚拟目录”:在 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 |
否 |
该标记指示是否为网站或 Web 应用程序启用预加载功能。 允许的值为:
|
PhysicalPath |
是 [创建操作] 否 [其他所有虚拟目录、网站和 Web 应用程序操作] |
虚拟目录、网站或 Web 应用程序的完整物理路径。 |
PipeLineMode |
否 |
要在应用程序池中使用的托管管道模式。 允许的值为:
|
PortNumber |
是 [仅创建操作] |
要用于新网站或已修改网站的端口号。 |
ProcessIdleTimeOut |
否 |
进程可在应用程序池中闲置的分钟数。 |
RecycleAfterMinutes |
否 |
在回收应用程序池之前等待的固定分钟数。 |
RecycleFixedTime |
否 |
回收应用程序池的固定时间。 所需格式为 HH:MM,例如 23:58 或 01:23。 |
RecycleKbMemory |
否 |
回收应用程序池之前要使用的内存的最大 KB 数。 |
SiteName |
是 [网站操作] 否 [虚拟目录操作] |
要创建、配置、删除、启动或停止的网站的名称。[网站操作] 虚拟目录所在的网站的名称。 如果未定义此参数,将使用默认网站。[虚拟目录操作] |
StartMode |
否 |
用于应用程序池的启动模式。 允许的值为:
|
VirtualDirectoryName |
是 |
要创建、配置或删除的虚拟目录的名称。 |
WebApplicationName |
否 |
虚拟目录所在的 Web 应用程序的名称。 如果未定义此参数,将使用网站的根 Web 应用程序。 |
WebAppName |
是 |
要配置、创建或删除的 Web 应用程序的名称。 |
WebSiteName |
是 [网站操作] 否 [Web 应用程序操作] |
要配置、创建、删除、启动或停止的网站的名称。[网站操作] Web 应用程序所在的网站的名称。 如果未定义此参数,将使用默认网站。[Web 应用程序操作] |
创建或修改 .ini 文件
这些 .ini 文件操作使用**“INI 文件管理器”**工具从文件中添加、修改或删除节和键。 有关本工具的信息,请转到 此处。
操作 |
说明 |
---|---|
创建键 |
在 .ini 文件的特定节中创建有值的新键。 如果指定的文件不存在,此操作将创建它。 如果指定的节不存在,此操作将创建它。 如果键已存在于指定的节中,此操作将替换其值。 |
修改键 |
在 .ini 文件的特定节中使用新值修改现有的键。 如果指定的文件不存在,此操作将创建它。 如果指定的节不存在,此操作将创建它。 如果键已存在于指定的节中,此操作将添加其值。 |
修改值 |
在 .ini 文件的特定节中修改现有键的值。 如果指定的文件不存在,此操作将创建它。 如果指定的节不存在,此操作将创建它。 如果键不存在于指定的节中,此操作将添加它。 |
删除键 |
从 .ini 文件的特定节中删除键及其值。 如果指定的文件不存在,此操作将失败。 如果指定的节或键不存在,此操作仍会成功。如果指定从节中删除所有键,此操作还将删除节。 |
修改节 |
更改 .ini 文件中节的名称。 如果指定的文件不存在,此操作将创建它。 如果指定的节不存在,此操作仍会成功。 |
删除节 |
删除 .ini 文件中的节及其所有键和值。 如果指定的文件不存在,此操作将失败。 如果指定的节不存在,此操作仍会成功。 |
配置变量
参数 |
必需 |
说明 |
---|---|---|
INIFile |
是 |
要修改的 .ini 文件的名称和路径(根据需要)。 |
KeyName |
是 |
要创建、修改或删除的键的名称。 |
KeyValue |
否 |
分配给键的新值。 如果未指定此参数,但指定了 NewKeyName,系统将使用实际值。 如果未指定此参数且未指定 NewKeyName,此值将清空。 |
NewKeyName |
否 |
分配给键的新名称。 如果未指定此参数,则将不会更改键名称。 |
NewSectionName |
否 |
分配给节的新名称。 如果未指定此参数,则将旧节的键置于根节下方(位于文件开头的第一节之前的所有键都被视为位于根中)。 |
SectionName |
否 |
[创建或修改键操作] 要在其中添加或修改键的节名称。 如果未指定此参数,此操作将更新根节。
说明
位于文件开头的第一节之前的所有键都被视为位于根中。
[重命名操作] 要重命名的节名称。 如果未指定此参数,旧节的键将放置在根节下。 [删除操作] 要删除的节名称。 如果未指定此操作,将删除根节。 |
管理 SQL Server 数据库
这些操作使用**“数据库 Deployer - 执行脚本”**工具创建、删除、备份和还原 SQL Server 数据库。 有关本工具的信息,请转到 此处。
操作 |
说明 |
---|---|
创建 SQL 数据库 |
创建新数据库。 如果数据库已存在,此操作将失败。 |
删除 SQL 数据库 |
删除数据库。 如果数据库不存在,此操作将失败。 |
备份 SQL 数据库 |
将现有数据库备份到指定路径。 |
还原 SQL 数据库 |
从指定的源还原数据库。 |
配置变量
参数 |
必需 |
说明 |
---|---|---|
DatabaseName |
是 |
要创建、删除、备份或还原的 SQL Server 数据库的名称。 |
Path |
是 |
用于存储数据库备份的路径和文件名。 例如,\\server\filename.bak。 |
ServerName |
是 |
要在其中创建、备份、还原或删除 SQL 数据库的服务器的名称。 |
Source |
是 |
用于还原数据库的数据库备份的路径和文件名。 |
设置服务器
这些操作可用于设置运行任何 Windows 操作系统的服务器计算机。 你可以运行命令和取消进程,还能管理文件、文件夹、环境变量和 Windows 注册表项及值。 系统使用若干预定义的 Release Management 工具(包括**“命令行运行程序”、“Windows 进程”和“XCOPY Deployer”**)执行这些操作。 有关这些工具的信息,请转到 此处。
操作 |
注释和部署失败条件 |
---|---|
|
使用“运行命令行”以部署代理身份运行命令。 使用“以用户身份运行命令行”借助特定用户凭据运行命令。 |
|
这些操作支持创建、修改和删除文件、文件夹和选定特性。 当你创建文件或文件夹时,也将创建要创建的文件夹的任何不存在的父目录。 |
|
这些操作支持创建、修改和删除环境变量。 |
|
这些操作支持创建、修改和删除注册表项及值。 仅当你尝试修改不存在的注册表项时,部署序列才会失败。 |
用于运行命令或取消进程的配置变量
参数 |
必需 |
说明 |
---|---|---|
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 作为用户并输入 "" 作为密码。 |