| --- |
| title: "Install via Helm" |
| description: > |
| The steps to install Apache DevLake via Helm for Kubernetes |
| sidebar_position: 2 |
| --- |
| |
| ## Prerequisites |
| |
| - Helm >= 3.6.0 |
| - Kubernetes >= 1.19.0 |
| |
| |
| ## Quick Start |
| |
| #### You can also check You can also check https://github.com/apache/incubator-devlake-helm-chart to make contribution |
| |
| ### Install |
| |
| To install the chart with release name `devlake`: |
| |
| ```shell |
| helm repo add devlake https://apache.github.io/incubator-devlake-helm-chart |
| helm repo update |
| helm install devlake devlake/devlake |
| ``` |
| And visit your devlake from the node port (32001 by default). |
| |
| http://YOUR-NODE-IP:32001 |
| |
| #### Tips: |
| If you are using minikube inside your mac, please use the following command to forward the port: |
| ```shell |
| kubectl port-forward service/devlake-ui 30090:4000 |
| ``` |
| and open another terminal: |
| ```shell |
| kubectl port-forward service/devlake-grafana 30091:3000 |
| ``` |
| |
| Then you can visit: |
| config-ui by url `http://YOUR-NODE-IP:30090` |
| grafana by url `http://YOUR-NODE-IP:30091` |
| |
| ### Update |
| |
| ```shell |
| helm repo update |
| helm upgrade --install devlake devlake/devlake |
| ``` |
| |
| ### Uninstall |
| |
| To uninstall/delete the `devlake` release: |
| |
| ```shell |
| helm uninstall devlake |
| ``` |
| |
| |
| ## Some example deployments |
| |
| ### Deploy with NodePort |
| |
| Conditions: |
| - IP Address of Kubernetes node: 192.168.0.6 |
| - Want to visit devlake with port 30000. |
| |
| ``` |
| helm install devlake . --set service.uiPort=30000 |
| ``` |
| |
| After deployed, visit devlake: http://192.168.0.6:30000 |
| |
| ### Deploy with Ingress |
| |
| Conditions: |
| - I have already configured default ingress for the Kubernetes cluster |
| - I want to use http://devlake.example.com for visiting devlake |
| |
| ``` |
| 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 |
| |
| | Parameter | Description | Default | |
| |-----------|-------------|---------| |
| | replicaCount | Replica Count for devlake, currently not used | 1 | |
| | mysql.useExternal | If use external mysql server, currently not used | false | |
| | mysql.externalServer | External mysql server address | 127.0.0.1 | |
| | mysql.externalPort | External mysql server port | 3306 | |
| | mysql.username | username for mysql | merico | |
| | mysql.password | password for mysql | merico | |
| | mysql.database | database for mysql | lake | |
| | mysql.rootPassword | root password for mysql | admin | |
| | mysql.storage.class | storage class for mysql's volume | "" | |
| | mysql.storage.size | volume size for mysql's data | 5Gi | |
| | mysql.image.repository | repository for mysql's image | mysql | |
| | mysql.image.tag | image tag for mysql's image | 8.0.26 | |
| | mysql.image.pullPolicy | pullPolicy for mysql's image | IfNotPresent | |
| | grafana.image.repository | repository for grafana's image | mericodev/grafana | |
| | grafana.image.tag | image tag for grafana's image | latest | |
| | grafana.image.pullPolicy | pullPolicy for grafana's image | Always | |
| | lake.storage.class | storage class for lake's volume | "" | |
| | lake.storage.size | volume size for lake's data | 100Mi | |
| | lake.image.repository | repository for lake's image | mericodev/lake | |
| | lake.image.tag | image tag for lake's image | latest | |
| | lake.image.pullPolicy | pullPolicy for lake's image | Always | |
| | lake.loggingDir | the root logging directory of Devlake | /app/logs | |
| | ui.image.repository | repository for ui's image | mericodev/config-ui | |
| | ui.image.tag | image tag for ui's image | latest | |
| | ui.image.pullPolicy | pullPolicy for ui's image | Always | |
| | service.type | Service type for exposed service | NodePort | |
| | service.uiPort | Service port for config ui | 32001 | |
| | service.ingress.enabled | If enable ingress | false | |
| | service.ingress.enableHttps | If enable https | false | |
| | service.ingress.className | The class name for ingressClass. If leave empty, the default IngressClass will be used | "" | |
| | service.ingress.hostname | The hostname/domainname for ingress | localhost | |
| | service.ingress.prefix | The prefix for endpoints, currently not supported due to devlake's implementation | / | |
| | service.ingress.tlsSecretName | The secret name for tls's certificate, required when https enabled | "" | |
| | service.ingress.httpPort | The http port for ingress | 80 | |
| | service.ingress.httpsPort | The https port for ingress | 443 | |
| | option.localtime | The hostpath for mount as /etc/localtime | /etc/localtime | |
