Skip to content

Commit

Permalink
Add chart README
Browse files Browse the repository at this point in the history
  • Loading branch information
mkilchhofer committed Mar 1, 2021
1 parent fbd8ae6 commit 1469a3a
Showing 1 changed file with 107 additions and 0 deletions.
107 changes: 107 additions & 0 deletions charts/nebraska/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
# Nebraska Helm Chart

Nebraska is an update manager for Flatcar Container Linux.

## TL;DR

```console
$ helm repo add nebraska https://kinvolk.github.io/nebraska/
$ helm install my-nebraska nebraska/nebraska
```

## Parameters

### Global parameters

| Parameter | Description | Default |
|---------------------------|------------------------------|---------|
| `global.imageRegistry` | Global Container image registry | `nil` |

### Nebraska parameters

| Parameter | Description | Default |
|-----------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------|
| `replicaCount` | Number of desired pods | `1` |
| `image.registry` | Container image registry | `quay.io` |
| `image.repository` | Container image name | `flatcar/nebraska` |
| `image.tag` | Container image tag | `""` (use appVersion in `Chart.yaml`) |
| `image.pullPolicy` | Image pull policy. One of `Always`, `Never`, `IfNotPresent` | `IfNotPresent` |
| `image.pullSecrets` | An optional list of references to secrets in the same namespace to use for pulling any of the images used | `[]` |
| `nameOverride` | Overrides the name of the chart | `""` |
| `fullnameOverride` | Overrides the full name of the chart | `""` |
| `serviceAccount.create` | Specifies whether a service account should be created | `false` |
| `serviceAccount.annotations` | Annotations to add to the service account | `{}` |
| `serviceAccount.name` | The name of the service account to use. (If not set and create is true, a name is generated using the fullname template) | `{}` |
| `strategy.type` | Type of deployment. Can be `Recreate` or `RollingUpdate` | `Recreate` |
| `strategy.rollingUpdate.maxSurge` | The maximum number of pods that can be scheduled above the desired number of pods (Only applies when `strategy.type` is `RollingUpdate`) | `nil` |
| `strategy.rollingUpdate.maxUnavailable` | The maximum number of pods that can be unavailable during the update (Only applies when `strategy.type` is `RollingUpdate`) | `nil` |
| `podAnnotations` | Annotations for pods | `nil` |
| `podSecurityContext` | Holds pod-level security attributes and common container settings | `nil` |
| `securityContext` | Security options the container should run with | `nil` |
| `service.type` | Kubernetes Service type | `ClusterIP` |
| `service.port` | Kubernetes Service port | `80` |
| `ingress.enabled` | Enable ingress controller resource | `true` |
| `ingress.annotations` | Annotations for Ingress resource | `{}` |
| `ingress.hosts` | Hostname(s) for the Ingress resource | `["flatcar.example.com"]` |
| `ingress.tls` | Ingress TLS configuration | `[]` |
| `resources` | CPU/Memory resource requests/limits | `{}` |
| `nodeSelector` | Node labels for pod assignment | `{}` |
| `tolerations` | Toleration labels for pod assignment | `[]` |
| `affinity` | Affinity settings for pod assignment | `{}` |
| `livenessProbe` | Liveness Probe settings | Check `values.yaml` file |
| `readinessProbe` | Readiness Probe settings | Check `values.yaml` file |

### Nebraska Configuration

| Parameter | Description | Default |
|-------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------|
| `config.app.logoPath` | Client app logo, should be a path to svg file | `/nebraska/assets/kinvolk-logo.svg` |
| `config.app.title` | Client app title | `Kinvolk Update Service` |
| `config.app.headerStyle` | Client app header style, should be either `dark` or `light` | `dark` |
| `config.app.httpStaticDir` | Path to frontend static files | `/nebraska/static` |
| `config.syncer.enabled` | Enable Flatcar packages syncer | `true` |
| `config.syncer.interval` | Sync check interval (the minimum depends on the number of channels to sync, e.g., `8m` for 8 channels incl. different architectures) | `nil` (uses app defaults of `1h`) |
| `config.syncer.updateURL` | Flatcar update URL to sync from (default "https://public.update.flatcar-linux.net/v1/update/") | `nil` (uses app defaults) |
| `config.hostFlatcarPackages.enabled` | Host Flatcar packages in Nebraska | `false` |
| `config.hostFlatcarPackages.packagesPath` | Path where Flatcar packages files should be stored | `/mnt/packages` |
| `config.hostFlatcarPackages.nebraskaURL` | Nebraska URL (`http://host:port`) | `nil` (defaults to first ingress host) |
| `config.hostFlatcarPackages.persistence.enabled` | Enable persistence using PVC | `false` |
| `config.hostFlatcarPackages.persistence.storageClass` | PVC Storage Class for PostgreSQL volume | `nil` |
| `config.hostFlatcarPackages.persistence.accessModes` | PVC Access Mode for PostgreSQL volume | `["ReadWriteOnce"]` |
| `config.hostFlatcarPackages.persistence.size` | PVC Storage Request for PostgreSQL volume | `10Gi` |
| `config.auth.mode` | Authentication mode, available modes: `noop`, `github` | `noop` |
| `config.auth.github.clientID` | GitHub client ID used for authentication | `nil` |
| `config.auth.github.clientSecret` | GitHub client secret used for authentication | `nil` |
| `config.auth.github.sessionAuthKey` | Session secret used for authenticating sessions in cookies used for storing GitHub info , will be generated if none is passed | `nil` |
| `config.auth.github.sessionCryptKey` | Session key used for encrypting sessions in cookies used for storing GitHub info, will be generated if none is passed | `nil` |
| `config.auth.github.webhookSecret` | GitHub webhook secret used for validing webhook messages | `nil` |
| `config.auth.github.readWriteTeams` | comma-separated list of read-write GitHub teams in the org/team format | `nil` |
| `config.auth.github.readOnlyTeams` | comma-separated list of read-only GitHub teams in the org/team format | `nil` |
| `config.auth.github.enterpriseURL` | Base URL of the enterprise instance if using GHE | `nil` |
| `config.database.host` | The host name of the database server | `""` (use postgresql from Bitnami subchart) |
| `config.database.port` | The port number the database server is listening on | `5432` |
| `config.database.dbname` | The database name | `{{ .Values.postgresql.postgresqlDatabase }}` (evaluated as a template) |
| `config.database.username` | PostgreSQL user | `{{ .Values.postgresql.postgresqlUsername }}` (evaluated as a template) |
| `config.database.password` | PostgreSQL user password | `""` (evaluated as a template) |
| `config.database.passwordExistingSecret.enabled` | Enables setting PostgreSQL user password via an existing secret | `true` |
| `config.database.passwordExistingSecret.name` | Name of the existing secret | `{{ .Release.Name }}-postgresql` (evaluated as a template) |
| `config.database.passwordExistingSecret.key` | Key inside the existing secret containing the PostgreSQL user password | `postgresql-password` |
| `extraArgs` | Extra arguments to pass to Nebraska binary | `[]` |
| `extraEnvVars` | Any extra environment variables you would like to pass on to the pod | `{ "TZ": "UTC" }` |

### Postgresql dependency

| Parameter | Description | Default |
|-----------------------------------------|----------------------------------------------------------------------------------------|------------------------------------|
| `postgresql.enabled` | Enable Bitnami postgresql subchart and deploy database within this helm release | `true` |
| `postgresql.postgresqlDatabase` | PostgreSQL database | `nebraska` |
| `postgresql.postgresqlUsername` | PostgreSQL user (creates a non-admin user when `postgresqlUsername` is not `postgres`) | `postgres` |
| `postgresql.postgresqlPassword` | PostgreSQL user password | `changeIt` **Please change this!** |
| `postgresql.postgresqlPostgresPassword` | PostgreSQL admin password (used when `postgresqlUsername` is not `postgres`) | `-` |
| `postgresql.image.tag` | PostgreSQL Image tag | `12.5.0-debian-10-r76` |
| `postgresql.persistence.enabled` | Enable persistence using PVC | `false` |
| `postgresql.persistence.storageClass` | PVC Storage Class for PostgreSQL volume | `nil` |
| `postgresql.persistence.accessModes` | PVC Access Mode for PostgreSQL volume | `["ReadWriteOnce"]` |
| `postgresql.persistence.size` | PVC Storage Request for PostgreSQL volume | `1Gi` |

... for more options see https://github.com/bitnami/charts/tree/master/bitnami/postgresql

0 comments on commit 1469a3a

Please sign in to comment.