From beb790aeccc2e25914ee919af091ea210a5a8927 Mon Sep 17 00:00:00 2001 From: David Nuzik Date: Wed, 30 Oct 2019 13:24:58 -0700 Subject: [PATCH 1/3] Add FAQ and Known Issues sections Adds these sections to the k3s docs with some faq questions filled in and one known issue. This will need to be updated periodically. --- content/k3s/latest/en/building/_index.md | 2 +- content/k3s/latest/en/faq/_index.md | 18 ++++++++++++++++++ content/k3s/latest/en/known-issues/_index.md | 13 +++++++++++++ 3 files changed, 32 insertions(+), 1 deletion(-) create mode 100644 content/k3s/latest/en/faq/_index.md create mode 100644 content/k3s/latest/en/known-issues/_index.md diff --git a/content/k3s/latest/en/building/_index.md b/content/k3s/latest/en/building/_index.md index e6afe642911..397010eb218 100644 --- a/content/k3s/latest/en/building/_index.md +++ b/content/k3s/latest/en/building/_index.md @@ -1,6 +1,6 @@ --- title: "Building from Source" -weight: 10 +weight: 99999 --- This section provides information on building k3s from source. diff --git a/content/k3s/latest/en/faq/_index.md b/content/k3s/latest/en/faq/_index.md new file mode 100644 index 00000000000..9546d22dd83 --- /dev/null +++ b/content/k3s/latest/en/faq/_index.md @@ -0,0 +1,18 @@ +--- +title: FAQ +weight: 8000 +--- + +The FAQ is updated periodically and designed to answer the questions our users most frequently ask about k3s. + +**Is k3s a suitable replacement for k8s?** + +k3s is capable of nearly everything k8s can do. It is just a more lightweight version. See the [main]({{}}/k3s/latest/en/) docs page for more details. + +**How can I use my own Ingress instead of Traefik?** + +Simply start k3s server with `--no-deploy=traefik` and deploy your ingress. + +**Does k3s support Windows?** + +At this time k3s does not natively support Windows, however we are open to the idea in the future. diff --git a/content/k3s/latest/en/known-issues/_index.md b/content/k3s/latest/en/known-issues/_index.md new file mode 100644 index 00000000000..423b42d29c1 --- /dev/null +++ b/content/k3s/latest/en/known-issues/_index.md @@ -0,0 +1,13 @@ +--- +title: Known Issues +weight: 9000 +--- +The Known Issues are updated periodically and designed to inform you about any issues that may not be immediately addressed in the next upcoming release. + +**Snap Docker** + +If you plan to use k3s with docker, Docker installed via a snap package is not recommended as it has been known to cause issues running k3s. + +**Iptables version issue?** + +There was an issue with an iptables version or something - what is the nature of the issue and where is the GH issue for this? Need to look into. From e7cbf7457921f2b7bf49e577689ba288ea5d4cb7 Mon Sep 17 00:00:00 2001 From: David Nuzik Date: Wed, 30 Oct 2019 13:29:00 -0700 Subject: [PATCH 2/3] Remove placeholder known-issue --- content/k3s/latest/en/known-issues/_index.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/content/k3s/latest/en/known-issues/_index.md b/content/k3s/latest/en/known-issues/_index.md index 423b42d29c1..cfcd5933348 100644 --- a/content/k3s/latest/en/known-issues/_index.md +++ b/content/k3s/latest/en/known-issues/_index.md @@ -7,7 +7,3 @@ The Known Issues are updated periodically and designed to inform you about any i **Snap Docker** If you plan to use k3s with docker, Docker installed via a snap package is not recommended as it has been known to cause issues running k3s. - -**Iptables version issue?** - -There was an issue with an iptables version or something - what is the nature of the issue and where is the GH issue for this? Need to look into. From 8a1565d53bc160445ba1566024b2850be7b1cf8b Mon Sep 17 00:00:00 2001 From: David Nuzik Date: Thu, 31 Oct 2019 10:39:42 -0700 Subject: [PATCH 3/3] Adds iptables known-issue --- content/k3s/latest/en/known-issues/_index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/content/k3s/latest/en/known-issues/_index.md b/content/k3s/latest/en/known-issues/_index.md index cfcd5933348..7731c22dc4b 100644 --- a/content/k3s/latest/en/known-issues/_index.md +++ b/content/k3s/latest/en/known-issues/_index.md @@ -7,3 +7,7 @@ The Known Issues are updated periodically and designed to inform you about any i **Snap Docker** If you plan to use k3s with docker, Docker installed via a snap package is not recommended as it has been known to cause issues running k3s. + +**Iptables** + +If you are running iptables in nftables mode instead of legacy you might encounter issues. We recommend utilizing newer iptables (such as 1.6.1+) to avoid issues.