Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update helm fields #176

Merged
merged 6 commits into from
Sep 14, 2023
Merged

Update helm fields #176

Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
b35ec22
Update helm fields
dereknola Sep 5, 2023
d1f3f01
Update docs/helm/helm.md
dereknola Sep 5, 2023
1a9555a
Update docs/helm/helm.md
dereknola Sep 5, 2023
16f9522
Add example with auth and cert-ca config
dereknola Sep 5, 2023
af59940
More generic helm chart example
dereknola Sep 12, 2023
f7006dc
Spelling
dereknola Sep 12, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 6 additions & 10 deletions docs/helm/helm.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,15 +45,21 @@ spec:
| metadata.name | | Helm Chart name | NAME |
| spec.chart | | Helm Chart name in repository, or complete HTTPS URL to chart archive (.tgz) | CHART |
| spec.targetNamespace | default | Helm Chart target namespace | `--namespace` |
| spec.createNamespace | false | Create target namespace if not present | `--create-namespace` |
| spec.version | | Helm Chart version (when installing from repository) | `--version` |
| spec.repo | | Helm Chart repository URL | `--repo` |
| spec.repoCA | | Specify the certificates of HTTPS-enabled servers | `--ca-file` |
| spec.repoCAConfigMap | | Values of all keys in ConfigMap will be merged with repoCA | `--ca-file` |
dereknola marked this conversation as resolved.
Show resolved Hide resolved
| spec.helmVersion | v3 | Helm version to use (`v2` or `v3`) | |
| spec.bootstrap | False | Set to True if this chart is needed to bootstrap the cluster (Cloud Controller Manager, etc) | |
| spec.set | | Override simple default Chart values. These take precedence over options set via valuesContent. | `--set` / `--set-string` |
| spec.jobImage | | Specify the image to use when installing the helm chart. E.g. rancher/klipper-helm:v0.3.0 . | |
| spec.backOffLimit | 1000 | Specify the number of retries before considering a job failed. | |
| spec.timeout | 300s | Timeout for Helm operations, as a [duration string](https://pkg.go.dev/time#ParseDuration) (`300s`, `10m`, `1h`, etc) | `--timeout` |
| spec.failurePolicy | reinstall | Set to `abort` which case the Helm operation is aborted, pending manual intervention by the operator. | |
| spec.authSecret | | Pass basic username/pass auth to Chart repos via `kubernetes.io/basic-auth` | |
| spec.authPassCredentials | false | Pass credentials to all domains | `--pass-credentials` |
| spec.dockerRegsistrySecret | | Point to mounted docker auth secret via `kubernetes.io/dockerconfigjson`. Used to authenticate OCI-compliant Docker registries | |
dereknola marked this conversation as resolved.
Show resolved Hide resolved
| spec.valuesContent | | Override complex default Chart values via YAML file content | `--values` |
| spec.chartContent | | Base64-encoded chart archive .tgz - overrides spec.chart | CHART |

Expand All @@ -65,12 +71,6 @@ The `name` field should follow the Helm chart naming conventions. Refer to the [

### Customizing Packaged Components with HelmChartConfig

:::info Version Gate

Available as of [v1.19.1+k3s1](https://github.com/k3s-io/k3s/releases/tag/v1.19.1%2Bk3s1)

:::

To allow overriding values for packaged components that are deployed as HelmCharts (such as Traefik), K3s supports customizing deployments via a HelmChartConfig resources. The HelmChartConfig resource must match the name and namespace of its corresponding HelmChart, and it supports providing additional `valuesContent`, which is passed to the `helm` command as an additional value file.

:::note
Expand Down Expand Up @@ -101,10 +101,6 @@ spec:

### Migrating from Helm v2

:::info Version Gate
As of [v1.17.0+k3s.1](https://github.com/k3s-io/k3s/releases/tag/v1.17.0%2Bk3s.1) Helm v3 is supported and used by default.
:::

K3s can handle either Helm v2 or Helm v3. If you wish to migrate to Helm v3, [this](https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/) blog post by Helm explains how to use a plugin to successfully migrate. Refer to the official Helm 3 documentation [here](https://helm.sh/docs/) for more information. Just be sure you have properly set your kubeconfig as per the section about [cluster access.](../cluster-access/cluster-access.md)

:::note
Expand Down
Loading