Skip to content

Commit 676f9fd

Browse files
committed
docs(v0): pin cozystack download URLs in v0 docs
The legacy releases/latest/download/cozystack-installer.yaml URL no longer resolves: that asset was dropped in v1.0 when the installer manifest was split into cozystack-crds.yaml plus cozystack-operator-{generic,hosted,talos}.yaml, and `latest` now points to v1.4.x. The metal image URLs (metal-amd64.iso, metal-amd64.raw.xz) under `latest` also resolve to the v1.4-era Talos build, silently mismatching the Talos version shipped by the v0 installer manifest. The talm bare-binary asset name was dropped, but the tar.gz asset under `latest` is fine. - Add data/versions/v0.yaml with the cozystack_tag pin so the {{< version-pin "cozystack_tag" >}} shortcode resolves on v0 pages — same pattern as data/versions/v1.{3,4}.yaml. - Pin every cozystack/cozystack release URL referenced under content/en/docs/v0/ to v0.41.11 via the shortcode: the installer manifest (3 pages), the metal image downloads (2 pages), and the Oracle Cloud guide's link to the cozystack release page. - Switch the v0 Oracle Cloud talm download from the obsolete bare-binary URL to the renamed tar.gz under `latest` (talm floats across cozystack minors per data/versions/v1.4.yaml policy). boot-to-talos URLs in v0 docs intentionally remain on `latest` — same floating policy as talm. Assisted-By: Claude <noreply@anthropic.com> Signed-off-by: Aleksei Sviridkin <f@lex.la>
1 parent 94f043f commit 676f9fd

6 files changed

Lines changed: 21 additions & 7 deletions

File tree

content/en/docs/v0/getting-started/install-cozystack.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ This file defines the Cozystack version.
9090
For tutorial, just take the latest stable version available on GitHub:
9191

9292
```bash
93-
kubectl apply -f https://github.com/cozystack/cozystack/releases/latest/download/cozystack-installer.yaml
93+
kubectl apply -f https://github.com/cozystack/cozystack/releases/download/{{< version-pin "cozystack_tag" >}}/cozystack-installer.yaml
9494
```
9595

9696
As the installation goes on, you can track the logs of installer:

content/en/docs/v0/install/cozystack/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ Create a namespace `cozy-system` and install Cozystack system components:
9393
```bash
9494
kubectl create ns cozy-system --dry-run=client --output yaml | kubectl apply -f -
9595
kubectl apply -f cozystack.yaml
96-
kubectl apply -f https://github.com/cozystack/cozystack/releases/latest/download/cozystack-installer.yaml
96+
kubectl apply -f https://github.com/cozystack/cozystack/releases/download/{{< version-pin "cozystack_tag" >}}/cozystack-installer.yaml
9797
```
9898

9999
As the installation goes on, you can track the logs of installer:

content/en/docs/v0/install/providers/hetzner.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -350,7 +350,7 @@ The final stage of deploying a Cozystack cluster on Hetzner is to install Cozyst
350350
```bash
351351
kubectl create ns cozy-system --dry-run=client --output yaml | kubectl apply -f -
352352
kubectl apply -f cozystack-config.yaml
353-
kubectl apply -f https://github.com/cozystack/cozystack/releases/latest/download/cozystack-installer.yaml
353+
kubectl apply -f https://github.com/cozystack/cozystack/releases/download/{{< version-pin "cozystack_tag" >}}/cozystack-installer.yaml
354354
```
355355
356356
The last command starts Cozystack installation, which will last for some time.

content/en/docs/v0/install/providers/oracle-cloud.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,10 +27,10 @@ or come and share your experience in the [Cozystack community](https://t.me/cozy
2727

2828
The first step is to make a Talos Linux installation image available for use in Oracle Cloud as a custom image.
2929

30-
1. Download the Talos Linux image archive from the [Cozystack releases page](https://github.com/cozystack/cozystack/releases/latest/) and unpack it:
30+
1. Download the Talos Linux image archive from the [Cozystack releases page](https://github.com/cozystack/cozystack/releases/tag/{{< version-pin "cozystack_tag" >}}) and unpack it:
3131

3232
```bash
33-
wget https://github.com/cozystack/cozystack/releases/latest/download/metal-amd64.raw.xz
33+
wget https://github.com/cozystack/cozystack/releases/download/{{< version-pin "cozystack_tag" >}}/metal-amd64.raw.xz
3434
xz -d metal-amd64.raw.xz
3535
```
3636

@@ -251,7 +251,8 @@ Make it executable and save it to `/usr/local/bin/talm`:
251251
252252
```bash
253253
# pick your preferred architecture from the release artifacts
254-
wget -O talm https://github.com/cozystack/talm/releases/latest/download/talm-darwin-arm64
254+
wget https://github.com/cozystack/talm/releases/latest/download/talm-darwin-arm64.tar.gz
255+
tar -xzf talm-darwin-arm64.tar.gz talm
255256
chmod +x talm
256257
mv talm /usr/local/bin/talm
257258
```

content/en/docs/v0/install/talos/iso.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Note that Cozystack provides its own Talos builds, which are tested and optimize
2121
1. Download Talos Linux asset from the Cozystack's [releases page](https://github.com/cozystack/cozystack/releases).
2222

2323
```bash
24-
wget https://github.com/cozystack/cozystack/releases/latest/download/metal-amd64.iso
24+
wget https://github.com/cozystack/cozystack/releases/download/{{< version-pin "cozystack_tag" >}}/metal-amd64.iso
2525
```
2626

2727
1. Boot your machine with ISO attached.

data/versions/v0.yaml

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Pinned upstream-tool versions for the Cozystack v0 docs.
2+
#
3+
# This file exists so the {{< version-pin "<key>" >}} shortcode can keep v0
4+
# download links pinned to a v0-era release. The legacy
5+
# `releases/latest/download/cozystack-installer.yaml` URL no longer resolves —
6+
# that asset was dropped in v1.0 when the installer manifest was split into
7+
# cozystack-crds.yaml plus cozystack-operator-*.yaml.
8+
#
9+
# Add more keys (talos, etc.) only when a v0 page introduces the corresponding
10+
# shortcode call.
11+
12+
# Last released Cozystack v0.x version, used as v-prefixed in GitHub URLs.
13+
cozystack_tag: "v0.41.11"

0 commit comments

Comments
 (0)