docs: update docs for Talos 0.12 release

Preparing for Talos 0.12 release. Signed-off-by: Andrey Smirnov <andrey.smirnov@talos-systems.com>
siderolabs · Aug 31, 2021 · 01cca09 · 01cca09
1 parent 668627d
commit 01cca09
Show file tree

Hide file tree

Showing 5 changed files with 36 additions and 18 deletions.
diff --git a/website/content/docs/v0.12/Guides/upgrading-talos.md b/website/content/docs/v0.12/Guides/upgrading-talos.md
@@ -12,21 +12,15 @@ To see a live demo of this writeup, see the video below:
 
 <iframe width="560" height="315" src="https://www.youtube.com/embed/sw78qS8vBGc" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 
-## Upgrading from Talos 0.9
+## Upgrading from Talos 0.11
 
-TBD
-
-### After Upgrade to 0.10
-
-TBD
-
-### After Upgrade to 0.11
-
-TBD
+Only for clusters bootstrapped with Talos <= 0.8: please make sure control plane was converted to use static pods
+(first introduced in Talos 0.9), as Talos 0.12 drops support for self-hosted control plane.
 
 ### After Upgrade to 0.12
 
-TBD
+There are no special items to follow after the upgrade to Talos 0.12, please see section on machine configuration changes
+below.
 
 ## `talosctl` Upgrade
 
@@ -68,4 +62,28 @@ future.
 
 ## Machine Configuration Changes
 
-TBD
+There are two new machine configuration fields introduced in Talos 0.12 which are not being used in Talos 0.12 yet,
+but they will be used to support additional features in Talos 0.13:
+
+* `.cluster.id`: 32 random bytes, base64 encoded
+* `.cluster.secret`: 32 random bytes, base64 encoded
+
+Values of these fields should be kept in sync across all nodes of the cluster (control plane and worker nodes).
+
+These fields can be added to the machine configuration of the running Talos cluster upgraded to Talos 0.12 with the following commands
+(doesn't require a reboot):
+
+```bash
+$ CLUSTER_ID=`dd if=/dev/urandom of=/dev/stdout bs=1 count=32 | base64`
+32+0 records in
+32+0 records out
+32 bytes copied, 0,000180749 s, 177 kB/s
+$ CLUSTER_SECRET=`dd if=/dev/urandom of=/dev/stdout bs=1 count=32 | base64`
+32+0 records in
+32+0 records out
+32 bytes copied, 0,000180749 s, 177 kB/s
+$ talosctl -n <IP> patch mc --immediate --patch "[{\"op\": \"add\", \"path\": \"/cluster/id\", \"value\": \"$CLUSTER_ID\"},{\"op\": \"add\", \"path\": \"/cluster/secret\", \"value\": \"$CLUSTER_SECRET\"}]"
+patched mc at the node <IP>
+```
+
+Repeat the last command for every node of the cluster.
diff --git a/website/content/docs/v0.12/Introduction/support-matrix.md b/website/content/docs/v0.12/Introduction/support-matrix.md
@@ -5,7 +5,7 @@ weight: 6
 
 | Talos Version                                                                                                  | 0.12                               | 0.11                               |
 |----------------------------------------------------------------------------------------------------------------|------------------------------------|------------------------------------|
-| Release Date                                                                                                   | 2021-08-30 (TBD)                   | 2021-07-08 (0.11.0)                |
+| Release Date                                                                                                   | 2021-08-30                         | 2021-07-08 (0.11.0)                |
 | End of Community Support                                                                                       | 0.13.0 release (2021-10-15, TBD)   | 2021-09-15                         |
 | Enterprise Support                                                                                             | [offered by Talos Systems Inc.](https://www.talos-systems.com/support/) |
 | Kubernetes                                                                                                     | 1.22, 1.21, 1.20                   | 1.21, 1.20, 1.19                   |

diff --git a/website/content/docs/v0.12/Introduction/what-is-new.md b/website/content/docs/v0.12/Introduction/what-is-new.md
@@ -48,7 +48,7 @@ the default values overwritten by Talos.
 
 ### Equinix Metal
 
-Added support for Equinix Metal IPs for the Talos virtual (shared) IP (option `equnixMetal` under `vip` in the machine configuration).
+Added support for Equinix Metal IPs for the Talos virtual (shared) IP (option `equinixMetal` under `vip` in the machine configuration).
 Talos automatically re-assigns IP using the Equinix Metal API when leadership changes.
 
 ### Support for Self-hosted Control Plane Dropped

diff --git a/website/content/docs/v0.13/Introduction/support-matrix.md b/website/content/docs/v0.13/Introduction/support-matrix.md
@@ -5,7 +5,7 @@ weight: 6
 
 | Talos Version                                                                                                  | 0.13                               | 0.12                               |
 |----------------------------------------------------------------------------------------------------------------|------------------------------------|------------------------------------|
-| Release Date                                                                                                   | 2021-10-15 (TBD)                   | 2021-08-30 (0.12.0)                |
+| Release Date                                                                                                   | 2021-10-15 (TBD)                   | 2021-08-31 (0.12.0)                |
 | End of Community Support                                                                                       | 0.14.0 release (2021-12-15, TBD)   | 2021-10-15                         |
 | Enterprise Support                                                                                             | [offered by Talos Systems Inc.](https://www.talos-systems.com/support/) |
 | Kubernetes                                                                                                     | 1.22, 1.21, 1.20                   | 1.22, 1.21, 1.20                    |

diff --git a/website/gridsome.config.js b/website/gridsome.config.js
@@ -30,13 +30,13 @@ module.exports = {
       {
         version: "v0.12",
         url: "/docs/v0.12/",
-        latest: false,
-        prerelease: true,
+        latest: true,
+        prerelease: false,
       },
       {
         version: "v0.11",
         url: "/docs/v0.11/",
-        latest: true,
+        latest: false,
         prerelease: false,
       },
       {