|
1 |
| -# Plane One Helm Chart |
2 |
| - |
3 | 1 | ## Pre-requisite
|
4 | 2 |
|
5 |
| -- A Plane One license |
6 |
| - > If you don’t have a license, get it at [prime.plane.so](https://prime.plane.so) |
7 | 3 | - A working Kubernetes cluster
|
8 | 4 | - `kubectl` and `helm` on the client system that you will use to install our Helm charts
|
9 | 5 |
|
10 |
| -## Installing Plane One |
| 6 | +## Installing Plane Enterprise |
11 | 7 |
|
12 | 8 | 1. Open Terminal or any other command-line app that has access to Kubernetes tools on your local system.
|
13 | 9 | 2. Set the following environment variables.
|
14 | 10 |
|
15 | 11 | Copy the format of constants below, paste it on Terminal to start setting environment variables, set values for each variable, and hit ENTER or RETURN.
|
16 |
| - > You will get the values for the variables from [prime.plane.so](https://prime.plane.so) under the Kuberntes tab of your license's details page. When installing Plane One for the first time, remember to specify a domain name. |
17 | 12 |
|
18 | 13 | ```bash
|
19 |
| - LICENSE_KEY=<your_license_key> |
20 |
| - REG_USER_ID=<license-XXXXX+XXXX-XXXX-XXX-XXXXX> |
21 |
| - REG_PASSWORD=<******> |
22 | 14 | PLANE_VERSION=<v1.xx.x>
|
23 | 15 | DOMAIN_NAME=<subdomain.domain.tld or domain.tld>
|
24 | 16 | ```
|
|
40 | 32 | Continue to be on the same Terminal window as you have so far, copy the code below, and paste it on your Terminal screen.
|
41 | 33 |
|
42 | 34 | ```bash
|
43 |
| - helm install one-app plane/plane-enterprise \ |
| 35 | + helm install plane-app plane/plane-enterprise \ |
44 | 36 | --create-namespace \
|
45 |
| - --namespace plane-one \ |
46 |
| - --set dockerRegistry.loginid=${REG_USER_ID} \ |
47 |
| - --set dockerRegistry.password=${REG_PASSWORD} \ |
48 |
| - --set license.licenseKey=${LICENSE_KEY} \ |
| 37 | + --namespace plane \ |
49 | 38 | --set license.licenseDomain=${DOMAIN_NAME} \
|
50 | 39 | --set license.licenseServer=https://prime.plane.so \
|
51 | 40 | --set planeVersion=${PLANE_VERSION} \
|
| 41 | + --set ingress.enabled=true \ |
52 | 42 | --set ingress.ingressClass=nginx \
|
53 | 43 | --set env.storageClass=longhorn \
|
54 | 44 | --timeout 10m \
|
55 | 45 | --wait \
|
56 | 46 | --wait-for-jobs
|
57 | 47 | ```
|
58 | 48 |
|
59 |
| - > This is the minimum required to set up Plane One. You can change the default namespace from `plane-one`, the default appname |
60 |
| - from `one-app`, the default storage class from `env.storageClass`, and the default ingress class from `ingress.ingressClass` to |
| 49 | + > This is the minimum required to set up Plane Enterprise. You can change the default namespace from `plane`, the default appname |
| 50 | + from `plane-app`, the default storage class from `longhorn`, and the default ingress class from `nginx` to |
61 | 51 | whatever you would like to.<br> <br>
|
62 | 52 | You can also pass other settings referring to `Configuration Settings` section.
|
63 | 53 |
|
|
72 | 62 |
|
73 | 63 | Make sure you set the minimum required values as below.
|
74 | 64 | - `planeVersion: <v1.xx.x>`
|
75 |
| - - `dockerRegistry.loginid: <REG_USER_ID as on prime.plane.so>` |
76 |
| - - `dockerRegistry.password: <REG_PASSWORD as on prime.plane.so>` |
77 |
| - - `license.licenseKey: <LICENSE_KEY as on prime.plane.so>` |
78 | 65 | - `license.licenseDomain: <The domain you have specified to host Plane>`
|
79 | 66 | - `license.licenseServer: https://prime.plane.so`
|
| 67 | + - `ingress.enabled: <true | false>` |
80 | 68 | - `ingress.ingressClass: <nginx or any other ingress class configured in your cluster>`
|
81 | 69 | - `env.storageClass: <longhorn or any other storage class configured in your cluster>`
|
82 | 70 |
|
|
85 | 73 | After saving the `values.yaml` file, continue to be on the same Terminal window as on the previous steps, copy the code below, and paste it on your Terminal screen.
|
86 | 74 |
|
87 | 75 | ```bash
|
88 |
| - helm install one-app plane/plane-enterprise \ |
| 76 | + helm install plane-app plane/plane-enterprise \ |
89 | 77 | --create-namespace \
|
90 |
| - --namespace plane-one \ |
| 78 | + --namespace plane \ |
91 | 79 | -f values.yaml \
|
92 | 80 | --timeout 10m \
|
93 | 81 | --wait \
|
|
100 | 88 |
|
101 | 89 | | Setting | Default | Required | Description |
|
102 | 90 | |---|:---:|:---:|---|
|
103 |
| -| dockerRegistry.enabled | true | Yes | Plane uses a private Docker registry which needs authenticated login. This must be set to `true` to install Plane One. | |
| 91 | +| dockerRegistry.enabled | false | | Plane uses a private Docker registry which needs authenticated login. This must be set to `true` to install Plane Enterprise. | |
104 | 92 | | dockerRegistry.registry | registry.plane.tools| Yes | The host that will serve the required Docker images; Don't change this. |
|
105 | 93 | | dockerRegistry.loginid | | Yes | Sets the `loginid` for the Docker registry. This is the same as the REG_USER_ID value on prime. plane.so |
|
106 | 94 | | dockerRegistry.password | | Yes | Sets the `password` for the Docker registry. This is the same as the REG_PASSWORD value on prime.plane.so|
|
|
109 | 97 |
|
110 | 98 | | Setting | Default | Required | Description |
|
111 | 99 | |---|:---:|:---:|---|
|
112 |
| -| planeVersion | v1.1.1 | Yes | Specifies the version of Plane to be deployed. Copy this from prime.plane.so. | |
| 100 | +| planeVersion | v1.2.1 | Yes | Specifies the version of Plane to be deployed. Copy this from prime.plane.so. | |
113 | 101 | | license.licenseServer | <https://prime.plane.so> | Yes | Sets the value of the `licenseServer` that gets you your license and validates it periodically. Don't change this. |
|
114 |
| -| license.licenseKey | | Yes | Holds your license key to Plane One. Copy this from prime.plane.so. | |
115 | 102 | | license.licenseDomain | 'plane.example.com' | Yes | The fully-qualified domain name (FQDN) in the format `sudomain.domain.tld` or `domain.tld` that the license is bound to. It is also attached to your `ingress` host to access Plane. |
|
116 | 103 |
|
117 | 104 | ### Postgres
|
|
187 | 174 | | services.admin.image| registry.plane.tools/plane/admin-enterprise | | This deployment needs a preconfigured docker image to function. Docker image name is provided by the owner and must not be changed for this deployment |
|
188 | 175 | | services.admin.assign_cluster_ip | false | | Set it to `true` if you want to assign `ClusterIP` to the service |
|
189 | 176 |
|
| 177 | +### Monitor Deployment |
| 178 | + |
| 179 | +| Setting | Default | Required | Description | |
| 180 | +|---|:---:|:---:|---| |
| 181 | +| services.monitor.memoryLimit | 1000Mi | | Every deployment in kubernetes can be set to use maximum memory they are allowed to use. This key sets the memory limit for this deployment to use.| |
| 182 | +| services.monitor.cpuLimit | 500m | | Every deployment in kubernetes can be set to use maximum cpu they are allowed to use. This key sets the cpu limit for this deployment to use.| |
| 183 | +| services.monitor.image| registry.plane.tools/plane/monitor-enterprise | | This deployment needs a preconfigured docker image to function. Docker image name is provided by the owner and must not be changed for this deployment | |
| 184 | +| services.monitor.volumeSize | 100Mi | | While setting up the stateful deployment, while creating the persistant volume, volume allocation size need to be provided. This key helps you set the volume allocation size. Unit of this value must be in Mi (megabyte) or Gi (gigabyte) | |
| 185 | +| services.monitor.assign_cluster_ip | false | | Set it to `true` if you want to assign `ClusterIP` to the service | |
| 186 | + |
190 | 187 | ### API Deployment
|
191 | 188 |
|
192 | 189 | | Setting | Default | Required | Description |
|
@@ -243,10 +240,10 @@ If you are planning to use 3rd party ingress providers, here is the available ro
|
243 | 240 |
|
244 | 241 | | Host | Path | Service |
|
245 | 242 | |--- |:---:|---|
|
246 |
| -| plane.example.com | / | <http://plane-web.plane-one:3000> | |
247 |
| -| plane.example.com | /spaces/* | <http://plane-space.plane-one:3000> | |
248 |
| -| plane.example.com | /god-mode/* | <http://plane-admin.plane-one:3000> | |
249 |
| -| plane.example.com | /api/* | <http://plane-api.plane-one:8000> | |
250 |
| -| plane.example.com | /auth/* | <http://plane-api.plane-one:8000> | |
251 |
| -| plane.example.com | /uploads/* | <http://plane-minio.plane-one:9000> | |
252 |
| -| plane-minio.example.com | / | <http://plane-minio.plane-one:9090> | |
| 243 | +| plane.example.com | / | <http://plane-app-web.plane:3000> | |
| 244 | +| plane.example.com | /spaces/* | <http://plane-app-space.plane:3000> | |
| 245 | +| plane.example.com | /god-mode/* | <http://plane-app-admin.plane:3000> | |
| 246 | +| plane.example.com | /api/* | <http://plane-app-api.plane:8000> | |
| 247 | +| plane.example.com | /auth/* | <http://plane-app-api.plane:8000> | |
| 248 | +| plane.example.com | /uploads/* | <http://plane-app-minio.plane:9000> | |
| 249 | +| plane-minio.example.com | / | <http://plane-app-minio.plane:9090> | |
0 commit comments