AzureMysqlDeployment@2 - Azure Database for MySQL utrullningsuppgift v2

Denna uppgift distribuerar skript till Azure Database for MySQL Flexible Server. Du kan distribuera med en SQL-skriptfil eller genom att skriva skriptet inline.

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.

Ingångar

azureSubscription - Azure-prenumeration
Alias för inmatning: ConnectedServiceName. string. Required.

Detta behövs för att ansluta till ditt Azure-konto.

Om du vill konfigurera en ny tjänstanslutning väljer du Azure-prenumerationen i listan och klickar på Authorize.

Om din prenumeration inte visas eller om du vill använda ett befintligt tjänsthuvudnamn kan du konfigurera en Azure-tjänstanslutning med hjälp av knapparna Add eller Manage.


ServerName - Värdnamn
string. Required.

Namnet på din Azure Database for MySQL-server.

Exempel: fabrikam.mysql.database.azure.com

Servernamnet anges i Azure-portalen på 'Overview'-bladet i din Azure Database for MySQL-serverresurs.

När du ansluter med MySQL Workbench är detta samma värde som används för Hostname i Parameters.


DatabaseName - Databasens namn
string.

Optional. Namnet på databasen. Skriptet skapar ett databasnamn om det inte finns.

Om det inte specificeras, se till att databasen refereras i den medföljande SQL-filen eller inline-SQL, där det behövs.

Obs: MySQL-databasnamn är kasuskänsliga.


SqlUsername - Serveradministratörsinloggning
string. Required.

Azure Database for MySQL-servern stöder inbyggd MySQL-autentisering. Du kan ansluta och autentisera dig mot en server med serverns admininloggning. Exempel: bbo1@fabrikam.

När du ansluter med MySQL Workbench är detta samma värde som används för Username i Parameters.


SqlPassword - Lösenord
string. Required.

Administratörslösenordet för Azure Database for MySQL. Om du inte minns lösenordet kan du ändra det från Azure portal.

Denna sträng kan definieras med en variabel i pipelinen. Exempel: $(password).

Du kan också markera variabeltypen för secret att säkra den.


TaskNameSelector - typ
string. Tillåtna värden: SqlTaskFile (MySQL Script File), InlineSqlTask (Inline MySQL Script). Standardvärde: SqlTaskFile.

Optional. Väljer ett av alternativen mellan Script File och Inline Script.

  • SqlTaskFile(default), för användning med argumentet SqlFile
  • InlineSqlTask, för användning med argumentet SqlInline .

Observera: dessa värden är kasuskänsliga.


SqlFile - MySQL Script
string. Krävs när TaskNameSelector = SqlTaskFile.

Den fullständiga sökvägen för skriptfilen på automationsagenten eller på en UNC-väg som är tillgänglig för automationsagenten. Till exempel: \\BudgetIT\DeployBuilds\script.sql.

Fördefinierade systemvariabler, såsom $(agent.releaseDirectory), och filer som innehåller SQL-satser kan användas här.

Observera: MySQL-klienten föredrar Unix-liknande vägar, så från version 1.183.0 och framåt konverterar uppgiften Windows-stil vägar till Unix-liknande vägar. Exempel: från c:\foo\bar\myscript.sql till c:/foo/bar/myscript.sql.

När uppgiften används på Linux-plattformar förblir vägarna oförändrade. Det finns inget behov av att undvika specialkaraktärer i vägar.


SqlInline - Inline MySQL-skript
string. Krävs när TaskNameSelector = InlineSqlTask.

Anger MySQL-skriptet för att köras på databasen som valts ovan.


SqlAdditionalArguments - Ytterligare MySQL-argument
string.

Optional. De ytterligare alternativen som stöds av MySQL-klienten. Dessa alternativ tillämpas när den aktuella filen körs på Azure Database for MySQL.

Exempel: Du kan byta till standardformatet för tabulusseparerad utdata, till HTML eller till och med till XML-formatet. Andra exempel är:

  • --comments För att ta bort kommentarer som skickas från klienten till servern.
  • --quick för att förhindra resultatcache.
  • --xml för att ge resultat som XML.

Alla tillgängliga alternativ beskrivs i MySQL-klientdokumentationen.


IpDetectionMethod - ange brandväggsregler med hjälp av
string. Required. Tillåtna värden: AutoDetect, IPAddressRange. Standardvärde: AutoDetect.

För att uppgiften ska lyckas måste vi ge administratörer tillgång till Azure Database for MySQL Server från automationsagentens IP-adress.

Genom att välja auto-detektering kan du automatiskt lägga till ett brandväggsundantag för intervallet av möjliga IP-adresser för automationsagenter, eller så kan du uttryckligen ange intervallet.

Godkända värden:

  • AutoDetect för att automatiskt upptäcka automationsagentens publika IP-adress.
  • IPAddressRange för att uttryckligen specificera IP-adressintervallet som ska konfigureras. Ställ in IP-adressintervallet med hjälp av och-parametrarna StartIpAddressEndIpAddress .

Notera: Dessa värden är kasuskänsliga.


StartIpAddress - Starta IP-adress
string. Krävs när IpDetectionMethod = IPAddressRange.

Start-IP-adressen för automationsagentens maskinpool. Till exempel: 196.21.30.50.


EndIpAddress - slut-IP-adress
string. Krävs när IpDetectionMethod = IPAddressRange.

Den slutande IP-adressen för automationsagentens maskinpool. Till exempel: 196.21.30.65.


DeleteFirewallRule - ta bort regel när aktiviteten har avslutats
boolean. Standardvärde: true.

Optional. Om den väljs kommer det tillagda undantaget för automationsagentens IP-adresser att tas bort för motsvarande Azure Database for MySQL.


Alternativ för uppgiftskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Anmärkningar

Denna uppgift distribuerar skript till Azure Database for MySQL Flexible Server. Du kan distribuera med en SQL-skriptfil eller genom att skriva skriptet inline.

Azure Database for MySQL Single Server är på pensioneringsvägen. Flexible Server är den rekommenderade distributionsmodellen framöver. AzureMysqlDeployment@2 använder resursleverantören Flexible Server (Microsoft.DBforMySQL/flexibleServers) och dess hanterings-API:er.

Förutsättningar

Följande förutsättningar måste fastställas för att arbetet ska fungera korrekt.

Azure-prenumeration

För att distribuera till Azure Database for MySQL måste en Azure-prenumeration kopplas till Azure DevOps via fliken Service Connections i projektinställningarna. Använd endpoint-typen Azure Resource Manager. Mer information finns i Ansluta till Azure med en Azure Resource Manager-tjänstanslutning.

Azure Database for MySQL Flexible Server

Denna uppgift förväntar sig att en Azure Database for MySQL Flexible Server resurs redan finns i Azure-portalen. Uppgiften kan skapa en ny databas och köra MySQL-kommandon, men den skapar inte servern själv.

MySQL Client på agenten

  • Windows Agent: Använd detta script för att installera MySQL-klienten.
  • Linux-agent: Spring apt-get install mysql-client.

Requirements

Krav Description
Typer av pipelines YAML, klassisk version, klassisk version
Körs på Agent
Demands Ingen
Kapaciteter Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Begränsningar för kommandon Vilket som helst
Inställbara variabler Vilket som helst
Agentversion 1.100.0 eller högre
Aktivitetskategori Rulla ut