Partager via


Exemple de script de prédéploiement et de post-déploiement

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Conseil

Essayez Data Factory dans Microsoft Fabric, une solution d’analyse tout-en-un pour les entreprises. Microsoft Fabric couvre tous les aspects, du déplacement des données à la science des données, en passant par l’analyse en temps réel, l’aide à la décision et la création de rapports. Découvrez comment démarrer un nouvel essai gratuitement !

L’exemple suivant montre comment utiliser un script de pré-déploiement et de publication avec intégration et remise continues dans Azure Data Factory.

Installation d’Azure PowerShell

Installez les modules Azure PowerShell les plus récents en suivant les instructions décrites dans Comment installer et configurer Azure PowerShell.

Avertissement

Veillez à utiliser PowerShell Core dans la tâche ADO pour exécuter le script

Script de pré-déploiement et de post-déploiement

Les exemples de scripts pour arrêter/démarrer des déclencheurs et mettre à jour les paramètres globaux pendant le processus de mise en production (CICD) se trouvent dans la page GitHub officielle d’Azure Data Factory.

Notes

Utilisez le PrePostDeploymentScript.Ver2.ps1 si vous souhaitez désactiver/activer uniquement les déclencheurs qui ont été modifiés au lieu d’activer/désactiver tous les déclencheurs pendant CI/CD.

Exécution du script et paramètres

L’exemple de script suivant peut être utilisé pour arrêter les déclencheurs avant le déploiement, et les redémarrer après. Le script inclut également le code pour supprimer les ressources qui ont été retirées. Enregistrez le script dans un dépôt Git Azure DevOps et référencez-le par le biais d’une tâche Azure PowerShell comme la dernière version Azure PowerShell.

Lors de l’exécution d’un script de prédéploiement, vous devez spécifier une variation des paramètres suivants dans le champ Arguments de script.

-armTemplate "$(System.DefaultWorkingDirectory)/<your-arm-template-location>" -ResourceGroupName <your-resource-group-name> -DataFactoryName <your-data-factory-name> -predeployment $true -deleteDeployment $false

Lors de l’exécution d’un script de post-déploiement, vous devez spécifier une variation des paramètres suivants dans le champ Arguments de script.

-armTemplate "$(System.DefaultWorkingDirectory)/<your-arm-template-location>" -ResourceGroupName <your-resource-group-name> -DataFactoryName <your-data-factory-name> -predeployment $false -deleteDeployment $true

Notes

L’indicateur -deleteDeployment est utilisé pour spécifier la suppression de l’entrée de déploiement ADF de l’historique de déploiement dans ARM.

Azure PowerShell task

Exécution et paramètres de script – Pipelines YAML

Le code YAML suivant exécute un script qui permet d’arrêter les déclencheurs avant le déploiement et de les redémarrer ensuite. Le script inclut également le code pour supprimer les ressources qui ont été retirées. Si vous suivez les étapes décrites dans Nouveau flux CI/CD, ce script est exporté dans le cadre de l’artefact créé via le package npm publish.

Arrêter les déclencheurs ADF

 - task: AzurePowerShell@5
            displayName: Stop ADF Triggers
            inputs:
              scriptType: 'FilePath'
              ConnectedServiceNameARM: AzureDevServiceConnection
              scriptPath: ../ADFTemplates/PrePostDeploymentScript.ps1
              ScriptArguments: -armTemplate "<your-arm-template-location>" -ResourceGroupName <your-resource-group-name> -DataFactoryName <your-data-factory-name> -predeployment $true -deleteDeployment $false
              errorActionPreference: stop
              FailOnStandardError: False
              azurePowerShellVersion: 'LatestVersion'
              pwsh: True
              workingDirectory: ../

Démarrer les déclencheurs ADF

          - task: AzurePowerShell@5
            displayName: Start ADF Triggers
            inputs:
              scriptType: 'FilePath'
              ConnectedServiceNameARM: AzureDevServiceConnection
              scriptPath: ../ADFTemplates/PrePostDeploymentScript.ps1
              ScriptArguments: -armTemplate "<your-arm-template-location>" -ResourceGroupName <your-resource-group-name> -DataFactoryName <your-data-factory-name>-predeployment $false -deleteDeployment $true
              errorActionPreference: stop
              FailOnStandardError: False
              azurePowerShellVersion: 'LatestVersion'
              pwsh: True
              workingDirectory: ../