Commit Graph

65 Commits

Author SHA1 Message Date
William Bartholomew ff6d133b8e Add update exclusion to kubernetes.repo
Add an update exclusion for `kubelet`, `kubeadm`, and `kubectl` in the CentOS to mirror the Ubuntu, Debian, or HypriotOS instructions.
2020-04-26 15:32:29 +08:00
Lubomir I. Ivanov 3e0a1b540c install-kubeadm: update container linux guide
- Use crictl v1.17.0
- Use new links for the droping / unit files for kubelet and kubeadm
These now reside in k/release. Pin to v0.2.7 as the latest release
from that repository.
2020-04-26 15:32:28 +08:00
Lubomir I. Ivanov 21b8456a87 install-kubeadm: use $basearch instead of pinning the arch for RHEL 2020-04-26 15:32:28 +08:00
Lubomir I. Ivanov 4060a3453b kubeadm: add TS entry about joining 1.18 nodes to 1.17 cluster (#19868) 2020-04-26 15:30:47 +08:00
Dan Winship 08f4c0ebf1 Revert "Add instructions for switching to iptables-legacy (#16271)" (#19773)
This reverts commit 9cdaf4ead1.

As of kube 1.17, kubeadm is compatible with iptables-nft
2020-04-26 15:30:38 +08:00
RA489 6d37f8ccfc improvements to the br_netfilter documentation for kubeadm (#19610) 2020-03-15 22:50:35 -07:00
Vishnu Narayanan 5bfb4f4ae7 Improve kops macOS installation (#19425) 2020-03-15 01:16:35 -07:00
Marshall Ford c331ff47a7 fixes troubleshooting-kubeadm references to taint node-role.kubernetes.io/master (#19293)
* fixes troubleshooting-kubeadm references to taint node-role.kubernetes.io/master

Signed-off-by: Marshall Ford <inbox@marshallford.me>

* revert ja,zsh langs

Signed-off-by: Marshall Ford <inbox@marshallford.me>
2020-03-11 08:13:37 -07:00
Andrew Allbright 1242c008a8 Update some instances of latin abbreviation e.g. to alternative phrases (#19182) 2020-02-29 23:12:40 -08:00
Tim Bannister 6a3c364706 Reword “Creating a single control-plane cluster with kubeadm” (#18939)
* Consolidate words of caution about Pod network

* Tweak wording

- use tooltips
- fix a TODO hyperlink
- adopt style guidelines

* Revise prerequisites for kubeadm

* Rework page structure

- Replace some headings with anchor elements (preserving inbound links)
- Use a "discussion" section for the discussion part of the page.
- Make Feedback be a part of the What's Next section
- Skip mentioning Docker in a logging context; provide generic
  signposting instead.
- Update overview
- Document limitations and fix link to HA topology
- Fixes for styling

* Redo network plugin info

* Use glossary tooltips to introduce terms
2020-02-19 12:49:45 -08:00
Lubomir I. Ivanov 2d0bde0458 kubeadm: add TS guide note about CoreOS read-only /usr (#19166)
* kubeadm: add TS guide note about CoreOS read-only /usr

* Update content/en/docs/setup/production-environment/tools/kubeadm/troubleshooting-kubeadm.md

Co-Authored-By: Tim Bannister <tim@scalefactory.com>

Co-authored-by: Tim Bannister <tim@scalefactory.com>
2020-02-18 16:54:24 -08:00
Tim Bannister e5eea5d8b9 Clean up kubeadm install guide (#17584)
* Fix link to cluster upgrade with kubeadm

* Improve kubeadm container runtime install steps

* Use tabs for Linux vs. non-Linux kubeadm CRI details

* Tweak wording

* Use dagger in place of double asterisk

(Double asterisks don't render as well, and also can confuse
Markdown-aware editors).

* Move link inside preceding tabs

Repeating the text makes life easier for readers.
2020-02-11 05:52:05 -08:00
Casey Davenport 09a8e814e5 Update Calico section of kubeadm install guide (#18821)
* Update Calico section of kubeadm install guide

* Address review feedback
2020-02-01 04:39:20 -08:00
Sascha Grunert c43b4a5dd5 Unify runtime references (#18493)
- Use the glossary to correctly reference runtimes
- Updated runtime class documentation for CRI-O
- Removed rktlet from runtimes since its EOL

Signed-off-by: Sascha Grunert <sgrunert@suse.com>
2020-01-29 15:24:14 -08:00
0xC45 b57509bbf6 Install legacy iptables binaries for Ubuntu/Debian (#18625)
On the latest Debian 10, the `arptables-legacy` and `ebtables-legacy` binaries are not installed by default. Although the (non-legacy) versions are installed by default, it appears the respective packages that provide the legacy binaries must be installed in order to switch to the legacy alternatives. If you attempt to switch to the legacy alternatives without installing the `arptables` and `ebtables` packages, you will see an error:
```
update-alternatives: error: alternative /usr/sbin/arptables-legacy for arptables not registered; not setting
```

I have confirmed that the packages are present on Debian 10 and Ubuntu 19.10 and they provide the legacy alternatives. See:
* https://packages.ubuntu.com/eoan/amd64/iptables/filelist
* https://packages.ubuntu.com/eoan/amd64/arptables/filelist
* https://packages.ubuntu.com/eoan/amd64/ebtables/filelist
* https://packages.debian.org/buster/amd64/iptables/filelist
* https://packages.debian.org/buster/amd64/arptables/filelist
* https://packages.debian.org/buster/amd64/ebtables/filelist
2020-01-18 09:45:35 -08:00
Lubomir I. Ivanov 8de8d173bb kubeadm: remove some CNI plugins from the kubeadm setup guide (#17694)
The kubeadm survey for 1.13:
https://docs.google.com/forms/d/1A855D054FZfdvNbx6mAa54tcZ204GmPCIhxe1UrXKd8/edit#responses

The kubeadm survey for 1.13:
https://docs.google.com/forms/d/1A855D054FZfdvNbx6mAa54tcZ204GmPCIhxe1UrXKd8/edit#responses

Revealed the top 3 plugins in terms of popularity are:

Flannel
Calico
WeaveNet
The kubeadm maintainers are in contact with the maintainers
of these plugins and can provide support and updates to this guide.

The rest of the plugins in the guide are unmaintained, by the kubeadm team!

Some plugins are not in the CNCF landscape, or maintained by the kubeadm team, but still
present in the guide.

Remove the following non-CNCF / unmaintained plugins:

AWS VPC
Romana
Juniper*
Canal (it is an alternative to Calico and already explained in the
Calico guide)
Add note that users can still defer to this page for more options and a more complete list:
https://kubernetes.io/docs/concepts/cluster-administration/networking/Revealed the top 3 plugins in terms of popularity are:
- Flannel
- Calico
- WeaveNet

The kubeadm maintainers are in contact with the maintainers
of these plugins and can provide support and updates to this guide.

Some plugins are not in the CNCF landscape, but still
covered in this page:
https://kubernetes.io/docs/concepts/cluster-administration/networking/

Remove the following non-CNCF plugins:
- AWS VPC
- Romana
- Juniper*
- Canal (it is an alternative to Calico and already explained in the
Calico guide)

Add note that users can still defer to this page for more options:
https://kubernetes.io/docs/concepts/cluster-administration/networking/
2020-01-17 03:46:56 -08:00
Samuel Kihahu 49a33c7d3f Improve Kops Installation Steps (#18000) 2020-01-14 13:50:35 -08:00
André Martins 5cb0e3d7b4 Update Cilium related docs (#18563)
* Extend Cilium CNI plugin description

Mention that it works on top of other CNI plugins due to the CNI
chaining [1].

[1]: http://docs.cilium.io/en/v1.6/gettingstarted/cni-chaining/

Signed-off-by: Martynas Pumputis <m@lambda.lt>

* Update Cilium installation steps for kubeadm

- Use the latest v1.6 Cilium.
- By default, Cilium no longer needs/deploys ETCD store.

Signed-off-by: Martynas Pumputis <m@lambda.lt>

* Update Cilium NetworkPolicy guide

- Update minikube min version requirement.
- Use Cilium v1.6.
- Remove the etcd store bits, as Cilium v1.6 no longer depend on
  it by default.

Signed-off-by: Martynas Pumputis <m@lambda.lt>

* Update Cilium installation steps for kubeadm

- How to run without kube-proxy.

Signed-off-by: Martynas Pumputis <m@lambda.lt>

Co-authored-by: Martynas Pumputis <m@lambda.lt>
2020-01-13 04:35:36 -08:00
vyask ee2960eac9 Update kops.md (#17278)
kops uses DNS for discovery, both inside the cluster and outside so that you can reach the kubernetes API server
from clients.
2020-01-11 10:39:36 -08:00
Javier Revillas 46033f8f0d Fix typo in install-kubeadm.md (#18170) 2020-01-10 15:15:38 -08:00
Eric Smalling 70936d4dbd Update cluster health check command for newer etcd (#18392)
* Update cluster health check command for newer etcd

Existing docs assume the older (v3.2) etcdctl `health-check` command but with a 3.4.3 cluster (which is what kubeadm creates in the static manifest now), that subcommand is no longer supported and returns 404 errors like:
```
root@etcd-1:~# docker run --rm -it --net host -v /etc/kubernetes:/etc/kubernetes quay.io/coreos/etcd:${ETCD_TAG} etcdctl --cert-file /etc/kubernetes/pki/etcd/peer.crt --key-file /etc/kubernetes/pki/etcd/peer.key --ca-file /etc/kubernetes/pki/etcd/ca.crt --endpoints https://10.170.68.181:2379 cluster-health
cluster may be unhealthy: failed to list members
Error:  unexpected status code 404
```

* PR review changes
2020-01-03 09:43:41 -08:00
bogard1203 68e836b267 Fixed the incorrect parameter of specifying the CRI endpoint for kubelet and corrected Default CNs (#17839)
* Fixed the incorrect parameter of specifying the CRI endpoint for kubelet

Corrected the parameter of '--container-runtime-path-endpoint' with '--container-runtime-endpoint'

* Corrected Default CNs

Fixed the incorrect Default CNs for apiserver-etcd-client.crt and apiserver-kubelet-client.crt
2019-11-27 21:17:03 -08:00
Samuel Kihahu 7fe525ce45 Update kops Installation Steps (#17726)
* Document downloading the latest or a specific kops version

Add links to Install Homebrew On MacOS, Linux

* Update kops.md
2019-11-25 07:43:06 -08:00
Samuel Kihahu 9afc68d402 Update kops Linux Setup Step (#17696)
Moving the downloaded kops binary in Linux to the path /usr/local/bin/kops requires privileged permissions.
2019-11-21 02:07:28 -08:00
chentanjun f77f57925e fix-up 404 urls (#17668) 2019-11-20 18:11:28 -08:00
yacinelazaar a6a505fb73 Remove instructions to copy Etcd CA key in HA (#17611)
* Remove instructions to copy Etcd CA key in HA

No need to copy etcd CA key when manually copying certs from first master node to nodes joining the control plane.

* ca.key still needed for stacked ETCD

Added note to quote/unquote the copying instructions depending on Etcd configuration
2019-11-17 17:53:41 -08:00
SataQiu c1c108f044 kubeadm: clarify the usage of kubeadm commands in our external etcd guide (#17541) 2019-11-13 00:43:11 -08:00
Luzhenxing e48b8693ae fix error link of kubeadm init args (#17318) 2019-11-04 21:12:38 -08:00
Dr Nic Williams cdc590065c base64 --decode works across Linux and MacOS (#17240)
Signed-off-by: Dr Nic Williams <drnicwilliams@gmail.com>
2019-10-29 18:24:53 -07:00
vanou 4fe0eaae1f Fixes commands not working without sudo (#17139)
In doc of kubeadm installation, there are commands which wont work
without sudo regarding to Ubuntu/Debian instruction. However, other
docs related to kubeadm under
content/en/docs/setup/production-environment have commands with sudo.

This commit fixes this inconsistency.
2019-10-27 18:23:25 -07:00
Yuk, Yongsu d437e8c6bc en: Change the full link in the document to an inline link. (#17057)
* Change the full link in the document to an inline link.

grep -r "https \: \ / \ / kubernetes \ .io" content/en/docs
Changed to inline link except the following list.
- URLs are mentioned directly in the body
- release note
- url to blog
- url to community
- Url to be redirected

* Apply suggestions from code review

Co-Authored-By: June Yi <june.yi@samsung.com>
2019-10-23 06:20:14 -07:00
Armando Migliaccio 77d831c7ea Replace Digital Ocean with DigitalOcean (#17033)
The former is the official spelling, but both spellings have been
used throughout the docs. This commit replaces the occurrences of
the unofficial spelling with the official one.
2019-10-22 14:34:13 -07:00
Duffie Cooley 331cc6fee0 Minor doc fix for syntax and typo (#16666)
* Minor doc fix for syntax and typo

Signed-off-by: Duffie Cooley <cooleyd@vmware.com>

* Feedback from sftim
2019-10-09 16:44:51 -07:00
James Peach cbef9c2bc3 Replace CRI-O incubator links. (#16698)
Update CRI-O links from Kubernetes incubator to the official CRI-O
homepage. Most links were already updated, but there were a few
stragglers in minikube documentation and old blog posts.
2019-10-06 03:29:10 -07:00
Steven Correa a3371164ab Formatting fixes (#16626) 2019-10-05 17:49:10 -07:00
Toni Tauro 764a485885 add /etc/sysconfig/kubelet info for CentOS/RHEL/Fedora Distributions (#16347) 2019-09-27 12:09:36 -07:00
Rafael Fernández López 1524d24915 Fix flannel revision for 1.16+ (#16575)
This version of flannel manifests include `cniVersion` that is
required for it to work properly with Kubernetes 1.16+.
2019-09-26 13:00:35 -07:00
bjpaul 702d05e9fe resolving merge conflict (#16497) 2019-09-21 17:19:23 -07:00
Song Shukun 7185f00801 Update url for flannel (#16442) 2019-09-20 11:23:26 -07:00
Mark Janssen 9cdaf4ead1 Add instructions for switching to iptables-legacy (#16271) 2019-09-16 04:40:38 -07:00
Lubomir I. Ivanov 06fc088703 kubeadm: update setup docs for 1.16 (#16016)
- minor fix for control-plane-flags
- cleanup tables from "kubeadm maturity" in create-cluster
- update install guide for container linux guide in install-kubeadm
- minor fixes in self-hosting
2019-09-05 09:29:09 -07:00
simplytunde 5e8cf9b8a5 Merge remote-tracking branch 'upstream/master' into HEAD 2019-08-12 08:05:36 -05:00
Tahmid Shakil 2928d6ac9c Fix troubleshooting instruction at troubleshooting-kubeadm.md (#15234)
## Issue

Section: *Another workaround is to overwrite the existing `kubeconfig` for the "admin" user*
Line: 173

`sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config` fails, since the directory `$HOME/.kube` doesn't exist.

## Fix

`mkdir $HOME/.kube` added prior to `sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config`.
2019-08-06 16:34:51 -07:00
Michael Vorburger ⛑️ da9db0b0c4 porting some information from kubeadm-init.md to kubelet-integration.md (#15423)
* porting some information from kubeadm-init.md to kubelet-integration.md doc

from reference/setup-tools/kubeadm/kubeadm-init.md to setup/production-environment/tools/kubeadm/kubelet-integration.md

includes edits I just proposed in #15421 and #80136

* improve wording re. systemd in kubelet-integration.md

* removing quotes and adding the in kubelet-integration.md

* Update content/en/docs/setup/production-environment/tools/kubeadm/kubelet-integration.md

Co-Authored-By: Lubomir I. Ivanov <neolit123@gmail.com>
2019-08-05 17:09:54 -07:00
simplytunde 68fe9a8adc Merge remote-tracking branch 'upstream/master' into HEAD 2019-08-05 17:30:25 -05:00
Strajan Sebastian Ioan e0b3959eba remove experimental from flag name (#15653) 2019-08-04 17:47:48 -07:00
RA489 66aacf713f Adding --cgroup-driver flag to etcd documentation (#15595) 2019-07-31 23:18:15 -07:00
Lubomir I. Ivanov 0247da1b01 kubeadm: add considerations section for control-plane-endpoint (#15524)
* kubeadm: add considerations section for control-plane-endpoint

* kubeadm: change master->control-plane in create-cluster-kubeadm.md
2019-07-30 00:24:51 -07:00
Alex Punnen 14c348819f pod-network to be done only on master node (#15505)
* pod-network to be done only on master node

added a note saying that Install a pod-network add on need to be done only on the master node

* updated where to run pod-network doc
2019-07-25 00:35:53 -07:00
Lubomir I. Ivanov e75c348dbe kubeadm: update the docs for HA with --control-plane-endpoint (#15369)
The addition of the flag "---control-plane-endpoint" for
"kubeadm init" removes the requirement for creating a config file
for the stacked etcd setup.

The config is still required for stacked etcd setup.
2019-07-22 07:06:52 -07:00