Skip to content

Commit 532b51e

Browse files
authored
Remove weave-net-references
Updated Kubernetes service documentation to reflect changes in CNI plugins and versioning.
1 parent fd7c1aa commit 532b51e

File tree

1 file changed

+14
-25
lines changed

1 file changed

+14
-25
lines changed

source/plugins/cloudstack-kubernetes-service.rst

Lines changed: 14 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
CloudStack Kubernetes Service
1414
==============================
1515

16-
The Kubernetes Service plugin adds Kubernetes integration to CloudStack. The plugin is disabled by default and an admin can enable it using a Global Setting. It enables users to run containerized services using Kubernetes clusters.
16+
The Kubernetes Service plugin adds Kubernetes integration to CloudStack. The plugin is disabled by default and an admin can enable it using a Global Setting. It enables users to run containerized services using Kubernetes clusters. Also the global setting "endpoint.url" needs to be set to the CloudStack management server ip example (http://management-server-ip:8080/client/api)
1717

1818
The Kubernetes Service plugin will use the existing SystemVM Template by default for deploying Kubernetes clusters. For
1919
installation of Kubernetes binaries on the cluster nodes, a binaries ISO is used for each
@@ -27,9 +27,7 @@ multiple versions of Kubernetes for upgrades and running different clusters.
2727

2828
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 Instances. 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/.
2929

30-
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/.
31-
32-
Calico CNI provider plugin is also supported from ACS 4.21 onwards. More about Calico CNI plugin here: https://docs.projectcalico.org/getting-started/kubernetes/.
30+
Calico CNI provider plugin is used for cluster networking supported from ACS 4.21 onwards. More about Calico CNI plugin here: https://docs.projectcalico.org/getting-started/kubernetes/.
3331

3432
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/
3533

@@ -75,24 +73,19 @@ Eg: To generate the latest kubernetes iso
7573

7674
.. parsed-literal::
7775
78-
1.27.2, kubernetes version, see https://github.com/kubernetes/kubernetes/releases
79-
1.3.0, CNI version, see https://github.com/containernetworking/plugins/releases
80-
1.27.0, cri-tools version, see https://github.com/kubernetes-sigs/cri-tools/releases
81-
1.11, weave addon for kubernetes, see https://github.com/weaveworks/weave/tree/master/prog/weave-kube
76+
1.33.1, kubernetes version, see https://github.com/kubernetes/kubernetes/releases
77+
1.7.1, CNI version, see https://github.com/containernetworking/plugins/releases
78+
1.33.0, cri-tools version, see https://github.com/kubernetes-sigs/cri-tools/releases
8279
3.30.0, calico addon for kubernetes, see https://raw.githubusercontent.com/projectcalico/calico/v3.30.0/manifests/calico.yaml
8380
2.7.0, kubernetes dashboard version, see https://github.com/kubernetes/dashboard/release
8481
8582
Usage:
8683

8784
.. parsed-literal::
8885
89-
# ./create-kubernetes-binaries-iso.sh OUTPUT_PATH KUBERNETES_VERSION CNI_VERSION CRICTL_VERSION WEAVENET_NETWORK_YAML_CONFIG DASHBOARD_YAML_CONFIG [OPTIONAL_OUTPUT_FILENAME] [OPTIONAL_ETCD_VERSION]
90-
91-
Eg: To generate the kubernetes iso with weave cni plugin
86+
# ./create-kubernetes-binaries-iso.sh OUTPUT_PATH KUBERNETES_VERSION CNI_VERSION CRICTL_VERSION CALICO_NETWORK_YAML_CONFIG DASHBOARD_YAML_CONFIG [OPTIONAL_OUTPUT_FILENAME] [OPTIONAL_ETCD_VERSION]
9287
93-
.. parsed-literal::
9488
95-
# ./create-kubernetes-binaries-iso.sh ./ 1.27.2 1.3.0 1.27.0 https://raw.githubusercontent.com/weaveworks/weave/master/prog/weave-kube/weave-daemonset-k8s-1.11.yaml https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml setup-v1.27.2
9689
9790
Eg: To generate the kubernetes iso with calico cni plugin
9891

@@ -106,18 +99,14 @@ Eg: To generate the kubernetes iso with calico cni plugin for ARM64 architecture
10699
107100
# ./create-kubernetes-binaries-iso.sh ./ 1.33.1 1.7.1 1.33.0 https://raw.githubusercontent.com/projectcalico/calico/v3.30.0/manifests/calico.yaml https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml aarch64 setup-v1.33.1-calico-arm64
108101
109-
110-
**NOTE:**
111-
From ACS 4.16 onwards, Kubernetes versions >= 1.20.x are only supported (https://endoflife.date/kubernetes).
112-
113102
**NOTE:**
114103
From ACS 4.21 onwards, it is possible to specify the version for etcd binaries in the create-kubernetes-binaries-iso.sh script as an optional parameter - ETCD_VERSION. When the ETCD_VERSION parameter is set, the specified etcd version binaries are downloaded and stored in the Kubernetes ISO.
115104

116105
Example for etcd version 3.5.1:
117106

118107
.. parsed-literal::
119108
120-
# ./create-kubernetes-binaries-iso.sh ./ 1.27.2 1.3.0 1.27.0 https://raw.githubusercontent.com/weaveworks/weave/master/prog/weave-kube/weave-daemonset-k8s-1.11.yaml https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml setup-v1.27.2 3.5.1
109+
# ./create-kubernetes-binaries-iso.sh ./ 1.33.1 1.7.1 1.33.0 https://raw.githubusercontent.com/projectcalico/calico/v3.30.0/manifests/calico.yaml https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml setup-v1.33.1-calico-etcd 3.5.1
121110
122111
To deploy Kubernetes clusters with
123112
Kubernetes ISOs built with a specified etcd version are necessary for creating Kubernetes clusters with separate etcd nodes. See :ref:`flexible-kubernetes-clusters`.
@@ -148,15 +137,15 @@ addKubernetesSupportedVersion API can be used by an admin to add a new supported
148137
For example:
149138

150139
.. parsed-literal::
151-
> add kubernetessupportedversion name=v1.13.2 semanticversion=1.13.2 url=http://172.20.0.1/files/setup-1.13.2.iso zoneid=34d23dd5-5ced-4e8b-9b0a-835a0b8ae2a6 mincpunumber=2 minmemory=2048
140+
> add kubernetessupportedversion name=v1.33.1 semanticversion=1.33.1 url=http://172.20.0.1/files/setup-1.33.1.iso zoneid=34d23dd5-5ced-4e8b-9b0a-835a0b8ae2a6 mincpunumber=2 minmemory=2048
152141
{
153142
"kubernetessupportedversion": {
154143
"id": "6668e999-fe6c-4a91-88d8-d10bcf280d02",
155144
"isoid": "78d45e9b-a482-46f4-8cbc-cf7964564b85",
156-
"isoname": "v1.13.2-Kubernetes-Binaries-ISO",
145+
"isoname": "v1.33.1-Kubernetes-Binaries-ISO",
157146
"isostate": "Active",
158-
"semanticversion": "1.13.2",
159-
"name": "v1.13.2",
147+
"semanticversion": "1.33.1",
148+
"name": "v1.33.1",
160149
"supportsha": false,
161150
"zoneid": "34d23dd5-5ced-4e8b-9b0a-835a0b8ae2a6",
162151
"zonename": "KVM-advzone1"
@@ -165,7 +154,7 @@ For example:
165154
}
166155
}
167156
168-
The minimum Kubernetes version that can be added in the service is 1.11. At present, v1.17 and above might not work due to their incompatibility with weave-net plugin.
157+
169158
170159
Listing supported Kubernetes versions
171160
######################################
@@ -290,7 +279,7 @@ For example:
290279
"endpoint": "https://172.20.20.12:6443/",
291280
"id": "74e3cc02-bbf7-438f-bfb0-9c193e90c1fb",
292281
"kubernetesversionid": "6668e999-fe6c-4a91-88d8-d10bcf280d02",
293-
"kubernetesversionname": "v1.13.2",
282+
"kubernetesversionname": "v1.33.1",
294283
"controlnodes": 1,
295284
"memory": "4096",
296285
"name": "Test",
@@ -843,4 +832,4 @@ kubectl delete pod --all -A
843832
.. |cks-cni-configuration-cluster-creation.png| image:: /_static/images/cks-cni-configuration-cluster-creation.png
844833
:alt: Kubernetes cluster creation setting a CNI configuration.
845834
.. |cks-cni-configuration-registration-sample.png| image:: /_static/images/cks-cni-configuration-registration-sample.png
846-
:alt: CNI Configuration registration sample.
835+
:alt: CNI Configuration registration sample.

0 commit comments

Comments
 (0)