AzureMysqlDeployment@2 - Base de Dados do Azure para MySQL tarefa de implementação v2

Esta tarefa implementa scripts para Base de Dados do Azure para MySQL Servidor Flexível. Podes implementar usando um ficheiro SQL ou escrevendo o script em linha.

Sintaxe

# Azure Database for MySQL deployment v2
# Run your scripts and make changes to your Azure Database for MySQL Flexible Server.
- task: AzureMysqlDeployment@2
  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. Required.

Isto é necessário para se ligar à sua conta 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 Anfitrião
string. Required.

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

Exemplo: fabrikam.mysql.database.azure.com

O nome do servidor é fornecido no portal Azure na lâmina 'Overview' do seu recurso servidor Base de Dados do Azure para MySQL.

Quando se liga usando o MySQL Workbench, este é o mesmo valor que é usado em HostnameParameters.


DatabaseName - Nome da Base de Dados
string.

Opcional. O nome do banco de dados. O script criará um nome de base de dados caso não exista.

Se não for especificado, certifique-se de que a base de dados está referenciada no ficheiro SQL fornecido ou SQL inline, quando necessário.

Nota: Os nomes das bases de dados MySQL são distinguíveis de maiúsculas e minúsculas.


SqlUsername - Login de Administrador do Servidor
string. Required.

O servidor Base de Dados do Azure para MySQL suporta autenticação MySQL nativa. Pode ligar-se e autenticar-se a um servidor com o login de administrador do servidor. Exemplo: bbo1@fabrikam.

Quando se liga usando o MySQL Workbench, este é o mesmo valor que é usado em UsernameParameters.


SqlPassword - Palavra-passe
string. Required.

A palavra-passe de administrador do Base de Dados do Azure para MySQL. Caso não se lembre da palavra-passe, pode alterá-la no portal 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 a proteger.


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 e Script Inline.

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

Nota: estes valores são distintos a maiúsculas e maiúsculas.


SqlFile - MySQL Script
string. Necessário quando TaskNameSelector = SqlTaskFile.

O caminho completo do ficheiro de script no agente de automação ou num caminho UNC acessível ao agente de automação. Por exemplo: \\BudgetIT\DeployBuilds\script.sql.

Variáveis de sistema pré-definidas, como $(agent.releaseDirectory), e ficheiros contendo instruções SQL, podem ser usadas aqui.

Nota: O cliente MySQL prefere caminhos ao estilo Unix, por isso, a partir da versão 1.183.0, a tarefa converterá caminhos ao estilo Windows em caminhos ao 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 há necessidade de escapar a personagens especiais nos caminhos.


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

Entra o script MySQL para ser executado 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 dado na Base de Dados do Azure para MySQL.

Exemplo: Pode mudar para o formato de saída separado por separados por separador, para HTML ou até para o formato XML. Outros exemplos incluem:

  • --comments para remover os comentários enviados pelo cliente para o servidor.
  • --quick para evitar o cache de resultados.
  • --xml para gerar resultados em XML.

Todas as opções disponíveis estão descritas na documentação do cliente MySQL.


IpDetectionMethod - especificar regras de firewall usando
string. Required. Valores permitidos: AutoDetect, IPAddressRange. Valor predefinido: AutoDetect.

Para a execução bem-sucedida da tarefa, precisamos de permitir que os administradores acedam ao Base de Dados do Azure para MySQL Server a partir do endereço IP do agente de automação.

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

Valores aceites:

  • AutoDetect para detetar automaticamente o endereço IP público do agente de automação.
  • IPAddressRange especificar explicitamente o intervalo de endereços IP a configurar. Defina o intervalo de endereços IP usando os StartIpAddress parâmetros e.EndIpAddress

Nota: Estes valores são distintos de maiúsculas e maiúsculas.


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

O endereço IP inicial do pool de máquinas de agentes 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 de agentes de automação. Por exemplo: 196.21.30.65.


DeleteFirewallRule - Excluir regra após o término da tarefa
boolean. Valor predefinido: true.

Opcional. Se selecionado, a exceção adicionada para os endereços IP do agente de automação será removida para a correspondente Base de Dados do Azure 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.

Remarks

Esta tarefa implementa scripts para Base de Dados do Azure para MySQL Servidor Flexível. Podes implementar usando um ficheiro SQL ou escrevendo o script em linha.

O Base de Dados do Azure para MySQL Single Server está no caminho da reforma. O Servidor Flexível é o modelo de implementação recomendado para o futuro. AzureMysqlDeployment@2 utiliza o fornecedor de recursos Flexible Server (Microsoft.DBforMySQL/flexibleServers) e as suas APIs de gestão.

Pré-requisitos

Os seguintes pré-requisitos devem ser definidos para que a tarefa funcione corretamente.

Subscrição do Azure

Para implementar no Base de Dados do Azure para MySQL, uma subscrição do Azure deve estar ligada ao Azure DevOps através do separador Ligações de Serviço nas definições do projeto. Use o tipo de endpoint Azure Resource Manager. Para obter mais informações, consulte Conectar-se ao Azure com uma conexão de serviço do Azure Resource Manager.

Banco de Dados do Azure para Servidor Flexível MySQL

Esta tarefa espera que já exista um recurso Base de Dados do Azure para MySQL Servidor Flexível no portal Azure. A tarefa pode criar uma nova base de dados e executar comandos MySQL, mas não cria o próprio servidor.

Cliente MySQL no Agente

  • Windows Agent: Use este script para instalar o cliente MySQL.
  • Agente Linux: Corre apt-get install mysql-client.

Requisitos

Requirement Description
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agent
Demands None
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