leonidlm / aqua-helm

Helm charts for installing Aqua server components

Aquasec Helm Charts

Helm charts for installing and maintaining Aquasec server and agent components.

Chart Details

This repo includes two charts that can be installed separately:

1. Server - installs the web, gateway and optionally database and a scanner CLI component
2. Enforcer - installs the enforcer daemonset

Install the Chart

First add Aquasec's repository to Helm:

helm repo add aquasec-charts https://aquasec-charts.storage.googleapis.com

Then, run one of the commands below to install the relevant services.

Server

helm upgrade --install --namespace aquasec server aquasec-charts/server --set imageCredentials.username=<>,imageCredentials.password=<>,imageCredentials.email=<>

Enforcer

helm upgrade --install --namespace aquasec enforcer aquasec-charts/enforcer --set imageCredentials.username=<>,imageCredentials.password=<>,imageCredentials.email=<>,token=<aquasec-token>

Configuration

The following tables list the configurable parameters of the Server and Enforcer charts and their default values.

Server

Parameter	Description	Default
imageCredentials.usernmae	Your Dockerhub username	N/A
imageCredentials.password	Your Dockerhub password	N/A
imageCredentials.email	Your Dockerhub email	N/A
rbac.enabled	Create a service account and a ClusterRole	false
rbac.roleRef	Use an existing ClusterRole	``
db.external.enabled	Avoid installing a Postgres container and use an external database instead	false
db.external.name	Postresql DB name	N/A
db.external.host	Postresql DB hostname	N/A
db.external.port	Postresql DB port	N/A
db.external.user	Postresql DB username	N/A
db.external.password	Postresql DB password	N/A
db.image.repository	Default Postgresql Docker image repository	aquasec/database
db.image.tag	Default Postgresql Docker image tag	3.2
db.service.type	Default Postgresql service type	ClusterIP
db.persistence.enabled	Enable a use of a Postgresql PVC	true
db.persistence.storageClass	Postgresql PVC StorageClass	default
db.persistence.size	Postgresql PVC volume size	30Gi
db.persistence.accessMode	Postgresql PVC volume AccessMode	ReadWriteOnce
db.resources	Postgresql pod resources	{}
web.service.type	Web service type	ClusterIP
web.ingress.enabled	Install ingress for the web component	false
web.image.repository	Default Web Docker image repository	aquasec/server
web.image.tag	Default Web Docker image tag	3.2
web.ingress.annotations	Web ingress annotations	{}
web.ingress.hosts	Web ingress hosts definition	[]
web.ingress.tls	Web ingress tls	[]
gate.service.type	Gate service type	ClusterIP
gate.image.repository	Default Gate Docker image repository	aquasec/gate
gate.image.tag	Default Gate Docker image tag	3.2
gate.publicIP	Default Gate service public IP	``
scanner.enabled	Enable the Scanner CLI component	false
scanner.replicas	Number of Scanner CLI replicas to run	1
scanner.user	Username with the Scanner role	N/A
scanner.password	Password for the username with the Scanner role	N/A

Enforcer

Parameter	Description	Default
imageCredentials.usernmae	Your Dockerhub username	N/A
imageCredentials.password	Your Dockerhub password	N/A
imageCredentials.email	Your Dockerhub email	N/A
token	Aquasec Enforcer token	N/A
server	Gateways host name	server-gateway
port	Gateway port	3622

Specify the Dockerhub credentials

The Aqua server components are private, and you will need to set up an imagePullSecret.

You can do this manually by running:

kubectl create secret docker-registry dockerhub --docker-username=<your-name> --docker-password=<your-pword> --docker-email=<your-email>

Or by setting your Dockerhub credentials when you're running the Helm install commands as specified above, in which case Helm will create a new imagePullSecret for you.

Use existing Postgresql database

By default the server chart will also install a Postgresql database and attach persistent storage to it.

If you want to override this behaviour and specify an existing Postgresql database, set the following variables when running Helm:

db:
  external:
    enabled: true
    name: example-aquasec
    host: aquasec-db
    port: 5432
    user: aquasec-db-username
    password: verysecret

Include Scanner CLI installation

To install the scanner CLI along with the server components set the following variables:

scanner:
  enabled: true