pangolin_mirror/docs-v2
1
0
Fork 0
mirror of https://github.com/fosrl/docs-v2.git synced 2026-10-21 03:59:16 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs(kubernetes): add --devel for Pangolin Helm pre-release installs

Browse Source 
The Pangolin chart is published as a pre-release, and Helm hides pre-release
versions from search and refuses to install them unless --devel is passed or an
exact version is named. Following these instructions on a clean Helm setup listed
only the Newt chart and failed the install.

Adds --devel to the install, upgrade and Gerbil startup-mode commands, documents
the explicit --version alternative as the safer choice for production, and
refreshes the OCI examples, which still pinned 0.1.0-alpha.0.

Fixes #139

Signed-off-by: Marc Schäfer <git@marcschaeferger.de>
This commit is contained in:
Marc Schäfer
2026-09-10 12:25:35 +02:00
parent 293d23f078
commit cb4aa3ccba
1 changed files with 41 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
self-host/manual/kubernetes/pangolin/helm.mdx
+41 -5
View File
@@ -179,14 +179,44 @@ helm repo add fossorial https://charts.fossorial.io
helm repo update fossorial
```
<Warning>
The Pangolin chart is published as a pre-release (currently `0.1.0-alpha.2`). Helm hides
pre-release versions from `helm search` and refuses to install them unless you pass
`--devel` or name an exact version, so the commands below need `--devel`. Without it,
`helm search repo fossorial` lists only the Newt chart and the install fails with
`no chart version found`.
This applies only to Pangolin. The Newt chart has stable releases and needs no flag.
</Warning>
List the available charts:
```bash
helm search repo fossorial --devel
```
Install Pangolin:
```bash
helm upgrade --install pangolin fossorial/pangolin \
helm upgrade --install pangolin fossorial/pangolin --devel \
--namespace pangolin \
--values values-pangolin.yaml
```
<Tip>
Prefer pinning the exact version instead of tracking the newest pre-release, so an
upgrade never picks up a new alpha unintentionally:
```bash
helm upgrade --install pangolin fossorial/pangolin \
--version 0.1.0-alpha.2 \
--namespace pangolin \
--values values-pangolin.yaml
```
An explicit `--version` makes `--devel` unnecessary.
</Tip>
Do not use `--create-namespace` here. The namespace was created and labeled before installation.
### Step 5: Verify the deployment
@@ -264,7 +294,7 @@ The chart routes `/api/v1` to the Pangolin external/API port and the dashboard r
If you installed with `gerbil.startupMode=delayed`, switch Gerbil to normal mode after the initial setup is complete:
```bash
helm upgrade pangolin fossorial/pangolin \
helm upgrade pangolin fossorial/pangolin --devel \
--namespace pangolin \
--reuse-values \
--set gerbil.startupMode=normal
@@ -288,11 +318,17 @@ helm repo update fossorial
Upgrade the release:
```bash
helm upgrade pangolin fossorial/pangolin \
helm upgrade pangolin fossorial/pangolin --devel \
--namespace pangolin \
--values values-pangolin.yaml
```
<Note>
`--devel` is required here for the same reason as during install: without it Helm will
not resolve a pre-release version and the upgrade fails. Drop it once the chart has a
stable release, or replace it with an explicit `--version`.
</Note>
Check upgrade status:
```bash
@@ -314,14 +350,14 @@ Pull the chart:
```bash
helm pull oci://ghcr.io/fosrl/helm-charts/pangolin \
--version 0.1.0-alpha.0
--version 0.1.0-alpha.2
```
Install from OCI:
```bash
helm upgrade --install pangolin oci://ghcr.io/fosrl/helm-charts/pangolin \
--version 0.1.0-alpha.0 \
--version 0.1.0-alpha.2 \
--namespace pangolin \
--values values-pangolin.yaml
```