This is an automated email from the ASF dual-hosted git repository.
mappjzc pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/incubator-devlake-website.git
The following commit(s) were added to refs/heads/main by this push:
new 29e16031c4 feat: update v0.17.0 version (#564)
29e16031c4 is described below
commit 29e16031c4dd9743f08ebdaab317c2d22d4826ef
Author: abeizn <[email protected]>
AuthorDate: Wed Jun 21 15:39:31 2023 +0800
feat: update v0.17.0 version (#564)
* feat: update v0.17.0 version
* feat: update v0.17.0 version
* feat: update v0.17.0-beta12
* feat: update v0.17.0-beta12
---
.../GettingStarted/DockerComposeSetup.md | 94 +++++++++++-----------
.../version-v0.17/GettingStarted/HelmSetup.md | 4 +-
2 files changed, 49 insertions(+), 49 deletions(-)
diff --git a/versioned_docs/version-v0.17/GettingStarted/DockerComposeSetup.md
b/versioned_docs/version-v0.17/GettingStarted/DockerComposeSetup.md
index c4588beac0..9260f89bb4 100644
--- a/versioned_docs/version-v0.17/GettingStarted/DockerComposeSetup.md
+++ b/versioned_docs/version-v0.17/GettingStarted/DockerComposeSetup.md
@@ -12,7 +12,7 @@ sidebar_position: 1
## Launch DevLake
-1. Download `docker-compose.yml` and `env.example` from the [latest
release](https://github.com/apache/incubator-devlake/releases/tag/v0.17.0-beta4)
into a folder.
+1. Download `docker-compose.yml` and `env.example` from the [latest
release](https://github.com/apache/incubator-devlake/releases/tag/v0.17.0-beta12)
into a folder.
2. Rename `env.example` to `.env`. For Mac/Linux users, please run `mv
env.example .env` in the terminal. This file contains the environment variables
that the Devlake server will use. Additional ones can be found in the compose
file(s).
3. Run `docker-compose up -d` if the version of Docker Desktop is too low to
use `docker compose up -d`.
@@ -36,56 +36,56 @@ Please note: **Back up your Grafana dashboards** before
upgrade if you have modi
Please check the [upgrade doc](Upgrade.md) for more information.
## FAQ
+
### Can I use a managed cloud database service instead of running database in
Docker?
Yes, please follow the steps below:
1. Comment out the 'mysql' part in `docker-compose.yml`:
+
```yaml
- mysql:
- image: mysql:8
- volumes:
- - mysql-storage:/var/lib/mysql
- restart: always
- ports:
- - "127.0.0.1:3306:3306"
- environment:
- MYSQL_ROOT_PASSWORD: admin
- MYSQL_DATABASE: lake
- MYSQL_USER: merico
- MYSQL_PASSWORD: merico
- command:
- --character-set-server=utf8mb4
- --collation-server=utf8mb4_bin
+mysql:
+ image: mysql:8
+ volumes:
+ - mysql-storage:/var/lib/mysql
+ restart: always
+ ports:
+ - "127.0.0.1:3306:3306"
+ environment:
+ MYSQL_ROOT_PASSWORD: admin
+ MYSQL_DATABASE: lake
+ MYSQL_USER: merico
+ MYSQL_PASSWORD: merico
+ command: --character-set-server=utf8mb4
+ --collation-server=utf8mb4_bin
```
2. Comment out the 'mysql' volume in `docker-compose.yml`:
```yaml
volumes:
- mysql-storage:
+ mysql-storage:
```
3. Comment out the 'depends_on mysql' part in `docker-compose.yml`:
```yaml
- depends_on:
- - mysql
+depends_on:
+ - mysql
```
4. Provide your managed cloud database connection info in the 'grafana'
section in `docker-compose.yml`:
-* MYSQL_URL: This parameter specifies the URL of your database instance. For
example, if your database is hosted on a server with IP address 123.45.67.89
and port number 3306, the URL would be "123.45.67.89:3306".
-* MYSQL_DATABASE: This parameter specifies the name of your database. For
example, if your database is named "mydatabase", you would set this parameter
to "mydatabase".
-* MYSQL_USER: This parameter specifies the username that you will use to
connect to your database. For example, if your username is "myuser", you would
set this parameter to "myuser".
-* MYSQL_PASSWORD: This parameter specifies the password that you will use to
connect to your database. For example, if your password is "mypassword", you
would set this parameter to "mypassword".
-
+- MYSQL_URL: This parameter specifies the URL of your database instance. For
example, if your database is hosted on a server with IP address 123.45.67.89
and port number 3306, the URL would be "123.45.67.89:3306".
+- MYSQL_DATABASE: This parameter specifies the name of your database. For
example, if your database is named "mydatabase", you would set this parameter
to "mydatabase".
+- MYSQL_USER: This parameter specifies the username that you will use to
connect to your database. For example, if your username is "myuser", you would
set this parameter to "myuser".
+- MYSQL_PASSWORD: This parameter specifies the password that you will use to
connect to your database. For example, if your password is "mypassword", you
would set this parameter to "mypassword".
```yaml
- MYSQL_URL: 123.45.67.89:3306
- MYSQL_DATABASE: mydatabase
- MYSQL_USER: myuser
- MYSQL_PASSWORD: mypassword
+MYSQL_URL: 123.45.67.89:3306
+MYSQL_DATABASE: mydatabase
+MYSQL_USER: myuser
+MYSQL_PASSWORD: mypassword
```
5. Set DB_URL to your own DB_URL in `.env`:
@@ -106,24 +106,24 @@ Yes, please follow the steps below:
1. Comment out the 'grafana' part:
```yaml
- grafana:
- image: mericodev/devlake-dashboard:latest
- build:
- context: grafana/
- ports:
- - "3002:3000"
- volumes:
- - grafana-storage:/var/lib/grafana
- environment:
- GF_SERVER_ROOT_URL: "http://localhost:4000/grafana";
- GF_USERS_DEFAULT_THEME: "light"
- MYSQL_URL: mysql:3306
- MYSQL_DATABASE: lake
- MYSQL_USER: merico
- MYSQL_PASSWORD: merico
- restart: always
- depends_on:
- - mysql
+grafana:
+ image: mericodev/devlake-dashboard:latest
+ build:
+ context: grafana/
+ ports:
+ - "3002:3000"
+ volumes:
+ - grafana-storage:/var/lib/grafana
+ environment:
+ GF_SERVER_ROOT_URL: "http://localhost:4000/grafana";
+ GF_USERS_DEFAULT_THEME: "light"
+ MYSQL_URL: mysql:3306
+ MYSQL_DATABASE: lake
+ MYSQL_USER: merico
+ MYSQL_PASSWORD: merico
+ restart: always
+ depends_on:
+ - mysql
```
2. Comment out grafana volume:
@@ -148,7 +148,7 @@ config-ui:
5. If you want to import dashboards, please check
https://grafana.com/docs/grafana/latest/dashboards/export-import/.
-* You can find DevLake's self-built Grafana dashboards here
(https://github.com/apache/incubator-devlake/tree/main/grafana/dashboards).
+- You can find DevLake's self-built Grafana dashboards here
(https://github.com/apache/incubator-devlake/tree/main/grafana/dashboards).
6. Final step: `docker compose up -d`
diff --git a/versioned_docs/version-v0.17/GettingStarted/HelmSetup.md
b/versioned_docs/version-v0.17/GettingStarted/HelmSetup.md
index 8a943f188b..e67cd77720 100644
--- a/versioned_docs/version-v0.17/GettingStarted/HelmSetup.md
+++ b/versioned_docs/version-v0.17/GettingStarted/HelmSetup.md
@@ -21,7 +21,7 @@ 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 --version=0.17.0-beta11
+helm install devlake devlake/devlake --version=0.17.0-beta12
```
And visit your devlake from the node port (32001 by default).
@@ -50,7 +50,7 @@ grafana by url `http://YOUR-NODE-IP:30091`
```shell
helm repo update
-helm upgrade --install devlake devlake/devlake --version=0.17.0-beta11
+helm upgrade --install devlake devlake/devlake --version=0.17.0-beta12
```
### Uninstall
