AzureMysqlDeployment@1 - Azure Database for MySQL 部署 v1 任务

使用此任务运行脚本,并在 Azure Database for MySQL 中更改数据库。 Azure Database for MySQL 部署任务仅适用于 Azure Database for MySQL 单一服务器

语法

# Azure Database for MySQL deployment v1
# Run your scripts and make changes to your Azure Database for MySQL.
- task: AzureMysqlDeployment@1
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure Subscription. 
  # DB Details
    ServerName: # string. Required. Host Name. 
    #DatabaseName: # string. Database Name. 
    SqlUsername: # string. Required. Server Admin Login. 
    SqlPassword: # string. Required. Password. 
  # Deployment Package
    #TaskNameSelector: 'SqlTaskFile' # 'SqlTaskFile' | 'InlineSqlTask'. Type. Default: SqlTaskFile.
    SqlFile: # string. Required when TaskNameSelector = SqlTaskFile. MySQL Script. 
    #SqlInline: # string. Required when TaskNameSelector = InlineSqlTask. Inline MySQL Script. 
    #SqlAdditionalArguments: # string. Additional MySQL Arguments. 
  # Firewall
    IpDetectionMethod: 'AutoDetect' # 'AutoDetect' | 'IPAddressRange'. Required. Specify Firewall Rules Using. Default: AutoDetect.
    #StartIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. Start IP Address. 
    #EndIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. End IP Address. 
    #DeleteFirewallRule: true # boolean. Delete Rule After Task Ends. Default: true.

输入

azureSubscription - Azure 订阅
输入别名:ConnectedServiceNamestring。 必填。

连接到 Azure 帐户需要执行此作。

若要配置新的服务连接,请从列表中选择 Azure 订阅,然后单击 Authorize

如果订阅未列出,或者想要使用现有服务主体,则可以使用 AddManage 按钮设置 Azure 服务连接。


ServerName - 主机名
string。 必填。

Azure Database for MySQL 服务器的名称。

示例:fabrikam.mysql.database.azure.com

服务器名称在 Azure 门户的 Azure 门户的 Azure Database for MySQL 服务器资源的“概述”边栏选项卡中提供。

使用 MySQL Workbench 进行连接时,此值与 Parameters中用于 Hostname 的值相同。


DatabaseName - 数据库名称
string

可选。 数据库的名称。 如果该脚本不存在,该脚本将创建数据库名称。

如果未指定,请确保在提供的 SQL 文件或内联 SQL 中引用数据库(如果需要)。

注意:MySQL 数据库名称区分大小写。


SqlUsername - 服务器管理员登录
string。 必填。

Azure Database for MySQL 服务器支持本机 MySQL 身份验证。 可使用服务器的管理员登录名连接到服务器并进行身份验证。 示例:bbo1@fabrikam

使用 MySQL Workbench 进行连接时,此值与 Parameters中用于 Username 的值相同。


SqlPassword - 密码
string。 必填。

Azure Database for MySQL 的管理员密码。 如果不记得密码,可以从 Azure 门户更改密码。

可以使用管道中的变量定义此字符串。 示例:$(password)

此外,可以将变量类型标记为 secret 来保护它。


TaskNameSelector - 类型
string。 允许的值:SqlTaskFile(MySQL 脚本文件)、InlineSqlTask(内联 MySQL 脚本)。 默认值:SqlTaskFile

可选。 选择脚本文件 & 内联脚本之间的选项之一。

  • SqlTaskFile(默认值),用于 SqlFile 参数
  • InlineSqlTask,用于 SqlInline 参数。

注意:这些值区分大小写。


SqlFile - MySQL 脚本
stringTaskNameSelector = SqlTaskFile时是必需的。

自动化代理上的脚本文件的完整路径或自动化代理可访问的 UNC 路径。 例如: \BudgetIT\DeployBuilds\script.sql

预定义的系统变量(如 $(agent.releaseDirectory))和包含 SQL 语句的文件可在此处使用。

注意:MySQL 客户端更喜欢 Unix 样式路径,因此从版本 1.183.0 开始,任务会将 Windows 样式路径转换为 Unix 样式路径。 示例:从 c:\foo\bar\myscript.sqlc:/foo/bar/myscript.sql

在 Linux 平台上使用该任务时,路径保持不变。 无需在路径中转义特殊字符。


SqlInline - 内联 MySQL 脚本
stringTaskNameSelector = InlineSqlTask时是必需的。

输入要对上面选择的数据库执行的 MySQL 脚本。


SqlAdditionalArguments - 其他 MySQL 参数
string

可选。 MySQL 客户端支持的其他选项。 在 Azure Database for MySQL 上执行给定文件时,将应用这些选项。

示例:可以更改为默认选项卡分隔输出格式、HTML 甚至 XML 格式。 其他示例包括:

  • --comments 去除从客户端发送到服务器的注释。
  • --quick 以防止结果缓存。
  • --xml 将结果输出为 XML。

MySQL 客户端文档中介绍了所有可用选项。


IpDetectionMethod - 使用 指定防火墙规则
string。 必填。 允许的值:AutoDetectIPAddressRange。 默认值:AutoDetect

若要成功执行任务,我们需要使管理员能够从自动化代理的 IP 地址访问 Azure Database for MySQL 服务器。

通过选择自动检测,可以为自动化代理的可能 IP 地址范围自动添加防火墙例外,也可以显式指定该范围。

接受的值:

  • AutoDetect 自动检测自动化代理的公共 IP 地址。
  • IPAddressRange 显式指定要配置的 IP 地址范围。 使用 StartIpAddressEndIpAddress 参数设置 IP 地址范围。

注意:这些值区分大小写。


StartIpAddress - 启动 IP 地址
stringIpDetectionMethod = IPAddressRange时是必需的。

自动化代理计算机池的起始 IP 地址。 例如: 196.21.30.50


EndIpAddress - 结束 IP 地址
stringIpDetectionMethod = IPAddressRange时是必需的。

自动化代理计算机池的结束 IP 地址。 例如: 196.21.30.65


任务结束后 DeleteFirewallRule - 删除规则
boolean。 默认值:true

可选。 如果选择,将为相应的 Azure Database for MySQL 删除自动化代理的 IP 地址添加的异常。


任务控制选项

除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性

输出变量

没有。

注解

使用此任务运行脚本,并在 Azure Database for MySQL 中更改数据库。 请注意,这是预览版。 Azure Database for MySQL 部署任务仅适用于 Azure Database for MySQL 单一服务器

要求

要求 说明
管道类型 YAML,经典版本,经典版本
运行时间 代理人
需求 没有
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任何
Settable 变量 任何
代理版本 1.100.0 或更高版本
任务类别 部署