Configurez manuellement votre flux de travail CI/CD pour exécuter des tests de charge

• Une organisation et un projet Azure DevOps. Si vous n'avez pas d'organisation Azure DevOps, vous pouvez créer gratuitement. Si vous avez besoin d’aide pour commencer à utiliser Azure Pipelines, consultez Créer votre premier pipeline.

• Un compte GitHub. Si vous n'avez pas de compte GitHub, vous pouvez créer un compte gratuitement.
• Référentiel GitHub pour stocker les fichiers d’entrée de test de charge et créer un flux de travail GitHub Actions. Pour en créer un, consultez Création d’un référentiel.

• Autorisation de créer ou de modifier un pipeline de CI.
• Référentiel de code source pour stocker les fichiers d’entrée de test de charge.

Créer une connexion de service dans Azure Pipelines

Dans Azure Pipelines, vous créez une connexion service dans votre projet de Azure DevOps pour accéder aux ressources de votre abonnement Azure. Lorsque vous créez la connexion de service, Azure DevOps crée un objet de principal de service Microsoft Entra.

1. Connectez-vous à votre organisation Azure DevOps (https://dev.azure.com/<your-organization>), puis sélectionnez votre projet.

   Remplacez l’espace réservé de texte <your-organization> par votre identificateur de projet.

2. Sélectionnez Project settings>Service connections>+ New service connection.

3. Dans le volet Nouvelle connexion de service, sélectionnez Azure Resource Manager, puis sélectionnez Suivant.

4. Sélectionnez la méthode d’authentification Principal de service (automatique), puis Suivant.

5. Entrez les informations de connexion de service, puis sélectionnez Enregistrer pour créer la connexion de service.

   Champ	Valeur
   Niveau de portée	Abonnement.
   Abonnement	Sélectionnez l’abonnement Azure qui héberge votre ressource de test de charge.
   Groupe de ressources	Sélectionnez le groupe de ressources qui contient votre ressource de test de charge.
   Nom de la connexion de service	Saisissez un nom unique pour la connexion de service.
   Accorder l’autorisation d’accès à tous les pipelines	Coché.

6. Dans la liste des connexions de service, sélectionnez celle que vous avez précédemment créée, puis sélectionnez Gérer le principal de service.

   

   Le portail Azure s’ouvre dans un onglet de navigateur distinct et affiche les détails du principal de service.

7. Dans le portail Azure, copiez la valeur Nom d’affichage.

   Vous utilisez cette valeur dans l’étape suivante pour accorder des autorisations d’exécution de tests de charge vers le principal de service.

Accorder l’accès à Test de charge Azure

Test de charge Azure utilise Azure RBAC pour accorder des autorisations pour effectuer des activités spécifiques sur votre ressource de test de charge. Pour exécuter un test de charge à partir de votre pipeline CI/CD, vous accordez le rôle de Contributeur au test de charge au principal de service.

1. Dans le portail Azure, accédez à votre ressource de Test de charge Azure.

2. Sélectionnez Contrôle d’accès (IAM)>Ajouter>Ajouter une attribution de rôle.

3. Sous l’onglet Rôle, sélectionnez Contributeur au test de charge dans la liste des rôles de fonction de travail.

   

4. Sous l’onglet Membres, choisissez Sélectionner des membres, puis utilisez le nom d’affichage que vous avez précédemment copié pour rechercher le principal de service.

5. Sélectionnez le principal du service, puis choisissez Sélectionner.

6. Dans l’onglet Passer en revue + attribuer, sélectionnez Passer en revue + attribuer pour ajouter l’attribution de rôle.

Vous pouvez maintenant utiliser la connexion de service dans votre définition de flux de travail Azure Pipelines pour accéder à votre ressource de test de charge Azure.

Pour accéder à votre ressource d'Test de charge Azure à partir du workflow GitHub Actions, vous créez d'abord un principal de service Microsoft Entra . Ce principal de service représente votre flux de travail GitHub Actions dans Microsoft Entra ID.

Ensuite, vous accordez des autorisations au principal de service pour créer et exécuter un test de charge avec votre ressource Test de charge Azure.

Créer un principal de service

Créez un principal de service dans l’abonnement Azure et attribuez le rôle Contributeur de test de charge afin que votre flux de travail GitHub Actions ait accès à votre ressource de test de charge Azure pour exécuter des tests de charge.

1. Créez un principal de service et attribuez le rôle Load Test Contributor :

   # Get the resource ID for the load testing resource - replace the text place holders.
   loadtest=$(az resource show -g <resource-group-name> -n <load-testing-resource-name> --resource-type "Microsoft.LoadTestService/loadtests" --query "id" -o tsv)
   echo $loadtest
   
   # Create a service principal and assign the Load Test Contributor role - the scope is limited to the load testing resource.
   az ad sp create-for-rbac --name "my-load-test-cicd" --role "Load Test Contributor" \
                            --scopes $loadtest \
                            --json-auth
   

   La sortie est un objet JSON qui représente le principal de service. Vous utilisez ces informations pour vous authentifier auprès de Azure dans le flux de travail GitHub Actions.

   Creating 'Load Test Contributor' role assignment under scope
   {
     "clientId": "00000000-0000-0000-0000-000000000000",
     "clientSecret": "00000000-0000-0000-0000-000000000000",
     "subscriptionId": "00000000-0000-0000-0000-000000000000",
     "tenantId": "00000000-0000-0000-0000-000000000000",
     "activeDirectoryEndpointUrl": "https://login.microsoftonline.com",
     "resourceManagerEndpointUrl": "https://management.azure.com/",
     "activeDirectoryGraphResourceId": "https://graph.windows.net/",
     "sqlManagementEndpointUrl": "https://management.core.windows.net:8443/",
     "galleryEndpointUrl": "https://gallery.azure.com/",
     "managementEndpointUrl": "https://management.core.windows.net/"    
   }
   

   Remarque

   Il est possible que vous ayez un avertissement de dépréciation --sdk-auth lorsque vous exécutez cette commande. Vous pouvez également utiliser l’authentification basée sur OpenID Connect (OIDC) pour authentifier GitHub avec Azure. Découvrez comment utiliser l’action de connexion Azure avec OpenID Connect.

2. Copiez l’objet JSON de sortie dans le presse-papiers.

   Dans l’étape suivante, vous stockez les informations de principal de service en tant que secret GitHub Actions.

Stocker les informations d’identification Azure dans le secret GitHub Actions

Créez un secret GitHub Actions pour stocker en toute sécurité les informations du principe de service. Vous utilisez ce secret dans votre définition de flux de travail pour vous connecter à l’authentification avec Azure et accéder à votre ressource de test de charge Azure.

Pour créer un secret GitHub Actions :

1. Dans GitHub, accédez à votre référentiel.

2. Sélectionnez Paramètres>Secrets et variables>Actions.

3. Sélectionnez Nouveau secret de référentiel, entrez les informations de secret, puis sélectionnez Ajouter un secret pour créer un nouveau secret.

   Champ	Valeur
   Nom	AZURE_CREDENTIALS
   Secret	Collez la sortie JSON de la commande de création du principal de service que vous avez précédemment copiée.

Vous pouvez désormais accéder à votre abonnement Azure et à la ressource de test de charge à partir de votre flux de travail GitHub Actions à l’aide des informations d’identification stockées.

Si vous utilisez un autre outil CI/CD, vous utilisez le Azure CLI pour interagir avec vos ressources Azure. Procédez de la manière suivante pour autoriser l’accès de l’outil de CI à votre ressource de test de charge :

1. Créez un principal de service Microsoft Entra pour vous connecter à votre abonnement Azure et accéder à votre ressource de test de charge Azure.
2. Accordez aux principaux de service les autorisations nécessaires pour créer et exécuter un test de charge en affectant le rôle Contributeur de test de charge.
3. Stockez les informations d’identification Azure en toute sécurité dans l’outil CI.

Procédez de la manière suivante pour configurer l’autorisation de service pour votre outil de CI :

1. Créez un principal de service et attribuez le rôle de contributeur de test de charge :

   Remplacez les valeurs des espaces réservés <resource-group-name> et <load-testing-resource-name>.

   # Get the resource ID for the load testing resource - replace the text place holders.
   loadtest=$(az resource show -g <resource-group-name> -n <load-testing-resource-name> --resource-type "Microsoft.LoadTestService/loadtests" --query "id" -o tsv)
   echo $loadtest
   
   # Create a service principal and assign the Load Test Contributor role - the scope is limited to the load testing resource.
   az ad sp create-for-rbac --name "my-load-test-cicd" --role "Load Test Contributor" \
                            --scopes $loadtest \
                            --json-auth
   

   La sortie est un objet JSON qui représente le principal de service.

   Creating 'Load Test Contributor' role assignment under scope
   {
     "clientId": "00000000-0000-0000-0000-000000000000",
     "clientSecret": "00000000-0000-0000-0000-000000000000",
     "subscriptionId": "00000000-0000-0000-0000-000000000000",
     "tenantId": "00000000-0000-0000-0000-000000000000",
     "activeDirectoryEndpointUrl": "https://login.microsoftonline.com",
     "resourceManagerEndpointUrl": "https://management.azure.com/",
     "activeDirectoryGraphResourceId": "https://graph.windows.net/",
     "sqlManagementEndpointUrl": "https://management.core.windows.net:8443/",
     "galleryEndpointUrl": "https://gallery.azure.com/",
     "managementEndpointUrl": "https://management.core.windows.net/"    
   }
   

2. Copiez les valeurs clientId, clientSecret et tenantId et stockez-les en toute sécurité sous forme de secrets dans votre outil de CI.

   Vous utilisez ces valeurs pour vous connecter à votre abonnement Azure avec la commande Azure CLI az login.

Installer l’extension Test de charge Azure pour Azure DevOps

Pour créer et exécuter un test de charge, la définition de flux de travail Azure Pipelines utilise la tâche Test de charge Azure à partir de la Place de marché Azure DevOps.

1. Ouvrez l’extension de tâche Test de charge Azure dans la Place de marché Azure DevOps, puis sélectionnez Getez-le gratuitement.

2. Sélectionnez votre organisation Azure DevOps, puis Install pour installer l’extension.

   Si vous n'avez pas de privilèges d'administrateur pour l'organisation Azure DevOps sélectionnée, sélectionnez Request pour demander à un administrateur d'installer l'extension.

Mettre à jour le flux de travail Azure Pipelines

Mettez à jour votre flux de travail Azure Pipelines pour exécuter un test de charge pour votre ressource de test de charge Azure.

1. Connectez-vous à votre organisation Azure DevOps (https://dev.azure.com/<your-organization>), puis sélectionnez votre projet.

2. Sélectionnez Pipelines dans le volet de navigation gauche, sélectionnez votre pipeline, puis sélectionnez Modifier pour modifier la définition de votre workflow.

   Vous pouvez également sélectionner Create Pipeline pour créer un pipeline dans Azure Pipelines.

3. Utilisez la tâche AzureLoadTest pour exécuter le test de charge.

   Spécifiez le fichier de configuration de test de charge que vous avez précédemment exporté dans la propriété loadTestConfigFile.

   Remplacez les espaces réservés texte <load-testing-resource> et <load-testing-resource-group> par le nom de votre ressource de test de charge Azure et le groupe de ressources.

       - task: AzureLoadTest@1
         inputs:
           azureSubscription: $(serviceConnection)
           loadTestConfigFile: 'config.yaml'
           loadTestResource: <load-testing-resource>
           resourceGroup: <load-testing-resource-group>
   

   Vous pouvez éventuellement passer des paramètres ou des secrets vers le test de charge à l’aide de la propriété env ou secrets. Définissez waitForCompletion: false si vous souhaitez continuer sans attendre la fin de l’exécution du test de charge.

4. Utilisez la tâche publish pour publier les résultats des tests en tant qu’artefacts dans votre exécution de flux de travail Azure Pipelines.

       - publish: $(System.DefaultWorkingDirectory)/loadTest
         artifact: loadTestResults
   

Mettre à jour le flux de travail GitHub Actions

Mettez à jour votre flux de travail GitHub Actions pour exécuter un test de charge pour votre ressource de test de charge Azure.

1. Dans GitHub, accédez à votre référentiel.

2. Modifiez votre flux de travail GitHub Actions ou créez un nouveau flux de travail dans votre référentiel GitHub.

3. Utilisez l’action actions/checkout pour extraire le référentiel avec les fichiers d’entrée de test de charge.

       - name: Checkout
         uses: actions/checkout@v3
   

4. Utilisez l’action azure/login pour vous authentifier auprès de Azure à l’aide des informations d’identification stockées.

   Collez le contenu YAML suivant dans votre définition de workflow :

       - name: Login to Azure
         uses: azure/login@v1
         continue-on-error: false
         with:
           creds: ${{ secrets.AZURE_CREDENTIALS }}
   

5. Utilisez l’action azure/load-testing pour exécuter le test de charge.

   Spécifiez le fichier de configuration de test de charge que vous avez précédemment exporté dans la propriété loadTestConfigFile.

   Remplacez les espaces réservés texte <load-testing-resource> et <load-testing-resource-group> par le nom de votre ressource de test de charge Azure et le groupe de ressources.

       - name: 'Azure Load Testing'
         uses: azure/load-testing@v1
         with:
           loadTestConfigFile: 'config.yaml'
           loadTestResource: <load-testing-resource>
           resourceGroup: <load-testing-resource-group>
   

   Vous pouvez éventuellement passer des paramètres ou des secrets vers le test de charge à l’aide de la propriété env ou secrets. Définissez waitForCompletion: false si vous souhaitez continuer sans attendre la fin de l’exécution du test de charge.

6. Utilisez l’action actions/upload-artifact pour publier les résultats des tests sous forme d’artefacts dans votre flux de travail GitHub Actions.

       - uses: actions/upload-artifact@v2
         with:
           name: loadTestResults
           path: ${{ github.workspace }}/loadTest
   

Mettez à jour votre flux de travail CI pour exécuter un test de charge pour votre ressource de test de charge Azure à l’aide du Azure CLI. Utilisez les spécificités de votre outil de CI pour ajouter les commandes suivantes à votre flux de travail de CI :

1. Connectez-vous à l’abonnement Azure à l’aide du principal de service.

   Utilisez les valeurs clientId, clientSecret et tenantId que vous avez stockées précédemment.

   az login --service-principal -u $AZURE_CLIENT_ID -p $AZURE_CLIENT_SECRET -t $AZURE_TENANT_ID
   az account set -s $AZURE_SUBSCRIPTION_ID
   

2. Créez un test de charge à l’aide du fichier YAML de configuration de test de charge.

   Remplacez les espaces réservés texte <load-testing-resource>, <load-testing-resource-group> et <load-test-config-yaml> par le nom de la ressource de test de charge, le nom du groupe de ressources et le nom de fichier du fichier YAML de configuration du test de charge que vous avez ajouté au référentiel précédemment.

   az load test create --load-test-resource <load-testing-resource> --resource-group <load-testing-resource-group> --test-id sample-test-id --load-test-config-file <load-test-config-yaml>
   

3. Exécutez le test de charge.

   testRunId="run_"`date +"%Y%m%d%_H%M%S"`
   displayName="Run"`date +"%Y/%m/%d_%H:%M:%S"`
   
   az load test-run create --load-test-resource <load-testing-resource> --test-id sample-test-id --test-run-id $testRunId --display-name $displayName --description "Test run from CLI"
   

4. Récupérez et affichez les métriques côté client pour l’exécution du test de charge.

   az load test-run metrics list --load-test-resource <load-testing-resource> --test-run-id $testRunId --metric-namespace LoadTestRunMetrics
   

1. Supprimez les modifications d'Azure Pipelines.

   1. Connectez-vous à votre organisation Azure DevOps (https://dev.azure.com/<your-organization>), puis sélectionnez votre projet.

      Remplacez l’espace réservé de texte <your-organization> par votre identificateur de projet.

   2. Si vous avez créé un pipeline » :

      1. Sélectionnez Pipelines, puis choisissez votre pipeline.

      2. Sélectionnez les points de suspension, puis sélectionnez Supprimer.

         

      3. Entrez le nom du pipeline, puis sélectionnez Supprimer pour supprimer le pipeline.

   3. Si vous avez modifié une définition de workflow existante, annulez les modifications pour l’exécution du test de charge et enregistrez le workflow.

2. Supprimez la connexion de service :

   1. Sélectionnez Project settings>Service connections, puis sélectionnez votre connexion de service.
   2. Sélectionnez Modifier>Supprimer pour supprimer la connexion de service.

1. Supprimez les modifications de GitHub Actions

   1. Dans GitHub, accédez à votre référentiel.
   2. Si vous avez créé une nouvelle définition de workflow, supprimez le fichier YAML du workflow dans le dossier .github/workflows.
   3. Si vous avez modifié une définition de workflow existante, annulez les modifications pour l’exécution du test de charge et enregistrez le workflow.

2. Supprimez le principal de service :

   az ad sp delete --id $(az ad sp show --display-name "my-load-test-cicd" -o tsv)
   

1. Annulez les modifications apportées à votre flux de travail de CI.

2. Supprimez le principal de service :

   az ad sp delete --id $(az ad sp show --display-name "my-load-test-cicd" -o tsv)