Partilhar via


AzureMysqlDeployment@1 - Tarefa v1 de implantação do Banco de Dados do Azure para MySQL

Use esta tarefa para executar seus scripts e fazer alterações em seu banco de dados no Banco de Dados do Azure para MySQL. A tarefa Banco de Dados do Azure para Implantação do MySQL só funciona com Banco de Dados do Azure para MySQL Single Server.

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.

Insumos

azureSubscription - Subscrição 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 a sua subscrição não estiver listada ou se pretender utilizar uma Entidade de Serviço existente, pode configurar uma ligação de serviço do Azure utilizando os botões Add ou Manage.


ServerName - Nome do host
string. Obrigatório.

O nome do seu Banco de Dados do Azure para servidor MySQL.

Exemplo: fabrikam.mysql.database.azure.com

O nome do servidor é fornecido no portal do Azure na folha 'Visão geral' do seu recurso de servidor do Banco de Dados do Azure para MySQL.

Quando você se conecta usando o MySQL Workbench, esse é o mesmo valor que é 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 não existir.

Se não for especificado, verifique se o banco de dados está referenciado no arquivo SQL fornecido ou no SQL embutido, quando necessário.

Nota: Os nomes dos bancos de dados MySQL diferenciam maiúsculas de minúsculas.


de login de administrador do SqlUsername - Server
string. Obrigatório.

O Banco de Dados do Azure para servidor MySQL dá suporte à autenticação nativa do MySQL. Você pode se conectar e autenticar em um servidor com o login de administrador do servidor. Exemplo: bbo1@fabrikam.

Quando você se conecta usando o MySQL Workbench, esse é o mesmo valor que é usado para Username no Parameters.


SqlPassword - Palavra-passe
string. Obrigatório.

A senha de administrador do Banco de Dados do Azure para MySQL. Caso não se lembre da palavra-passe, pode alterá-la a partir do portal 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 (MySQL Script File), InlineSqlTask (Inline MySQL Script). Valor padrão: SqlTaskFile.

Opcional. Seleciona uma das opções entre Arquivo de Script & Script Inline.

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

Nota: estes valores diferenciam maiúsculas de minúsculas.


SqlFile - MySQL Script
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 de sistema predefinidas, como $(agent.releaseDirectory), e arquivos contendo instruções SQL podem ser usadas aqui.

Nota: O cliente MySQL prefere caminhos de estilo Unix, portanto, a partir da versão 1.183.0, a tarefa irá converter caminhos de estilo do Windows para 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 há necessidade de escapar de caracteres especiais em caminhos.


SqlInline - Script MySQL Inline
string. Necessário quando TaskNameSelector = InlineSqlTask.

Entra no script MySQL para executar no banco de dados selecionado acima.


SqlAdditionalArguments - Argumentos adicionais do MySQL
string.

Opcional. As opções adicionais suportadas pelo cliente MySQL. Essas opções são aplicadas ao executar o arquivo fornecido no Banco de Dados do Azure para MySQL.

Exemplo: Você pode mudar 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 remover comentários enviados do cliente para o servidor.
  • --quick para evitar o cache de resultados.
  • --xml aos resultados de saída 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 Banco de Dados do Azure para MySQL Server a partir do Endereço IP do agente de automação.

Ao selecionar a deteção automática, você pode adicionar automaticamente uma exceção de firewall para o intervalo de endereços IP possíveis de agentes de automação ou pode especificar explicitamente o intervalo.

Valores aceites:

  • AutoDetect detetar 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.

Nota: Estes 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 adicionada 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 controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

Use esta tarefa para executar seus scripts e fazer alterações em seu banco de dados no Banco de Dados do Azure para MySQL. Note que esta é uma versão de pré-visualização. A tarefa Banco de Dados do Azure para Implantação do MySQL só funciona com Banco de Dados do Azure para MySQL Single Server.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências 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 de tarefa Desplegar