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 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 Authorizeem .

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 argumento SqlFile
  • InlineSqlTask, para uso com o argumento SqlInline.

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âmetros EndIpAddress e StartIpAddress.

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