add readme

This commit is contained in:
Simon Larsen
2023-09-29 10:48:45 +01:00
parent 2cf1b2f54b
commit 0bb9ba47b8
3 changed files with 135 additions and 4 deletions

View File

@@ -0,0 +1,133 @@
<!-- markdownlint-disable MD033 -->
<h1 align="center"><img alt="oneuptime logo" width=50% src="https://raw.githubusercontent.com/OneUptime/oneuptime/master/Home/public/img/OneUptimePNG/7.png"/></h1>
<!-- markdownlint-enable MD033 -->
# OneUptime Helm Chart
OneUptime is a comprehensive solution for monitoring and managing your online services. Whether you need to check the availability of your website, dashboard, API, or any other online resource, OneUptime can alert your team when downtime happens and keep your customers informed with a status page. OneUptime also helps you handle incidents, set up on-call rotations, run tests, secure your services, analyze logs, track performance, and debug errors.
[Overview of OneUptime](http://www.oneuptime.com)
## Install Helm Chart
#### Create values.yaml file and change the default secrets.
Create a values.yaml file and change the default secrets.
```yaml
secrets:
oneuptime: please-change-this-to-random-value
encryption: please-change-this-to-random-value
probes:
one:
key: please-change-this-to-random-value
two:
key: please-change-this-to-random-value
redis:
auth:
password: please-change-this-to-random-value
postgresql:
auth:
password: please-change-this-to-random-value
clickhouse:
auth:
password: please-change-this-to-random-value
```
#### Pick a Storage Class
Storage class are different for different cloud environemtns. Please pick the right one for your cloud environment.
To get a list of storage classes, run the following command:
```console
kubectl get storageclass
```
and add this to your values.yaml file
```yaml
global:
storageClass: "your-storage-class"
```
```console
helm install my-release https://helm-chart.oneuptime.com/oneuptime -f values.yaml
```
## Uninstall Helm Chart
```console
helm uninstall my-release
```
## Configuration
The following table lists the configurable parameters of the OneUptime chart and their default values.
| Parameter | Description | Default | Change Required |
| --------- | ----------- | ------- | --------------- |
| `global.storageClass` | Storage class to be used for all persistent volumes | `nil` | ✅ |
| `host` | Hostname for the ingress | `localhost` | ✅ |
| `image.registry` | Docker image registry | `docker.io` | |
| `image.repository` | Docker image repository | `oneuptime` | |
| `image.tag` | Docker image tag | `release` |
| `image.pullPolicy` | Docker image pull policy | `IfNotPresent` | |
| `image.restartPolicy` | Docker image restart policy | `Always` | |
| `secrets.oneuptime` | Secret for OneUptime | `please-change-this-to-random-value` | ✅ |
| `secrets.encryption` | Secret for Encryption | `please-change-this-to-random-value` | ✅ |
| `autoScaling.enabled` | Enable autoscaling | `false` | |
| `autoScaling.minReplicas` | Minimum number of replicas | `1` | |
| `autoScaling.maxReplicas` | Maximum number of replicas | `100` | |
| `autoScaling.targetCPUUtilizationPercentage` | Target CPU utilization percentage | `80` | |
| `autoScaling.targetMemoryUtilizationPercentage` | Target memory utilization percentage | `80` | |
| `nodeEnvironment` | Node environment (please dont change this unless you're doing local development) | `production` | |
| `ingress.service.type` | Ingress service type | `LoadBalancer` | |
| `ingress.service.loadBalancerIP` | Ingress service load balancer IP | `nil` | |
| `deployment.replicaCount` | Number of replicas | `1` | |
| `probe.<key>.name` | Probe name | `<key>` | |
| `probe.<key>.description` | Probe description | `nil` | |
| `probe.<key>.monitoringWorkers` | Number of threads / parallel processes you need to monitor your resources | `3` | |
| `probe.<key>.monitorFetchLimit` | Number of resources to be monitored in parallel | `10` | |
| `probe.<key>.key` | Probe authentication key | `please-change-this-to-random-value` | ✅ |
| `statusPage.cnameRecord` | CNAME record for the status page | `nil` | |
| `internalSmtp.password` | Pick any random secure password. It just secures the internal SMTP Server | `nil` | ✅ |
| `internalSmtp.sendingDomain` | Domain to send emails from | `nil` | |
| `internalSmtp.dkimPrivateKey` | DKIM Private Key that is set for sending domain | `nil` | |
| `internalSmtp.dkimPublicKey` | DKIM Public Key that is set for sending domain | `nil` | |
| `internalSmtp.email` | Email address to send emails from | `nil` | |
| `internalSmtp.name` | Name to send emails from | `nil` | |
| `incidents.disableAutomaticCreation` | Disable incident creation (use this when your team is overloaded with incidents or in emergencies) | `false` | |
## Chart Dependencies
We use these charts as dependencies. You dont need to install them separately. Please read the readme for these individual charts to understand the configuration options.
| Chart | Description | Repository |
| ----- | ----------- | ---------- |
| `postgresql` | PostgreSQL database | https://charts.bitnami.com/bitnami |
| `redis` | Redis database | https://charts.bitnami.com/bitnami |
| `clickhouse` | Clickhouse database | https://charts.bitnami.com/bitnami |
| `minio` | Minio | https://charts.bitnami.com/bitnami |

View File

@@ -79,8 +79,6 @@ billing:
smsDefaultValueInCents:
callDefaultValueInCentsPerMinute:
disableAutomaticIncidentsCreation:
subscriptionPlan:
basic:
growth:
@@ -95,7 +93,7 @@ analytics:
key:
internalSmtp:
password:
password: please-change-this-to-random-value
sendingDomain:
dkimPrivateKey:
dkimPublicKey:

View File

@@ -1,5 +1,5 @@
<!-- markdownlint-disable MD033 -->
<h1 align="center"><img alt="oneuptime logo" width=75% src="https://raw.githubusercontent.com/OneUptime/oneuptime/master/Home/public/img/OneUptimePNG/7.png"/></h1>
<h1 align="center"><img alt="oneuptime logo" width=50% src="https://raw.githubusercontent.com/OneUptime/oneuptime/master/Home/public/img/OneUptimePNG/7.png"/></h1>
<!-- markdownlint-enable MD033 -->
**OneUptime: The Complete Open-Source Observability Platform**