103 Commits

Author SHA1 Message Date
vineeth c94ac9b6c0 Merge remote-tracking branch 'upstream/master' into HEAD 2020-03-24 21:27:22 +05:30
Sascha Grunert 06029f5a1b Update CRI-O installation guide (#19568)
CRI-O now uses a different location for their repositories which also
supports further distributions.

Signed-off-by: Sascha Grunert <sgrunert@suse.com>
2020-03-22 14:10:45 -07:00
vineeth f1d9ebc578 Merge remote-tracking branch 'upstream/master' into HEAD 2020-03-23 01:02:58 +05:30
Tim Bannister f368463034 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-03-23 00:33:37 +05:30
Lubomir I. Ivanov 8e08f65522 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-03-23 00:28:30 +05:30
Ciprian Hacman 86d2197944 Update Docker installation instructions to use v19.03.8 (#19643) 2020-03-17 15:15:28 -07:00
Ben Moss 615c7f619f Update kubeadm for Windows (#19217)
* Start updates for DaemonSet approach

* Rough first draft

* Remove old image assets

* Document how to fetch the correct version of kube-proxy

* Remove InstallNSSM script

It was merged into the PrepareNode script

* Update links to sig-windows-tools release files

Using the latest tag so we can continue to update things as needed
without needing to keep updating the docs

* Add upgrade tutorial for Windows kubeadm nodes

* Clarify which machine each command should be run from

* Add link from main tutorial, small edits

- Rename file / title
- Remove reviewers

* Remove IP management section

User can just rely on the defaults from kube-proxy and flannel now, or
change them in the same manner as on Linux

* Apply suggestions from code review

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

* More review updates

* Switch to task template

* Apply suggestions from code review

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

* More review feedback

* Adjust upgrading title

* Additional edits

* Move to kubeadm directory

* Remove stale link

This guide never had any real content about the pause image

* Add redirect from old url

* Fix weights

* Update Windows intro

* Apply suggestions from code review

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

* Fix typo

* Add beta markers

Co-authored-by: Tim Bannister <tim@scalefactory.com>
2020-03-16 08:14:43 -07:00
RA489 6d37f8ccfc improvements to the br_netfilter documentation for kubeadm (#19610) 2020-03-15 22:50:35 -07:00
Michael Michael 957444d1b3 Update user-guide-windows-containers.md (#19209)
* Update user-guide-windows-containers.md

* Update user-guide-windows-containers.md

* Update content/en/docs/setup/production-environment/windows/user-guide-windows-containers.md

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

Co-authored-by: Tim Bannister <tim@scalefactory.com>
2020-03-15 16:02:35 -07:00
Vishnu Narayanan 5bfb4f4ae7 Improve kops macOS installation (#19425) 2020-03-15 01:16:35 -07:00
Patrick Lang 5372544d6f doc: ContainerD on Windows alpha (#19208) 2020-03-12 12:32:39 -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
zacharysarah 4582f017e2 Merge remote-tracking branch 'upstream/master' into zacharysarah-merged-master-dev-1.18 2020-03-03 12:07:32 -08:00
Andrew Allbright 1242c008a8 Update some instances of latin abbreviation e.g. to alternative phrases (#19182) 2020-02-29 23:12:40 -08:00
Zach Corleissen e66e21ab7b Revert "Repair and sync the dev-1.18 branch" (#19228) 2020-02-21 12:16:47 -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
larntz-tbc a00f65d84c cri-o version must match the k8 version (#19092)
* cri-o version must match the k8 version

It's not clear from the doc that the cri-o version must match the k8 version as shown in the cri-o compatibility matrix.

* changed to note shortcode for cri-o compat matrix - fix author
2020-02-12 10:56:51 -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
Rene Luria d1c81147c1 Update container-runtimes.md (#18608)
for debian install of docker, also install gnupg2 for apt-key add to work
2020-02-03 01:29:21 -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
Venkata Harshavardhan Reddy Allu 2529bc642c install container runtimes without prompts (#18893)
In Kubernetes docs, all of the packages that are required to set up the
Kubernetes are installed without requiring any prompts through
the package manager (like apt or yum) except for the container runtimes.

https://kubernetes.io/docs/setup/production-environment/container-runtimes/

So, it would be better to have these installations with prompts (yes) disabled.
2020-01-29 10:10:15 -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
wawa e3a7a56878 Remove redundant information when deploy flannel on kubernetes include windows node (#18274) 2020-01-17 07:54:59 -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
makocchi 50c24e3e4e Fix the link for conjure-up (#18529)
* fix the link for conjure-up

* Fix the link for conjure-up to docs.conjure-up.io
2020-01-17 03:42:57 -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
Xiang Dai f21f4b2257 Fix en language misspell (#18201)
* fix misspell

Signed-off-by: Xiang Dai <764524258@qq.com>

* clean white noise

Signed-off-by: Xiang Dai <764524258@qq.com>
2019-12-20 06:49:32 -08:00
Damini Satya dff2f7b960 Official 1.17 Release Docs (#18011)
* feat: graduate TaintNodesByCondition to GA (#17073)

* Promote StartupProbe to beta (enabled by default). (#17164)

* Watch bookmarks to GA (#17026)

* feat: graduate ScheduleDaemonSetPods to GA (#17350)

* Update Docker installation instructions (#17405)

* Use exact version numbers for installing Docker in Ubuntu (#17428)

* Move CSIMigration and CSIMigrationGCE to Beta in Kubernetes v1.17 (#17478)

* Promote NodeLease feature to GA (#17189)

* Update docs for csi topology ga (#17408)

* Update RunAsUsername to beta (#17460)

* doc:Update RunAsUsername to beta

* doc: update samples - kubernetes.io/os is no longer beta

* Updating based on review feedback

* Promote Node-specific volume limits to GA (#17432)

* Promote PodShareProcessNamespace to stable (#17192)

* Promote PodShareProcessNamespace to stable

* Add for_k8s_version to feature-state label

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

* Readd version-check to shareProcessNamespace task

* Update service load balancer finalizer doc for GA (#17438)

* Update Topology Manager docs (#17451)

* Added information on how device plugins can take advantage
of Topology Manager
* Updated the Topology Manager documentation to include additionalinformation and update some out of date sections

* Fix broken Topology Manager link (#17746)

Part of What's Next Device Plugin section

* Update CRD defaulting docs for GA (#17450)

* Add documentation for VolumeSnapshot Beta (#17233)

* Updating EndpointSlice documentation for beta release in 1.17 (#17411)

* (docs/dualstack): v1.17 updates (#17457)

* Add placehold doc updates for dualstack in 1.17

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* Add Downward API and /etc/hosts Pod IP validation

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* remove addressed known issue via k/k pr 85246

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* Remove known issue and add flag as part of k/k 79993

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* remove follow up placeholders

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* Update verbiage

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* Make IP addressing consistent throughout the task

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* Update to status.podIPs

Signed-off-by: Lachlan Evenson <lachlan.evenson@microsoft.com>

* Update content/en/docs/tasks/network/validate-dual-stack.md

Use set instead of env

Co-Authored-By: Khaled Henidak (Kal) <khnidk@outlook.com>

* add topology.kubernetes.io/zone, topology.kubernetes.io/region and node.kubernetes.io/instance-type labels to docs (#17498)

Signed-off-by: Andrew Sy Kim <kiman@vmware.com>

* Service topology alpha documentation (#17459)

* Update list of feature flags for in-tree plugins migrated to CSI (#17533)

Signed-off-by: Deep Debroy <ddebroy@docker.com>

* Update Node concept for TaintNodesByCondition going GA (#17577)

* feat: graduate ResourceQuotaScopeSelectors to GA in 1.17 (#17554)

* kubeadm: update the upgrade documentation for 1.17 (#17587)

* doc: Simplify Windows deployments with RuntimeClass (#16697)

* doc: Simplify Windows deployments with RuntimeClass

* Updating on review feedback

* doc: Adding windows-build label from enhancement 1301

* update doc for kubelet option --reserved-cpus (#17648)

* feat: update TaintNodesByCondition in feature gates table (#17377)

* Update docs for v1 resource quota configuration (#17547)

* AdmissionConfiguration v1 (#17548)

* Update WebhookAdmissionConfiguration examples (#17549)

* Update AWS EBS Migration Feature state (#16126)

* Add resource version section to api-concepts documentation (#16910)

* Add Resource Version semantics section to api concepts

* Clarify risks of going back in time, add details about compaction and watch cache sizes

* Apply suggestions from liggitt

Co-Authored-By: Jordan Liggitt <jordan@liggitt.net>

* remove pesudocode, apply feedback

* Fix typo

* Clarify equality rules

* Cleanup kubectl generators docs (#17609)

* Write ReplicationController without a space

* Drop mentioning unsupported cluster versions

* Fix capitalization for “API group”

* Tweak wording

* Avoid using deprecated generator in example

* add Antrea description in dev-1.17 (#17919)

* Promote VolumeSubpathEnvExpansion to GA

* Reference Documentation for the Kubernetes API for 1.17 (#18019)

* Update feature-gates.md (#18033)

* Reference Documentation for kubectl Commands for 1.17 (#18017)

* Update for v1.17 (#18034)

* Update config.toml(release-1.17) for 1.17 (#18031)
2019-12-09 16:11:29 -08:00
Matt McNaughton 832371281d Add missing systemctl step for running cri-o (#17926)
After installing `cri-o`, we must run `systemctl daemon-reload` before
trying to run `systemctl start crio`. Otherwise, `systemd` doesn't know
about the crio configuration.

Similar instructions already exist for installing docker - this diff
adds these instructions for crio.
2019-12-03 06:00:57 -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
Luzhenxing c3444e39a7 fix error link (#17253) 2019-10-29 18:28:52 -07: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
Will McGregor fbca7bbfad Remove duplicate reference to awsElasticBlockStore (#17135) 2019-10-27 18:37:24 -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
Alberto Roura 8d115c59a3 Update alibaba-cloud.md (#17156)
Alibaba Cloud supports serverless kubernetes, a Kubernetes-In-Kubernetes based solution.
2019-10-27 18:17: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
Dax McDonald bbe6cc3dea Update windows containers deployment (#16749)
There are two fixes in this change. First, the yaml is left justified in order to ease copying. Secondly, the selector field is added to the deployment.
2019-10-11 14:50:04 -07:00