title | description | lead | date | lastmod | weight |
---|---|---|---|---|---|
Installation with Kubernetes |
Learn how to install Gatling Enterprise with Kubernetes |
Install Gatling Enterprise and Cassandra easily with Kubernetes |
2021-03-26 17:37:11 +0100 |
2023-10-12 08:44:13 +0000 |
1050 |
If you're using Kubernetes-based injector pools, it is recommended to run Gatling Enterprise itself inside Kubernetes too:
- Less configuration is required than when connecting to a cluster from the outside
- It is not necessary to open firewall rules so that Gatling Enterprise can contact injectors
We currently support the linux/amd64
and linux/arm64
platforms and publish our official images for both (Docker will automatically select the correct image variant).
Gatling Enterprise's image is hosted as a private image on Docker Hub.
Please contact our support and provide us with your Docker Hub username so we can grant you access.
Gatling Enterprise's injector image is publicly accessible on Docker Hub.
This manifest setups a single-node Cassandra cluster, along with a service to expose it
{{< include-code "kubernetes-cassandra.yml" yaml >}}
If your cluster has RBAC enabled, this manifest configures the necessary permissions for Gatling Enterprise:
{{< include-code "kubernetes-frontline.yml" yaml >}}
If you're not mirroring Gatling Enterprise's image in your private registry, you'll need to setup your Docker credentials as a secret to pull Gatling Enterprise's image:
kubectl create secret docker-registry docker-hub-credentials \
--docker-server=<your-registry-server> \
--docker-username=<your-name> \
--docker-password=<your-pword> \
--docker-email=<your-email>
This manifest sets up Gatling Enterprise, pre configured with your license key and admin credentials. You can then expose Gatling Enterprise using LoadBalancer/NodePort services, Ingress, etc...
Gatling enterprise requires two persistent volumes:
frontline-conf
contains your gatling enterprise configuration, license key included.ssh-keys
contains all your SSH private keys, possibly used for cloning git repositories and deploying tests on remote virtual machines.
In the example below, configMap
and hostPath
are used, but you can use secret
or setup persistent volumes.
apiVersion: v1
kind: ConfigMap
metadata:
name: frontline-conf
namespace: frontline
data:
frontline.conf: |
frontline.licenseKey = <YOUR FRONTLINE LICENSE KEY>
frontline.security.superAdminPassword = <YOUR SUPER ADMIN PASSWORD>
frontline.security.secretKey = <YOUR ENCRYPTION SECRET KEY>
frontline.cassandra.contactPoints = [{
host = cassandra.frontline.svc.cluster.local
port = 9042
}]
logback.xml: |
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<contextListener class="ch.qos.logback.classic.jul.LevelChangePropagator">
<resetJUL>true</resetJUL>
</contextListener>
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>%d [%-5level] %logger{15} - %msg%n%rEx</pattern>
</encoder>
<immediateFlush>false</immediateFlush>
</appender>
<logger name="io.gatling.frontline" level="INFO"/>
<root level="WARN">
<appender-ref ref="CONSOLE"/>
</root>
</configuration>
---
apiVersion: v1
kind: Service
metadata:
name: frontline
namespace: frontline
spec:
ports:
- name: http
port: 10542
selector:
app: frontline
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: frontline
namespace: frontline
spec:
replicas: 1
strategy:
type: Recreate
selector:
matchLabels:
app: frontline
template:
metadata:
labels:
app: frontline
spec:
# Required unless you mirror Gatling Enterprise in your private registry
imagePullSecrets:
- name: docker-hub-credentials
serviceAccountName: frontline-sa
containers:
- name: frontline
imagePullPolicy: Never
image: gatlingcorp/frontline:{{< var revnumber >}}
resources:
requests:
cpu: 2
memory: 4Gi
ports:
- containerPort: 10542
volumeMounts:
- mountPath: /opt/frontline/conf
name: frontline-conf
- mountPath: /opt/frontline/keys
name: ssh-keys
volumes:
- name: frontline-conf
configMap:
name: frontline-conf
- name: ssh-keys
# Prefer PersistentVolumeClaims for durability
hostPath:
path: <local storage path for SSH keys>
{{< alert tip >}} Depending on your needs, you may need to configure additional volumes on the Gatling Enterprise container (SSL certificate if HTTPS is configured, or keystore/truststore for LDAP support) {{< /alert >}}