Skip to content

Commit e6ed8f0

Browse files
Updated kubernetes service docs with inclusive words/terms.
1 parent a644137 commit e6ed8f0

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

source/plugins/cloudstack-kubernetes-service.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ The Kubernetes Service plugin adds Kubernetes integration to CloudStack. The plu
1717

1818
Kubernetes Service plugin uses a CoreOS based template for node VMs for the Kubernetes cluster. CoreOS has been used as it provides docker installation and networking rules needed for Kubernetes by default. In future, different guest OSes might be used. For installation of Kubernetes binaries on cluster nodes, a binaries ISO is used for each Kubernetes version to be made available via CloudStack. This allows faster, offline installation of Kubernetes binaries and docker images along with support for adding multiple versions of Kubernetes for upgrades and running different clusters.
1919

20-
For deployment and setup of Kubernetes on cluster nodes, the plugin uses the Kubernetes tool, 'kubeadm'. kubeadm is the command-line tool for easily provisioning a secure Kubernetes cluster on top of physical or cloud servers or virtual machines. Under the hood, master node(s) of the cluster starts a Kubernetes cluster using kubeadm init command with a custom token, and worker nodes join this Kubernetes cluster using kubeadm join command with the same token. More about kubeadm here: https://kubernetes.io/docs/reference/setup-tools/kubeadm/kubeadm/. Weave Net CNI provider plugin is used for cluster networking. More about Weave Net provide plugin here: https://www.weave.works/docs/net/latest/kubernetes/kube-addon/.
20+
For deployment and setup of Kubernetes on cluster nodes, the plugin uses the Kubernetes tool, 'kubeadm'. kubeadm is the command-line tool for easily provisioning a secure Kubernetes cluster on top of physical or cloud servers or virtual machines. Under the hood, control node(s) of the cluster starts a Kubernetes cluster using kubeadm init command with a custom token, and worker nodes join this Kubernetes cluster using kubeadm join command with the same token. More about kubeadm here: https://kubernetes.io/docs/reference/setup-tools/kubeadm/kubeadm/. Weave Net CNI provider plugin is used for cluster networking. More about Weave Net provide plugin here: https://www.weave.works/docs/net/latest/kubernetes/kube-addon/.
2121

2222
To access the Kubernetes dashboard securely, the plugin provides access to kubeconfig file data which uses the Kubernetes tool kubectl to run a local proxy and thereby access the dashboard. More about kubectl here: https://kubernetes.io/docs/reference/kubectl/overview/
2323

@@ -161,8 +161,8 @@ The following Global Setting value must be set to the name of Network Offering t
161161
A new network offering named DefaultNetworkOfferingforKubernetesService has been added since 4.14.0
162162

163163
.. note::
164-
- Multi-master, HA cluster can be created for Kubernetes version 1.16 and above only.
165-
- While creating multi-master, HA cluster over a shared network, an external load-balancer must be manually setup. This load-balancer should have port-forwarding rules for SSH, Kubernetes API server access. Service assumes SSH access to cluster nodes is available from port 2222 to (2222 + cluster node count -1). Similarly, for API access 6443 must be forwarded to master nodes. Over the CloudStack isolated network these rules are automatically provisioned.
164+
- Multi-control nodes, HA cluster can be created for Kubernetes version 1.16 and above only.
165+
- While creating multi-control nodes, HA cluster over a shared network, an external load-balancer must be manually setup. This load-balancer should have port-forwarding rules for SSH, Kubernetes API server access. Service assumes SSH access to cluster nodes is available from port 2222 to (2222 + cluster node count -1). Similarly, for API access 6443 must be forwarded to control nodes. Over the CloudStack isolated network these rules are automatically provisioned.
166166

167167
Managing Kubernetes clusters
168168
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -188,7 +188,7 @@ createKubernetesCluster API can be used to create new Kubernetes cluster. It tak
188188
- **projectid** (Deploy cluster for the project)
189189
- **networkid** (Network in which Kubernetes cluster is to be launched)
190190
- **keypair** (name of the ssh key pair used to login to the virtual machines)
191-
- **masternodes** (number of Kubernetes cluster master nodes, default is 1) externalloadbalanceripaddress (external load balancer IP address while using shared network with Kubernetes HA cluster)
191+
- **controlnodes** (number of Kubernetes cluster control nodes, default is 1) externalloadbalanceripaddress (external load balancer IP address while using shared network with Kubernetes HA cluster)
192192
- **size** (number of Kubernetes cluster worker nodes; Required)
193193
- **noderootdisksize** (root disk size of root disk for each node)
194194
- **dockerregistryusername** (username for the docker image private registry; Experimental)
@@ -209,7 +209,7 @@ For example:
209209
"id": "74e3cc02-bbf7-438f-bfb0-9c193e90c1fb",
210210
"kubernetesversionid": "6668e999-fe6c-4a91-88d8-d10bcf280d02",
211211
"kubernetesversionname": "v1.13.2",
212-
"masternodes": 1,
212+
"controlnodes": 1,
213213
"memory": "4096",
214214
"name": "Test",
215215
"networkid": "148af2cb-4b94-42a2-b701-3b6aa884cbb0",

0 commit comments

Comments
 (0)