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


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


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 o SqlFile argumento
  • InlineSqlTask, para utilização com o SqlInline 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 os StartIpAddress parâmetros e EndIpAddress .

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