Files
docs/doc/source/dist_cloud/kubernetes/configuration-for-specific-subclouds.rst
Ron Stone ab2c5331c8 Apply dir convention to DC
Moved all DC content under a kubernetes directory. This is needed
to allow title versioning distinctions in partner builds.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Ia7ab4fccc7cb9ed6c242cf584f237165f00e5ef2
(cherry picked from commit 10805c3e8f)

Move files into 'kuberneres' subdir

Needed for compatability with downstream builds per master 10805c3

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I4a15a09217584795274887837318113deabf1f9d
Signed-off-by: Ron Stone <ronald.stone@windriver.com>
2021-09-03 17:19:18 +00:00

6.0 KiB

Configuration for Specific Subclouds

To determine how upgrades are applied to the nodes on each subcloud, the upgrade strategy refers to separate configuration settings.

The following settings are applied by default:

  • storage apply type: parallel
  • worker apply type: parallel
  • max parallel workers: 10
  • alarm restriction type: relaxed
  • default instance action: migrate (This parameter is only applicable to hosted application with the stx-openstack application.)

To update the default values, use the dcmanager strategy-config update command. You can also use this command to configure custom behavior for individual subclouds.

  • To list the default upgrade strategy and any custom configurations configured for individual subclouds, use the strategy-config list command.

    For example:

    ~(keystone_admin)]$ dcmanager strategy-config list
    +--------------------+--------------------+--------------------+-----------------------+------------------------+------------------+
    | cloud              | storage apply type | worker apply type  | max parallel workers  | alarm restriction type | default instance |
    |                    |                    |                    |                       |                        | action           |
    +--------------------+--------------------+--------------------+-----------------------+------------------------+------------------+
    | all clouds default | parallel           | parallel           |                    10 | relaxed                | migrate          |
    | subcloud-6         | parallel           | parallel           |                     2 | relaxed                | stop-start       |
    +--------------------+--------------------+--------------------+-----------------------+------------------------+------------------+
  • To show the configuration settings applicable to all subclouds by default, use the strategy-config show command.

    ~(keystone_admin)]$ dcmanager strategy-config show
    +-------------------------+--------------------+
    | Field                   | Value              |
    +-------------------------+--------------------+
    | cloud                   | all clouds default |
    | storage apply type      | parallel           |
    | worker apply type       | parallel           |
    | max parallel workers    | 10                 |
    | alarm restriction type  | relaxed            |
    | default instance action | migrate            |
    | created_at              | None               |
    | updated_at              | None               |
    +-------------------------+--------------------+
  • To update the settings, or to create a custom configuration for a subcloud, use the strategy-config update command.

    ~(keystone_admin)]$ dcmanager strategy-config update \
     \
    --storage-apply-type <type> \
    --worker-apply-type <type> \
    --max-parallel-workers <i> \
    --alarm-restriction-type <level> \
    --default-instance-action <action> \
    [<subcloud_name>]

    where

    storage apply type

    parallel or serial — determines whether storage nodes are upgraded in parallel or serially.

    worker apply type

    parallel or serial — determines whether worker nodes are upgraded in parallel or serially.

    max parallel workers

    Set the maximum number of worker nodes that can be upgraded in parallel.

    alarm restriction type

    relaxed or strict — determines whether the orchestration is aborted for alarms that are not management-affecting. For more information, refer to the

default instance action

Note

This parameter is only applicable to hosted application with the stx-openstack application.

migrate or stop-start — determines whether hosted application are migrated or stopped and restarted when a worker host is upgraded

subcloud_name

The name of the subcloud to use the custom strategy. If this omitted, the default upgrade strategy is updated.

Note

You must specify all of the settings.

  • To show the configuration settings for a subcloud, use the strategy-config show <subcloud> command.

    ~(keystone_admin)]$ dcmanager strategy-config show [<name>]

    For example:

    ~(keystone_admin)]$ dcmanager strategy-config show subcloud-6
    +-------------------------+----------------------------+
    | Field                   | Value                      |
    +-------------------------+----------------------------+
    | cloud                   | subcloud-6                 |
    | storage apply type      | parallel                   |
    | worker apply type       | parallel                   |
    | max parallel workers    | 2                          |
    | alarm restriction type  | relaxed                    |
    | default instance action | stop-start                 |
    | created_at              | 2020-03-12 20:08:48.917866 |
    | updated_at              | None                       |
    +-------------------------+----------------------------+

    If custom configuration settings have not been created for the subcloud, the following message is displayed:

    ERROR (app) No options found for Subcloud with id 1, defaults will be
    used.