AzureMysqlDeployment@2 - compito di deployment v2 Database di Azure per MySQL

Questo compito distribuisce script su Database di Azure per MySQL Flexible Server. Puoi distribuire usando un file di script SQL o scrivendo lo script in linea.

Sintassi

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

Ingressi

azureSubscription - sottoscrizione di Azure
Alias di input: ConnectedServiceName. string. Obbligatorio.

Questo è necessario per collegarti al tuo account Azure.

Per configurare una nuova connessione al servizio, selezionare la sottoscrizione di Azure nell'elenco e fare clic su Authorize.

Se la sottoscrizione non è elencata o se si vuole usare un'entità servizio esistente, è possibile configurare una connessione al servizio di Azure usando i pulsanti Add o Manage.


ServerName - Nome ospite
string. Obbligatorio.

Il nome del tuo server Database di Azure per MySQL.

Esempio: fabrikam.mysql.database.azure.com

Il nome del server è fornito nel portale Azure sulla lama 'Overview' della tua risorsa server Database di Azure per MySQL.

Quando ti connetti usando MySQL Workbench, questo è lo stesso valore usato per Hostname .Parameters


DatabaseName - Nome del database
string.

Optional. Nome del database. Lo script creerà un nome di database se non esiste.

Se non specificato, assicurarsi che il database sia riferito nel file SQL fornito o SQL inline, dove necessario.

Nota: i nomi dei database MySQL sono distinti dalla mastruzzeria e minuscolo.


SqlUsername - Login Amministratore Server
string. Obbligatorio.

Il server Database di Azure per MySQL supporta l'autenticazione nativa MySQL. Puoi connetterti e autenticarti a un server con l'accesso amministrativo del server. Esempio: bbo1@fabrikam.

Quando ti connetti usando MySQL Workbench, questo è lo stesso valore usato per Username .Parameters


SqlPassword - password
string. Obbligatorio.

La password amministratore per Database di Azure per MySQL. Nel caso non ricordi la password, puoi cambiarla dal portale Azure.

Questa stringa può essere definita con una variabile nella pipeline. Esempio: $(password).

Inoltre, puoi indicare il tipo di variabile per secret assicurarla.


di tipo TaskNameSelector -
string. Valori consentiti: SqlTaskFile (MySQL Script File), InlineSqlTask (Inline MySQL Script). Valore predefinito: SqlTaskFile

Optional. Seleziona una delle opzioni tra File di Script e Script Inline.

  • SqlTaskFile(predefinito), per l'uso con l'argomento SqlFile
  • InlineSqlTask, da usare con l'argomento SqlInline .

Nota: questi valori sono distinti dalla maiuscola e minuscola.


SqlFile - MySQL Script
string. Obbligatorio quando TaskNameSelector = SqlTaskFile.

Il percorso completo del file script sull'agente di automazione o su un percorso UNC accessibile all'agente di automazione. Ad esempio: \\BudgetIT\DeployBuilds\script.sql.

Qui possono essere usate variabili di sistema predefinite, come $(agent.releaseDirectory), e file contenenti istruzioni SQL.

Nota: Il client MySQL preferisce i percorsi in stile Unix, quindi dalla versione 1.183.0 in poi, il compito convertirà i percorsi in stile Windows in percorsi in stile Unix. Esempio: da c:\foo\bar\myscript.sql a c:/foo/bar/myscript.sql.

Quando il compito viene utilizzato su piattaforme Linux, i percorsi rimangono invariati. Non c'è bisogno di sfuggire a personaggi speciali nei percorsi.


SqlInline - Inline MySQL Script
string. Obbligatorio quando TaskNameSelector = InlineSqlTask.

Entra in scena lo script MySQL per eseguire sul database selezionato sopra.


SqlAdditionalArguments - Argomenti aggiuntivi di MySQL
string.

Optional. Le opzioni aggiuntive supportate dal client MySQL. Queste opzioni vengono applicate durante l'esecuzione del file fornito sull'Database di Azure per MySQL.

Esempio: puoi cambiare il formato di output predefinito separato dalle schede, in HTML o anche in formato XML. Altri esempi includono:

  • --comments per rimuovere i commenti inviati dal client al server.
  • --quick per evitare la cache dei risultati.
  • --xml per produrre i risultati in XML.

Tutte le opzioni disponibili sono descritte nella documentazione del client MySQL.


IpDetectionMethod - specificare le regole del firewall tramite
string. Obbligatorio. Valori consentiti: AutoDetect, IPAddressRange. Valore predefinito: AutoDetect

Per l'esecuzione con successo del compito, dobbiamo permettere agli amministratori di accedere al server Database di Azure per MySQL dall'indirizzo IP dell'agente di automazione.

Selezionando il rilevamento automatico, puoi aggiungere automaticamente un'eccezione firewall per l'intervallo di possibili indirizzi IP degli agenti di automazione, oppure specificare esplicitamente l'intervallo.

Valori accettati:

  • AutoDetect per rilevare automaticamente l'indirizzo IP pubblico dell'agente di automazione.
  • IPAddressRange per specificare esplicitamente l'intervallo di indirizzi IP da configurare. Imposta l'intervallo di indirizzi IP usando i StartIpAddress parametri e.EndIpAddress

Nota: Questi valori sono distinti dalla maiuscola e minuscola.


StartIpAddress - Indirizzo IP iniziale
string. Obbligatorio quando IpDetectionMethod = IPAddressRange.

L'indirizzo IP iniziale del pool di macchine di agenti di automazione. Ad esempio: 196.21.30.50.


EndIpAddress - indirizzo IP finale
string. Obbligatorio quando IpDetectionMethod = IPAddressRange.

L'indirizzo IP finale del pool di macchine agenti di automazione. Ad esempio: 196.21.30.65.


DeleteFirewallRule - elimina regola al termine dell'attività
boolean. Valore predefinito: true

Optional. Se selezionata, l'eccezione aggiunta per gli indirizzi IP dell'agente di automazione verrà rimossa per il corrispondente Database di Azure per MySQL.


Opzioni di controllo delle attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni:

Questo compito distribuisce script su Database di Azure per MySQL Flexible Server. Puoi distribuire usando un file di script SQL o scrivendo lo script in linea.

Database di Azure per MySQL Single Server è sul percorso di pensionamento. Il server flessibile è il modello di distribuzione raccomandato per il futuro. AzureMysqlDeployment@2 utilizza il fornitore di risorse Flexible Server (Microsoft.DBforMySQL/flexibleServers) e le sue API di gestione.

Prerequisiti

Devono essere stabiliti i seguenti prerequisiti affinché il compito funzioni correttamente.

Sottoscrizione di Azure

Per distribuire su Database di Azure per MySQL, un abbonamento Azure deve essere collegato ad Azure DevOps tramite la scheda Service Connections nelle impostazioni del progetto. Usa il tipo di endpoint Azure Resource Manager. Per altre informazioni, vedere Connettersi ad Azure con una connessione al servizio Azure Resource Manager.

Database di Azure per MySQL - Server flessibile

Questo compito si aspetta che una risorsa Database di Azure per MySQL Flexible Server esista già nel portale Azure. Il task può creare un nuovo database ed eseguire comandi MySQL, ma non crea il server stesso.

Client MySQL sull'agente

  • Windows Agent: Usa questo script per installare il client MySQL.
  • Agente Linux: Corri apt-get install mysql-client.

Requisiti

Requisito Description
Tipi di pipeline YAML, build classica, versione classica
Funziona su Agent
Demands Nessuno
Funzionalità Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente 1.100.0 o superiore
Categoria attività Distribuire