Azure DevOps

Denna guide förklarar hur du integrerar LoadFocus JMeter API-klienten med Azure DevOps för automatiserad prestandatestning.

Installationssteg

1. Lagra autentiseringsuppgifter i Azure Key Vault

För säker hantering av autentiseringsuppgifter, lagra dina LoadFocus API-uppgifter i Azure Key Vault:

  1. Skapa ett Key Vault i Azure om du inte redan har ett
  2. Lägg till följande hemligheter:
    • loadfocus-api-key: Din LoadFocus API-nyckel
    • loadfocus-team-id: Ditt LoadFocus team-ID
  3. Konfigurera en tjänstanslutning för att komma åt Key Vault från din pipeline

2. Skapa en Azure Pipeline

Skapa en ny fil med namnet azure-pipelines.yml i ditt repository:

trigger:
  - main
  - develop


pool:
  vmImage: 'ubuntu-latest'


variables:
  - group: loadfocus-variables  # Variabelgrupp som innehåller Key Vault-referenser


stages:
  - stage: Build
    jobs:
      - job: BuildAndTest
        steps:
          # Dina befintliga bygg- och teststeg...


  - stage: PerformanceTest
    dependsOn: Build
    condition: succeeded()
    jobs:
      - job: RunPerformanceTests
        steps:
          - task: NodeTool@0
            inputs:
              versionSpec: '16.x'
            displayName: 'Install Node.js'


          - script: |
              npm install -g @loadfocus/loadfocus-api-client
            displayName: 'Install LoadFocus JMeter API Client'


          - script: |
              loadfocus-api config set apikey $(LOADFOCUS_API_KEY)
              loadfocus-api config set teamid $(LOADFOCUS_TEAM_ID)
            displayName: 'Configure LoadFocus API Client'


          - script: |
              loadfocus-api jmeter run-test \
                --name "AzureDevOps_$(Build.Repository.Name)_$(Build.SourceBranchName)" \
                --thresholds "avgresponse<=200,errors==0,p95<=250" \
                --format json > $(Build.ArtifactStagingDirectory)/performance_results.json
            displayName: 'Run Performance Tests'
            continueOnError: false


          - task: PublishBuildArtifacts@1
            inputs:
              pathtoPublish: '$(Build.ArtifactStagingDirectory)'
              artifactName: 'performance-test-results'
            displayName: 'Publish Performance Test Results'


  - stage: Deploy
    dependsOn: PerformanceTest
    condition: succeeded()
    jobs:
      - job: DeployApplication
        steps:
          # Dina deployment-steg...

3. Konfigurera variabelgrupp med Key Vault-integration

  1. Gå till Pipelines > Library > Variable Groups
  2. Skapa en ny variabelgrupp med namnet "loadfocus-variables"
  3. Länka den till ditt Azure Key Vault
  4. Lägg till följande variabler och länka dem till dina Key Vault-hemligheter:
    • LOADFOCUS_API_KEY: Länka till hemligheten loadfocus-api-key
    • LOADFOCUS_TEAM_ID: Länka till hemligheten loadfocus-team-id

Avancerad konfiguration

Använda YAML-mallar

För återanvändbara prestandateststeg, skapa en mallfil performance-test-template.yml:

parameters:
  testName: 'Default_Test'
  thresholds: 'avgresponse<=200,errors==0,p95<=250'
  waitTimeout: 1800


steps:
- script: |
    loadfocus-api jmeter run-test \
      --name "${{ parameters.testName }}" \
      --thresholds "${{ parameters.thresholds }}" \
      --waitTimeout ${{ parameters.waitTimeout }} \
      --format json > $(Build.ArtifactStagingDirectory)/performance_results.json
  displayName: 'Run Performance Tests'
  continueOnError: false

Sedan i din huvudpipeline:

- template: performance-test-template.yml
  parameters:
    testName: 'AzureDevOps_$(Build.Repository.Name)_$(Build.SourceBranchName)'
    thresholds: 'avgresponse<=150,errors==0,p95<=200'
    waitTimeout: 2400

Köra flera tester

För att köra flera prestandatester i sekvens:

- script: |
    # Kör API-test
    loadfocus-api jmeter run-test \
      --name "API_Test" \
      --thresholds "avgresponse<=200,errors==0" \
      --format json > $(Build.ArtifactStagingDirectory)/api_test_results.json


    # Kör UI-test
    loadfocus-api jmeter run-test \
      --name "UI_Test" \
      --thresholds "avgresponse<=500,errors==0" \
      --format json > $(Build.ArtifactStagingDirectory)/ui_test_results.json
  displayName: 'Run Multiple Performance Tests'

Integration med Azure Test Plans

För att integrera prestandatestresultat med Azure Test Plans:

- task: PublishTestResults@2
  inputs:
    testResultsFormat: 'JUnit'
    testResultsFiles: '$(Build.ArtifactStagingDirectory)/test-results.xml'
    testRunTitle: 'Performance Tests'
  displayName: 'Publish Test Results'
  condition: succeededOrFailed()

Du behöver konvertera JSON-utdatan till JUnit-format:

- script: |
    # Kör prestandatest
    loadfocus-api jmeter run-test \
      --name "AzureDevOps_Test" \
      --thresholds "avgresponse<=200,errors==0" \
      --format json > $(Build.ArtifactStagingDirectory)/performance_results.json


    # Konvertera JSON till JUnit-format (med ett anpassat skript)
    node convert-to-junit.js \
      $(Build.ArtifactStagingDirectory)/performance_results.json \
      $(Build.ArtifactStagingDirectory)/test-results.xml
  displayName: 'Run Performance Tests and Convert Results'

Tips för Azure DevOps-integration

  1. Parallella jobb: Om du har flera prestandatester, överväg att använda parallella jobb:

    jobs:
    - job: API_Performance_Test
      steps:
        # Kör API-prestandatest
    

    - job: UI_Performance_Test
      steps:
        # Kör UI-prestandatest

  2. Deployment-grindar: Använd prestandatestresultat som en deployment-grind:

    - job: DeploymentGate
      steps:
      - script: |
          # Kontrollera om prestandatester godkändes
          if grep -q '"overallResult": "FAILED"' $(Build.ArtifactStagingDirectory)/performance_results.json; then
            echo "##vso[task.logissue type=error]Performance tests failed"
            echo "##vso[task.complete result=Failed;]"
          fi

  3. Anpassad instrumentpanel: Skapa en anpassad instrumentpanel för att visualisera prestandatestresultat över tid.

  4. Notifikationer: Konfigurera notifikationer för misslyckade prestandatester:

    - task: SendEmail@1
      inputs:
        to: 'team@example.com'
        subject: 'Performance Test Failed'
        body: 'Performance tests failed to meet thresholds. See attached results.'
        addAttachment: true
        attachmentPath: '$(Build.ArtifactStagingDirectory)/performance_results.json'
      condition: failed()

För mer information, se Azure DevOps-dokumentationen och LoadFocus API-klientdokumentationen.

Föregående
API-integration för lasttestning
Nästa
CircleCI