adds velaux sql database docs (#1280)
Co-authored-by: qiaozp <47812250+chivalryq@users.noreply.github.com>
This commit is contained in:
parent
0629186b72
commit
fa3ff7485e
|
@ -39,8 +39,9 @@ kubectl scale deploy -n vela-system kubevela-cluster-gateway --replicas=3
|
||||||
|
|
||||||
VelaUX is an addon, it composed by 3 major parts: nginx for frontend, APIServer as backend, and its database.
|
VelaUX is an addon, it composed by 3 major parts: nginx for frontend, APIServer as backend, and its database.
|
||||||
|
|
||||||
We strongly recommend to use high availability mongodb cluster as the database driver. The frontend and backend are both stateless services, just configure multiple replicas for them. As a result, the high availability installation command just like below:
|
We strongly recommend to use high availability mongodb, mysql(beta) or postgresql(beta) cluster as the database driver. The frontend and backend are both stateless services, just configure multiple replicas for them. As a result, the high availability installation command just like below:
|
||||||
|
|
||||||
```
|
```
|
||||||
vela addon enable velaux dbType=mongodb dbURL=mongodb://<MONGODB_USER>:<MONGODB_PASSWORD>@<MONGODB_URL> replicas=3
|
vela addon enable velaux dbType=mongodb dbURL=mongodb://<MONGODB_USER>:<MONGODB_PASSWORD>@<MONGODB_URL> replicas=3
|
||||||
```
|
```
|
||||||
|
You can refer [Setup with the database](../../reference/addons/velaux.md#setup-with-the-database) for more info.
|
|
@ -2,6 +2,9 @@
|
||||||
title: VelaUX
|
title: VelaUX
|
||||||
---
|
---
|
||||||
|
|
||||||
|
import Tabs from '@theme/Tabs';
|
||||||
|
import TabItem from '@theme/TabItem';
|
||||||
|
|
||||||
VelaUX provides the UI console of KubeVela.
|
VelaUX provides the UI console of KubeVela.
|
||||||
|
|
||||||

|

|
||||||
|
@ -126,9 +129,12 @@ Please make sure the certificate matches the domain.
|
||||||
vela addon enable velaux domain=example.doamin.com gatewayDriver=traefik secretName=velaux-cert
|
vela addon enable velaux domain=example.doamin.com gatewayDriver=traefik secretName=velaux-cert
|
||||||
```
|
```
|
||||||
|
|
||||||
## Setup with MongoDB database
|
## Setup with the database
|
||||||
|
|
||||||
VelaUX supports Kubernetes and MongoDB as the database. the default is Kubernetes. We strongly advise using the MongoDB database to power your production environment.
|
VelaUX supports Kubernetes, MongoDB, MySQL and PostgreSQL as the database. the default is Kubernetes. We strongly advise using the databases other than Kubernetes to power your production environment.
|
||||||
|
|
||||||
|
<Tabs className="unique-tabs" groupId="os">
|
||||||
|
<TabItem label="MongoDB" value="mongodb">
|
||||||
|
|
||||||
```shell script
|
```shell script
|
||||||
vela addon enable velaux dbType=mongodb dbURL=mongodb://<MONGODB_USER>:<MONGODB_PASSWORD>@<MONGODB_URL>
|
vela addon enable velaux dbType=mongodb dbURL=mongodb://<MONGODB_USER>:<MONGODB_PASSWORD>@<MONGODB_URL>
|
||||||
|
@ -173,6 +179,104 @@ spec:
|
||||||
```
|
```
|
||||||
|
|
||||||
After deployed, let's get the root password from the secret `vela-system/velaux-db-mongodb`.
|
After deployed, let's get the root password from the secret `vela-system/velaux-db-mongodb`.
|
||||||
|
</TabItem>
|
||||||
|
|
||||||
|
<TabItem label="MySQL" value="mysql">
|
||||||
|
|
||||||
|
```shell script
|
||||||
|
vela addon enable velaux dbType=mysql dbURL=mysql://<MYSQL_USER>:<MYSQL_PASSWORD>@<MYSQL_HOST>:<MYSQL_PORT>/<MYSQL_DB_NAME>
|
||||||
|
```
|
||||||
|
> It's necessary to create the specified database in advance. You can find the relevant connection string parameters [here](https://github.com/go-sql-driver/mysql#parameters)
|
||||||
|
|
||||||
|
You can also deploy the MySQL with this application configuration:
|
||||||
|
|
||||||
|
> Your cluster must have a default storage class.
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
apiVersion: core.oam.dev/v1beta1
|
||||||
|
kind: Application
|
||||||
|
metadata:
|
||||||
|
name: velaux-db
|
||||||
|
namespace: vela-system
|
||||||
|
spec:
|
||||||
|
components:
|
||||||
|
- name: velaux-db
|
||||||
|
properties:
|
||||||
|
chart: mysql
|
||||||
|
repoType: helm
|
||||||
|
url: https://charts.bitnami.com/bitnami
|
||||||
|
values:
|
||||||
|
persistence:
|
||||||
|
size: 20Gi
|
||||||
|
version: 12.1.12
|
||||||
|
type: helm
|
||||||
|
policies:
|
||||||
|
- name: vela-system
|
||||||
|
properties:
|
||||||
|
clusters:
|
||||||
|
- local
|
||||||
|
namespace: vela-system
|
||||||
|
type: topology
|
||||||
|
workflow:
|
||||||
|
steps:
|
||||||
|
- name: vela-system
|
||||||
|
properties:
|
||||||
|
policies:
|
||||||
|
- vela-system
|
||||||
|
type: deploy
|
||||||
|
```
|
||||||
|
|
||||||
|
After deployed, let's get the root password from the secret `vela-system/velaux-db-mysql`.
|
||||||
|
</TabItem>
|
||||||
|
|
||||||
|
<TabItem label="PostgreSQL" value="postgresql">
|
||||||
|
|
||||||
|
```shell script
|
||||||
|
vela addon enable velaux dbType=postgresql dbURL=postgres://<POSTGRESQL_USER>:<POSTGRESQL_PASSWORD>@<POSTGRESQL_HOST>:<POSTGRESQL_PORT>/<POSTGRESQL_DB_NAME>
|
||||||
|
```
|
||||||
|
> It's necessary to create the specified database in advance.
|
||||||
|
|
||||||
|
You can also deploy the PostgreSQL with this application configuration:
|
||||||
|
|
||||||
|
> Your cluster must have a default storage class.
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
apiVersion: core.oam.dev/v1beta1
|
||||||
|
kind: Application
|
||||||
|
metadata:
|
||||||
|
name: velaux-db
|
||||||
|
namespace: vela-system
|
||||||
|
spec:
|
||||||
|
components:
|
||||||
|
- name: velaux-db
|
||||||
|
properties:
|
||||||
|
chart: postgresql
|
||||||
|
repoType: helm
|
||||||
|
url: https://charts.bitnami.com/bitnami
|
||||||
|
values:
|
||||||
|
persistence:
|
||||||
|
size: 20Gi
|
||||||
|
version: 12.1.12
|
||||||
|
type: helm
|
||||||
|
policies:
|
||||||
|
- name: vela-system
|
||||||
|
properties:
|
||||||
|
clusters:
|
||||||
|
- local
|
||||||
|
namespace: vela-system
|
||||||
|
type: topology
|
||||||
|
workflow:
|
||||||
|
steps:
|
||||||
|
- name: vela-system
|
||||||
|
properties:
|
||||||
|
policies:
|
||||||
|
- vela-system
|
||||||
|
type: deploy
|
||||||
|
```
|
||||||
|
|
||||||
|
After deployed, let's get the root password from the secret `vela-system/velaux-db-postgresql`.
|
||||||
|
</TabItem>
|
||||||
|
</Tabs>
|
||||||
|
|
||||||
## Specify the addon image
|
## Specify the addon image
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue