AzureMysqlDeployment@1 – tarefa de implementação do Base de Dados do Azure para MySQL v1
Utilize esta tarefa para executar os scripts e fazer alterações à base de dados no Base de Dados do Azure para MySQL. A tarefa implementação do Base de Dados do Azure para MySQL só funciona com Base de Dados do Azure para MySQL Servidor Único.
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
- Subscrição do Azure
Alias de entrada: ConnectedServiceName
. string
. Obrigatório.
Isto é necessário para ligar à sua conta do Azure.
Para configurar uma nova ligação de serviço, selecione a subscrição do Azure na lista e clique em Authorize
.
Se a sua subscrição não estiver listada ou se quiser utilizar um Principal de Serviço existente, pode configurar uma ligação de serviço do Azure com os Add
botões ou Manage
.
ServerName
- Nome do Anfitrião
string
. Obrigatório.
O nome do servidor Base de Dados do Azure para MySQL.
Exemplo: fabrikam.mysql.database.azure.com
O nome do servidor é fornecido no portal do Azure no painel "Descrição geral" do recurso do servidor Base de Dados do Azure para MySQL.
Quando se liga com o MySQL Workbench, este é o mesmo valor utilizado no Hostname
Parameters
.
DatabaseName
- Nome da Base de Dados
string
.
Opcional. O nome da base de dados. O script criará um nome de base de dados se não existir.
Se não for especificado, certifique-se de que a base de dados é referenciada no ficheiro SQL fornecido ou no SQL inline, sempre que necessário.
Nota: os nomes das bases de dados MySQL são sensíveis às maiúsculas e minúsculas.
SqlUsername
- Início de Sessão do Administração do Servidor
string
. Obrigatório.
O servidor Base de Dados do Azure para MySQL suporta a autenticação MySQL nativa. Pode ligar e autenticar-se num servidor com o início de sessão de administrador do servidor. Exemplo: bbo1@fabrikam
.
Quando se liga com o MySQL Workbench, este é o mesmo valor utilizado no Username
Parameters
.
SqlPassword
- Palavra-passe
string
. Obrigatório.
A palavra-passe de administrador para Base de Dados do Azure para MySQL. Caso não se lembre da palavra-passe, pode alterar a palavra-passe de portal do Azure.
Esta cadeia pode ser definida com uma variável no pipeline. Exemplo: $(password)
.
Além disso, pode marcar o tipo de variável como secret
para protegê-lo.
TaskNameSelector
- Tipo
string
. Valores permitidos: SqlTaskFile
(Ficheiro de Script MySQL), InlineSqlTask
(Script MySQL Inline). Valor predefinido: SqlTaskFile
.
Opcional. Seleciona uma das opções entre Ficheiro de Script & Script Inline.
SqlTaskFile
(predefinição), para utilização com oSqlFile
argumentoInlineSqlTask
, para utilização com oSqlInline
argumento .
Nota: estes valores são sensíveis às maiúsculas e minúsculas.
SqlFile
- MySQL Script
string
. Necessário quando TaskNameSelector = SqlTaskFile
.
O caminho completo do ficheiro de script no agente de automatização ou num caminho UNC acessível ao agente de automatização. Por exemplo: \BudgetIT\DeployBuilds\script.sql
.
As variáveis de sistema predefinidas, como $(agent.releaseDirectory)
, e os ficheiros que contêm instruções SQL podem ser utilizadas aqui.
Nota: o cliente MySQL prefere caminhos de estilo Unix, por isso, a partir da versão 1.183.0, a tarefa irá 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 é utilizada em plataformas Linux, os caminhos permanecem inalterados. Não há necessidade de escapar a carateres especiais em caminhos.
SqlInline
- Inline MySQL Script
string
. Necessário quando TaskNameSelector = InlineSqlTask
.
Introduz o script MySQL a executar na base de dados selecionada acima.
SqlAdditionalArguments
- Argumentos MySQL Adicionais
string
.
Opcional. As opções adicionais suportadas pelo cliente MySQL. Estas opções são aplicadas ao executar o ficheiro especificado no Base de Dados do Azure para MySQL.
Exemplo: pode alterar para o formato de saída separado por separador predefinido, para HTML ou até para o formato XML. Outros exemplos incluem:
--comments
para retirar os comentários enviados do cliente para o servidor.--quick
para impedir a colocação em cache de resultados.--xml
para produzir resultados como XML.
Todas as opções disponíveis estão descritas na documentação do cliente MySQL.
IpDetectionMethod
- Especificar Regras de Firewall com
string
. Obrigatório. Valores permitidos: AutoDetect
, IPAddressRange
. Valor predefinido: AutoDetect
.
Para a execução bem-sucedida da tarefa, temos de permitir que os administradores acedam ao Servidor Base de Dados do Azure para MySQL a partir do Endereço IP do agente de automatização.
Ao selecionar detetar automaticamente, pode adicionar automaticamente uma exceção de firewall para o intervalo de possíveis endereços IP de agentes de automatização ou pode especificar explicitamente o intervalo.
Valores aceites:
AutoDetect
para detetar automaticamente o endereço IP público do agente de automatização.IPAddressRange
para especificar explicitamente o intervalo de endereços IP a configurar. Defina o intervalo de endereços IP com osStartIpAddress
parâmetros eEndIpAddress
.
Nota: estes valores são sensíveis às maiúsculas e minúsculas.
StartIpAddress
- Endereço IP Inicial
string
. Necessário quando IpDetectionMethod = IPAddressRange
.
O Endereço IP inicial do conjunto de máquinas do agente de automatização. Por exemplo: 196.21.30.50
.
EndIpAddress
- Endereço IP Final
string
. Necessário quando IpDetectionMethod = IPAddressRange
.
O Endereço IP final do conjunto de máquinas do agente de automatização. Por exemplo: 196.21.30.65
.
DeleteFirewallRule
- Eliminar Regra Após o Fim da Tarefa
boolean
. Valor predefinido: true
.
Opcional. Se selecionada, a exceção adicionada para os endereços IP do agente de automatização será removida para o Base de Dados do Azure para MySQL correspondente.
Opções de controlo de tarefas
Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.
Variáveis de saída
Nenhum.
Observações
Utilize esta tarefa para executar os scripts e fazer alterações à base de dados no Base de Dados do Azure para MySQL. Tenha em atenção que esta é uma versão de pré-visualização. A tarefa implementação do Base de Dados do Azure para MySQL só funciona com Base de Dados do Azure para MySQL Servidor Único.
Requisitos
Requisito | Description |
---|---|
Tipos de pipeline | YAML, Compilação clássica, Versão clássica |
É executado em | Agente |
Exigências | Nenhuma |
Capacidades | Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa. |
Restrições de comandos | Qualquer |
Variáveis de tabelas definidas | Qualquer |
Versão do agente | 1.100.0 ou superior |
Categoria da tarefa | Implementação |