Install via Kubernetes

警告

We highly recommend the helm approach, this page is for Advanced Installation only

We provide a sample k8s-deploy.yaml to help deploy DevLake to Kubernetes

k8s-deploy.yaml will create a namespace devlake on your k8s cluster, and use nodePort 30004 for config-ui, nodePort 30002 for grafana dashboards. If you would like to use a specific version of Apache DevLake, please update the image tag of grafana, devlake and config-ui deployments.

Step-by-step guide

1. Download k8s-deploy.yaml
2. Customize the settings (devlake-config config map):
   • Settings shared between grafana and mysql
     • MYSQL_ROOT_PASSWORD: set root password for mysql
     • MYSQL_USER: shared between mysql and grafana
     • MYSQL_PASSWORD: shared between mysql and grafana
     • MYSQL_DATABASE: shared between mysql and grafana
   • Settings used by grafana
     • MYSQL_URL: set MySQL URL for grafana in $HOST:$PORT format
     • GF_SERVER_ROOT_URL: Public URL to the grafana
   • Settings used by config-ui:
     • GRAFANA_ENDPOINT: FQDN of grafana which can be reached within k8s cluster, normally you don't need to change it unless namespace was changed
     • DEVLAKE_ENDPOINT: FQDN of devlake which can be reached within k8s cluster, normally you don't need to change it unless namespace was changed
     • ADMIN_USER/ADMIN_PASS: Not required, but highly recommended
   • Settings used by devlake:
     • DB_URL: update this value if MYSQL_USER, MYSQL_PASSWORD or MYSQL_DATABASE were changed
     • LOGGING_DIR: the directory of logs for Devlake - you likely don't need to change it.
3. The devlake deployment store its configuration in /app/.env. In our sample yaml, we use hostPath volume, so please make sure directory /var/lib/devlake exists on your k8s workers, or employ other techniques to persist /app/.env file. Please do NOT mount the entire /app directory, because plugins are located in /app/bin folder.
4. Finally, execute the following command and DevLake should be up and running:

   kubectl apply -f k8s-deploy.yaml

FAQ

1. Can I use a managed Cloud database service instead of running database in k8s?

   Yes, it only takes a few changes in the sample yaml file. Below we'll use MySQL on AWS RDS as an example.

   1. (Optional) Create a MySQL instance on AWS RDS following this doc, skip this step if you'd like to use an existing instance
   2. Remove the mysql deployment and service sections from k8s-deploy.yaml
   3. Update devlake-config configmap according to your RDS instance setup:
   • MYSQL_ROOT_PASSWORD: remove this line
   • MYSQL_USER: use your RDS instance's master username
   • MYSQL_PASSWORD: use your RDS instance's password
   • MYSQL_DATABASE: use your RDS instance's DB name, you may need to create a database first with CREATE DATABASE <DB name>;
   • MYSQL_URL: set this for grafana in $HOST:$PORT format, where $HOST and $PORT should be your RDS instance's endpoint and port respectively
   • DB_URL: update the connection string with your RDS instance's info for devlake