Skip to content

Commit e1d3e95

Browse files
committed
Address review comments
1 parent 9b51bde commit e1d3e95

File tree

4 files changed

+85
-2
lines changed

4 files changed

+85
-2
lines changed
174 KB
Loading
213 KB
Loading
60.6 KB
Loading

source/plugins/cloudstack-kubernetes-service.rst

Lines changed: 85 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -459,7 +459,7 @@ From 4.21.0, many enhancements have been added to CloudStack Kubernetes Service
459459

460460
- Select the Hypervisor hype for the Kubernetes Cluster nodes
461461
- Specify different templates and/or service offerings for different types of Kubernetes Clusters nodes
462-
- Use CKS-ready custom and non-ready templates for Kubernetes cluster nodes
462+
- Use CKS-ready custom templates for Kubernetes cluster nodes marked as 'For CKS'
463463
- Separate etcd nodes from control nodes of the Kubernetes clusters
464464
- Add and remove a pre-created instance as a worker node to an existing Kubernetes cluster
465465
- Mark Kubernetes cluster nodes for manual-only upgrade
@@ -513,6 +513,7 @@ To register a template that will be listed as an option for Kubernetes cluster n
513513

514514
- Mark the option 'For CKS'. This ensures the template is considered as an option for Kubernetes cluster nodes on the Advanced Settings section for clusters creation.
515515

516+
|cks-custom-template-registration.png|
516517

517518
Separate etcd nodes from control nodes
518519
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -521,6 +522,8 @@ By default, a CKS cluster has 0 dedicated etcd nodes, and the etcd service runs
521522

522523
To use separate etcd nodes, it is required to build and register a CKS ISO version containing the etcd binaries as explained in: :ref:`kubernetes-supported-versions`
523524

525+
For convenience, some CKS ISOs are uploaded to: https://download.cloudstack.org/testing/cks/custom_templates/iso-etcd/
526+
524527
Add an external VM Instance as a worker node to a Kubernetes cluster
525528
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
526529

@@ -530,7 +533,7 @@ Requirements for a VM Instance to be added as worker node to a Kubernetes cluste
530533

531534
- The VM Instance must have a NIC on the Kubernetes cluster network
532535

533-
- The Management Server’s SSH Public key must be added at the cloud user’s authorized_keys file at `~/.ssh/authorized_keys`.
536+
- **The Management Server’s SSH Public key must be added at the cloud user’s authorized_keys file at `~/.ssh/authorized_keys`**.
534537

535538
The VM Instances meeting the requirements above can be added to the Kubernetes cluster by the `addNodesToKubernetesCluster` API specifying:
536539

@@ -664,6 +667,80 @@ Sample Calico CNI configuration data used which is appended to the existing Kube
664667
- for i in {1..3}; do sudo /opt/bin/kubectl apply -f /home/cloud/bgp-peer.yaml && break || sleep 5; done
665668
666669
670+
The CNI Configuration creation allows specifying the parameters to be set as a comma separated list:
671+
672+
|cks-cni-configuration-registration-sample.png|
673+
674+
After a CNI Configuration is created, it can be appended to Kubernetes cluster nodes as part of 'Advanced Settings':
675+
676+
|cks-cni-configuration-cluster-creation.png|
677+
678+
For verification of the applied CNI Configuration, the following commands can be used:
679+
680+
.. code-block:: bash
681+
682+
root@cksclusteradditon-control-190ca0ce253:~# kubectl get pods -A
683+
684+
NAMESPACE NAME READY STATUS RESTARTS AGE
685+
686+
kube-system calico-kube-controllers-8d76c5f9b-pkhcv 1/1 Running 6 (44m ago) 2d21h
687+
688+
kube-system calico-node-n4msg 1/1 Running 0 2d21h
689+
690+
kube-system calico-node-pdz2w 1/1 Running 0 2d18h
691+
692+
kube-system calico-node-slmg2 1/1 Running 0 2d21h
693+
694+
695+
696+
root@cksclusteradditon-control-190ca0ce253:~# kubectl get bgppeer
697+
698+
NAME AGE
699+
700+
bgp-peer-1 2d22h
701+
702+
703+
704+
root@cksclusteradditon-control-190ca0ce253:~# kubectl get bgpconfiguration
705+
706+
NAME AGE
707+
708+
default 2d22h
709+
710+
711+
root@cksclusteradditon-control-190ca0ce253:~# kubectl describe bgpconfiguration
712+
713+
Name: default
714+
715+
Namespace:
716+
717+
Labels: <none>
718+
719+
Annotations: <none>
720+
721+
API Version: crd.projectcalico.org/v1
722+
723+
Kind: BGPConfiguration
724+
725+
Metadata:
726+
727+
Creation Timestamp: 2024-07-19T08:25:14Z
728+
729+
Generation: 1
730+
731+
Resource Version: 580
732+
733+
UID: 2b927b4e-82d3-4200-a3c1-9bf0cd5f5824
734+
735+
Spec:
736+
737+
As Number: 65145
738+
739+
Log Severity Screen: Debug
740+
741+
Events: <none>
742+
743+
667744
.. |cks-add-version-form.png| image:: /_static/images/cks-add-version-form.png
668745
:alt: Add Kubernetes Supported Version form.
669746
.. |cks-cluster-access-tab.png| image:: /_static/images/cks-cluster-access-tab.png
@@ -696,3 +773,9 @@ Sample Calico CNI configuration data used which is appended to the existing Kube
696773
:alt: Upgrade Kubernetes Cluster form.
697774
.. |cks-versions.png| image:: /_static/images/cks-versions.png
698775
:alt: Supported Kubernetes versions list.
776+
.. |cks-custom-template-registration.png| image:: /_static/images/cks-custom-template-registration.png
777+
:alt: Custom Template Registration for Kubernetes cluster nodes.
778+
.. |cks-cni-configuration-cluster-creation.png| image:: /_static/images/cks-cni-configuration-cluster-creation.png
779+
:alt: Kubernetes cluster creation setting a CNI configuration.
780+
.. |cks-cni-configuration-registration-sample.png| image:: /_static/images/cks-cni-configuration-registration-sample.png
781+
:alt: CNI Configuration registration sample.

0 commit comments

Comments
 (0)