tree: cbb34bc6f7d417c51bcbc056e19890ed04b2be2f [path history] [tgz]
  1. templates/
  2. .helmignore
  3. Chart.yaml
  4. README.md
  5. values.yaml
deployment/helm/README.md

Deploy devlake with helm

Prerequest

  • Helm >= 3.6.0
  • Kubernetes >= 1.19.0

Quick Install

clone the code, and enter the deployment/helm folder.

helm install devlake . --set service.grafanaEndpoint=http://YOUR-NODE-IP:32000

And visit your devlake from the node port (32001 by default).

http://YOUR-NODE-IP:32001

Some example deployments

Deploy with NodePort

Conditions:

  • IP Address of Kubernetes node: 192.168.0.6
  • Want to visit devlake with port 30000, and grafana at port 30001
helm install devlake . --set "service.uiPort=30000,service.grafanaPort=30001,service.grafanaEndpoint=http://192.168.0.6:30001"

After deployed, visit devlake: http://192.168.0.6:30000

Deploy with Ingress

Conditions:

helm install devlake . --set "ingress.enabled=true,ingress.hostname=devlake.example.com"

After deployed, visit devlake: http://devlake.example.com, and grafana at http://devlake.example.com/grafana

Deploy with Ingress (Https)

Conditions:

  • I have already configured ingress(class: nginx) for the Kubernetes cluster, and the https using 8443 port.
  • I want to use https://devlake-0.example.com:8443 for visiting devlake.
  • The https certificates are generated by letsencrypt.org, and the certificate and key files: cert.pem and key.pem

First, create the secret:

kubectl create secret tls ssl-certificate --cert cert.pem --key secret.pem

Then, deploy the devlake:

helm install devlake . \
    --set "ingress.enabled=true,ingress.enableHttps=true,ingress.hostname=devlake-0.example.com" \
    --set "ingress.className=nginx,ingress.httpsPort=8443" \
    --set "ingress.tlsSecretName=ssl-certificate"

After deployed, visit devlake: https://devlake-0.example.com:8443, and grafana at https://devlake-0.example.com:8443/grafana

Parameters

Some useful parameters for the chart, you could also check them in values.yaml

ParameterDescriptionDefault
replicaCountReplica Count for devlake, currently not used1
mysql.useExternalIf use external mysql server, currently not usedfalse
mysql.externalServerExternal mysql server address127.0.0.1
mysql.externalPortExternal mysql server port3306
mysql.usernameusername for mysqlmerico
mysql.passwordpassword for mysqlmerico
mysql.databasedatabase for mysqllake
mysql.rootPasswordroot password for mysqladmin
mysql.storage.classstorage class for mysql's volume""
mysql.storage.sizevolume size for mysql's data5Gi
mysql.image.repositoryrepository for mysql's imagemysql
mysql.image.tagimage tag for mysql's image8.0.26
mysql.image.pullPolicypullPolicy for mysql's imageIfNotPresent
grafana.image.repositoryrepository for grafana's imagemericodev/grafana
grafana.image.tagimage tag for grafana's imagelatest
grafana.image.pullPolicypullPolicy for grafana's imageAlways
lake.storage.classstorage class for lake's volume""
lake.storage.sizevolume size for lake's data100Mi
lake.image.repositoryrepository for lake's imagemericodev/lake
lake.image.tagimage tag for lake's imagelatest
lake.image.pullPolicypullPolicy for lake's imageAlways
ui.image.repositoryrepository for ui's imagemericodev/config-ui
ui.image.tagimage tag for ui's imagelatest
ui.image.pullPolicypullPolicy for ui's imageAlways
service.typeService type for exposed serviceNodePort
service.grafanaPortService port for grafana32000
service.uiPortService port for config ui32001
service.grafanaEndpointThe external grafana endpoint, used when ingress not configuredhttp://127.0.0.1:32000
service.ingress.enabledIf enable ingressfalse
service.ingress.enableHttpsIf enable httpsfalse
service.ingress.classNameThe class name for ingressClass. If leave empty, the default IngressClass will be used""
service.ingress.hostnameThe hostname/domainname for ingresslocalhost
service.ingress.prefixThe prefix for endpoints, currently not supported due to devlake's implementation/
service.ingress.tlsSecretNameThe secret name for tls's certificate, required when https enabled""
service.ingress.httpPortThe http port for ingress80
service.ingress.httpsPortThe https port for ingress443
option.localtimeThe hostpath for mount as /etc/localtime/etc/localtime