Skip to content

Commit

Permalink
Add an initial quick menu and update a couple of networking points
Browse files Browse the repository at this point in the history
Signed-off-by: Manuel Buil <[email protected]>
  • Loading branch information
manuelbuil committed Oct 16, 2023
1 parent ab50206 commit c1f9344
Show file tree
Hide file tree
Showing 4 changed files with 378 additions and 150 deletions.
16 changes: 14 additions & 2 deletions docs/installation/network-options.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,15 @@ title: "Network Options"
weight: 25
---

This page describes K3s network configuration options, including configuration or replacement of Flannel, and configuring IPv6.
This page describes K3s network configuration options:

- [Flannel options](#flannel-options)
- [Custom CNI](#custom-cni)
- [Control-Plane Egress Selector configuration](#control-plane-egress-selector-configuration)
- [Dual-stack (IPv4 + IPv6) Networking](#dual-stack-ipv4--ipv6-networking)
- [Single-stack IPv6 Networking](#single-stack-ipv6-networking)
- [Distributed hybrid or multicloud cluster](#distributed-hybrid-or-multicloud-cluster)


> **Note:** Please reference the [Networking](../networking/networking.md) page for information about CoreDNS, Traefik, and the Service LB.
Expand Down Expand Up @@ -141,7 +149,7 @@ Stable support is available as of [v1.23.7+k3s1](https://github.com/k3s-io/k3s/r

:::caution Known Issue

Kubernetes [Issue #111695](https://github.com/kubernetes/kubernetes/issues/111695) causes the Kubelet to ignore the node IPv6 addresses if you have a dual-stack environment and you are not using the primary network interface for cluster traffic. To avoid this bug, add the following flag to both K3s servers and agents:
Before 1.27, Kubernetes [Issue #111695](https://github.com/kubernetes/kubernetes/issues/111695) causes the Kubelet to ignore the node IPv6 addresses if you have a dual-stack environment and you are not using the primary network interface for cluster traffic. To avoid this bug, use 1.27 or newer or add the following flag to both K3s servers and agents:

```
--kubelet-arg="node-ip=0.0.0.0" # To proritize IPv4 traffic
Expand All @@ -163,6 +171,10 @@ Note that you may configure any valid `cluster-cidr` and `service-cidr` values,

If you are using a custom CNI plugin, i.e. a CNI plugin other than Flannel, the additional configuration may be required. Please consult your plugin's dual-stack documentation and verify if network policies can be enabled.

:::caution Known Issue
When defining cluster-cidr and service-cidr, if the first IPFamily is IPv6, node-ip should be specified if you want the main IP of the pods to be IPv6, otherwise kubelet will always pick IPv4.
:::

## Single-stack IPv6 Networking

:::info Version Gate
Expand Down
2 changes: 1 addition & 1 deletion docs/release-notes/v1.27.X.md
Original file line number Diff line number Diff line change
Expand Up @@ -131,7 +131,7 @@ For more details on what's new, see the [Kubernetes release notes](https://githu
* Bump google.golang.org/grpc from 1.51.0 to 1.53.0 in /tests/terraform [(#7879)](https://github.com/k3s-io/k3s/pull/7879)
* Add retry for clone step [(#7862)](https://github.com/k3s-io/k3s/pull/7862)
* Generation of certificates and keys for etcd gated if etcd is disabled. [(#6998)](https://github.com/k3s-io/k3s/pull/6998)
* Don't use zgrep in `check-config` if apparmor porfile is enforced [(#7939)](https://github.com/k3s-io/k3s/pull/7939)
* Don't use zgrep in `check-config` if apparmor profile is enforced [(#7939)](https://github.com/k3s-io/k3s/pull/7939)
* Fix image_scan.sh script and download trivy version [(#7950)](https://github.com/k3s-io/k3s/pull/7950)
* Revert "Warn that v1.28 will deprecate reencrypt/prepare" [(#7977)](https://github.com/k3s-io/k3s/pull/7977)
* Adjust default kubeconfig file permissions [(#7978)](https://github.com/k3s-io/k3s/pull/7978)
Expand Down
10 changes: 5 additions & 5 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,10 @@
"write-heading-ids": "docusaurus write-heading-ids"
},
"dependencies": {
"@docusaurus/core": "^2.4.1",
"@docusaurus/plugin-client-redirects": "^2.4.1",
"@docusaurus/preset-classic": "^2.4.1",
"@docusaurus/theme-mermaid": "^2.4.1",
"@docusaurus/core": "^2.4.3",
"@docusaurus/plugin-client-redirects": "^2.4.3",
"@docusaurus/preset-classic": "^2.4.3",
"@docusaurus/theme-mermaid": "^2.4.3",
"@easyops-cn/docusaurus-search-local": "^0.35.0",
"@mdx-js/react": "^1.6.22",
"clsx": "^1.1.1",
Expand All @@ -31,7 +31,7 @@
"remark-validate-links-heading-id": "^0.0.3"
},
"devDependencies": {
"@docusaurus/module-type-aliases": "^2.4.1"
"@docusaurus/module-type-aliases": "^2.4.3"
},
"browserslist": {
"production": [
Expand Down
Loading

0 comments on commit c1f9344

Please sign in to comment.