@@ -5,7 +5,11 @@
55[Octopod](https://octopod.site/) is a fully open-source self-hosted solution for managing multiple deployments in a Kubernetes cluster with a user-friendly web interface. Managing deployments does not require any technical expertise.
66
77## TL;DR
8−TBD (install chart from typeable's chart repository)
8+```console
9+helm repo add typeable https://typeable.github.io/octopod/
10+kubectl create ns octopod-deployment
11+helm install octopod typeable/octopod --set octopod.baseDomain="your-domain.com"
12+```
913
1014## Introduction
1115
@@ -48,8 +52,8 @@ Name for configmap is cofigured in octopod.certsConfigMapName
4852To install the chart with the release name `my-release` from current directory execute:
4953
5054```console
51−$ helm dependency build
52−$ helm -n octopod install my-release .
55+$ helm repo add typeable https://typeable.github.io/octopod/
56+# helm -n octopod install my-release typeable/octopod
5357```
5458
5559The command deploys Octopod on the Kubernetes cluster in the default configuration inside octopod namespace. The [Parameters](#parameters) section lists the parameters that can be configured during installation.
@@ -80,26 +84,30 @@ The following tables lists the configurable parameters of the Octopod chart and
8084| image.tag | string | `""` | Octopod image tag (default values is taken from chart metadata) |
8185| imagePullSecrets | list | `[]` | Pull secrets if you want to use private registry |
8286| ingress.app.annotations | object | `{}` | Additional ingress annotations for app service |
83−| ingress.app.host | string | `"octopod-app.example.com"` | Hostname for app service |
87+| ingress.app.host | string | `null` | Hostname override for app service by default it will be generated using your baseDomain |
8488| ingress.enabled | bool | `true` | Create ingress objects or not |
8589| ingress.ingressClass | string | `"nginx"` | Ingress class |
8690| ingress.powerApp.annotations | object | `{}` | Additional ingress annotations for power-app service |
87−| ingress.powerApp.host | string | `"octopod-powerapp.example.com"` | Hostname for power-app |
91+| ingress.powerApp.host | string | `null` | Hostname override for powerapp by default it will be generated using your baseDomain |
8892| ingress.tls.clusterIssuer | string | `"letsencrypt"` | Name of cluster issuer you want to use |
8993| ingress.tls.enabled | bool | `true` | Use https for all services |
9094| ingress.ui.annotations | object | `{}` | Additional ingress annotations for ui service |
91−| ingress.ui.host | string | `"octopod.example.com"` | Hostname for main UI |
95+| ingress.ui.host | string | `null` | Hostname override for main UI by default it will be generated using your baseDomain |
9296| ingress.ws.annotations | object | `{}` | Additional ingress annotations for ws service |
93−| ingress.ws.host | string | `"octopod-ws.example.com"` | Hostname for websockets ingress |
97+| ingress.ws.host | string | `null` | Hostname override for websockets ingress by default it will be generated using your baseDomain |
98+| kubernetesDashboard.enabled | bool | `false` | Set this if you are using kubernetes dashboard and want to enable Details featire of octopod |
99+| kubernetesDashboard.url | bool | `""` | URL to your kubernetes dashboard |
94100| nameOverride | string | `""` | Name ovveride (default is Release.Name) |
95101| nodeSelector | object | `{}` | Node selector if you want octopod to use specific nodes onn your cluster |
96102| octopod.archiveRetention | int | `1209600` | |
97−| octopod.baseDomain | string | `""` | Domain that will be used as a ase for Octopod deploymets |
103+| octopod.baseDomain | string | `""` | Domain that will be used as a ase for Octopod deploymets and ingress hosts|
98104| octopod.certsConfigMapName | string | `"octopod-certs"` | Config map with self-signed certificates |
99105| octopod.deploymentNamespace | string | `"octopod-deployment"` | Name of a namespace which will be used for all Octopod deployments (you need to create it yourself) |
106+| octopod.env | object | `{}` | key value map for supplying additional environment variables for octopod or your control scripts |
100107| octopod.migrations.enabled | bool | `true` | Enable or not automatic DB schema migrations |
101108| octopod.projectName | string | `"Octopod"` | Project name |
102109| octopod.statusUpdateTimeout | int | `600` | Time to wait before deployment is marked as failed |
110+| octopod.vaultEnv | object | `{}` | key value map for reference kv secrets stored in Hashicorp's Vault |
103111| podAnnotations | object | `{}` | Additional pod annotations |
104112| podSecurityContext | object | `{}` | Additional security context |
105113| postgresql.enabled | bool | `true` | Use bitnami postgres chart |
@@ -125,6 +133,8 @@ The following tables lists the configurable parameters of the Octopod chart and
125133| sqitch.image.repository | string | `"typeable/sqitch"` | squitch image repository |
126134| sqitch.image.tag | string | `"v2.0.0"` | squitch image tag |
127135| tolerations | list | `[]` | Octpod deploymet tolerations |
136+| vault.enabled | bool | `false` | Set to true if you want to add Vault agent annotations (vaultEnv must contain at least one reference) |
137+| vault.clusterName | string | `""` | Name of your cluster authentication method in Vault |
128138
129139
130140Specify each parameter using the `--set key=value[,key=value]` argument to `helm install`. For example,