Partager via


AzureMysqlDeployment@1 - tâche de déploiement Azure Database pour MySQL v1

Utilisez cette tâche pour exécuter des scripts et apporter des changements à votre base de données dans Azure Database pour MySQL. La tâche de déploiement Azure Database pour MySQL fonctionne uniquement avec Azure Database pour MySQL – Serveur unique.

Syntax

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

Entrées

azureSubscription - Abonnement Azure
Alias d’entrée : ConnectedServiceName. string. Obligatoire.

Cela est nécessaire pour vous connecter à votre compte Azure.

Pour configurer une nouvelle connexion de service, sélectionnez l’abonnement Azure dans la liste, puis cliquez sur Authorize.

Si votre abonnement n’est pas répertorié ou si vous souhaitez utiliser un principal de service existant, vous pouvez configurer une connexion de service Azure à l’aide des Add boutons ou Manage .


ServerName - Nom d’hôte
string. Obligatoire.

Nom de votre serveur Azure Database pour MySQL.

Exemple : fabrikam.mysql.database.azure.com

Le nom du serveur est fourni dans le Portail Azure du panneau « Vue d’ensemble » de votre ressource de serveur Azure Database pour MySQL.

Lorsque vous vous connectez à l’aide de MySQL Workbench, il s’agit de la même valeur que celle utilisée dans HostnameParameters.


DatabaseName - Nom de la base de données
string.

facultatif. Nom de la base de données. Le script crée un nom de base de données s’il n’en existe pas.

S’il n’est pas spécifié, vérifiez que la base de données est référencée dans le fichier SQL fourni ou dans le SQL Inline, si nécessaire.

Remarque : Les noms de base de données MySQL respectent la casse.


SqlUsername - Connexion Administration serveur
string. Obligatoire.

Le serveur Azure Database pour MySQL prend en charge l’authentification MySQL native. Vous pouvez vous connecter et vous authentifier auprès d’un serveur avec les informations de connexion d’administrateur du serveur. Exemple : bbo1@fabrikam.

Lorsque vous vous connectez à l’aide de MySQL Workbench, il s’agit de la même valeur que celle utilisée dans UsernameParameters.


SqlPassword - Mot de passe
string. Obligatoire.

Mot de passe administrateur pour Azure Database pour MySQL. Si vous ne vous souvenez pas du mot de passe, vous pouvez modifier le mot de passe de Portail Azure.

Cette chaîne peut être définie avec une variable dans le pipeline. Exemple : $(password).

En outre, vous pouvez marquer le type de variable comme secret pour le sécuriser.


TaskNameSelector - Type
string. Valeurs autorisées : SqlTaskFile (fichier de script MySQL), InlineSqlTask (script MySQL inline). Valeur par défaut : SqlTaskFile.

facultatif. Sélectionne l’une des options entre fichier de script & script inline.

  • SqlTaskFile (par défaut), à utiliser avec l’argument SqlFile
  • InlineSqlTask, à utiliser avec l’argument SqlInline.

Remarque : ces valeurs respectent la casse.


SqlFile - MySQL Script
string. Nécessaire lorsque TaskNameSelector = SqlTaskFile.

Chemin d’accès complet du fichier de script sur l’agent Automation ou sur un chemin UNC accessible à l’agent Automation. Par exemple : \BudgetIT\DeployBuilds\script.sql.

Les variables système prédéfinies, telles que $(agent.releaseDirectory), et les fichiers contenant des instructions SQL peuvent être utilisés ici.

Remarque : Le client MySQL préfère les chemins de style Unix. Par conséquent, à partir de la version 1.183.0, la tâche convertit les chemins de style Windows en chemins de style Unix. Exemple : de c:\foo\bar\myscript.sql à c:/foo/bar/myscript.sql.

Lorsque la tâche est utilisée sur des plateformes Linux, les chemins d’accès restent inchangés. Il n’est pas nécessaire d’échapper des caractères spéciaux dans les chemins d’accès.


SqlInline - Inline MySQL Script
string. Nécessaire lorsque TaskNameSelector = InlineSqlTask.

Entre le script MySQL à exécuter sur la base de données sélectionnée ci-dessus.


SqlAdditionalArguments - Arguments MySQL supplémentaires
string.

facultatif. Options supplémentaires prises en charge par le client MySQL. Ces options sont appliquées lors de l’exécution du fichier donné sur le Azure Database pour MySQL.

Exemple : Vous pouvez passer au format de sortie séparé par onglet par défaut, au format HTML ou même au format XML. Autres exemples :

  • --comments pour supprimer les commentaires envoyés du client au serveur.
  • --quick pour empêcher la mise en cache des résultats.
  • --xml pour générer des résultats au format XML.

Toutes les options disponibles sont décrites dans la documentation du client MySQL.


IpDetectionMethod - Spécifier des règles de pare-feu à l’aide de
string. Obligatoire. Valeurs autorisées : AutoDetect, IPAddressRange. Valeur par défaut : AutoDetect.

Pour que la tâche s’exécute correctement, nous devons permettre aux administrateurs d’accéder au serveur Azure Database pour MySQL à partir de l’adresse IP de l’agent Automation.

En sélectionnant détection automatique, vous pouvez ajouter automatiquement une exception de pare-feu pour la plage d’adresses IP possibles des agents Automation, ou vous pouvez spécifier explicitement la plage.

Valeurs acceptées :

  • AutoDetect pour détecter automatiquement l’IP publique de l’agent Automation.
  • IPAddressRange pour spécifier explicitement la plage d’adresses IP à configurer. Définissez la plage d’adresses IP à l’aide des paramètres StartIpAddress et EndIpAddress.

Remarque : ces valeurs respectent la casse.


StartIpAddress - Adresse IP de démarrage
string. Nécessaire lorsque IpDetectionMethod = IPAddressRange.

Adresse IP de démarrage du pool d’ordinateurs de l’agent Automation. Par exemple : 196.21.30.50.


EndIpAddress - Adresse IP de fin
string. Nécessaire lorsque IpDetectionMethod = IPAddressRange.

Adresse IP de fin du pool de machines de l’agent Automation. Par exemple : 196.21.30.65.


DeleteFirewallRule - Supprimer une règle après la fin de la tâche
boolean. Valeur par défaut : true.

facultatif. Si cette option est sélectionnée, l’exception ajoutée pour les adresses IP de l’agent Automation est supprimée pour le Azure Database pour MySQL correspondant.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Utilisez cette tâche pour exécuter des scripts et apporter des changements à votre base de données dans Azure Database pour MySQL. Notez qu’il s’agit d’une version préliminaire. La tâche de déploiement Azure Database pour MySQL fonctionne uniquement avec Azure Database pour MySQL – Serveur unique.

Configuration requise

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent
Demandes None
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes Quelconque
Variables settables Quelconque
Version de l’agent 1.100.0 ou supérieur
Catégorie de la tâche Déployer