Compartilhar via


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 Implantação do Banco de Dados do Azure para MySQL só funciona com banco de dados do Azure para MySQL.

Sintaxe

# 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ório

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 em Authorize.

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 botões Add ou Manage.


ServerName - nome do host
string. Obrigatório

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.


de Logon do Administrador do Servidor SqlUsername -
string. Obrigatório

O servidor do Banco de Dados do Azure para MySQL dá suporte à autenticação MySQL nativa. É 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 - de senha
string. Obrigatório

A senha de administrador do 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 o Arquivo de Script & Script Embutido.

  • SqlTaskFile (padrão), para uso com o argumento SqlFile
  • InlineSqlTask, para uso com o argumento SqlInline.

Observação: esses valores diferenciam maiúsculas de minúsculas.


SqlFile - de script MySQL
string. Necessá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 predefinidas do sistema, 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 a c:/foo/bar/myscript.sql.

Quando a tarefa é usada em plataformas Linux, os caminhos permanecem inalterados. Não é necessário escapar de caracteres especiais em caminhos.


script MySQL embutido SqlInline -
string. Necessá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 da guia padrão, para HTML ou até mesmo para o formato XML. Outros exemplos incluem:

  • --comments 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ório Valores permitidos: AutoDetect, IPAddressRange. Valor padrão: AutoDetect.

Para a execução bem-sucedida da tarefa, precisamos permitir que os administradores acessem o Servidor do Banco de Dados do Azure para MySQL no 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 detectar automaticamente o endereço IP público do agente de automação.
  • IPAddressRange especificar explicitamente o intervalo de endereços IP a ser configurado. Defina o intervalo de endereços IP usando os parâmetros StartIpAddress e EndIpAddress.

Observação: esses valores diferenciam maiúsculas de minúsculas.


StartIpAddress - iniciar o endereço IP
string. Necessário quando IpDetectionMethod = IPAddressRange.

O endereço IP inicial do pool de máquinas do agente de automação. Por exemplo: 196.21.30.50.


EndIpAddress - endereço IP final
string. Necessário quando IpDetectionMethod = IPAddressRange.

O endereço IP final do pool de máquinas 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 adicional para os endereços IP do agente de automação será removida para o Banco de Dados do Azure correspondente para MySQL.


Opções de controle de tarefa

Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

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 Implantação do Banco de Dados do Azure para MySQL só funciona com banco de dados do Azure para MySQL.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agente
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 1.100.0 ou superior
Categoria de tarefa Implantar