Utiliser Azure DevOps pour créer un pipeline CI/CD pour une tâche Stream AnalyticsUse Azure DevOps to create a CI/CD pipeline for a Stream Analytics job

Dans cet article, vous allez apprendre à créer des pipelines Azure DevOps build et release à l’aide des outils Azure Stream Analytics CI/CD.In this article, you learn how to create Azure DevOps build and release pipelines using Azure Stream Analytics CI/CD tools.

Valider votre projet Stream AnalyticsCommit your Stream Analytics project

Avant de commencer, validez vos projets Stream Analytics complets en tant que fichiers sources dans un référentiel Azure DevOps.Before you begin, commit your complete Stream Analytics projects as source files to an Azure DevOps repository. Vous pouvez référencer cette exemple de référentiel et le code source du projet Stream Analytics dans Azure Pipelines.You can reference this sample repository and Stream Analytics project source code in Azure Pipelines.

Les étapes décrites dans cet article utilisent un projet Stream Analytics Visual Studio Code.The steps in this article use a Stream Analytics Visual Studio Code project. Si vous utilisez un projet Visual Studio, suivez les étapes décrites dans Automatiser les builds, les tests et les déploiements d’une tâche Azure Stream Analytics à l’aide des outils CI/CD.If you're using a Visual Studio project, follow the steps in Automate builds, tests, and deployments of an Azure Stream Analytics job using CI/CD tools.

Créer un pipeline de buildCreate a build pipeline

Dans cette section, vous découvrez comment créer un pipeline de build.In this section, you learn how to create a build pipeline. Vous pouvez consulter cet exemple de pipeline de build et de test automatiques dans Azure DevOps.You can reference this sample auto build and test pipeline in Azure DevOps.

  1. Ouvrez un navigateur web et accédez à votre projet dans Azure DevOps.Open a web browser and navigate to your project in Azure DevOps.

  2. Sous Pipelines dans le menu de navigation gauche, sélectionnez Builds.Under Pipelines in the left navigation menu, select Builds. Sélectionnez ensuite Nouveau pipeline.Then, select New pipeline.

    Créer un pipeline Azure

  3. Sélectionnez Utiliser l’éditeur classique pour créer un pipeline sans YAML.Select Use the classic editor to create a pipeline without YAML.

  4. Sélectionnez votre type de source, votre projet d’équipe et votre référentiel.Select your source type, team project, and repository. Sélectionnez ensuite Continuer.Then, select Continue.

    Sélectionner un projet Azure Stream Analytics

  5. Dans la page Sélectionner un modèle, sélectionnez Projet vide.On the Choose a template page, select Empty job.

Installer le package npmInstall npm package

  1. Dans la page Tâches, sélectionnez le signe plus en regard de Travail d’agent 1.On the Tasks page, select the plus sign next to Agent job 1. Entrez npm dans la recherche de tâches et sélectionnez npm.Enter npm in the task search and select npm.

    Sélectionner une tâche npm

  2. Donnez à la tâche un nom d’affichage.Give the task a Display name. Définissez l'option Commande sur Personnalisée, puis entrez la commande suivante dans Commande et arguments.Change the Command option to custom and enter the following command in Command and arguments. Conservez les options par défaut restantes.Leave the remaining default options.

    install -g azure-streamanalytics-cicd
    

    Entrer les configurations pour la tâche npm

Ajoutez une tâche de buildAdd a Build task

  1. Dans la page Variables , sélectionnez + Ajouter dans Variables de pipeline.On the Variables page, select + Add in Pipeline variables. Ajoutez les variables suivantes.Add the following variables. Définissez les valeurs suivantes en fonction de vos préférences :Set the following values according to your preference:

    Nom de la variableVariable name ValeurValue
    projectRootPathprojectRootPath [YourProjectName][YourProjectName]
    outputPathoutputPath SortieOutput
    deployPathdeployPath DéployerDeploy
  2. Dans la page Tâches, sélectionnez le signe plus en regard de Travail d’agent 1.On the Tasks page, select the plus sign next to Agent job 1. Recherchez Ligne de commande.Search for Command line.

  3. Donnez à la tâche un nom d’affichage et entrez le script suivant.Give the task a Display name and enter the following script. Modifiez le script avec le nom de votre référentiel et le nom de votre projet.Modify the script with your repository name and project name.

    azure-streamanalytics-cicd build -project $(projectRootPath)/asaproj.json -outputpath $(projectRootPath)/$(outputPath)/$(deployPath)
    

    L’image ci-dessous utilise un projet Stream Analytics Visual Studio Code à titre d’exemple.The image below uses a Stream Analytics Visual Studio Code project as an example.

    Entrer les configurations pour la tâche de ligne de commande Visual Studio Code

Ajouter une Tâche de testAdd a Test task

  1. Dans la page Variables , sélectionnez + Ajouter dans Variables de pipeline.On the Variables page, select + Add in Pipeline variables. Ajoutez les variables suivantes.Add the following variables. Modifiez les valeurs avec le chemin de sortie et le nom du référentiel.Modify the values with your output path and repository name.

    Nom de la variableVariable name ValeurValue
    testPathtestPath TestTest

    Ajouter des variables de pipeline

  2. Dans la page Tâches, sélectionnez le signe plus en regard de Travail d’agent 1.On the Tasks page, select the plus sign next to Agent job 1. Recherchez Ligne de commande.Search for Command line.

  3. Donnez à la tâche un nom d’affichage et entrez le script suivant.Give the task a Display name and enter the following script. Modifiez le script avec le nom de votre fichier projet et le chemin d’accès au fichier de configuration de test.Modify the script with your project file name and the path to the test configuration file.

    Pour plus d’informations sur la façon d’ajouter et de configurer des cas de test, consultez Instructions de test automatisées.See automated test instructions for details on how to add and configure test cases.

    azure-streamanalytics-cicd test -project $(projectRootPath)/asaproj.json -outputpath $(projectRootPath)/$(outputPath)/$(testPath) -testConfigPath $(projectRootPath)/test/testConfig.json 
    

    Entrer les configurations pour la tâche de ligne de commande

Ajouter une tâche de copie des fichiersAdd a Copy files task

Vous devez ajouter une tâche de copie des fichiers pour copier le fichier de résumé de test et les fichiers de modèle Azure Resource Manager dans le dossier de l’artefact.You need to add a copy file task to copy the test summary file and Azure Resource Manager template files to the artifact folder.

  1. Dans la page Tâches, sélectionnez + en regard de Tâche d’agent 1.On the Tasks page, select the + next to Agent job 1. Recherchez Copier des fichiers.Search for Copy files. Entrez ensuite les configurations suivantes.Then enter the following configurations. En affectant des ** à Contenus, tous les fichiers des résultats des tests sont copiés.By assigning ** to Contents, all files of the test results are copied.

    ParamètreParameter EntréeInput
    Nom completDisplay name Copier des fichiers vers : $(build.artifactstagingdirectory)Copy Files to: $(build.artifactstagingdirectory)
    Dossier sourceSource Folder $(system.defaultworkingdirectory)/$(outputPath)/
    ContenuContents **
    Dossier cibleTarget Folder $(build.artifactstagingdirectory)
  2. Développez Options de contrôleExpand Control Options. Sélectionnez Même en cas d'échec d'une tâche antérieure, sauf si la build a été annulée dans Exécuter cette tâche.Select Even if a previous task has failed, unless the build was canceled in Run this task.

    Entrer les configurations pour la tâche de copie

Ajouter une tâche Publier des artefacts de buildAdd a Publish build artifacts task

  1. Dans la page Tâches, sélectionnez le signe plus en regard de Travail d’agent 1.On the Tasks page, select the plus sign next to Agent job 1. Recherchez Publier des artefacts de build et sélectionnez l’option accompagnée d'une icône de flèche noire.Search for Publish build artifacts and select the option with the black arrow icon.

  2. Développez Options de contrôleExpand Control Options. Sélectionnez Même en cas d'échec d'une tâche antérieure, sauf si la build a été annulée dans Exécuter cette tâche.Select Even if a previous task has failed, unless the build was canceled in Run this task.

    Entrer les configurations pour la tâche de publication

Enregistrer et exécuterSave and run

Après avoir ajouté les tâches npm, ligne de commande, copier les fichiers et publier les artefacts de build, sélectionnez Enregistrer et mettre en file d'attente.Once you have finished adding the npm package, command line, copy files, and publish build artifacts tasks, select Save & queue. Lorsque vous y êtes invité, entrez un commentaire d'enregistrement et sélectionnez Enregistrer et exécuter.When you are prompted, enter a save comment and select Save and run. Vous pouvez télécharger les résultats des tests à partir de la page Résumé du pipeline.You can download the testing results from Summary page of the pipeline.

Vérifier les résultats de build et de testCheck the build and test results

Le fichier de résumé de test et les fichiers de modèle Azure Resource Manager se trouvent dans le dossier Publié.The test summary file and Azure Resource Manager Template files can be found in Published folder.

Vérifier les résultats de build et de test

Vérifier les artefacts

Mettre en production avec Azure PipelinesRelease with Azure Pipelines

Dans cette section, vous découvrez comment créer un pipeline de mise en production.In this section, you learn how to create a release pipeline. Vous pouvez référencer cet exemple de pipeline de mise en production dans Azure DevOps.You can reference this sample release pipeline in Azure DevOps.

Ouvrez un navigateur web et accédez à votre projet Azure Stream Analytics Visual Studio Code.Open a web browser and navigate to your Azure Stream Analytics Visual Studio Code project.

  1. Sous Pipelines dans le menu de navigation gauche, sélectionnez Mises en production.Under Pipelines in the left navigation menu, select Releases. Sélectionnez ensuite Nouveau pipeline.Then select New pipeline.

  2. Sélectionnez Démarrer par une tâche vide.Select start with an Empty job.

  3. Dans la zone Artefacts, sélectionnez + Ajouter un artefact.In the Artifacts box, select + Add an artifact. Sous Source, sélectionnez le pipeline de build que vous venez de créer, puis Ajouter.Under Source, select the build pipeline you created and select Add.

    Entrer un artefact de pipeline de build

  4. Remplacez le nom de Étape 1 par Travail de déploiement dans l’environnement de test.Change the name of Stage 1 to Deploy job to test environment.

  5. Ajoutez une nouvelle étape et nommez-la Travail de déploiement dans l'environnement de production.Add a new stage and name it Deploy job to production environment.

Ajouter des tâches de déploiementAdd deploy tasks

  1. Dans la liste déroulante des tâches, sélectionnez Travail de déploiement dans l’environnement de test.From the tasks dropdown, select Deploy job to test environment.

  2. Sélectionnez + en regard de Tâche d'agent et recherchez Déploiement du modèle ARM.Select the + next to Agent job and search for ARM template deployment. Entrez les paramètres suivants :Enter the following parameters:

    ParamètreParameter ValeurValue
    Nom completDisplay name Déployer myASAProjectDeploy myASAProject
    Abonnement AzureAzure subscription Choisissez votre abonnement.Choose your subscription.
    ActionAction Créer ou mettre à jour un groupe de ressourcesCreate or update resource group
    Resource groupResource group Choisissez un nom pour le groupe de ressources de test qui contiendra votre travail Stream Analytics.Choose a name for the test resource group that will contain your Stream Analytics job.
    EmplacementLocation Sélectionnez l’emplacement de votre groupe de ressources de test.Choose the location of your test resource group.
    Emplacement du modèleTemplate location Artefact liéLinked artifact
    ModèleTemplate $(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.json$(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.json
    Paramètres de modèleTemplate parameters $(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.parameters.json$(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.parameters.json
    Remplacer les paramètres du modèleOverride template parameters <arm_template_parameter> "your value".-<arm_template_parameter> "your value". Vous pouvez définir les paramètres à l’aide de Variables.You can define the parameters using Variables.
    Mode de déploiementDeployment mode IncrémentielIncremental
  3. Dans la liste déroulante des tâches, sélectionnez Travail de déploiement dans l’environnement de production.From the tasks dropdown, select Deploy job to production environment.

  4. Sélectionnez + en regard de Tâche d'agent et recherchez Déploiement du modèle ARM.Select the + next to Agent job and search for ARM template deployment. Entrez les paramètres suivants :Enter the following parameters:

    ParamètreParameter ValeurValue
    Nom completDisplay name Deploy myASAProjectDeploy myASAProject
    Abonnement AzureAzure subscription Choisissez votre abonnement.Choose your subscription.
    ActionAction Créer ou mettre à jour un groupe de ressourcesCreate or update resource group
    Resource groupResource group Choisissez un nom pour le groupe de ressources de production qui contiendra votre travail Stream Analytics.Choose a name for the production resource group that will contain your Stream Analytics job.
    EmplacementLocation Sélectionnez l’emplacement de votre groupe de ressources de production.Choose the location of your production resource group.
    Emplacement du modèleTemplate location Artefact liéLinked artifact
    ModèleTemplate $(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.json$(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.json
    Paramètres de modèleTemplate parameters $(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.parameters.json$(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.parameters.json
    Remplacer les paramètres du modèleOverride template parameters -<arm_template_parameter> "your value".-<arm_template_parameter> "your value"
    Mode de déploiementDeployment mode IncrémentielIncremental

Créer une mise en productionCreate a release

Pour créer une mise en production, sélectionnez Créer une mise en production dans le coin supérieur droit.To create a release, select Create release in the top-right corner.

Créer une mise en production à l'aide d'Azure Pipelines

Étapes suivantesNext steps