Merge pull request #35122 from ydFu/update-Kubespray
Updated the 'Installing Kubernetes with Kubespray'
This commit is contained in:
		
						commit
						4edda58266
					
				| 
						 | 
				
			
			@ -8,19 +8,24 @@ weight: 30
 | 
			
		|||
 | 
			
		||||
This quickstart helps to install a Kubernetes cluster hosted on GCE, Azure, OpenStack, AWS, vSphere, Equinix Metal (formerly Packet), Oracle Cloud Infrastructure (Experimental) or Baremetal with [Kubespray](https://github.com/kubernetes-sigs/kubespray).
 | 
			
		||||
 | 
			
		||||
Kubespray is a composition of [Ansible](https://docs.ansible.com/) playbooks, [inventory](https://github.com/kubernetes-sigs/kubespray/blob/master/docs/ansible.md), provisioning tools, and domain knowledge for generic OS/Kubernetes clusters configuration management tasks. Kubespray provides:
 | 
			
		||||
Kubespray is a composition of [Ansible](https://docs.ansible.com/) playbooks, [inventory](https://github.com/kubernetes-sigs/kubespray/blob/master/docs/ansible.md#inventory), provisioning tools, and domain knowledge for generic OS/Kubernetes clusters configuration management tasks. 
 | 
			
		||||
 | 
			
		||||
* a highly available cluster
 | 
			
		||||
* composable attributes
 | 
			
		||||
* support for most popular Linux distributions
 | 
			
		||||
  * Ubuntu 16.04, 18.04, 20.04, 22.04
 | 
			
		||||
  * CentOS/RHEL/Oracle Linux 7, 8
 | 
			
		||||
  * Debian Buster, Jessie, Stretch, Wheezy
 | 
			
		||||
  * Fedora 34, 35
 | 
			
		||||
  * Fedora CoreOS
 | 
			
		||||
  * openSUSE Leap 15
 | 
			
		||||
  * Flatcar Container Linux by Kinvolk
 | 
			
		||||
* continuous integration tests
 | 
			
		||||
Kubespray provides:
 | 
			
		||||
* Highly available cluster.
 | 
			
		||||
* Composable (Choice of the network plugin for instance).
 | 
			
		||||
* Supports most popular Linux distributions:
 | 
			
		||||
  - Flatcar Container Linux by Kinvolk
 | 
			
		||||
  - Debian Bullseye, Buster, Jessie, Stretch
 | 
			
		||||
  - Ubuntu 16.04, 18.04, 20.04, 22.04
 | 
			
		||||
  - CentOS/RHEL 7, 8
 | 
			
		||||
  - Fedora 34, 35
 | 
			
		||||
  - Fedora CoreOS
 | 
			
		||||
  - openSUSE Leap 15.x/Tumbleweed
 | 
			
		||||
  - Oracle Linux 7, 8
 | 
			
		||||
  - Alma Linux 8
 | 
			
		||||
  - Rocky Linux 8
 | 
			
		||||
  - Amazon Linux 2 
 | 
			
		||||
* Continuous integration tests.
 | 
			
		||||
 | 
			
		||||
To choose a tool which best fits your use case, read [this comparison](https://github.com/kubernetes-sigs/kubespray/blob/master/docs/comparisons.md) to
 | 
			
		||||
[kubeadm](/docs/reference/setup-tools/kubeadm/) and [kops](/docs/setup/production-environment/tools/kops/).
 | 
			
		||||
| 
						 | 
				
			
			@ -33,13 +38,13 @@ To choose a tool which best fits your use case, read [this comparison](https://g
 | 
			
		|||
 | 
			
		||||
Provision servers with the following [requirements](https://github.com/kubernetes-sigs/kubespray#requirements):
 | 
			
		||||
 | 
			
		||||
* **Ansible v2.11 and python-netaddr are installed on the machine that will run Ansible commands**
 | 
			
		||||
* **Jinja 2.11 (or newer) is required to run the Ansible Playbooks**
 | 
			
		||||
* The target servers must have access to the Internet in order to pull docker images. Otherwise, additional configuration is required ([See Offline Environment](https://github.com/kubernetes-sigs/kubespray/blob/master/docs/offline-environment.md))
 | 
			
		||||
* The target servers are configured to allow **IPv4 forwarding**
 | 
			
		||||
* **Your ssh key must be copied** to all the servers in your inventory
 | 
			
		||||
* **Firewalls are not managed by kubespray**. You'll need to implement appropriate rules as needed. You should disable your firewall in order to avoid any issues during deployment
 | 
			
		||||
* If kubespray is run from a non-root user account, correct privilege escalation method should be configured in the target servers and the `ansible_become` flag or command parameters `--become` or `-b` should be specified
 | 
			
		||||
* **Minimum required version of Kubernetes is v1.22**
 | 
			
		||||
* **Ansible v2.11+, Jinja 2.11+ and python-netaddr is installed on the machine that will run Ansible commands**
 | 
			
		||||
* The target servers must have **access to the Internet** in order to pull docker images. Otherwise, additional configuration is required See ([Offline Environment](https://github.com/kubernetes-sigs/kubespray/blob/master/docs/offline-environment.md))
 | 
			
		||||
* The target servers are configured to allow **IPv4 forwarding**.
 | 
			
		||||
* If using IPv6 for pods and services, the target servers are configured to allow **IPv6 forwarding**.
 | 
			
		||||
* The **firewalls are not managed**, you'll need to implement your own rules the way you used to. in order to avoid any issue during deployment you should disable your firewall.
 | 
			
		||||
* If kubespray is run from non-root user account, correct privilege escalation method should be configured in the target servers. Then the `ansible_become` flag or command parameters `--become` or `-b` should be specified.
 | 
			
		||||
 | 
			
		||||
Kubespray provides the following utilities to help provision your environment:
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -110,11 +115,10 @@ When running the reset playbook, be sure not to accidentally target your product
 | 
			
		|||
 | 
			
		||||
## Feedback
 | 
			
		||||
 | 
			
		||||
* Slack Channel: [#kubespray](https://kubernetes.slack.com/messages/kubespray/) (You can get your invite [here](https://slack.k8s.io/))
 | 
			
		||||
* [GitHub Issues](https://github.com/kubernetes-sigs/kubespray/issues)
 | 
			
		||||
* Slack Channel: [#kubespray](https://kubernetes.slack.com/messages/kubespray/) (You can get your invite [here](https://slack.k8s.io/)).
 | 
			
		||||
* [GitHub Issues](https://github.com/kubernetes-sigs/kubespray/issues).
 | 
			
		||||
 | 
			
		||||
## {{% heading "whatsnext" %}}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
Check out planned work on Kubespray's [roadmap](https://github.com/kubernetes-sigs/kubespray/blob/master/docs/roadmap.md).
 | 
			
		||||
 | 
			
		||||
* Check out planned work on Kubespray's [roadmap](https://github.com/kubernetes-sigs/kubespray/blob/master/docs/roadmap.md).
 | 
			
		||||
* Learn more about [Kubespray](https://github.com/kubernetes-sigs/kubespray).
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
		Reference in New Issue