Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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 oSqlFileargumento -
InlineSqlTask, para uso com oSqlInlineargumento.
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:
-
--commentspara remover os comentários enviados pelo cliente para o servidor. -
--quickpara evitar o cache de resultados. -
--xmlpara 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:
-
AutoDetectpara detetar automaticamente o endereço IP público do agente de automação. -
IPAddressRangeespecificar explicitamente o intervalo de endereços IP a configurar. Defina o intervalo de endereços IP usando osStartIpAddressparâ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 |