docs: provide documentation for Talos 1.6 #8071
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This comment was marked as resolved.
This comment was marked as resolved.
smira
commented
Dec 15, 2023
smira
commented
Dec 15, 2023
| @@ -27,11 +26,11 @@ If you are just getting familiar with Talos, we recommend starting here: | |||
| ### Community | |||
|
|
|||
| - GitHub: [repo](https://github.com/siderolabs/talos) | |||
| - Slack: Join our [slack channel](https://slack.dev.talos-systems.io) | |||
| - Support: Questions, bugs, feature requests [GitHub Discussions](https://github.com/siderolabs/talos/discussions) | |||
There was a problem hiding this comment.
restructured to push people more to GitHub
smira
commented
Dec 15, 2023
| @@ -1,449 +0,0 @@ | |||
| --- | |||
| title: "Troubleshooting Control Plane" | |||
There was a problem hiding this comment.
moved into generic troubleshooting guide below
smira
commented
Dec 15, 2023
| - the controlplane nodes | ||
| - the worker nodes | ||
|
|
||
| Talos enforces a high level of security by using mutual TLS for authentication and authorization. |
There was a problem hiding this comment.
this was pretty strange document, and not sure what it adds to the stuff we already have
smira
commented
Dec 15, 2023
| > Note: if you edit or patch the machine config on a running control plane node to set `allowSchedulingOnControlPlanes: true`, it will be applied immediately, but will not have any effect until the next reboot. | ||
| You may reboot the nodes via `talosctl reboot`. | ||
|
|
||
| You may also immediately make the control plane nodes schedulable by running the below: |
There was a problem hiding this comment.
Talos now is reactive on that config change
smira
commented
Dec 15, 2023
| @@ -19,7 +19,7 @@ As Talos Linux is fully contained in the UKI image, the full operating system is | |||
|
|
|||
| ## Acquiring the SecureBoot Assets | |||
|
|
|||
| Sidero Labs is going to provide Talos images signed with the Sidero Labs Secureboot key in August 2023, but until then, you can use the following instructions to build your own. | |||
| Sidero Labs is going to provide Talos images signed with the Sidero Labs SecureBoot key early 2024 via [Image Factory]({{< relref "../../../learn-more/image-factory" >}}), but until then, you can use the following instructions to build your own. | |||
smira
commented
Dec 15, 2023
| ghcr.io/siderolabs/gvisor:20231214.0-v1.5.0-beta.0 | ||
| ghcr.io/siderolabs/intel-ucode:20230613 | ||
| ```shell | ||
| $ crane export ghcr.io/siderolabs/extensions:{{< release >}} | tar x -O image-digests | egrep 'gvisor|intel-ucode' |
There was a problem hiding this comment.
modified the example to show full hashes
There was a problem hiding this comment.
egrep is kinda deprecated, grep -E please
utkuozdemir
reviewed
Dec 15, 2023
| ## `hostPath` mounts | ||
|
|
||
| The simplest way to use local storage is to use `hostPath` mounts. | ||
| When using `hostPath` mounts, make sure the root directory of the mount is mounted into the `kubelet` container: |
There was a problem hiding this comment.
Great long-overdue documentation ❤️
There was a problem hiding this comment.
yeah, I feel people are confused and think the minimum is to use OpenEBS
utkuozdemir
approved these changes
Dec 15, 2023
TimJones
approved these changes
Dec 15, 2023
website/content/v1.6/talos-guides/howto/workers-on-controlplane.md
Outdated
Show resolved
Hide resolved
Updated lots of documentation with new/updated flows. Provide What's New for Talos 1.6.0. Update Troubleshooting guide to cover more steps. Make Talos 1.6 docs the default. Signed-off-by: Andrey Smirnov <[email protected]>
|
Thank you very much @TimJones, applied everything! |
|
/m |
|
/m |
frezbo
reviewed
Dec 15, 2023
| If the initial boot requires firmware, a [custom ISO can be built]({{< relref "../../talos-guides/install/boot-assets" >}}) with the firmware included using the Image Factory service or using the `imager`. | ||
| This also ensures that the linux-firmware is not tied to a specific Talos version. | ||
|
|
||
| The list of firmware packages which are now available as extensions: |
There was a problem hiding this comment.
i think this is confusing, we have more firmware as extensions, the list below is the ones we removed for 1.6
There was a problem hiding this comment.
yes, I tried to say 'are now available' as extensions, in the sense they moved out
frezbo
approved these changes
Dec 15, 2023
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Updated lots of documentation with new/updated flows.
Provide What's New for Talos 1.6.0.
Update Troubleshooting guide to cover more steps.
Make Talos 1.6 docs the default.