AzureMysqlDeployment@2 - Azure Database for MySQL Deployment v2 Task

Diese Aufgabe stellt Skripte auf Azure Database for MySQL Flexible Server bereit. Du kannst mit einer SQL-Skriptdatei deployen oder indem du das Skript inline schreibst.

Syntax

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

Eingaben

azureSubscription - Azure-Abonnement-
Eingabe-Alias: ConnectedServiceName. string. Required.

Dies ist notwendig, um sich mit Ihrem Azure-Konto zu verbinden.

Um eine neue Dienstverbindung zu konfigurieren, wählen Sie das Azure-Abonnement aus der Liste aus, und klicken Sie auf Authorize.

Wenn Ihr Abonnement nicht aufgeführt ist oder Sie einen vorhandenen Dienstprinzipal verwenden möchten, können Sie eine Azure-Dienstverbindung mit den Schaltflächen Add oder Manage einrichten.


ServerName - Moderatorname
string. Required.

Der Name Ihres Azure Database for MySQL-Servers.

Beispiel: fabrikam.mysql.database.azure.com

Der Servername wird im Azure-Portal auf dem 'Overview'-Blade Ihrer Azure Database for MySQL-Serverressource angegeben.

Wenn Sie sich mit MySQL Workbench verbinden, ist dies derselbe Wert, der in Parametersverwendet wirdHostname.


DatabaseName - Datenbankname
string.

Dies ist optional. Der Name der Datenbank. Das Skript erstellt einen Datenbanknamen, falls einer nicht existiert.

Falls nicht angegeben, stellen Sie sicher, dass die Datenbank in der bereitgestellten SQL-Datei oder Inline-SQL referenziert wird, wo dies benötigt wird.

Hinweis: MySQL-Datenbanknamen sind groß- und kleinschreibungssensitiv.


SqlUsername - Server-Admin-Login
string. Required.

Der Azure Database for MySQL Server unterstützt native MySQL-Authentifizierung. Du kannst dich mit dem Admin-Login des Servers verbinden und authentifizieren. Beispiel: bbo1@fabrikam.

Wenn Sie sich mit MySQL Workbench verbinden, ist dies derselbe Wert, der in Parametersverwendet wirdUsername.


SqlPassword - Kennwort
string. Required.

Das Administrator-Passwort für Azure Database for MySQL. Falls Sie sich nicht an das Passwort erinnern, können Sie es von Azure portal ändern.

Dieser String kann mit einer Variablen in der Pipeline definiert werden. Beispiel: $(password).

Außerdem kannst du den Variablentyp markieren, um secret ihn zu sichern.


TaskNameSelector - Typ
string. Erlaubte Werte: SqlTaskFile (MySQL-Skriptdatei), InlineSqlTask (Inline-MySQL-Skript). Standardwert: SqlTaskFile.

Dies ist optional. Wählt eine der Optionen zwischen Skriptdatei und Inline-Skript aus.

  • SqlTaskFile(Standard), zur Verwendung mit dem Argument SqlFile
  • InlineSqlTask, zur Verwendung mit dem Argument SqlInline .

Hinweis: Diese Werte sind groß- und kleinschreibungssensitiv.


SqlFile - MySQL Script
string. Erforderlich, wenn TaskNameSelector = SqlTaskFile.

Der vollständige Pfad der Skriptdatei auf dem Automatisierungsagent oder auf einem für den Automatisierungsagenten zugänglichen UNC-Pfad. Beispiel: \\BudgetIT\DeployBuilds\script.sql.

Vordefinierte Systemvariablen wie $(agent.releaseDirectory), und Dateien mit SQL-Anweisungen können hier verwendet werden.

Hinweis: Der MySQL-Client bevorzugt Unix-ähnliche Pfade, sodass ab Version 1.183.0 die Aufgabe Windows-ähnliche Pfade in Unix-ähnliche Pfade umwandelt. Beispiel: von nach c:\foo\bar\myscript.sqlc:/foo/bar/myscript.sql.

Wenn die Aufgabe auf Linux-Plattformen verwendet wird, bleiben die Pfade unverändert. Es ist nicht nötig, Spezialcharaktere in Pfaden zu entkommen.


SqlInline - Inline MySQL Script
string. Erforderlich, wenn TaskNameSelector = InlineSqlTask.

Gibt das MySQL-Skript ein, um auf der oben ausgewählten Datenbank auszuführen.


SqlAdditionalArguments - Zusätzliche MySQL-Argumente
string.

Dies ist optional. Die zusätzlichen Optionen werden vom MySQL-Client unterstützt. Diese Optionen werden angewendet, wenn die jeweilige Datei in der Azure Database for MySQL ausgeführt wird.

Beispiel: Sie können auf das standardmäßige tab-getrennte Ausgabeformat, auf HTML oder sogar auf das XML-Format wechseln. Weitere Beispiele sind:

  • --comments Um Kommentare zu entfernen, die vom Client an den Server gesendet werden.
  • --quick Um Ergebnis-Caching zu verhindern.
  • --xml um Ergebnisse als XML auszugeben.

Alle verfügbaren Optionen sind in der MySQL-Client-Dokumentation beschrieben.


IpDetectionMethod - Firewallregeln mithilfe von angeben
string. Required. Zulässige Werte: AutoDetect, IPAddressRange. Standardwert: AutoDetect.

Für die erfolgreiche Ausführung der Aufgabe müssen wir Administratoren ermöglichen, von der IP-Adresse des Automatisierungsagenten aus auf die Azure Database for MySQL Server zuzugreifen.

Indem Sie Auto-Detect auswählen, können Sie automatisch eine Firewall-Ausnahme für den Bereich der möglichen IP-Adressen von Automatisierungsagenten hinzufügen oder den Bereich explizit angeben.

Zulässige Werte:

  • AutoDetect um die öffentliche IP-Adresse des Automatisierungsagenten automatisch zu erkennen.
  • IPAddressRange um explizit den zu konfigurierenden IP-Adressbereich anzugeben. Stellen Sie den IP-Adressbereich mit den Parametern und StartIpAddressEndIpAddress ein.

Hinweis: Diese Werte sind groß- und kleinschreibungsabhängig.


StartIpAddress - START-IP-Adresse
string. Erforderlich, wenn IpDetectionMethod = IPAddressRange.

Die Start-IP-Adresse des Automation Agent-Maschinenpools. Beispiel: 196.21.30.50.


EndIpAddress - End-IP-Adresse
string. Erforderlich, wenn IpDetectionMethod = IPAddressRange.

Die End-IP-Adresse des Automatisierungsagenten-Maschinenpools. Beispiel: 196.21.30.65.


DeleteFirewallRule - Regel löschen, nachdem der Vorgang beendet
boolean. Standardwert: true.

Dies ist optional. Wenn ausgewählt, wird die hinzugefügte Ausnahme für die IP-Adressen des Automatisierungsagenten für die entsprechende Azure Database for MySQL entfernt.


Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Diese Aufgabe stellt Skripte auf Azure Database for MySQL Flexible Server bereit. Du kannst mit einer SQL-Skriptdatei deployen oder indem du das Skript inline schreibst.

Azure Database for MySQL Single Server befindet sich auf dem Retirement Path. Flexible Server ist das empfohlene Bereitstellungsmodell für die Zukunft. AzureMysqlDeployment@2 verwendet den Flexible Server Resource Provider (Microsoft.DBforMySQL/flexibleServers) und dessen Management-APIs.

Voraussetzungen

Die folgenden Voraussetzungen müssen festgelegt werden, damit die Aufgabe ordnungsgemäß funktioniert.

Azure-Abonnement

Um auf Azure Database for MySQL bereitzustellen, muss ein Azure-Abonnement über den Reiter Service Connections in den Projekteinstellungen mit Azure DevOps verknüpft werden. Verwenden Sie den Endpunkttyp Azure Resource Manager. Weitere Informationen finden Sie unter Verbinden mit Azure mittels einer Azure Resource Manager-Dienstverbindung.

Azure-Datenbank für MySQL Flexible Server

Diese Aufgabe erwartet, dass bereits eine Azure Database for MySQL Flexible Server Ressource im Azure Portal existiert. Die Aufgabe kann eine neue Datenbank erstellen und MySQL-Befehle ausführen, erstellt jedoch nicht den Server selbst.

MySQL-Client auf dem Agenten

  • Windows Agent: Verwenden Sie dieses script, um den MySQL-Client zu installieren.
  • Linux-Agent: Lauf.apt-get install mysql-client

Requirements

Anforderung Beschreibung
Pipeline-Typen YAML, Classic Build, Classic Release
Läuft auf Agent
Demands Nichts
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Einschränkungen von Befehlen Any
Einstellbare Variablen Any
Agentversion 1.100.0 oder höher
Aufgabenkategorie Deploy