docs: update documentation for 0.14.0 release

Makes 0.14 latest, update what's new based on release notes. Signed-off-by: Andrey Smirnov <[email protected]>
siderolabs · Dec 21, 2021 · 880a778 · 880a778
1 parent dc9a0cf
commit 880a778
Show file tree

Hide file tree

Showing 4 changed files with 106 additions and 11 deletions.
diff --git a/website/content/docs/v0.14/Introduction/support-matrix.md b/website/content/docs/v0.14/Introduction/support-matrix.md
@@ -6,7 +6,7 @@ weight: 6
 | Talos Version                                                                                                  | 0.14                               | 0.13                               |
 |----------------------------------------------------------------------------------------------------------------|------------------------------------|------------------------------------|
 | Release Date                                                                                                   | 2021-12-21                         | 2021-10-11 (0.13.0)                |
-| End of Community Support                                                                                       | 0.15.0 release (2022-02-01, TBD)   | 0.14.0 release (2021-12-21, TBD)   |
+| End of Community Support                                                                                       | 0.15.0 release (2022-03-01, TBD)   | 0.14.0 release (2021-12-21)        |
 | Enterprise Support                                                                                             | [offered by Sidero Labs Inc.](https://www.siderolabs.com/support/)      |
 | Kubernetes                                                                                                     | 1.23, 1.22, 1.21                   | 1.22, 1.21, 1.20                   |
 | Architecture                                                                                                   | amd64, arm64                                                            |
@@ -17,9 +17,9 @@ weight: 6
 | - SBCs                                                                                                         | Raspberry Pi4, Banana Pi M64, Pine64, and other                         |
 | - local                                                                                                        | Docker, QEMU                                                            |
 | **Cluster API**                                                                                                |                                    |                                    |
-| [CAPI Bootstrap Provider Talos](https://github.com/talos-systems/cluster-api-bootstrap-provider-talos)         | >= 0.4.1                           | >= 0.3.0                           |
-| [CAPI Control Plane Provider Talos](https://github.com/talos-systems/cluster-api-control-plane-provider-talos) | >= 0.3.0                           | >= 0.1.1                           |
-| [Sidero](https://www.sidero.dev/)                                                                              | >= 0.3.0                           | >= 0.3.0                           |
+| [CAPI Bootstrap Provider Talos](https://github.com/talos-systems/cluster-api-bootstrap-provider-talos)         | >= 0.4.3                           | >= 0.3.0                           |
+| [CAPI Control Plane Provider Talos](https://github.com/talos-systems/cluster-api-control-plane-provider-talos) | >= 0.4.1                           | >= 0.1.1                           |
+| [Sidero](https://www.sidero.dev/)                                                                              | >= 0.4.1                           | >= 0.3.0                           |
 | **UI**                                                                                                         |                                    |                                    |
 | [Theila](https://github.com/talos-systems/theila)                                                              | ✓                                  | ✓                                  |
 

diff --git a/website/content/docs/v0.14/Introduction/what-is-new.md b/website/content/docs/v0.14/Introduction/what-is-new.md
@@ -3,4 +3,99 @@ title: What's New in Talos 0.14
 weight: 5
 ---
 
-TBD
+### Kubelet
+
+Kubelet configuration can be updated without node restart (`.machine.kubelet` section of machine configuration) with commands
+`talosctl edit mc --immediate`, `talosctl apply-config --immediate`, `talosctl patch mc --immediate`.
+
+Kubelet service can now be restarted with `talosctl service kubelet restart`.
+
+Kubelet node IP configuration (`.machine.kubelet.nodeIP.validSubnets`) can now include negative subnet matches (prefixed with `!`).
+
+### Kubernetes Upgrade Enhancements
+
+`talosctl upgrade-k8s` was improved to:
+
+* sync all boostrap manifest resources in the Kubernetes cluster with versions bundled with current version Talos
+* upgrade `kubelet` to the version of the control plane components (without node reboot)
+
+So there is no need to update CoreDNS, Flannel container manually after running `upgrade-k8s` anymore.
+
+### Log Shipping
+
+Talos can now [ship system logs](../../guides/logging/)
+to the configured destination using either JSON-over-UDP or JSON-over-TCP:
+see `.machine.logging` machine configuration option.
+
+### NTP Sync
+
+Talos NTP sync process was improved to align better with kernel time adjustment periods and to filter out spikes.
+
+### `talosctl support`
+
+`talosctl` CLI tool now has a new subcommand `support` that gathers all
+cluster information that could help with debugging in.
+
+Output of the command is a `zip` archive with all Talos service logs, Kubernetes pod logs and manifests,
+Talos resources manifests and so on.
+Generated archive does not contain any secret information, so it is safe to send it for analysis to a third party.
+
+### Component Updates
+
+* Linux: 5.15.6
+* etcd: 3.5.1
+* containerd: 1.5.8
+* runc: 1.0.3
+* Kubernetes: 1.23.1
+* CoreDNS: 1.8.6
+* Flannel (default CNI): 0.15.1
+
+Talos is built with Go 1.17.5
+
+### Cluster Discovery
+
+[Cluster Discovery](../../guides/discovery/) is enabled by default for Talos 0.14.
+Cluster Discovery can be disabled with `talosctl gen config --with-cluster-discovery=false`.
+
+## Kexec and capabilities
+
+When kexec support is disabled
+Talos no longer drops Linux capabilities (`CAP_SYS_BOOT` and `CAP_SYS_MODULES`) for child processes.
+That is helpful for advanced use-cases like Docker-in-Docker.
+
+If you want to permanently disable kexec and capabilities dropping, pass `kexec_load_disabled=1` argument to the kernel.
+
+For example:
+
+```yaml
+install:
+  extraKernelArgs:
+    - sysctl.kernel.kexec_load_disabled=1
+```
+
+Please note that capabilities are dropped before machine configuration is loaded,
+so disabling kexec via `machine.sysctls` will not be enough.
+
+### `installer` and `imager` images
+
+Talos supports two target architectures: `amd64` and `arm64`, so all Talos images are built for both `amd64` and `arm64`.
+
+New image `imager` was added which contains Talos assets for both architectures which allows to generate Talos disk images
+cross-arch: e.g. generate Talos Raspberry PI disk image on `amd64` machine.
+
+As `installer` image is used only to do initial install and upgrades, it now contains Talos assets for a specific architecture.
+This reduces size of the `installer` image leading to faster upgrades and less memory usage.
+
+There are no user-visible changes except that now `imager` container image should be used to produce Talos disk images.
+
+### SideroLink
+
+A set of Talos ehancements is going to unlock a number of exciting features in the upcoming release of [Sidero](https://www.sidero.dev/):
+
+* `SideroLink`: a point-to-point Wireguard tunnel connecting Talos node back to the provisioning platform (Sidero).
+* event sink (kernel arg `talos.event.sink=http://10.0.0.1:4000`) delivers Talos internal events to the specified destination.
+* kmsg log delivery (kernel arg `talos.logging.kernel=tcp://10.0.0.1:4001`) sends kernel logs as JSON lines over TCP or UDP.
+
+### VLAN Enhancements
+
+Talos now supports setting MTU and Virtual IPs on VLAN interfaces.
diff --git a/website/gridsome.config.js b/website/gridsome.config.js
@@ -24,13 +24,13 @@ module.exports = {
       {
         version: "v0.14",
         url: "/docs/v0.14/",
-        latest: false,
-        prerelease: true,
+        latest: true,
+        prerelease: false,
       },
       {
         version: "v0.13",
         url: "/docs/v0.13/",
-        latest: true,
+        latest: false,
         prerelease: false,
       },
       {

diff --git a/website/static/_redirects b/website/static/_redirects
@@ -1,7 +1,7 @@
-/docs/latest/* /docs/v0.13/:splat 302
+/docs/latest/* /docs/v0.14/:splat 302
 
 # The Netlify documentation says that the following redirect rules are
 # equivalent: https://docs.netlify.com/routing/redirects/redirect-options/#trailing-slash
 # But that is not what is observed in practice.
-/docs/latest  /docs/v0.13/ 302
-/docs/latest/ /docs/v0.13/ 302
+/docs/latest  /docs/v0.14/ 302
+/docs/latest/ /docs/v0.14/ 302