starlingx/docs
Code Issues Proposed changes

Merge "Kubernetes custom configuration support at Runtime (r8, dsR8)"

Browse Source
This commit is contained in:
Zuul 2023-04-12 20:58:39 +00:00 committed by Gerrit Code Review
commit 35af206725
1 changed files with 63 additions and 61 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
doc/source/system_configuration/kubernetes/kubernetes-custom-configuration-31c1fd41857d.rst
View File

@ -10,7 +10,7 @@ Introduction
Kubernetes configuration can be customized during deployment by specifying Kubernetes configuration can be customized during deployment by specifying
bootstrap overrides in the ``localhost.yml`` file during the Ansible bootstrap bootstrap overrides in the ``localhost.yml`` file during the Ansible bootstrap
process. process or during runtime via ``sysinv service-parameters`` |CLI|.
Custom configuration includes: Custom configuration includes:
@ -38,7 +38,7 @@ shared state through which all other components interact.
For a list of all configurable options of kube-apiserver, see `kube-apiserver For a list of all configurable options of kube-apiserver, see `kube-apiserver
<https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/>`__. <https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/>`__.
.. **Bootstrap configuration** **Bootstrap configuration**
To set or override a ``kube-apiserver`` option, add the desired parameters to an To set or override a ``kube-apiserver`` option, add the desired parameters to an
``apiserver_extra_args`` section in the ``localhost.yml``. ``apiserver_extra_args`` section in the ``localhost.yml``.
@ -56,7 +56,7 @@ Example usage:
event-ttl: "20h" event-ttl: "20h"
.. **Runtime configuration** **Runtime configuration**
To set, modify or delete a ``kube-apiserver`` parameter use the To set, modify or delete a ``kube-apiserver`` parameter use the
service-parameter add, modify or delete |CLI| command. service-parameter add, modify or delete |CLI| command.
@ -73,8 +73,8 @@ Example usage:
.. note:: .. note::
Parameter must not exists on service parameters, otherwise use :command:`modify` Parameter must not exists on service parameters, otherwise use
command. :command:`modify` command.
- Modify existing parameter - Modify existing parameter
@ -107,7 +107,7 @@ For a list of all configurable options of kube-controller-manager, see
<https://kubernetes.io/docs/reference/command-line-tools-reference/kube-controller-manager/>`__. <https://kubernetes.io/docs/reference/command-line-tools-reference/kube-controller-manager/>`__.
.. **Bootstrap configuration** **Bootstrap configuration**
To set or override a ``kube-controller-manager`` option, add the desired To set or override a ``kube-controller-manager`` option, add the desired
parameters to an ``controllermanager_extra_args`` section in the parameters to an ``controllermanager_extra_args`` section in the
@ -125,7 +125,7 @@ Example usage:
feature-gates: "TTLAfterFinished=true,MemoryManager=true" feature-gates: "TTLAfterFinished=true,MemoryManager=true"
.. **Runtime configuration** **Runtime configuration**
To set, modify or delete a ``kube-controller-manager`` parameter use the To set, modify or delete a ``kube-controller-manager`` parameter use the
service-parameter add, modify or delete |CLI| command. service-parameter add, modify or delete |CLI| command.
@ -142,8 +142,8 @@ Example usage:
.. note:: .. note::
Parameter must not exists on service parameters, otherwise use :command:`modify` Parameter must not exists on service parameters, otherwise use
command. :command:`modify` command.
- Modify existing parameter - Modify existing parameter
@ -176,7 +176,7 @@ the reference implementation.
For a list of all configurable options of ``kube-scheduler``, see `kube-scheduler For a list of all configurable options of ``kube-scheduler``, see `kube-scheduler
<https://kubernetes.io/docs/reference/command-line-tools-reference/kube-scheduler/>`__. <https://kubernetes.io/docs/reference/command-line-tools-reference/kube-scheduler/>`__.
.. **Bootstrap configuration** **Bootstrap configuration**
To set or override a ``kube-scheduler`` option, add the desired parameters to an To set or override a ``kube-scheduler`` option, add the desired parameters to an
``scheduler_extra_args`` section in the ``localhost.yml`` . ``scheduler_extra_args`` section in the ``localhost.yml`` .
@ -188,12 +188,12 @@ Example usage:
scheduler_extra_args: scheduler_extra_args:
feature-gates: "TTLAfterFinished=false" feature-gates: "TTLAfterFinished=false"
.. **Runtime configuration** **Runtime configuration**
To set, modify or delete a ``kube-controller-manager`` parameter use the To set, modify or delete a ``kube-controller-manager`` parameter use the
service-parameter add, modify or delete |CLI| command. service-parameter add, modify or delete |CLI| command.
.. Example usage: Example usage:
- Add new parameter - Add new parameter
@ -205,8 +205,8 @@ service-parameter add, modify or delete |CLI| command.
.. note:: .. note::
Parameter must not exists on service parameters, otherwise use :command:`modify` Parameter must not exists on service parameters, otherwise use
command. :command:`modify` command.
- Modify existing parameter - Modify existing parameter
@ -238,8 +238,9 @@ To set or override a kubelet option, add the desired parameters to an
``kubelet_configurations`` section in the ``localhost.yml`` . ``kubelet_configurations`` section in the ``localhost.yml`` .
.. important::
.. Custom Kubelet configuration is not supported during runtime. This feature Custom Kubelet configuration is not supported during runtime. This feature
will be supported in the next release. will be supported in the next release.
Example usage: Example usage:
@ -263,8 +264,9 @@ overrides (``localhost.yml``) with the ``apiserver_extra_volumes``,
definitions. definitions.
.. important::
.. Kubernetes custom configuration of extra-volumes for ``kube-apiserver``, Kubernetes custom configuration of extra-volumes for ``kube-apiserver``,
``kube-controller-manager`` and ``kube-scheduler`` are not supported during ``kube-controller-manager`` and ``kube-scheduler`` are not supported during
runtime. This feature will be supported in the next release. runtime. This feature will be supported in the next release.