Усім прывітанне!
У гэтым артыкуле жадаю падзяліцца адным з спосабаў запуску тэстаў прадукцыйнасці JMeter у OpenShift'e з выкарыстаннем Jenkins'a у якасці аўтаматызацыі. Спачатку мы праробім усе неабходныя дзеянні (стварэнне ImageStreams
, BuildConfig
, Job
і інш) у ручным рэжыме. Пасля гэтага напішым Jenkins Pipeline.
У якасці адпраўной кропкі ў нас павінна быць:
- які працуе OpenShift (v3.11) кластар
- Jenkins server з настроенымі ўліковымі дадзенымі для працы ў OpenShift
- файл
apache-jmeter-5.2.tgz
У якасці тэстаў будзе просты HTTP Request
на ya.ru
у адзін паток.
Стварэнне праекта ў OpenShift
Пачнём са стварэння новага асяроддзя. Створым perftest
асяроддзе камандай:
$ oc new-project perftest --display-name="Performance Tests" --description="Performance Tests - JMeter"
Нас аўтаматычна перакіне ў толькі што створанае асяроддзе perftest
, праверым, што гэта так:
$ oc project
Using project "perftest" on server "https://127.0.0.1:8443".
Стварэнне Storage'a
Справаздачы тэстаў будуць захоўвацца ўвогуле для вэб-сервера і jmeter-meter
На месцы - /jmeter/reports
.
Старажыты стварыць лепш зараз, таму што на іх будуць завязаныя POD'ы jmeter-web
и jmeter-master
.
Больш дэталёвую інфармацыю па вартаўніках вы знойдзеце ў афіцыйнай дакументацыі
Створым yaml-файлы для PV
и 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
Створым PV
и PVC
у асяроддзі OpenShift'a:
$ oc create -f pv.yaml -n perftest
$ oc create -f pvc.yaml -n perftest
Правяраем статус для 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
Вось, як будзе выглядаць у GUI:
Стварэнне базавай выявы JMeter
Пяройдзем да стварэння ImageStream
и BuildConfig
.
Усю неабходную інфармацыю зможаце знайсці ў дакументацыі.
У якасці стратэгіі зборкі выяў выкарыстоўваецца. Docker
з лакальнага крыніцы.
Створым базавую выяву jmeter-base
, які будзе асновай для jmeter-master
.
Докер-файл
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
Створым аб'екты IS
и BC
:
$ oc create -f is.yaml -n perftest
$ oc create -f bc.yaml -n perftest
Цяпер збяром базавы вобраз jmeter-base
:
$ oc start-build jmeter-base -n perftest --from-dir=. --follow
JMeter WEB
jmeter-web
гэта вэб-сервер Apache. У яго задачу ўваходзіць прадастаўленне дырэкторыі з вынікамі тэсціравання для прагляду.
Падрыхтаваны Dockerfile
і файл канфігурацыі httpd.conf
. Для дырэктывы DocumentRoot
выстаўлена значэнне /jmeter/reports
, г.зн. дырэкторыя ў якую захоўваюцца вынікі тэставання.
Докер-файл
$ 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
Створым ImageStream
и BuildConfig
аб'екты:
$ oc create -f is.yaml -n perftest
$ oc create -f bc.yaml -n perftest
Збіраны вобраз з 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
Створым аб'екты Service
и DeploymentConfig
:
$ oc create -f sc.yaml -n perftest
$ oc create -f dc.yaml -n perftest
Jmeter-master
Зоймемся дэплайментам вэб-сервера Apache.
Гэта Dockerfile jmeter-master
'а, заснаваны на jmeter-base
, які будзе запускаць тэсты і захоўваць вынікі ў стородж.
Докер-файл
Dockerfile
для jmeter-master
, заснаваны на 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
гэта скрыпт, які выконвае запуск JMeter'a і захоўвае вынікі ў дырэкторыю files
.
Пры кожным запуску скрыпт выдаляе папярэднія тэсты, таму працаваць можна толькі з апошнімі дадзенымі. Але гэта не праблема, таму што яго можна змяніць пад свае патрэбы.
#!/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
Створым IS
и BC
аб'екты:
$ oc create -f is.yaml -n perftest
$ oc create -f bc.yaml -n perftest
збіраем jmeter-master
вобраз:
$ oc start-build jmeter-master -n perftest --from-dir=. --follow
Ёў
Job
'ы выкарыстоўваюцца ў OpenShift
'e для таго, каб запускаць адзін ці некалькі POD
'ов і гарантаваць іх паспяховае завяршэнне пасля выканання каманды / сцэнарыя.
$ 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
Ствараем аб'ект Job
:
$ oc create -f job.yaml -n perftest
Праверым статус джобы:
$ oc get jobs -n perftest
NAME DESIRED SUCCESSFUL AGE
jmeter-master 1 1 5m
Каб выдаліць Job
скарыстаемся камандай:
$ oc delete jobs/jmeter-master -n perftest --ignore-not-found=true
Jenkins Pipeline
Цяпер аўтаматызацыя. Яшчэ раз прагаворым крокі:
git clone
oc whoami -t
oc start-build ...
oc delete jobs/jmeter-master
oc create -f job.yaml -n perftest
Ніжэй прадстаўлены пайплайн, у якім выконваюцца кланаванне рэпазітара, выдаленне і стварэнне OpenShift Job
Ты.
#!groovy
pipeline {
agent any
stages {
stage('Start Notifications') {
steps {
echo "Sending Email Notification"
}
post {
always {
echo "STARTED - Performance Tests"
mail(to: '[email protected]', from: "[email protected]", subject: "START - Performance Tests",mimeType: "text/html", body: "<strong>START - Performance Tests</strong><br /><br />Project: Name of Project<br />Environment: PerfTest<br />Build number: ${env.BUILD_NUMBER}<br />Build URL: ${env.BUILD_URL}"
}
}
}
stage('Git checkout') {
steps {
...
}
}
stage('Perf Tests') {
steps {
script {
sh '''
OC_CMD1="oc login -u=username -p=PASS -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
'''
}
}
}
post {
failure {
echo "FAILED - Performance Tests"
mail(to: '[email protected]', from: "[email protected]", subject: "FAILED - Performance Tests",mimeType: "text/html", body: "<strong>FAILED - Performance Tests</strong><br /><br />Project: Name of Project<br />Environment: PerfTest<br />Build number: ${env.BUILD_NUMBER}<br />Build URL: ${env.BUILD_URL}"
}
success {
echo "SUCCESSED - Performance Tests"
mail(to: '[email protected]', from: "[email protected]", subject: "SUCCESSED - Performance Tests",mimeType: "text/html", body: "<strong>SUCCESSED - Performance Tests</strong><br /><br />Project: Name of Project<br />Environment: PerfTest<br />Build number: ${env.BUILD_NUMBER}<br />Build URL: ${env.BUILD_URL}"
}
}
}
}
Пасля таго, як Pipeline адпрацаваў, мы атрымаем апавяшчэнне на электронную пошту '[email protected]
ад [email protected]
.
Перайшоўшы па спасылцы files
, у якой захоўваюцца справаздачы тэстаў:
Змесціва файла 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
Заключэнне
У гэтым артыкуле быў прадэманстраваны адзін з варыянтаў запуску тэстаў JMeter у OpenShift асяроддзі. Зрабілі ўсе крокі ў ручным рэжыме, пасля чаго стварылі Jenkins Pipeline для аўтаматызацыі працэсу запуску тэстаў.
Крыніцы і дакументацыя
JMeter - Distributed Load Testing using Docker Running JMeter Tests у OpenShift з Jenkins Pipeline адкрыты зрухПастаяннае захоўванне Builds and Image Streams
Крыніца: habr.com