Delen via

AzureMysqlDeployment@1 - Azure Database for MySQL-implementatie v1-taak

  • Artikel

Gebruik deze taak om uw scripts uit te voeren en wijzigingen aan te brengen in uw database in Azure Database for MySQL. De Azure Database for MySQL-implementatietaak werkt alleen met Azure Database for MySQL Enkele server.

Syntaxis

# Azure Database for MySQL deployment v1
# Run your scripts and make changes to your Azure Database for MySQL.
- task: AzureMysqlDeployment@1
  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.

Invoer

azureSubscription - Azure-abonnement
Invoeralias: ConnectedServiceName. string. Verplicht.

Dit is nodig om verbinding te maken met uw Azure-account.

Als u een nieuwe serviceverbinding wilt configureren, selecteert u het Azure-abonnement in de lijst en klikt u op Authorize.

Als uw abonnement niet wordt vermeld of als u een bestaande service-principal wilt gebruiken, kunt u een Azure-serviceverbinding instellen met behulp van de knoppen Add of Manage.


ServerName - hostnaam
string. Verplicht.

De naam van uw Azure Database for MySQL-server.

Voorbeeld: fabrikam.mysql.database.azure.com

De servernaam wordt opgegeven in Azure Portal op de blade Overzicht van uw Azure Database for MySQL-serverresource.

Wanneer u verbinding maakt met MySQL Workbench, is dit dezelfde waarde die wordt gebruikt voor Hostname in Parameters.


DatabaseName - databasenaam
string.

Facultatief. De naam van de database. Met het script wordt een databasenaam gemaakt als deze niet bestaat.

Als dit niet is opgegeven, moet u ervoor zorgen dat naar de database wordt verwezen in het opgegeven SQL-bestand of inline SQL, indien nodig.

Opmerking: MySQL-databasenamen zijn hoofdlettergevoelig.


SqlUsername - aanmeldgegevens van de serverbeheerder
string. Verplicht.

De Azure Database for MySQL-server ondersteunt systeemeigen MySQL-verificatie. U kunt verbinding maken met en verifiëren bij een server met de beheerdersaanmelding van de server. Voorbeeld: bbo1@fabrikam.

Wanneer u verbinding maakt met MySQL Workbench, is dit dezelfde waarde die wordt gebruikt voor Username in Parameters.


SqlPassword - wachtwoord
string. Verplicht.

Het beheerderswachtwoord voor Azure Database for MySQL. Als u het wachtwoord niet meer weet, kunt u het wachtwoord wijzigen vanuit Azure Portal.

Deze tekenreeks kan worden gedefinieerd met een variabele in de pijplijn. Voorbeeld: $(password).

U kunt ook het variabeletype markeren als secret om het te beveiligen.


TaskNameSelector - type
string. Toegestane waarden: SqlTaskFile (MySQL-scriptbestand), InlineSqlTask (Inline MySQL-script). Standaardwaarde: SqlTaskFile.

Facultatief. Selecteert een van de opties tussen scriptbestand & inlinescript.

  • SqlTaskFile (standaard) voor gebruik met het argument SqlFile
  • InlineSqlTaskvoor gebruik met het argument SqlInline.

Opmerking: deze waarden zijn hoofdlettergevoelig.


SqlFile - MySQL-script
string. Vereist wanneer TaskNameSelector = SqlTaskFile.

Het volledige pad van het scriptbestand op de automatiseringsagent of op een UNC-pad dat toegankelijk is voor de automatiseringsagent. Voorbeeld: \BudgetIT\DeployBuilds\script.sql.

Vooraf gedefinieerde systeemvariabelen, zoals $(agent.releaseDirectory), en bestanden met SQL-instructies kunnen hier worden gebruikt.

Opmerking: De MySQL-client geeft de voorkeur aan Unix-stijlpaden, dus vanaf versie 1.183.0 worden Windows-stijlpaden geconverteerd naar Unix-stijlpaden. Voorbeeld: van c:\foo\bar\myscript.sql tot c:/foo/bar/myscript.sql.

Wanneer de taak wordt gebruikt op Linux-platforms, blijven paden ongewijzigd. U hoeft geen speciale tekens in paden te escapen.


SqlInline - Inline MySQL-script
string. Vereist wanneer TaskNameSelector = InlineSqlTask.

Hiermee voert u het MySQL-script in dat moet worden uitgevoerd op de database die hierboven is geselecteerd.


SqlAdditionalArguments - Aanvullende MySQL-argumenten
string.

Facultatief. De extra opties die worden ondersteund door de MySQL-client. Deze opties worden toegepast bij het uitvoeren van het opgegeven bestand in Azure Database for MySQL.

Voorbeeld: U kunt de standaarduitvoerindeling wijzigen in de standaarduitvoerindeling, in HTML of zelfs in de XML-indeling. Andere voorbeelden zijn:

  • --comments om opmerkingen die van de client naar de server worden verzonden, te verwijderen.
  • --quick om het opslaan van resultaten in de cache te voorkomen.
  • --xml om resultaten uit te voeren als XML.

Alle beschikbare opties worden beschreven in de mySQL-clientdocumentatie.


IpDetectionMethod - Firewallregels opgeven met behulp van
string. Verplicht. Toegestane waarden: AutoDetect, IPAddressRange. Standaardwaarde: AutoDetect.

Voor een geslaagde uitvoering van de taak moeten beheerders toegang hebben tot de Azure Database for MySQL-server vanuit het IP-adres van de automatiseringsagent.

Door automatisch detecteren te selecteren, kunt u automatisch een firewalluitzondering toevoegen voor het bereik van mogelijke IP-adressen van automatiseringsagents of u kunt het bereik expliciet opgeven.

Geaccepteerde waarden:

  • AutoDetect het openbare IP-adres van de automation-agent automatisch detecteren.
  • IPAddressRange expliciet het IP-adresbereik opgeven dat moet worden geconfigureerd. Stel het IP-adresbereik in met behulp van de parameters StartIpAddress en EndIpAddress.

Opmerking: deze waarden zijn hoofdlettergevoelig.


StartIpAddress - IP-adres starten
string. Vereist wanneer IpDetectionMethod = IPAddressRange.

Het begin-IP-adres van de machinegroep van de automation-agent. Voorbeeld: 196.21.30.50.


EndIpAddress - -eind-IP-adres
string. Vereist wanneer IpDetectionMethod = IPAddressRange.

Het eind-IP-adres van de machinegroep van de automation-agent. Voorbeeld: 196.21.30.65.


DeleteFirewallRule - regel verwijderen nadat de taak is beëindigd
boolean. Standaardwaarde: true.

Facultatief. Als deze optie is geselecteerd, wordt de toegevoegde uitzondering voor de IP-adressen van de automation-agent verwijderd voor de bijbehorende Azure Database for MySQL.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om uw scripts uit te voeren en wijzigingen aan te brengen in uw database in Azure Database for MySQL. Houd er rekening mee dat dit een preview-versie is. De Azure Database for MySQL-implementatietaak werkt alleen met Azure Database for MySQL Enkele server.

Vereisten

Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Vertegenwoordiger
eisen Geen
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Welk dan ook
variabelen instellen Welk dan ook
Agentversie 1.100.0 of hoger
Taakcategorie Implementeren