Azure DevOps

Acest ghid explică cum să integrați clientul API JMeter LoadFocus cu Azure DevOps pentru testare automată a performanței.

Pași de configurare

1. Stocarea credențialelor în Azure Key Vault

Pentru gestionarea securizată a credențialelor, stocați credențialele API LoadFocus în Azure Key Vault:

1. Creați un Key Vault în Azure dacă nu aveți unul
2. Adăugați următoarele secrete:
   • loadfocus-api-key: Cheia API LoadFocus
   • loadfocus-team-id: ID-ul echipei LoadFocus
3. Configurați o conexiune de serviciu pentru a accesa Key Vault din pipeline

2. Crearea unui pipeline Azure

Creați un fișier nou numit azure-pipelines.yml în repository:

trigger:
  - main
  - develop

pool:
  vmImage: 'ubuntu-latest'

variables:
  - group: loadfocus-variables  # Variable group containing Key Vault references

stages:
  - stage: Build
    jobs:
      - job: BuildAndTest
        steps:
          # Your existing build and test steps...

  - 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:
          # Your deployment steps...

3. Configurarea grupului de variabile cu integrare Key Vault

1. Accesați Pipelines > Library > Variable Groups
2. Creați un grup de variabile nou numit „loadfocus-variables"
3. Conectați-l la Azure Key Vault
4. Adăugați următoarele variabile, conectându-le la secretele Key Vault:
   • LOADFOCUS_API_KEY: Conectat la secretul loadfocus-api-key
   • LOADFOCUS_TEAM_ID: Conectat la secretul loadfocus-team-id

Configurare avansată

Utilizarea template-urilor YAML

Pentru pași reutilizabili de testare a performanței, creați un fișier template 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

Apoi în pipeline-ul principal:

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

Rularea testelor multiple

Pentru a rula mai multe teste de performanță în secvență:

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

    # Run 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'

Integrare cu Azure Test Plans

Pentru a integra rezultatele testelor de performanță cu Azure Test Plans:

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

Va trebui să convertiți ieșirea JSON în format JUnit:

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

    # Convert JSON to JUnit format (using a custom script)
    node convert-to-junit.js \
      $(Build.ArtifactStagingDirectory)/performance_results.json \
      $(Build.ArtifactStagingDirectory)/test-results.xml
  displayName: 'Run Performance Tests and Convert Results'

Sfaturi pentru integrarea Azure DevOps

1. Job-uri paralele: Dacă aveți mai multe teste de performanță, luați în considerare utilizarea job-urilor paralele:

   jobs:
   - job: API_Performance_Test
     steps:
       # Run API performance test
   
   - job: UI_Performance_Test
     steps:
       # Run UI performance test

2. Porți de deployment: Utilizați rezultatele testelor de performanță ca poartă de deployment:

   - job: DeploymentGate
     steps:
     - script: |
         # Check if performance tests passed
         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. Tablou de bord personalizat: Creați un tablou de bord personalizat pentru a vizualiza rezultatele testelor de performanță în timp.

4. Notificări: Configurați notificări pentru eșuările testelor de performanță:

   - 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()

Pentru mai multe informații, consultați documentația Azure DevOps și documentația clientului API LoadFocus.