AzureMysqlDeployment@1 – tarefa de implantação do Banco de Dados do Azure para MySQL v1
Use essa tarefa para executar seus scripts e fazer alterações no banco de dados no Banco de Dados do Azure para MySQL. A tarefa de Implantação do Banco de Dados do Azure para MySQL só funciona com o servidor único do Banco de Dados do Azure para MySQL.
Syntax
# 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.
# 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.
Entradas
azureSubscription
- Assinatura do Azure
Alias de entrada: ConnectedServiceName
. string
. Obrigatórios.
Isso é necessário para se conectar à sua conta do Azure.
Para configurar uma nova conexão de serviço, selecione a assinatura do Azure na lista e clique Authorize
em .
Se sua assinatura não estiver listada ou se você quiser usar uma entidade de serviço existente, você poderá configurar uma conexão de serviço do Azure usando os Add
botões ou Manage
.
ServerName
- Nome do Host
string
. Obrigatórios.
O nome do seu servidor de Banco de Dados do Azure para MySQL.
Exemplo: fabrikam.mysql.database.azure.com
O nome do servidor é fornecido no portal do Azure na folha "Visão geral" do recurso de servidor do Banco de Dados do Azure para MySQL.
Quando você se conecta usando o MySQL Workbench, esse é o mesmo valor usado para Hostname
no Parameters
.
DatabaseName
- Nome do Banco de Dados
string
.
Opcional. O nome do banco de dados. O script criará um nome de banco de dados se um não existir.
Se não for especificado, verifique se o banco de dados é referenciado no arquivo SQL fornecido ou no SQL embutido, quando necessário.
Observação: os nomes do banco de dados MySQL diferenciam maiúsculas de minúsculas.
SqlUsername
- Logon do Administração do Servidor
string
. Obrigatórios.
O servidor Banco de Dados do Azure para MySQL dá suporte à autenticação nativa do MySQL. É possível se conectar e autenticar em um servidor com o logon de administrador do servidor. Exemplo: bbo1@fabrikam
.
Quando você se conecta usando o MySQL Workbench, esse é o mesmo valor usado para Username
no Parameters
.
SqlPassword
- Senha
string
. Obrigatórios.
A senha de administrador para Banco de Dados do Azure para MySQL. Caso não se lembre da senha, você pode alterar a senha de portal do Azure.
Essa cadeia de caracteres pode ser definida com uma variável no pipeline. Exemplo: $(password)
.
Além disso, você pode marcar o tipo de variável como secret
para protegê-lo.
TaskNameSelector
- Tipo
string
. Valores permitidos: SqlTaskFile
(Arquivo de Script MySQL), InlineSqlTask
(Script MySQL Embutido). Valor padrão: SqlTaskFile
.
Opcional. Seleciona uma das opções entre Arquivo de Script & Script Embutido.
SqlTaskFile
(padrão), para uso com o argumentoSqlFile
InlineSqlTask
, para uso com o argumentoSqlInline
.
Observação: esses valores diferenciam maiúsculas de minúsculas.
SqlFile
- MySQL Script
string
. Obrigatório quando TaskNameSelector = SqlTaskFile
.
O caminho completo do arquivo de script no agente de automação ou em um caminho UNC acessível ao agente de automação. Por exemplo: \BudgetIT\DeployBuilds\script.sql
.
Variáveis de sistema predefinidas, como $(agent.releaseDirectory)
, e arquivos que contêm instruções SQL podem ser usados aqui.
Observação: o cliente MySQL prefere caminhos de estilo Unix, portanto, da versão 1.183.0 em diante, a tarefa converterá caminhos de estilo do Windows em caminhos de estilo unix.
Exemplo: de c:\foo\bar\myscript.sql
para c:/foo/bar/myscript.sql
.
Quando a tarefa é usada em plataformas Linux, os caminhos permanecem inalterados. Não é necessário escapar caracteres especiais nos caminhos.
SqlInline
- Script MySQL embutido
string
. Obrigatório quando TaskNameSelector = InlineSqlTask
.
Insere o script MySQL a ser executado no banco de dados selecionado acima.
SqlAdditionalArguments
- Argumentos adicionais do MySQL
string
.
Opcional. As opções adicionais compatíveis com o cliente MySQL. Essas opções são aplicadas ao executar o arquivo especificado no Banco de Dados do Azure para MySQL.
Exemplo: você pode alterar para o formato de saída separado por tabulação padrão, para HTML ou até mesmo para o formato XML. Outros exemplos incluem:
--comments
para remover comentários enviados do cliente para o servidor.--quick
para impedir o cache de resultados.--xml
para gerar resultados como XML.
Todas as opções disponíveis são descritas na documentação do cliente MySQL.
IpDetectionMethod
- Especificar regras de firewall usando
string
. Obrigatórios. Valores Permitidos: AutoDetect
e IPAddressRange
. Valor padrão: AutoDetect
.
Para a execução bem-sucedida da tarefa, precisamos permitir que os administradores acessem o servidor Banco de Dados do Azure para MySQL do endereço IP do agente de automação.
Ao selecionar a detecção automática, você pode adicionar automaticamente uma exceção de firewall para o intervalo de possíveis endereços IP de agentes de automação ou especificar explicitamente o intervalo.
Valores aceitos:
AutoDetect
para detectar automaticamente o endereço IP público do agente de automação.IPAddressRange
para especificar explicitamente o intervalo de endereços IP a ser configurado. Defina o intervalo de endereços IP usando os parâmetrosEndIpAddress
eStartIpAddress
.
Observação: esses valores diferenciam maiúsculas de minúsculas.
StartIpAddress
- Iniciar endereço IP
string
. Obrigatório quando IpDetectionMethod = IPAddressRange
.
O endereço IP inicial do pool de computadores do agente de automação. Por exemplo: 196.21.30.50
.
EndIpAddress
- Endereço IP final
string
. Obrigatório quando IpDetectionMethod = IPAddressRange
.
O endereço IP final do pool de computadores do agente de automação. Por exemplo: 196.21.30.65
.
DeleteFirewallRule
- Excluir regra após o término da tarefa
boolean
. Valor padrão: true
.
Opcional. Se selecionada, a exceção adicionada para os endereços IP do agente de automação será removida para o Banco de Dados do Azure para MySQL correspondente.
Opções de controle da tarefa
Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Comentários
Use essa tarefa para executar seus scripts e fazer alterações no banco de dados no Banco de Dados do Azure para MySQL. Observe que esta é uma versão prévia. A tarefa de Implantação do Banco de Dados do Azure para MySQL só funciona com o servidor único do Banco de Dados do Azure para MySQL.
Requisitos
Requisito | Descrição |
---|---|
Tipos de pipeline | YAML, build clássico, versão clássica |
Executa em | Agente |
Demandas | Nenhum |
Funcionalidades | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
Restrições de comando | Qualquer |
Variáveis configuráveis | Qualquer |
Versão do agente | 1.100.0 ou superior |
Categoria da tarefa | Implantar |