starlingx/docs
Code Issues Proposed changes
docs/doc/source/updates/openstack/apply-update-to-the-openstack-application.rst
Rafael Falcao 75b4f9f0b4 Update stx-openstack related docs with armada deprecation 
Since armada (deprecated) is being replaced by FluxCD in the
stx-openstack application [1], it is needed to also replace
the mentions of Armada in the stx-openstack related docs to
FluxCD.

[1] - https://review.opendev.org/c/starlingx/openstack-armada-app/+/862516

Signed-off-by: Rafael Falcao <rafael.vieirafalcao@windriver.com>
Change-Id: I0b2959630c970b51979db5eaefa81d59db477125
2022-10-28 15:50:00 -03:00

4.7 KiB
Raw Blame History

Apply Update to the OpenStack Application

is managed using the StarlingX Application Package Manager.

Use the StarlingX Application Package Manager application-update command to perform an update.

~(keystone_admin)$ system application-update [-n | --app-name] <app_name>
[-v | --app-version] <version> <tar_file>

where the following are optional arguments:

<app_name>

The name of the application to update.

You can look up the name of an application using the application-list command:

~(keystone_admin)$ system application-list +--------------------------+-----------+-------------------------------+---------------------------+----------+-----------+ | application | version | manifest name | manifest file | status | progress | +--------------------------+-----------+-------------------------------+---------------------------+----------+-----------+ | cert-manager | 20.06-5 | cert-manager-manifest | certmanager-manifest.yaml | applied | completed | | nginx-ingress-controller | 20.06-0 | nginx-ingress-controller- | nginx_ingress_controller | applied | completed | | | | -manifest | _manifest.yaml | | | | oidc-auth-apps | 20.06-28 | oidc-auth-manifest | manifest.yaml | uploaded | completed | | platform-integ-apps | 20.06-11 | platform-integration-manifest | manifest.yaml | applied | completed | | -openstack | 21.07-0- | stx-openstack-fluxcd-manifests| -openstack.yaml | applied | completed | | | centos- | | | | | | | stable- | | | | | | | versioned | | | | | +--------------------------+-----------+-------------------------------+---------------------------+----------+-----------+

The output indicates that the currently installed version of -openstack is 21.07-0.

<version>

The version to update the application to.

and the following is a positional argument which must come last:

<tar_file>

The tar file containing the application manifest, Helm charts and configuration file.

Note

In a configuration the System Controllers should be upgraded before the subclouds.

  1. Retrieve the latest application tarball, -openstack-<major>.<minor>-patch.tgz, from .

    Note

    The major-minor version is based on the current product release version. The patch version will change within the release based on incremental updates.

  2. Source the environment.

    $ source /etc/platform/openrc
~(keystone_admin)$

  3. Update the application.

    This will upload the software version and automatically apply it to the system.

    For example:

    ~(keystone_admin)$ system application-update -openstack-21.07-0.tgz

  4. Monitor the status of the application-apply operation until it has completed successfully.

    ~(keystone_admin)$ system application-show -openstack +---------------+----------------------------------+ | Property | Value | +---------------+----------------------------------+ | active | True | | app_version | 21.07-0 | | created_at | 2020-05-02T17:11:48.718963+00:00 | | manifest_file | -openstack.yaml | | manifest_name | stx-openstack-fluxcd-manifests | | name | -openstack | | progress | completed | | status | applied | | updated_at | 2020-05-02T17:44:40.152201+00:00 | +---------------+----------------------------------+