docs: fix incorrect image suffix

When user follow instructions in document v1.5 and v1.6, curl will make a request with invalid image URL, this correct image suffixes. Fixes #7809 Signed-off-by: mikucat0309 <[email protected]> Signed-off-by: Andrey Smirnov <[email protected]>
siderolabs · Oct 9, 2023 · 498aeb8 · 498aeb8
1 parent c14a5d4
commit 498aeb8
Show file tree

Hide file tree

Showing 22 changed files with 66 additions and 56 deletions.
diff --git a/website/content/v1.5/_index.md b/website/content/v1.5/_index.md
@@ -4,13 +4,12 @@ no_list: true
 linkTitle: "Documentation"
 cascade:
   type: docs
-lastRelease: v1.5.0
-kubernetesRelease: "1.28.0"
+lastRelease: v1.5.3
+kubernetesRelease: "1.28.2"
 prevKubernetesRelease: "1.27.4"
 theilaRelease: "v0.2.1"
 nvidiaContainerToolkitRelease: "v1.13.5"
 nvidiaDriverRelease: "535.54.03"
-iscsiToolsRelease: "v0.1.4"
 menu: main
 ---
 

diff --git a/...5/kubernetes-guides/configuration/replicated-local-storage-with-openebs-jiva.md b/...5/kubernetes-guides/configuration/replicated-local-storage-with-openebs-jiva.md
@@ -18,13 +18,19 @@ Refer to the OpenEBS Jiva [documentation](https://github.com/openebs/jiva-operat
 
 ## Preparing the nodes
 
+Find the matching `iscsi-tools` image reference for your Talos version by running the [following command](https://github.com/siderolabs/extensions):
+
+```bash
+crane export ghcr.io/siderolabs/extensions:{{< release >}} | tar x -O image-digests | grep iscsi-tools
+```
+
 Create a machine config patch with the contents below and save as `patch.yaml`
 
 ```yaml
 - op: add
   path: /machine/install/extensions
   value:
-    - image: ghcr.io/siderolabs/iscsi-tools:{{< iscsi_tools_system_extension_release >}}
+    - image: ghcr.io/siderolabs/iscsi-tools:<version>@sha256:<digest>
 - op: add
   path: /machine/kubelet/extraMounts
   value:
@@ -52,7 +58,7 @@ Run the following command on each nodes subsequently:
 talosctl -e <endpoint ip/hostname> -n <node ip/hostname> upgrade --image=ghcr.io/siderolabs/installer:{{< release >}}
 ```
 
-Once the node has upgraded and booted successfully the extension status can be verfied by running the following command:
+Once the node has upgraded and booted successfully the extension status can be verified by running the following command:
 
 ```bash
 talosctl -e <endpoint ip/hostname> -n <node ip/hostname> get extensions

diff --git a/website/content/v1.5/talos-guides/install/single-board-computers/bananapi_m64.md b/website/content/v1.5/talos-guides/install/single-board-computers/bananapi_m64.md
@@ -24,8 +24,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-bananapi_m64-arm64.img.xz
-xz -d metal-bananapi_m64-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-bananapi_m64-arm64.raw.xz
+xz -d metal-bananapi_m64-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/website/content/v1.5/talos-guides/install/single-board-computers/jetson_nano.md b/website/content/v1.5/talos-guides/install/single-board-computers/jetson_nano.md
@@ -85,8 +85,8 @@ Once the flashing is done you can disconnect the USB cable and power off the Jet
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-jetson_nano-arm64.img.xz
-xz -d metal-jetson_nano-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-jetson_nano-arm64.raw.xz
+xz -d metal-jetson_nano-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/...tent/v1.5/talos-guides/install/single-board-computers/libretech_all_h3_cc_h5.md b/...tent/v1.5/talos-guides/install/single-board-computers/libretech_all_h3_cc_h5.md
@@ -24,8 +24,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-libretech_all_h3_cc_h5-arm64.img.xz
-xz -d metal-libretech_all_h3_cc_h5-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-libretech_all_h3_cc_h5-arm64.raw.xz
+xz -d metal-libretech_all_h3_cc_h5-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/website/content/v1.5/talos-guides/install/single-board-computers/nanopi_r4s.md b/website/content/v1.5/talos-guides/install/single-board-computers/nanopi_r4s.md
@@ -24,8 +24,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4-arm64.img.xz
-xz -d metal-nanopi_r4s-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4-arm64.raw.xz
+xz -d metal-nanopi_r4s-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/website/content/v1.5/talos-guides/install/single-board-computers/pine64.md b/website/content/v1.5/talos-guides/install/single-board-computers/pine64.md
@@ -24,8 +24,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-pine64-arm64.img.xz
-xz -d metal-pine64-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-pine64-arm64.raw.xz
+xz -d metal-pine64-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/website/content/v1.5/talos-guides/install/single-board-computers/rock64.md b/website/content/v1.5/talos-guides/install/single-board-computers/rock64.md
@@ -24,8 +24,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rock64-arm64.img.xz
-xz -d metal-rock64-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rock64-arm64.raw.xz
+xz -d metal-rock64-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/website/content/v1.5/talos-guides/install/single-board-computers/rockpi_4.md b/website/content/v1.5/talos-guides/install/single-board-computers/rockpi_4.md
@@ -24,8 +24,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4-arm64.img.xz
-xz -d metal-rockpi_4-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4-arm64.raw.xz
+xz -d metal-rockpi_4-arm64.raw.xz
 ```
 
 ## Writing the Image
@@ -68,9 +68,9 @@ sudo dd if=rkspi_loader.img of=/dev/mtdblock0 bs=4K
 - Optionally, you can also write Talos image to the SSD drive right from your Rock PI board:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4-arm64.img.xz
-xz -d metal-rockpi_4-arm64.img.xz
-sudo dd if=metal-rockpi_4-arm64.img.xz of=/dev/nvme0n1
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4-arm64.raw.xz
+xz -d metal-rockpi_4-arm64.raw.xz
+sudo dd if=metal-rockpi_4-arm64.raw.xz of=/dev/nvme0n1
 ```
 
 - remove SD card and reboot.

diff --git a/website/content/v1.5/talos-guides/install/single-board-computers/rockpi_4c.md b/website/content/v1.5/talos-guides/install/single-board-computers/rockpi_4c.md
@@ -22,8 +22,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4c-arm64.img.xz
-xz -d metal-rockpi_4c-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4c-arm64.raw.xz
+xz -d metal-rockpi_4c-arm64.raw.xz
 ```
 
 ## Writing the Image
@@ -66,9 +66,9 @@ sudo dd if=rkspi_loader.img of=/dev/mtdblock0 bs=4K
 - Optionally, you can also write Talos image to the SSD drive right from your Rock PI board:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4c-arm64.img.xz
-xz -d metal-rockpi_4c-arm64.img.xz
-sudo dd if=metal-rockpi_4c-arm64.img.xz of=/dev/nvme0n1
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4c-arm64.raw.xz
+xz -d metal-rockpi_4c-arm64.raw.xz
+sudo dd if=metal-rockpi_4c-arm64.raw.xz of=/dev/nvme0n1
 ```
 
 - remove SD card and reboot.

diff --git a/website/content/v1.5/talos-guides/install/single-board-computers/rpi_generic.md b/website/content/v1.5/talos-guides/install/single-board-computers/rpi_generic.md
@@ -47,8 +47,8 @@ Power off the Raspberry Pi and remove the SD card from it.
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rpi_generic-arm64.img.xz
-xz -d metal-rpi_generic-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rpi_generic-arm64.raw.xz
+xz -d metal-rpi_generic-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/website/content/v1.6/_index.md b/website/content/v1.6/_index.md
@@ -10,7 +10,6 @@ prevKubernetesRelease: "1.28.0"
 theilaRelease: "v0.2.1"
 nvidiaContainerToolkitRelease: "v1.13.5"
 nvidiaDriverRelease: "535.54.03"
-iscsiToolsRelease: "v0.1.4"
 preRelease: true
 ---
 

diff --git a/...6/kubernetes-guides/configuration/replicated-local-storage-with-openebs-jiva.md b/...6/kubernetes-guides/configuration/replicated-local-storage-with-openebs-jiva.md
@@ -18,13 +18,19 @@ Refer to the OpenEBS Jiva [documentation](https://github.com/openebs/jiva-operat
 
 ## Preparing the nodes
 
+Find the matching `iscsi-tools` image reference for your Talos version by running the [following command](https://github.com/siderolabs/extensions):
+
+```bash
+crane export ghcr.io/siderolabs/extensions:{{< release >}} | tar x -O image-digests | grep iscsi-tools
+```
+
 Create a machine config patch with the contents below and save as `patch.yaml`
 
 ```yaml
 - op: add
   path: /machine/install/extensions
   value:
-    - image: ghcr.io/siderolabs/iscsi-tools:{{< iscsi_tools_system_extension_release >}}
+    - image: ghcr.io/siderolabs/iscsi-tools:<version>@sha256:<digest>
 - op: add
   path: /machine/kubelet/extraMounts
   value:
@@ -52,7 +58,7 @@ Run the following command on each nodes subsequently:
 talosctl -e <endpoint ip/hostname> -n <node ip/hostname> upgrade --image=ghcr.io/siderolabs/installer:{{< release >}}
 ```
 
-Once the node has upgraded and booted successfully the extension status can be verfied by running the following command:
+Once the node has upgraded and booted successfully the extension status can be verified by running the following command:
 
 ```bash
 talosctl -e <endpoint ip/hostname> -n <node ip/hostname> get extensions

diff --git a/website/content/v1.6/talos-guides/install/single-board-computers/bananapi_m64.md b/website/content/v1.6/talos-guides/install/single-board-computers/bananapi_m64.md
@@ -24,8 +24,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-bananapi_m64-arm64.img.xz
-xz -d metal-bananapi_m64-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-bananapi_m64-arm64.raw.xz
+xz -d metal-bananapi_m64-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/website/content/v1.6/talos-guides/install/single-board-computers/jetson_nano.md b/website/content/v1.6/talos-guides/install/single-board-computers/jetson_nano.md
@@ -85,8 +85,8 @@ Once the flashing is done you can disconnect the USB cable and power off the Jet
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-jetson_nano-arm64.img.xz
-xz -d metal-jetson_nano-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-jetson_nano-arm64.raw.xz
+xz -d metal-jetson_nano-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/...tent/v1.6/talos-guides/install/single-board-computers/libretech_all_h3_cc_h5.md b/...tent/v1.6/talos-guides/install/single-board-computers/libretech_all_h3_cc_h5.md
@@ -24,8 +24,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-libretech_all_h3_cc_h5-arm64.img.xz
-xz -d metal-libretech_all_h3_cc_h5-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-libretech_all_h3_cc_h5-arm64.raw.xz
+xz -d metal-libretech_all_h3_cc_h5-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/website/content/v1.6/talos-guides/install/single-board-computers/nanopi_r4s.md b/website/content/v1.6/talos-guides/install/single-board-computers/nanopi_r4s.md
@@ -24,8 +24,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4-arm64.img.xz
-xz -d metal-nanopi_r4s-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4-arm64.raw.xz
+xz -d metal-nanopi_r4s-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/website/content/v1.6/talos-guides/install/single-board-computers/pine64.md b/website/content/v1.6/talos-guides/install/single-board-computers/pine64.md
@@ -24,8 +24,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-pine64-arm64.img.xz
-xz -d metal-pine64-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-pine64-arm64.raw.xz
+xz -d metal-pine64-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/website/content/v1.6/talos-guides/install/single-board-computers/rock64.md b/website/content/v1.6/talos-guides/install/single-board-computers/rock64.md
@@ -24,8 +24,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rock64-arm64.img.xz
-xz -d metal-rock64-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rock64-arm64.raw.xz
+xz -d metal-rock64-arm64.raw.xz
 ```
 
 ## Writing the Image

diff --git a/website/content/v1.6/talos-guides/install/single-board-computers/rockpi_4.md b/website/content/v1.6/talos-guides/install/single-board-computers/rockpi_4.md
@@ -24,8 +24,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4-arm64.img.xz
-xz -d metal-rockpi_4-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4-arm64.raw.xz
+xz -d metal-rockpi_4-arm64.raw.xz
 ```
 
 ## Writing the Image
@@ -68,9 +68,9 @@ sudo dd if=rkspi_loader.img of=/dev/mtdblock0 bs=4K
 - Optionally, you can also write Talos image to the SSD drive right from your Rock PI board:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4-arm64.img.xz
-xz -d metal-rockpi_4-arm64.img.xz
-sudo dd if=metal-rockpi_4-arm64.img.xz of=/dev/nvme0n1
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4-arm64.raw.xz
+xz -d metal-rockpi_4-arm64.raw.xz
+sudo dd if=metal-rockpi_4-arm64.raw.xz of=/dev/nvme0n1
 ```
 
 - remove SD card and reboot.

diff --git a/website/content/v1.6/talos-guides/install/single-board-computers/rockpi_4c.md b/website/content/v1.6/talos-guides/install/single-board-computers/rockpi_4c.md
@@ -22,8 +22,8 @@ chmod +x /usr/local/bin/talosctl
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4c-arm64.img.xz
-xz -d metal-rockpi_4c-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4c-arm64.raw.xz
+xz -d metal-rockpi_4c-arm64.raw.xz
 ```
 
 ## Writing the Image
@@ -66,9 +66,9 @@ sudo dd if=rkspi_loader.img of=/dev/mtdblock0 bs=4K
 - Optionally, you can also write Talos image to the SSD drive right from your Rock PI board:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4c-arm64.img.xz
-xz -d metal-rockpi_4c-arm64.img.xz
-sudo dd if=metal-rockpi_4c-arm64.img.xz of=/dev/nvme0n1
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rockpi_4c-arm64.raw.xz
+xz -d metal-rockpi_4c-arm64.raw.xz
+sudo dd if=metal-rockpi_4c-arm64.raw.xz of=/dev/nvme0n1
 ```
 
 - remove SD card and reboot.

diff --git a/website/content/v1.6/talos-guides/install/single-board-computers/rpi_generic.md b/website/content/v1.6/talos-guides/install/single-board-computers/rpi_generic.md
@@ -47,8 +47,8 @@ Power off the Raspberry Pi and remove the SD card from it.
 Download the image and decompress it:
 
 ```bash
-curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rpi_generic-arm64.img.xz
-xz -d metal-rpi_generic-arm64.img.xz
+curl -LO https://github.com/siderolabs/talos/releases/download/{{< release >}}/metal-rpi_generic-arm64.raw.xz
+xz -d metal-rpi_generic-arm64.raw.xz
 ```
 
 ## Writing the Image