ProHoster > Blog > Administrácia > Spustenie JMeter testov v OpenShift pomocou Jenkins Pipeline

Spustenie JMeter testov v OpenShift pomocou Jenkins Pipeline

Ahojte všetci!

V tomto článku sa chcem podeliť o jeden zo spôsobov spustenia JMeter výkonových testov v OpenShift s použitím Jenkins ako automatizácie. Najprv vykonáme všetky potrebné akcie (vytvorenie ImageStreams, BuildConfig, Práca a ďalšie) ručne. Potom napíšeme Jenkins Pipeline.

Ako východiskový bod by sme mali mať:

  1. funkčný OpenShift (v3.11) klaster
  2. Jenkins server so nakonfigurovanými povereniami pre prácu v OpenShift
  3. súbor apache-jmeter-5.2.tgz

Testy budú jednoduché HTTP Request na ya.ru v jednom vlákne.

Vytvorenie projektu v OpenShift

Začneme vytvorením nového prostredia. Vytvoríme perftest prostredie príkazom:

$ oc new-project perftest --display-name="Performance Tests" --description="Performance Tests - JMeter"

Automaticky nás presunie do práve vytvoreného prostredia perftest, skontrolujeme, či je to tak:

$ oc project
Using project "perftest" on server "https://127.0.0.1:8443".

Vytvorenie Storage’u

Správy testov budú uložené na spoločnom mieste pre webový server a jmeter-meter‘a miesto — /jmeter/reports.

Je lepšie vytvoriť storage teraz, pretože na ňom budú závislé POD’y jmeter-web a jmeter-master.

Podrobnejšie informácie o storage nájdete v oficiálnej dokumentácii Persistent Storage.

Vytvoríme yaml súbory pre PV a PVC.

pv.yaml

$ tee pv.yaml<<EOF
apiVersion: v1
kind: PersistentVolume
metadata:
  name: jmeter-reports
spec:
  capacity:
    storage: 10Gi
  accessModes:
    - ReadWriteMany
  glusterfs:
    endpoints: glusterfs-cluster
    path: /jmeter/reports
    readOnly: false
  persistentVolumeReclaimPolicy: Retain
EOF

pvc.yaml

$ tee pvc.yaml<<EOF
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: jmeter-reports
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 10Gi
EOF

Vytvoríme PV a PVC v prostredí OpenShift:

$ oc create -f pv.yaml -n perftest
$ oc create -f pvc.yaml -n perftest

Kontrolujeme stav pre PVC:

$ oc get pvc -n perftest
NAME             STATUS    VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS        AGE
jmeter-reports   Bound     pvc-b0e5f152-db4b-11ea-a497-566f75280024   10Gi       RWX            glusterfs-storage   8m

Takto to bude vyzerať v GUI:

Spustenie JMeter testov v OpenShift pomocou Jenkins Pipeline

Vytvorenie základného obrazu JMeter

Prejdeme k vytvoreniu ImageStream a BuildConfig.

Všetky potrebné informácie nájdete v dokumentácii — Builds and Image Streams.

Ako stratégiu pre výstavbu obrazov používame Docker z lokálneho zdroja.

Vytvoríme základný obraz jmeter-base, ktorý bude základom pre jmeter-master.

Dockerfile

FROM openjdk:8u212-jdk

ARG JMETER_VER="5.2"
ENV JMETER_HOME /jmeter/apache-jmeter-$JMETER_VER
ENV PATH $JMETER_HOME/bin:$PATH

RUN mkdir -p /jmeter/results 
    && mkdir /jmeter/tests

WORKDIR /jmeter

COPY apache-jmeter-$JMETER_VER.tgz .

RUN tar -xzf $JMETER_HOME.tgz 
    && rm $JMETER_HOME.tgz 
    && ls -la

RUN sed -i s/#server.rmi.ssl.disable=false/server.rmi.ssl.disable=true/ $JMETER_HOME/bin/jmeter.properties

EXPOSE 60000

is.yaml

$ tee is.yaml<<EOF
apiVersion: v1
kind: ImageStream
metadata:
  labels:
    build: jmeter-base
  name: jmeter-base
EOF

bc.yaml

$ tee bc.yaml<<EOF
apiVersion: v1
kind: BuildConfig
metadata:
  name: jmeter-base
spec:
  failedBuildsHistoryLimit: 5
  nodeSelector: null
  output:
    to:
      kind: ImageStreamTag
      name: 'jmeter-base:latest'
  postCommit: {}
  resources: {}
  runPolicy: Serial
  source:
    binary: {}
    type: Binary
  strategy:
    dockerStrategy:
      from:
        kind: ImageStreamTag
        name: 'openjdk:8u212-jdk'
    type: Docker
  successfulBuildsHistoryLimit: 5
EOF

Vytvoríme objekty IS a BC:

$ oc create -f is.yaml -n perftest
$ oc create -f bc.yaml -n perftest

Teraz zostavíme základný obraz jmeter-base:

$ oc start-build jmeter-base -n perftest --from-dir=. --follow

JMeter WEB

jmeter-web je webový server Apache. Jeho úlohou je poskytnúť adresár s výsledkami testovania na prezeranie.

Pripravené Dockerfile a konfiguračný súbor httpd.conf. Pre direktívu DocumentRoot je nastavená hodnota /jmeter/reports, t.j. adresár, do ktorého sa ukladajú výsledky testovania.

Dockerfile

$ tee Dockerfile<<EOF
FROM httpd:2.4

COPY httpd.conf /usr/local/apache2/conf/httpd.conf
RUN chmod -R 777 /usr/local/apache2/logs

EXPOSE 8080

CMD ["httpd", "-D", "FOREGROUND"]
EOF

is.yaml

$ tee is.yaml<<EOF
apiVersion: v1
kind: ImageStream
metadata:
  generation: 1
  labels:
    build: jmeter-web
  name: jmeter-web
EOF

bc.yaml

$ tee bc.yaml<<EOF
apiVersion: v1
kind: BuildConfig
metadata:
  name: jmeter-web
spec:
  failedBuildsHistoryLimit: 5
  nodeSelector: null
  output:
    to:
      kind: ImageStreamTag
      name: 'jmeter-web:latest'
  runPolicy: Serial
  source:
    binary: {}
    type: Binary
  strategy:
    dockerStrategy:
      from:
        kind: ImageStreamTag
        name: 'httpd:2.4'
    type: Docker
  successfulBuildsHistoryLimit: 5
EOF

Vytvoríme ImageStream a BuildConfig objekty:

$ oc create -f is.yaml -n perftest
$ oc create -f bc.yaml -n perftest

Zostavujeme obraz z Dockerfile:

$ oc start-build jmeter-web -n perftest --from-dir=. --follow

dc.yaml

$ tee dc.yaml<<EOF
apiVersion: apps.openshift.io/v1
kind: DeploymentConfig
metadata:
  name: jmeter-web
spec:
  replicas: 1
  template:
    metadata:
      labels:
        name: jmeter-web
    spec:
      containers:
        - image: 172.30.1.1:5000/perftest/jmeter-web
          name: jmeter-web
          volumeMounts:
            - mountPath: /jmeter/reports
              name: jmeter-reports
          ports:
            - containerPort: 80
              protocol: TCP
            - containerPort: 8080
              protocol: TCP
      volumes:
        - name: jmeter-reports
          persistentVolumeClaim:
            claimName: jmeter-reports
EOF

sc.yaml

$ tee sc.yaml<<EOF
apiVersion: v1
kind: Service
metadata:
  labels:
    app: jmeter-web
  name: jmeter-web
spec:
  ports:
    - name: 8080-tcp
      port: 8080
      protocol: TCP
      targetPort: 8080
  selector:
    deploymentconfig: jmeter-web
  sessionAffinity: None
  type: ClusterIP
EOF

Vytvoríme objekty Service a DeploymentConfig:

$ oc create -f sc.yaml -n perftest
$ oc create -f dc.yaml -n perftest

Jmeter-master

Zaoberajme sa nasadením webového servera Apache.

Toto je Dockerfile jmeter-master‘a, založený na jmeter-base, ktorý bude spúšťať testy a ukladať výsledky do úložiska.

Dockerfile

Dockerfile pre jmeter-master, založený na jmeter-base.

FROM jmeter-base

ARG JMETER_VER="5.2"
ENV JMETER_HOME /jmeter/apache-jmeter-$JMETER_VER
ENV PATH $JMETER_HOME/bin:$PATH

WORKDIR /jmeter
COPY run.sh /jmeter/
COPY tests/*.jmx /jmeter/tests/
RUN chmod +x /jmeter/run.sh

ENTRYPOINT ["/bin/bash"]
CMD ["/jmeter/run.sh"]

run.sh

run.sh je skript, ktorý spúšťa JMeter a ukladá výsledky do adresára files.

Pri každom spustení skriptu sa odstránia predchádzajúce testy, takže je možné pracovať iba s najnovšími údajmi. Ale to nie je problém, pretože ho môžete prispôsobiť svojim potrebám.

#!/bin/bash

set -e

if [ -d "/jmeter/reports/files" ]
then
    echo "Directory /jmeter/reports/files exist - OK"
else
    echo "Creating /jmeter/reports/files directory"
    mkdir /jmeter/reports/files
fi

if [ -d "/jmeter/reports/dashboards" ]
then
    echo "Directory /jmeter/reports/dashboards exist"
else
    echo "Creating /jmeter/reports/dashboards directory"
    mkdir /jmeter/reports/dashboards
fi

echo "*** JMeter START Tests ***"

for item in $(ls -1 /jmeter/tests | grep jmx)
do
    echo "*** Removing dashboard directory for $item"
    rm -rdf /jmeter/reports/dashboards/${item}*

    echo "*** Removing tests directory for $item"
    rm -rdf /jmeter/reports/files/${item}*

    echo "*** Testing a $item file ***"
    jmeter -n -t /jmeter/tests/${item} -l /jmeter/reports/files/${item}-report.jtl -e -o /jmeter/reports/dashboards/${item}-dash
done

is.yaml

$ tee is.yaml<<EOF
apiVersion: image.openshift.io/v1
kind: ImageStream
metadata:
  generation: 1
  labels:
    build: jmeter-master
  name: jmeter-master
EOF

bc.yaml

$ tee bc.yaml<<EOF
apiVersion: build.openshift.io/v1
kind: BuildConfig
metadata:
  name: jmeter-master
spec:
  failedBuildsHistoryLimit: 5
  nodeSelector: null
  output:
    to:
      kind: ImageStreamTag
      name: 'jmeter-master:latest'
  runPolicy: Serial
  source:
    binary: {}
    type: Binary
  strategy:
    dockerStrategy:
      from:
        kind: ImageStreamTag
        name: 'jmeter-base:latest'
    type: Docker
  successfulBuildsHistoryLimit: 5
EOF

Vytvoríme IS a BC objekty:

$ oc create -f is.yaml -n perftest
$ oc create -f bc.yaml -n perftest

Zbierame jmeter-master obraz:

$ oc start-build jmeter-master -n perftest --from-dir=. --follow

Práca

Práca'y sa používajú v OpenShift'e na spúšťanie jedného alebo viacerých POD'ov a zaručujú ich úspešné ukončenie po vykonaní príkazu/scenára.

$ tee job.yaml<<EOF
apiVersion: batch/v1
kind: Job
metadata:
  name: jmeter-master
  labels:
    jobName: jmeter-master
spec:
  completions: 1
  parallelism: 1
  template:
    metadata:
      name: jmeter-master
      labels:
        jobName: jmeter-master
    spec:
      containers:
        - name: jmeter-master
          image: 172.30.1.1:5000/perftest/jmeter-master:latest
          volumeMounts:
            - mountPath: /jmeter/reports
              name: jmeter-reports
          imagePullPolicy: Always
      volumes:
        - name: jmeter-reports
          persistentVolumeClaim:
            claimName: jmeter-reports
      restartPolicy: Never
      terminationGracePeriodSeconds: 30
EOF

Vytvárame objekt Práca:

$ oc create -f job.yaml -n perftest

Skontrolujeme stav úlohy:

$ oc get jobs -n perftest
NAME            DESIRED   SUCCESSFUL   AGE
jmeter-master   1         1            5m

Aby sme odstránili Práca použijeme príkaz:

$ oc delete jobs/jmeter-master -n perftest --ignore-not-found=true

Jenkins Pipeline

Teraz automatizácia. Ešte raz si prejdeme kroky:

  1. git clone
  2. oc whoami -t
  3. oc start-build ...
  4. oc delete jobs/jmeter-master
  5. oc create -f job.yaml -n perftest

Nižšie je uvedený pipeline, v ktorom sa vykonávajú klonovanie repozitára, odstraňovanie a vytváranie OpenShift Práca'y.

#!groovy

pipeline {

    agent any

    stages {

        stage('Start Notifications') {
            steps {
                echo "Sending Email Notification"
            }
            post {
                always {
                    echo "STARTED - Performance Tests"
                    mail(to: 'username@srv.net', from: "jenkins@srv.net", subject: "START - Performance Tests",mimeType: "text/html", body: "<strong>ZAČIATOK - Výkonové Testy</strong><br /><br />Projekt: Názov Projektu<br />Prostredie: PerfTest<br />Číslo verzie: ${env.BUILD_NUMBER}<br />URL adresa verzie:   ${env.BUILD_URL}" 
                }
            }
        }

        fáza('Git checkout') {
            kroky {
                ...
            }
        }

        fáza('Výkonové Testy') {
            kroky {
                skript {
                    sh '''
                        OC_CMD1="oc login -u=užívateľ -p=HESLO -n=perftest 
                        --server=https://...:8443"

                        $OC_CMD1

                        OC_TOKEN=`oc whoami -t`

                        OC_CMD2="oc --token=$OC_TOKEN --server=https://...:8443 
                        start-build jmeter-master -n=perftest --from-dir=./master 
                        --follow=true"

                        OC_CMD3="oc --token=$OC_TOKEN --server=https://...:8443 
                        delete jobs/jmeter-master -n=perftest --ignore-not-found=true"

                        OC_CMD4="oc --token=$OC_TOKEN --server=https://...:8443 
                        create -f ./master/job.yaml -n=perftest"

                        $OC_CMD2
                        $OC_CMD3
                        $OC_CMD4
                    '''
                }
            }
        }

        po {
            zlyhanie {
                echo "ZLYHANIE - Výkonové Testy"
                mail(to: 'užívateľ@srv.net', from: "jenkins@srv.net", subject: "ZLYHANIE - Výkonové Testy", mimeType: "text/html", body: "<strong>ZLYHANIE - Výkonové Testy</strong><br /><br />Projekt: Názov Projektu<br />Prostredie: PerfTest<br />Číslo verzie: ${env.BUILD_NUMBER}<br />URL adresa verzie: ${env.BUILD_URL}"
                }
            úspech {
                echo "ÚSPEŠNE - Výkonové Testy"
                mail(to: 'užívateľ@srv.net', from: "jenkins@srv.net", subject: "ÚSPEŠNE - Výkonové Testy", mimeType: "text/html", body: "<strong>ÚSPEŠNE - Výkonové Testy</strong><br /><br />Projekt: Názov Projektu<br />Prostredie: PerfTest<br />Číslo verzie: ${env.BUILD_NUMBER}<br />URL adresa verzie:   ${env.BUILD_URL}"
            }
        }

    }
}

Po tom, čo Pipeline prebehol, dostaneme upozornenie na e-mail 'username@srv.net od jenkins@srv.net.

Prechodom na odkaz http://jmeter-web.127.0.0.1.nip.io/ uvidíme adresár files, v ktorom sú uložené správy testov:

Spustenie JMeter testov v OpenShift pomocou Jenkins Pipeline

Obsah súboru ya.HTTP.Request.jmx-report.jtk:

timeStamp,elapsed,label,responseCode,responseMessage,threadName,dataType,success,failureMessage,bytes,sentBytes,grpThreads,allThreads,URL,Latency,IdleTime,Connect
1597311456443,569,Yandex - HTTP Request,200,Ok,Thread Group 1-1,text,true,,59449,220,1,1,https://ya.ru/,145,0,57
1597311456443,147,Yandex - HTTP Request-0,302,Found,Thread Group 1-1,,true,,478,110,1,1,http://ya.ru/,145,0,57
1597311456592,420,Yandex - HTTP Request-1,200,Ok,Thread Group 1-1,text,true,,58971,110,1,1,https://ya.ru/,370,0,259

Záver

V tomto článku bol predstavený jeden z variantov spúšťania testov JMeter v prostredí OpenShift. Vykonali sme všetky kroky manuálne, po čom sme vytvorili Jenkins Pipeline na automatizáciu procesu spúšťania testov.

Zdroje a dokumentácia

Zdroj: habr.com

Kúpte si spoľahlivý hosting pre webové stránky s ochranou proti DDoS, VPS VDS servery 🔥 Kúpte si spoľahlivý hosting pre webové stránky s ochranou proti DDoS, VPS VDS servery | ProHoster