Azure DevOps
Denne veiledningen forklarer hvordan du integrerer LoadFocus JMeter API-klienten med Azure DevOps for automatisert ytelsestesting.
Oppsettstrinn
1. Lagre legitimasjon i Azure Key Vault
For sikker administrasjon av legitimasjon, lagre LoadFocus API-legitimasjonen din i Azure Key Vault:
- Opprett en Key Vault i Azure hvis du ikke allerede har en
- Legg til følgende hemmeligheter:
loadfocus-api-key: Din LoadFocus API-nøkkelloadfocus-team-id: Din LoadFocus team-ID
- Sett opp en tjenesteforbindelse for å få tilgang til Key Vault fra pipelinen din
2. Opprett en Azure Pipeline
Opprett en ny fil kalt azure-pipelines.yml i repositoriet ditt:
trigger:- main- developpool:vmImage: 'ubuntu-latest'variables:- group: loadfocus-variables # Variable group containing Key Vault referencesstages:- stage: Buildjobs:- job: BuildAndTeststeps:# Your existing build and test steps...- stage: PerformanceTestdependsOn: Buildcondition: succeeded()jobs:- job: RunPerformanceTestssteps:- task: NodeTool@0inputs:versionSpec: '16.x'displayName: 'Install Node.js'- script: |npm install -g @loadfocus/loadfocus-api-clientdisplayName: '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.jsondisplayName: 'Run Performance Tests'continueOnError: false- task: PublishBuildArtifacts@1inputs:pathtoPublish: '$(Build.ArtifactStagingDirectory)'artifactName: 'performance-test-results'displayName: 'Publish Performance Test Results'- stage: DeploydependsOn: PerformanceTestcondition: succeeded()jobs:- job: DeployApplicationsteps:# Your deployment steps...
3. Sett opp variabelgruppe med Key Vault-integrasjon
- Gå til Pipelines > Library > Variable Groups
- Opprett en ny variabelgruppe kalt "loadfocus-variables"
- Koble den til Azure Key Vault
- Legg til følgende variabler, koblet til Key Vault-hemmelighetene dine:
LOADFOCUS_API_KEY: Koble tilloadfocus-api-key-hemmelighetenLOADFOCUS_TEAM_ID: Koble tilloadfocus-team-id-hemmeligheten
Avansert konfigurasjon
Bruk av YAML-maler
For gjenbrukbare ytelsestestingstrinn, opprett en malfil performance-test-template.yml:
parameters:testName: 'Default_Test'thresholds: 'avgresponse<=200,errors==0,p95<=250'waitTimeout: 1800steps:- script: |loadfocus-api jmeter run-test \--name "${{ parameters.testName }}" \--thresholds "${{ parameters.thresholds }}" \--waitTimeout ${{ parameters.waitTimeout }} \--format json > $(Build.ArtifactStagingDirectory)/performance_results.jsondisplayName: 'Run Performance Tests'continueOnError: false
Deretter i hovedpipelinen din:
- template: performance-test-template.ymlparameters:testName: 'AzureDevOps_$(Build.Repository.Name)_$(Build.SourceBranchName)'thresholds: 'avgresponse<=150,errors==0,p95<=200'waitTimeout: 2400
Kjøre flere tester
For å kjøre flere ytelsestester i sekvens:
- script: |# Run API testloadfocus-api jmeter run-test \--name "API_Test" \--thresholds "avgresponse<=200,errors==0" \--format json > $(Build.ArtifactStagingDirectory)/api_test_results.json# Run UI testloadfocus-api jmeter run-test \--name "UI_Test" \--thresholds "avgresponse<=500,errors==0" \--format json > $(Build.ArtifactStagingDirectory)/ui_test_results.jsondisplayName: 'Run Multiple Performance Tests'
Integrasjon med Azure Test Plans
For å integrere ytelsestestresultater med Azure Test Plans:
- task: PublishTestResults@2inputs:testResultsFormat: 'JUnit'testResultsFiles: '$(Build.ArtifactStagingDirectory)/test-results.xml'testRunTitle: 'Performance Tests'displayName: 'Publish Test Results'condition: succeededOrFailed()
Du må konvertere JSON-utdataene til JUnit-format:
- script: |# Run performance testloadfocus-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.xmldisplayName: 'Run Performance Tests and Convert Results'
Tips for Azure DevOps-integrasjon
Parallelle jobber: Hvis du har flere ytelsestester, vurder å bruke parallelle jobber:
jobs:- job: API_Performance_Teststeps:# Run API performance test- job: UI_Performance_Teststeps:# Run UI performance testDistribusjonsporter: Bruk ytelsestestresultater som en distribusjonsport:
- job: DeploymentGatesteps:- script: |# Check if performance tests passedif grep -q '"overallResult": "FAILED"' $(Build.ArtifactStagingDirectory)/performance_results.json; thenecho "##vso[task.logissue type=error]Performance tests failed"echo "##vso[task.complete result=Failed;]"fiTilpasset dashbord: Opprett et tilpasset dashbord for å visualisere ytelsestestresultater over tid.
Varsler: Sett opp varsler for feil i ytelsestester:
- task: SendEmail@1inputs:to: 'team@example.com'subject: 'Performance Test Failed'body: 'Performance tests failed to meet thresholds. See attached results.'addAttachment: trueattachmentPath: '$(Build.ArtifactStagingDirectory)/performance_results.json'condition: failed()
For mer informasjon, se Azure DevOps-dokumentasjonen og LoadFocus API-klientdokumentasjonen.