You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/setup/production-environment/tools/kubespray.md
+29-25Lines changed: 29 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,19 +8,24 @@ weight: 30
8
8
9
9
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).
10
10
11
-
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:
12
-
13
-
* a highly available cluster
14
-
* composable attributes
15
-
* support for most popular Linux distributions
16
-
* Ubuntu 16.04, 18.04, 20.04, 22.04
17
-
* CentOS/RHEL/Oracle Linux 7, 8
18
-
* Debian Buster, Jessie, Stretch, Wheezy
19
-
* Fedora 34, 35
20
-
* Fedora CoreOS
21
-
* openSUSE Leap 15
22
-
* Flatcar Container Linux by Kinvolk
23
-
* continuous integration tests
11
+
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.
12
+
13
+
Kubespray provides:
14
+
* Highly available cluster.
15
+
* Composable (Choice of the network plugin for instance).
16
+
* Supports most popular Linux distributions:
17
+
- Flatcar Container Linux by Kinvolk
18
+
- Debian Bullseye, Buster, Jessie, Stretch
19
+
- Ubuntu 16.04, 18.04, 20.04, 22.04
20
+
- CentOS/RHEL 7, 8
21
+
- Fedora 34, 35
22
+
- Fedora CoreOS
23
+
- openSUSE Leap 15.x/Tumbleweed
24
+
- Oracle Linux 7, 8
25
+
- Alma Linux 8
26
+
- Rocky Linux 8
27
+
- Amazon Linux 2
28
+
* Continuous integration tests.
24
29
25
30
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
26
31
[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
33
38
34
39
Provision servers with the following [requirements](https://github.com/kubernetes-sigs/kubespray#requirements):
35
40
36
-
***Ansible v2.11 and python-netaddr are installed on the machine that will run Ansible commands**
37
-
***Jinja 2.11 (or newer) is required to run the Ansible Playbooks**
38
-
* 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))
39
-
* The target servers are configured to allow **IPv4 forwarding**
40
-
***Your ssh key must be copied** to all the servers in your inventory
41
-
***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
42
-
* 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
41
+
***Minimum required version of Kubernetes is v1.22**
42
+
***Ansible v2.11+, Jinja 2.11+ and python-netaddr is installed on the machine that will run Ansible commands**
43
+
* 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))
44
+
* The target servers are configured to allow **IPv4 forwarding**.
45
+
*If using IPv6 for pods and services, the target servers are configured to allow **IPv6 forwarding**.
46
+
*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.
47
+
* 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.
43
48
44
49
Kubespray provides the following utilities to help provision your environment:
45
50
@@ -110,11 +115,10 @@ When running the reset playbook, be sure not to accidentally target your product
110
115
111
116
## Feedback
112
117
113
-
* Slack Channel: [#kubespray](https://kubernetes.slack.com/messages/kubespray/) (You can get your invite [here](https://slack.k8s.io/))
0 commit comments