starlingx/docs
Code Issues Proposed changes

Platform Application Components Up-version

Browse Source 
Updated patchset 3 comments
Updated patchset 2 comments
Updated cert-armanda application version
Updated ingress-nginx application version

Story: 2011087
Task: 50159

Change-Id: I07756d3a8bd432347920d21e4f16e82b0283b317
Signed-off-by: Juanita Balaraj <juanita.balaraj@windriver.com>
Signed-off-by: Ngairangbam Mili <ngairangbam.mili@windriver.com>
This commit is contained in:
Juanita Balaraj 2024-08-22 20:31:51 +00:00 committed by Ngairangbam Mili
parent 76af70a0fb
commit 01cc81c348
13 changed files with 390 additions and 325 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/source/_includes/system-application-list.rest Normal file
View File

@ -0,0 +1,3 @@
.. system-application-list-begin
.. system-application-list-end

127
doc/source/admintasks/kubernetes/admin-application-commands-and-helm-overrides.rst
View File

@ -31,20 +31,28 @@ commands to manage containerized applications provided as part of |prod|.
For example: For example:
.. only:: starlingx
.. parsed-literal:: .. parsed-literal::
~(keystone_admin)]$ system application-list --nowrap ~(keystone_admin)]$ system application-list --nowrap
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
+--------------------------+----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+--------------------------+----------+-------------------------------------------+------------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| cert-manager | 24.03-73 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| dell-storage | 24.03-9 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| nginx-ingress-controller | 24.03-55 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
| oidc-auth-apps | 24.03-49 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| platform-integ-apps | 24.03-135| platform-integ-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+----------+-------------------------------------------+------------------+----------+-----------+ | rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
- Use the following command to show details for |prod|. - Use the following command to show details for |prod|.
@ -57,26 +65,13 @@ commands to manage containerized applications provided as part of |prod|.
**<app_name>** **<app_name>**
The name of the application to show details. The name of the application to show details.
For example: For example, run the following command to get details about the
``cert-manager`` application.
.. parsed-literal:: .. code-block::
~(keystone_admin)]$ system application-show cert-manager ~(keystone_admin)]$ system application-show cert-manager
+---------------+----------------------------------+
| Property | Value |
+---------------+----------------------------------+
| active | True |
| app_version | 1.13-1 |
| created_at | 2022-06-21T02:21:24.218835+00:00 |
| manifest_file | fluxcd-manifests |
| manifest_name | cert-manager-fluxcd-manifests |
| name | cert-manager |
| progress | completed |
| status | applied |
| updated_at | 2024-01-21T03:13:01.051293+00:00 |
+---------------+----------------------------------+
- Use the following command to upload application Helm chart\(s) and - Use the following command to upload application Helm chart\(s) and
manifest. manifest.
@ -98,25 +93,11 @@ commands to manage containerized applications provided as part of |prod|.
**<tar_file>** **<tar_file>**
The path to the tar file containing the application to be uploaded. The path to the tar file containing the application to be uploaded.
For example: Run the following command to upload the application contained in the tar file.
.. parsed-literal:: .. code-block:: none
~(keystone_admin)]$ system application-upload metrics-server-1.0-17.tgz ~(keystone_admin)]$ system application-upload metrics-server-*.tgz
+---------------+----------------------------------+
| Property | Value |
+---------------+----------------------------------+
| active | False |
| app_version | 1.0-17 |
| created_at | 2022-06-21T15:40:36.152383+00:00 |
| manifest_file | fluxcd-manifests |
| manifest_name | metrics-server-fluxcd-manifests |
| name | metrics-server |
| progress | None |
| status | uploading |
| updated_at | None |
+---------------+----------------------------------+
Please use 'system application-list' or 'system application-show metrics-server' to view the current progress.
- To list the Helm chart overrides for the |prod|, use the following - To list the Helm chart overrides for the |prod|, use the following
command: command:
@ -342,25 +323,11 @@ commands to manage containerized applications provided as part of |prod|.
**<app_name>** **<app_name>**
The name of the application to apply. The name of the application to apply.
For example: For example, run the following command to apply the ``metrics-server`` application.
.. parsed-literal:: .. parsed-literal::
~(keystone_admin)]$ system application-apply metrics-server ~(keystone_admin)]$ system application-apply metrics-server
+---------------+----------------------------------+
| Property | Value |
+---------------+----------------------------------+
| active | False |
| app_version | 1.0-17 |
| created_at | 2022-06-21T15:40:36.152383+00:00 |
| manifest_file | fluxcd-manifests |
| manifest_name | metrics-server-fluxcd-manifests |
| name | metrics-server |
| progress | None |
| status | applying |
| updated_at | 2022-06-21T15:40:42.727918+00:00 |
+---------------+----------------------------------+
Please use 'system application-list' or 'system application-show metrics-server' to view the current progress.
- Use the following command to abort the current application. - Use the following command to abort the current application.
@ -399,21 +366,31 @@ commands to manage containerized applications provided as part of |prod|.
You can look up the name of an application using the You can look up the name of an application using the
:command:`application-list` command: :command:`application-list` command:
.. only:: starlingx
.. code-block:: none .. code-block:: none
~(keystone_admin)]$ system application-list ~(keystone_admin)]$ system application-list
+--------------------------+----------+-------------------------------+---------------------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+--------------------------+----------+-------------------------------+---------------------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| cert-manager | 20.06-4 | cert-manager-manifest | certmanager-manifest.yaml | applied | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| nginx-ingress-controller | 20.06-1 | nginx-ingress-controller- | nginx_ingress_controller | applied | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| | | -manifest | _manifest.yaml | | | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
| oidc-auth-apps | 20.06-26 | oidc-auth-manifest | manifest.yaml | uploaded | completed | | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| platform-integ-apps | 20.06-9 | platform-integration-manifest | manifest.yaml | applied | completed | | platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+----------+-------------------------------+---------------------------+----------+-----------+ | rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
The output indicates that the currently installed version of The output indicates that the currently installed version of
**cert-manager** is 20.06-4. **cert-manager** is 24.09-79.
**<version>** **<version>**
The version to update the application to. The version to update the application to.
@ -447,25 +424,11 @@ commands to manage containerized applications provided as part of |prod|.
**<app_name>** **<app_name>**
The name of the application to remove. The name of the application to remove.
For example: For example, run the following command to remove the ``metric-server`` application.
.. parsed-literal:: .. code-block:: none
~(keystone_admin)]$ system application-remove metrics-server ~(keystone_admin)]$ system application-remove metrics-server
+---------------+----------------------------------+
| Property | Value |
+---------------+----------------------------------+
| active | False |
| app_version | 1.0-17 |
| created_at | 2022-06-21T15:40:36.152383+00:00 |
| manifest_file | fluxcd-manifests |
| manifest_name | metrics-server-fluxcd-manifests |
| name | metrics-server |
| progress | None |
| status | removing |
| updated_at | 2022-06-21T15:45:55.204697+00:00 |
+---------------+----------------------------------+
Please use 'system application-list' or 'system application-show metrics-server' to view the current progress.
This command places the application in the uploaded state. This command places the application in the uploaded state.

19
doc/source/deploy_install_guides/release/bare_metal/aio_duplex_install_kubernetes.rst
View File

@ -1485,14 +1485,19 @@ machine.
:: ::
~(keystone_admin)$ source /etc/platform/openrc ~(keystone_admin)$ source /etc/platform/openrc
~(keystone_admin)$ system application-list ~(keystone_admin)]$ system application-list
+---------------------+---------+-------------------------------+---------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+---------------------+---------+-------------------------------+---------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| oidc-auth-apps | 1.0-0 | oidc-auth-manifest | manifest.yaml | uploaded | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-8 | platform-integration-manifest | manifest.yaml | uploaded | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-1 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
+---------------------+---------+-------------------------------+---------------+----------+-----------+ | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
| rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
#. Configure Rook to use /dev/sdb on controller-0 and controller-1 as a ceph #. Configure Rook to use /dev/sdb on controller-0 and controller-1 as a ceph
|OSD|. |OSD|.

18
doc/source/deploy_install_guides/release/bare_metal/aio_simplex_install_kubernetes.rst
View File

@ -935,14 +935,18 @@ machine.
:: ::
$ source /etc/platform/openrc $ source /etc/platform/openrc
~(keystone_admin)$ system application-list ~(keystone_admin)]$ system application-list
+---------------------+---------+-------------------------------+---------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+---------------------+---------+-------------------------------+---------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| oidc-auth-apps | 1.0-0 | oidc-auth-manifest | manifest.yaml | uploaded | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-8 | platform-integration-manifest | manifest.yaml | uploaded | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-1 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
+---------------------+---------+-------------------------------+---------------+----------+-----------+ | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
| rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
#. Configure rook to use /dev/sdb disk on controller-0 as a ceph |OSD|. #. Configure rook to use /dev/sdb disk on controller-0 as a ceph |OSD|.

29
doc/source/deploy_install_guides/release/bare_metal/rook_storage_install_kubernetes.rst
View File

@ -703,14 +703,29 @@ On host storage-0 and storage-1:
:: ::
$ source /etc/platform/openrc $ source /etc/platform/openrc
$ system application-list
+---------------------+---------+-------------------------------+---------------+----------+-----------+ .. only:: starlingx
.. code-block:: none
~(keystone_admin)]$ system application-list
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+---------------------+---------+-------------------------------+---------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| oidc-auth-apps | 1.0-0 | oidc-auth-manifest | manifest.yaml | uploaded | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-8 | platform-integration-manifest | manifest.yaml | uploaded | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-1 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
+---------------------+---------+-------------------------------+---------------+----------+-----------+ | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
| rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
#. Edit values.yaml for rook-ceph-apps. #. Edit values.yaml for rook-ceph-apps.

29
doc/source/deploy_install_guides/release/virtual/aio_duplex_install_kubernetes.txt
View File

@ -514,14 +514,29 @@ On **virtual** controller-0 and controller-1:
:: ::
$ source /etc/platform/openrc $ source /etc/platform/openrc
$ system application-list
+---------------------+---------+-------------------------------+---------------+----------+-----------+ .. only:: starlingx
.. code-block:: none
~(keystone_admin)]$ system application-list
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+---------------------+---------+-------------------------------+---------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| oidc-auth-apps | 1.0-0 | oidc-auth-manifest | manifest.yaml | uploaded | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-8 | platform-integration-manifest | manifest.yaml | uploaded | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-1 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
+---------------------+---------+-------------------------------+---------------+----------+-----------+ | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
| rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
#. Configure Rook to use /dev/sdb on controller-0 and controller-1 as a ceph osd #. Configure Rook to use /dev/sdb on controller-0 and controller-1 as a ceph osd

29
doc/source/deploy_install_guides/release/virtual/aio_simplex_install_kubernetes.txt
View File

@ -357,14 +357,29 @@ On **virtual** controller-0:
:: ::
$ source /etc/platform/openrc $ source /etc/platform/openrc
$ system application-list
+---------------------+---------+-------------------------------+---------------+----------+-----------+ .. only:: starlingx
.. code-block:: none
~(keystone_admin)]$ system application-list
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+---------------------+---------+-------------------------------+---------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| oidc-auth-apps | 1.0-0 | oidc-auth-manifest | manifest.yaml | uploaded | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-8 | platform-integration-manifest | manifest.yaml | uploaded | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-1 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
+---------------------+---------+-------------------------------+---------------+----------+-----------+ | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
| rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
#. Configure rook to use /dev/sdb disk on controller-0 as a ceph osd #. Configure rook to use /dev/sdb disk on controller-0 as a ceph osd

30
doc/source/deploy_install_guides/release/virtual/rook_storage_install_kubernetes.rst
View File

@ -483,14 +483,30 @@ On virtual storage-0 and storage-1:
:: ::
$ source /etc/platform/openrc $ source /etc/platform/openrc
$ system application-list
+---------------------+---------+-------------------------------+---------------+----------+-----------+ .. only:: starlingx
.. code-block:: none
~(keystone_admin)]$ system application-list
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+---------------------+---------+-------------------------------+---------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| oidc-auth-apps | 1.0-0 | oidc-auth-manifest | manifest.yaml | uploaded | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-8 | platform-integration-manifest | manifest.yaml | uploaded | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-1 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
+---------------------+---------+-------------------------------+---------------+----------+-----------+ | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
| rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
#. Edit values.yaml for rook-ceph-apps. #. Edit values.yaml for rook-ceph-apps.

92
doc/source/fault-mgmt/kubernetes/enabling-snmp-support.rst
View File

@ -32,18 +32,28 @@ In order to enable and configure |SNMP|, complete the following steps.
already configured and enabled, see :ref:`Change Configuration of the SNMP already configured and enabled, see :ref:`Change Configuration of the SNMP
application <change-configuration-of-SNMP>` to make configuration changes. application <change-configuration-of-SNMP>` to make configuration changes.
.. only:: starlingx
.. code-block:: none .. code-block:: none
~(keystone)admin)$ system application-list ~(keystone)admin)$ system application-list
+--------------------------+---------+-------------------------------------------+------------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+--------------------------+---------+-------------------------------------------+------------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| cert-manager | 1.0-34 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| nginx-ingress-controller | 1.1-35 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| oidc-auth-apps | 1.0-68 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-52 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed | | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-17 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+---------+-------------------------------------------+------------------+----------+-----------+ | rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
#. In order to load the |SNMP| application definitions (FluxCD manifest and #. In order to load the |SNMP| application definitions (FluxCD manifest and
Helm charts), where **[snmp-<Major>.<Minor>-<Build>.tgz]**, for example, Helm charts), where **[snmp-<Major>.<Minor>-<Build>.tgz]**, for example,
@ -71,19 +81,28 @@ In order to enable and configure |SNMP|, complete the following steps.
#. List the |SNMP| application using the following command to see the status #. List the |SNMP| application using the following command to see the status
of the upload and wait for the upload to complete. of the upload and wait for the upload to complete.
.. only:: starlingx
.. code-block:: none .. code-block:: none
~(keystone)admin)$ system application-list ~(keystone)admin)$ system application-list
+--------------------------+---------+-------------------------------------------+------------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+--------------------------+---------+-------------------------------------------+------------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| cert-manager | 1.0-34 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| nginx-ingress-controller | 1.1-35 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| oidc-auth-apps | 1.0-68 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-52 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed | | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-17 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
| snmp | 1.0-36 | snmp-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
+--------------------------+---------+-------------------------------------------+------------------+----------+-----------+ | snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
#. Create a Helm chart values file (for example, ``user_conf.yaml``) with the #. Create a Helm chart values file (for example, ``user_conf.yaml``) with the
definition of the ``configmap:user_conf`` attribute, defining your |SNMP| definition of the ``configmap:user_conf`` attribute, defining your |SNMP|
@ -191,7 +210,7 @@ In order to enable and configure |SNMP|, complete the following steps.
| Property | Value | | Property | Value |
+---------------+----------------------------------+ +---------------+----------------------------------+
| active | False | | active | False |
| app_version | 1.0-36 | | app_version | 24.09-89 |
| created_at | 2022-06-27T10:45:42.733267+00:00 | | created_at | 2022-06-27T10:45:42.733267+00:00 |
| manifest_file | fluxcd-manifests | | manifest_file | fluxcd-manifests |
| manifest_name | snmp-fluxcd-manifests | | manifest_name | snmp-fluxcd-manifests |
@ -204,19 +223,28 @@ In order to enable and configure |SNMP|, complete the following steps.
#. List the |SNMP| application and check the status. Wait for the SNMP #. List the |SNMP| application and check the status. Wait for the SNMP
application to have fully started and is in the "applied" state. application to have fully started and is in the "applied" state.
.. only:: starlingx
.. code-block:: none .. code-block:: none
~(keystone)admin)$ system application-list ~(keystone)admin)$ system application-list
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| cert-manager | 1.0-34 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| nginx-ingress-controller | 1.1-35 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| oidc-auth-apps | 1.0-68 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-52 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed | | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-17 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
| snmp | 1.0-36 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed | | rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ | snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
#. Create a Helm chart values file (for example, ``snmp_port.yaml``) with UDP #. Create a Helm chart values file (for example, ``snmp_port.yaml``) with UDP
and TCP port mapping rules, for the nginx-ingress-controller application, and TCP port mapping rules, for the nginx-ingress-controller application,
@ -271,7 +299,7 @@ In order to enable and configure |SNMP|, complete the following steps.
| Property | Value | | Property | Value |
+---------------+--------------------------------------+ +---------------+--------------------------------------+
| active | True | | active | True |
| app_version | 1.0-52 | | app_version | 24.09-64 |
| created_at | 2022-06-26T21:21:47.428225+00:00 | | created_at | 2022-06-26T21:21:47.428225+00:00 |
| manifest_file | fluxcd-manifests | | manifest_file | fluxcd-manifests |
| manifest_name | platform-integ-apps-fluxcd-manifests | | manifest_name | platform-integ-apps-fluxcd-manifests |
@ -430,14 +458,14 @@ update its configuration.
| Property | Value | | Property | Value |
+---------------+----------------------------------+ +---------------+----------------------------------+
| active | False | | active | False |
| app_version | 1.0-36 | | app_version | 24.09-89 |
| created_at | 2022-06-27T10:45:42.733267+00:00 | | created_at | 2024-06-27T10:45:42.733267+00:00 |
| manifest_file | fluxcd-manifests | | manifest_file | fluxcd-manifests |
| manifest_name | snmp-fluxcd-manifests | | manifest_name | snmp-fluxcd-manifests |
| name | snmp | | name | snmp |
| progress | None | | progress | None |
| status | applying | | status | applying |
| updated_at | 2022-06-27T10:45:51.253949+00:00 | | updated_at | 2024-06-27T10:45:51.253949+00:00 |
+---------------+----------------------------------+ +---------------+----------------------------------+
.. _modifying-161udp-port: .. _modifying-161udp-port:
@ -501,7 +529,7 @@ Modify the external UDP port used for receiving |SNMP| requests.
| Property | Value | | Property | Value |
+---------------+-------------------------------------------+ +---------------+-------------------------------------------+
| active | True | | active | True |
| app_version | 1.1-35 | | app_version | 24.09-64 |
| created_at | 2022-06-26T20:49:02.437688+00:00 | | created_at | 2022-06-26T20:49:02.437688+00:00 |
| manifest_file | fluxcd-manifests | | manifest_file | fluxcd-manifests |
| manifest_name | nginx-ingress-controller-fluxcd-manifests | | manifest_name | nginx-ingress-controller-fluxcd-manifests |

90
doc/source/fault-mgmt/kubernetes/uninstalling-snmp.rst
View File

@ -9,19 +9,28 @@ Use the following procedure to uninstall |SNMP|:
#. Run the following command to check if the SNMP application is installed #. Run the following command to check if the SNMP application is installed
(status "applied"). (status "applied").
.. only:: starlingx
.. code-block:: none .. code-block:: none
~(keystone_admin)]$ system application-list ~(keystone)admin)$ system application-list
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| cert-manager | 1.0-34 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| nginx-ingress-controller | 1.1-35 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| oidc-auth-apps | 1.0-68 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-52 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed | | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-17 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
| snmp | 1.0-36 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed | | rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ | snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
#. Uninstall |SNMP|. #. Uninstall |SNMP|.
@ -32,8 +41,8 @@ Use the following procedure to uninstall |SNMP|:
| Property | Value | | Property | Value |
+---------------+----------------------------------+ +---------------+----------------------------------+
| active | False | | active | False |
| app_version | 1.0-36 | | app_version | 24.09-89 |
| created_at | 2022-06-27T10:45:42.733267+00:00 | | created_at | 2024-06-27T10:45:42.733267+00:00 |
| manifest_file | fluxcd-manifests | | manifest_file | fluxcd-manifests |
| manifest_name | snmp-fluxcd-manifests | | manifest_name | snmp-fluxcd-manifests |
| name | snmp | | name | snmp |
@ -44,19 +53,28 @@ Use the following procedure to uninstall |SNMP|:
The |SNMP| application is removed, but still shows as "Uploaded". The |SNMP| application is removed, but still shows as "Uploaded".
.. only:: starlingx
.. code-block:: none .. code-block:: none
~(keystone_admin)]$ system application-list ~(keystone)admin)$ system application-list
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| cert-manager | 1.0-34 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| nginx-ingress-controller | 1.1-35 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| oidc-auth-apps | 1.0-68 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-52 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed | | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-17 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
| snmp | 1.0-36 | snmp-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ | snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
#. Delete the uninstalled |SNMP| application definitions from the system. #. Delete the uninstalled |SNMP| application definitions from the system.
@ -69,15 +87,25 @@ Use the following procedure to uninstall |SNMP|:
#. Run the following command to check if the |SNMP| application is deleted. #. Run the following command to check if the |SNMP| application is deleted.
.. only:: starlingx
.. code-block:: none .. code-block:: none
~(keystone_admin)]$ system application-list ~(keystone)admin)$ system application-list
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| cert-manager | 1.0-34 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| nginx-ingress-controller | 1.1-35 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| oidc-auth-apps | 1.0-68 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-52 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed | | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-17 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ | rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end

5
doc/source/security/kubernetes/the-cert-manager-bootstrap-process.rst
View File

@ -76,8 +76,9 @@ web pages:
- ``nginx-ingress-controller`` - ``nginx-ingress-controller``
`https://github.com/kubernetes/ingress-nginx/blob/controller-v1.1.1/charts/ingress-nginx/values.yaml <https://github.com/kubernetes/ingress-nginx/blob/controller-v1.1.1/charts/ingress-nginx/values.yaml>`__ `https://github.com/kubernetes/ingress-nginx/blob/helm-chart-4.11.1/charts/ingress-nginx/values.yaml <https://github.com/kubernetes/ingress-nginx/blob/helm-chart-4.11.1/charts/ingress-nginx/values.yaml>`__
- ``cert-manager`` - ``cert-manager``
`https://github.com/cert-manager/cert-manager/blob/release-1.7/deploy/charts/cert-manager/values.yaml <https://github.com/cert-manager/cert-manager/blob/release-1.7/deploy/charts/cert-manager/values.yaml>`__ `https://github.com/cert-manager/cert-manager/blob/v1.15.3/deploy/charts/cert-manager/values.yaml <https://github.com/cert-manager/cert-manager/blob/v1.15.3/deploy/charts/cert-manager/values.yaml>`__

124
doc/source/system_configuration/kubernetes/application-commands-and-helm-overrides.rst
View File

@ -39,16 +39,24 @@ commands to manage containerized applications provided as part of |prod|.
.. parsed-literal:: .. parsed-literal::
~(keystone_admin)]$ system application-list --nowrap ~(keystone_admin)]$ system application-list
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
+--------------------------+---------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+--------------------------+---------+-------------------------------------------+------------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| cert-manager | 1.0-34 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| nginx-ingress-controller | 1.1-35 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| oidc-auth-apps | 1.0-68 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-52 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed | | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
+--------------------------+---------+-------------------------------------------+------------------+----------+-----------+ | platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
| rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
``application-show`` ``application-show``
Use the following command to show details for |prod|. Use the following command to show details for |prod|.
@ -62,26 +70,13 @@ commands to manage containerized applications provided as part of |prod|.
**<app_name>** **<app_name>**
is the name of the application to show details for. is the name of the application to show details for.
For example: For example, run the following command to show details of the ``cert-manager``
application.
.. parsed-literal:: .. code-block:: none
~(keystone_admin)]$ system application-show cert-manager ~(keystone_admin)]$ system application-show cert-manager
+---------------+----------------------------------+
| Property | Value |
+---------------+----------------------------------+
| active | True |
| app_version | 1.0-34 |
| created_at | 2022-06-21T02:21:24.218835+00:00 |
| manifest_file | fluxcd-manifests |
| manifest_name | cert-manager-fluxcd-manifests |
| name | cert-manager |
| progress | completed |
| status | applied |
| updated_at | 2022-06-21T03:13:01.051293+00:00 |
+---------------+----------------------------------+
``application-upload`` ``application-upload``
Use the following command to upload application Helm chart\(s) and Use the following command to upload application Helm chart\(s) and
manifest. manifest.
@ -105,25 +100,11 @@ commands to manage containerized applications provided as part of |prod|.
is the path to the tar file containing the application to be uploaded. is the path to the tar file containing the application to be uploaded.
For example: Run the following command to upload the application contained in the tar file.
.. parsed-literal:: .. code-block:: none
~(keystone_admin)]$ system application-upload metrics-server-1.0-17.tgz ~(keystone_admin)]$ system application-upload metrics-server-*.tgz
+---------------+----------------------------------+
| Property | Value |
+---------------+----------------------------------+
| active | False |
| app_version | 1.0-17 |
| created_at | 2022-06-21T15:40:36.152383+00:00 |
| manifest_file | fluxcd-manifests |
| manifest_name | metrics-server-fluxcd-manifests |
| name | metrics-server |
| progress | None |
| status | uploading |
| updated_at | None |
+---------------+----------------------------------+
Please use 'system application-list' or 'system application-show metrics-server' to view the current progress.
``helm-override-list`` ``helm-override-list``
To list the Helm chart overrides for the |prod|, use the following To list the Helm chart overrides for the |prod|, use the following
@ -354,25 +335,11 @@ commands to manage containerized applications provided as part of |prod|.
**<app_name>** **<app_name>**
is the name of the application to apply. is the name of the application to apply.
For example: For example, run the following command to apply the ``metrics-server`` application.
.. parsed-literal:: .. code-block:: none
~(keystone_admin)]$ system application-apply metrics-server ~(keystone_admin)]$ system application-apply metrics-server
+---------------+----------------------------------+
| Property | Value |
+---------------+----------------------------------+
| active | False |
| app_version | 1.0-17 |
| created_at | 2022-06-21T15:40:36.152383+00:00 |
| manifest_file | fluxcd-manifests |
| manifest_name | metrics-server-fluxcd-manifests |
| name | metrics-server |
| progress | None |
| status | applying |
| updated_at | 2022-06-21T15:40:42.727918+00:00 |
+---------------+----------------------------------+
Please use 'system application-list' or 'system application-show metrics-server' to view the current progress.
``application-abort`` ``application-abort``
Use the following command to abort the current application. Use the following command to abort the current application.
@ -423,14 +390,23 @@ commands to manage containerized applications provided as part of |prod|.
.. code-block:: none .. code-block:: none
~(keystone_admin)]$ system application-list ~(keystone_admin)]$ system application-list
+--------------------------+---------+-------------------------------------------+------------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+--------------------------+---------+-------------------------------------------+------------------+----------+-----------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| cert-manager | 1.0-34 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| nginx-ingress-controller | 1.1-35 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| oidc-auth-apps | 1.0-68 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-52 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed | | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
+--------------------------+---------+-------------------------------------------+------------------+----------+-----------+ | platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
| rook-ceph | 24.09-48 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-89 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
The output indicates that the currently installed version of **cert-manager** is 1.0-34. The output indicates that the currently installed version of **cert-manager** is 1.0-34.
@ -467,25 +443,11 @@ commands to manage containerized applications provided as part of |prod|.
**<app_name>** **<app_name>**
is the name of the application to remove. is the name of the application to remove.
For example: For example, run the following command to remove the ``metric-server`` application.
.. parsed-literal:: .. code-block:: none
~(keystone_admin)]$ system application-remove metrics-server ~(keystone_admin)]$ system application-remove metrics-server
+---------------+----------------------------------+
| Property | Value |
+---------------+----------------------------------+
| active | False |
| app_version | 1.0-17 |
| created_at | 2022-06-21T15:40:36.152383+00:00 |
| manifest_file | fluxcd-manifests |
| manifest_name | metrics-server-fluxcd-manifests |
| name | metrics-server |
| progress | None |
| status | removing |
| updated_at | 2022-06-21T15:45:55.204697+00:00 |
+---------------+----------------------------------+
Please use 'system application-list' or 'system application-show metrics-server' to view the current progress.
This command places the application in the uploaded state. This command places the application in the uploaded state.

56
doc/source/system_configuration/kubernetes/check-new-registry-and-reapply-application.rst
View File

@ -39,23 +39,23 @@ to controller-1 and perform the same steps.
.. code-block:: none .. code-block:: none
~(keystone_admin)]$ system registry-image-tags quay.io/kubernetes-ingress-controller/nginx-ingress-controller ~(keystone_admin)]$ system registry-image-tags registry.k8s.io/ingress-nginx/controller
+-----------+ +-----------+
| Image Tag | | Image Tag |
+-----------+ +-----------+
| 0.23.0 | | v1.11.1 |
+-----------+ +-----------+
system registry-image-delete quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.23.0 system registry-image-delete registry.k8s.io/ingress-nginx/controller:v1.11.1
system registry-garbage-collect system registry-garbage-collect
crictl images ls | grep quay.io/kubernetes-ingress-controller/nginx-ingress-controller crictl images ls | grep registry.k8s.io/ingress-nginx/controller
registry.local:9001/quay.io/kubernetes-ingress-controller/nginx-ingress-controller 0.23.0 42d47fe0c78f5 242MB registry.local:9001/registry.k8s.io/ingress-nginx/controller v1.11.1 5a3c471280784 105MB 42d47fe0c78f5 242MB
crictl rmi registry.local:9001/quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.23.0 crictl rmi registry.local:9001/registry.k8s.io/ingress-nginx/controller:v1.11.1
# Note an error on this step means there is no image in the cache # Note an error on this step means there is no image in the cache
# SSH to controller-1 (or the standby controller) # SSH to controller-1 (or the standby controller)
crictl rmi registry.local:9001/quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.23.0 crictl rmi registry.local:9001/registry.k8s.io/ingress-nginx/controller:v1.11.1
.. note:: .. note::
@ -73,28 +73,38 @@ to controller-1 and perform the same steps.
.. parsed-literal:: .. parsed-literal::
sysinv 2020-09-09 23:42:23.476 14930 INFO sysinv.conductor.kube_app [-] Image registry.local:9001/quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.23.0 is not available in local registry, download started from public/private registry sysinv 2024-10-09 23:42:23.476 14930 INFO sysinv.conductor.kube_app [-] Image registry.local:9001/registry.k8s.io/ingress-nginx/controller:v1.11.1 is not available in local registry, download started from public/private registry
sysinv 2020-09-09 23:42:23.526 14930 INFO sysinv.conductor.kube_app [-] Image registry.local:9001/k8s.gcr.io/defaultbackend:|v_defaultbackend-amd64| download succeeded in 0 seconds sysinv 2024-10-09 23:42:23.526 14930 INFO sysinv.conductor.kube_app [-] Image registry.local:9001/registry.k8s.io/defaultbackend-amd64:1.5 download succeeded in 0 seconds
sysinv 2020-09-09 23:43:10.226 14930 INFO sysinv.conductor.kube_app [-] Remove image <hostname>:5001/<quay.io path>/quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.23.0 after push to local registry. sysinv 2024-10-09 23:43:10.226 14930 INFO sysinv.conductor.kube_app [-] Remove image <hostname>:5001/registry.k8s.io/ingress-nginx/controller:v1.11.1 after push to local registry.
sysinv 2020-09-09 23:43:10.595 14930 INFO sysinv.conductor.kube_app [-] Image registry.local:9001/quay.io/kubernetes-ingress-controller/nginx-ingress-controller:0.23.0 download succeeded in 47 seconds sysinv 2024-10-09 23:43:10.595 14930 INFO sysinv.conductor.kube_app [-] Image registry.local:9001/registry.k8s.io/ingress-nginx/controller:v1.11.1 download succeeded in 47 seconds
sysinv 2020-09-09 23:43:10.596 14930 INFO sysinv.conductor.kube_app [-] All docker images for application nginx-ingress-controller were successfully downloaded in 50 seconds sysinv 2024-10-09 23:43:10.596 14930 INFO sysinv.conductor.kube_app [-] All docker images for application nginx-ingress-controller were successfully downloaded in 50 seconds
#. Validate that the application is running: #. Validate that the application is running:
.. begin-eg-system-aplication-list .. begin-eg-system-aplication-list
.. only:: starlingx
.. code-block:: none .. code-block:: none
~(keystone_admin)]$ system application-list ~(keystone)admin)$ system application-list
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| application | version | manifest name | manifest file | status | progress | | application | version | manifest name | manifest file | status | progress |
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ +--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
| cert-manager | 1.0-34 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed | | cert-manager | 24.09-79 | cert-manager-fluxcd-manifests | fluxcd-manifests | applied | completed |
| nginx-ingress-controller | 1.1-35 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed | | dell-storage | 24.09-25 | dell-storage-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| oidc-auth-apps | 1.0-68 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed | | nginx-ingress-controller | 24.09-64 | nginx-ingress-controller-fluxcd-manifests | fluxcd-manifests | applied | completed |
| platform-integ-apps | 1.0-52 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed | | oidc-auth-apps | 24.09-59 | oidc-auth-apps-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| rook-ceph-apps | 1.0-17 | rook-ceph-manifest | manifest.yaml | uploaded | completed | | platform-integ-apps | 24.09-141 | platform-integ-apps-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+---------+-------------------------------------------+------------------+----------+----------------------+ | rook-ceph | 24.09-40 | rook-ceph-fluxcd-manifests | fluxcd-manifests | uploaded | completed |
| snmp | 24.09-88 | snmp-fluxcd-manifests | fluxcd-manifests | applied | completed |
+--------------------------+-----------+-------------------------------------------+------------------+----------+-----------+
.. only:: partner
.. include:: /_includes/system-application-list.rest
:start-after: system-application-list-begin
:end-before: system-application-list-end
.. end-eg-system-aplication-list .. end-eg-system-aplication-list
@ -102,11 +112,11 @@ to controller-1 and perform the same steps.
.. code-block:: none .. code-block:: none
~(keystone_admin)]$ system registry-image-tags quay.io/kubernetes-ingress-controller/nginx-ingress-controller ~(keystone_admin)]$ system registry-image-tags registry.k8s.io/ingress-nginx/controller
+-----------+ +-----------+
| Image Tag | | Image Tag |
+-----------+ +-----------+
| 0.23.0 | | v1.11.1 |
+-----------+ +-----------+