Jenkins

Tämä opas selittää kuinka integroida LoadFocus JMeter API Client Jenkinsin kanssa automatisoitua suorituskykytestausta varten.

Asennusvaiheet

1. Tallenna tunnistetiedot Jenkinsiin

Tallenna ensin LoadFocus API -tunnistetietosi turvallisesti Jenkinsiin:

1. Siirry kohtaan Jenkins Dashboard > Manage Jenkins > Manage Credentials
2. Valitse sopiva tunnistetietojen alue (esim. global)
3. Napsauta "Add Credentials"
4. Lisää seuraavat tunnistetiedot:
   • Kind: Secret text
   • Scope: Global
   • Secret: LoadFocus API -avaimesi
   • ID: loadfocus-api-key
   • Description: LoadFocus API Key
5. Toista tiimi-ID:lle tunnuksella: loadfocus-team-id

2. Luo Jenkins-putki

Luo Jenkinsfile repositorioosi:

pipeline {
    agent {
        docker {
            image 'node:16-alpine'
        }
    }

    environment {
        LOADFOCUS_API_KEY = credentials('loadfocus-api-key')
        LOADFOCUS_TEAM_ID = credentials('loadfocus-team-id')
    }

    stages {
        stage('Build') {
            steps {
                // Your build steps
                sh 'npm install'
                sh 'npm run build'
            }
        }

        stage('Test') {
            steps {
                // Your test steps
                sh 'npm test'
            }
        }

        stage('Performance Test') {
            steps {
                // Install LoadFocus JMeter API Client
                sh 'npm install -g @loadfocus/loadfocus-api-client'

                // Configure LoadFocus API Client
                sh 'loadfocus-api config set apikey $LOADFOCUS_API_KEY'
                sh 'loadfocus-api config set teamid $LOADFOCUS_TEAM_ID'

                // Run Performance Tests
                sh '''
                    loadfocus-api jmeter run-test \
                      --name "Jenkins_${JOB_NAME}_${BUILD_NUMBER}" \
                      --thresholds "avgresponse<=200,errors==0,p95<=250" \
                      --format json > performance_results.json
                '''

                // Archive the results
                archiveArtifacts artifacts: 'performance_results.json', fingerprint: true
            }
        }

        stage('Deploy') {
            when {
                expression {
                    return currentBuild.resultIsBetterOrEqualTo('SUCCESS')
                }
            }
            steps {
                // Your deployment steps
                echo 'Deploying...'
            }
        }
    }

    post {
        always {
            // Clean up workspace
            cleanWs()
        }
    }
}

3. Konfiguroi Jenkins-tehtävä

1. Luo uusi Pipeline-tehtävä Jenkinsiin
2. Konfiguroi putki käyttämään Jenkinsfileasi
3. Määritä sopiva SCM-konfiguraatio repositoriosi hakemiseen

Edistynyt konfigurointi

Deklaratiivinen putki rinnakkaisella testauksella

Useiden suorituskykytestien suorittaminen rinnakkain:

pipeline {
    agent any

    environment {
        LOADFOCUS_API_KEY = credentials('loadfocus-api-key')
        LOADFOCUS_TEAM_ID = credentials('loadfocus-team-id')
    }

    stages {
        // Previous stages...

        stage('Performance Tests') {
            parallel {
                stage('API Performance') {
                    agent {
                        docker {
                            image 'node:16-alpine'
                        }
                    }
                    steps {
                        sh 'npm install -g @loadfocus/loadfocus-api-client'
                        sh 'loadfocus-api config set apikey $LOADFOCUS_API_KEY'
                        sh 'loadfocus-api config set teamid $LOADFOCUS_TEAM_ID'
                        sh '''
                            loadfocus-api jmeter run-test \
                              --name "API_Performance_Test" \
                              --thresholds "avgresponse<=150,errors==0" \
                              --format json > api_performance_results.json
                        '''
                        archiveArtifacts artifacts: 'api_performance_results.json', fingerprint: true
                    }
                }

                stage('UI Performance') {
                    agent {
                        docker {
                            image 'node:16-alpine'
                        }
                    }
                    steps {
                        sh 'npm install -g @loadfocus/loadfocus-api-client'
                        sh 'loadfocus-api config set apikey $LOADFOCUS_API_KEY'
                        sh 'loadfocus-api config set teamid $LOADFOCUS_TEAM_ID'
                        sh '''
                            loadfocus-api jmeter run-test \
                              --name "UI_Performance_Test" \
                              --thresholds "avgresponse<=300,errors==0" \
                              --format json > ui_performance_results.json
                        '''
                        archiveArtifacts artifacts: 'ui_performance_results.json', fingerprint: true
                    }
                }
            }
        }

        // Next stages...
    }
}

Vinkkejä Jenkins-integraatioon

1. Aikakatkaisun käsittely: Aseta aikakatkaisut pitkäkestoisille suorituskykytesteille:

   stage('Performance Test') {
       options {
           timeout(time: 60, unit: 'MINUTES')
       }
       steps {
           // Performance test steps
       }
   }

2. Ehdollinen suoritus: Suorita suorituskykytestit vain tietyissä haaroissa:

   stage('Performance Test') {
       when {
           anyOf {
               branch 'main'
               branch 'develop'
               tag pattern: "v\\d+\\.\\d+\\.\\d+", comparator: "REGEXP"
           }
       }
       steps {
           // Performance test steps
       }
   }

3. Ajastettu testaus: Suorita suorituskykytestit aikataulun mukaan:

   pipeline {
       agent any
   
       triggers {
           cron('0 0 * * *')  // Run at midnight every day
       }
   
       stages {
           // Pipeline stages
       }
   }

4. Parametrisoidut testit: Mahdollista testiparametrien mukauttaminen:

   pipeline {
       agent any
   
       parameters {
           string(name: 'TEST_NAME', defaultValue: 'API_Performance_Test', description: 'Name of the LoadFocus test to run')
           string(name: 'THRESHOLDS', defaultValue: 'avgresponse<=200,errors==0', description: 'Performance thresholds')
           string(name: 'WAIT_TIMEOUT', defaultValue: '1800', description: 'Maximum wait time in seconds')
       }
   
       stages {
           stage('Performance Test') {
               steps {
                   // Run test with parameters
                   sh """
                       loadfocus-api jmeter run-test \\
                         --name "${params.TEST_NAME}" \\
                         --thresholds "${params.THRESHOLDS}" \\
                         --waitTimeout ${params.WAIT_TIMEOUT} \\
                         --format json > performance_results.json
                   """
               }
           }
       }
   }

Lisätietoja löydät Jenkins-dokumentaatiosta ja LoadFocus API Client -dokumentaatiosta.