☰
Conductor Documentation

Conductor StarlingX Plugin

Conductor StarlingX Plugin enables users to orchestrate StarlingX workflows from a Cloudify manager.

Pre-Check workflows

Set up the Pre-Check

  1. Upload the starlingx plugin and the blueprint.
  2. Create a deployment using the blueprint.
  3. On that new deployment, run the “Audit Host Upgradable” workflow.
  4. The pre-check report will be available in the output/capabilities in the key pre_check_report.

Pre-Check Merge

This plugin implements a workflow to fetch all pre-check reports from all wrcp deployments and merge them. In order to do it, install the plugin conductor-precheck-merge-plugin, and upload the blueprint available using the GUI or CLI (cfy blueprints upload [options] BLUEPRINT_PATH).

Then, create a deployment from the uploaded blueprint and run the Pre Check Merge workflow. The output will be the merged to pre_check_report.

Custom workflows

upload_and_apply_patch

Workflow to install patches. It includes steps: - upload patch - apply patch - create subcloud patch strategy - execute apply action on created strategy

Parameters: - patch_dir - path to directory on the manager which contains patches to apply

refresh_status

Workflow starts check_update_status on each subcloud.

check_update_status

Checking status of strategy steps and update labels if failed/complete.

upgrade

IMPORTANT

Before start workflow make sure that below files does not exist on controller-0. These will be automatically copied from the load installed during the upgrade. - ~/wind-river-cloud-platform-deployment-manager-overrides.yaml - ~/wind-river-cloud-platform-deployment-manager.tgz - ~/wind-river-cloud-platform-deployment-manager.yaml

Workflow to upgrade sw version on nodes, deployment managers and subcloud. It contains steps: - upgrade controllers: - 1.Install license for new release - 2.Upload ISO and SIG files to controller-0 - 3.Start upgrade proces - 4.Verify that upgrade has started - 5.Lock controller-1 - 7.Check upgrade status - 8.Unlock controller-1 In case of HA: - 11.Set controller-1 as active controller - 12.Wait for all services on controller-1 are enabled-active, the swact is complete - 13.Lock controller-0 - 14.Upgrade controller-0 - 15.Unlock Controller-0 - upgrade workers and storages (if present) - upgrade deployment manager - upgrade each subcloud: - create subcloud upgrade strategy - execute apply action on created strategy

Parameters: - sw_version - version of software - license_file_path - path to license file on the manager - iso_path - path to iso on the manager - type_of_strategy - type of strategy (must be equal to upgrade) - subcloud_apply_type - type of apply type (parallel/serial) - strategy_action - action name (apply) - stop_on_failure - stop execution on failure - force_flag - force execution

Tests

Setup

Install the test requirements:

Install the package:

python -m pip install -e .```

Run

Run this command: python -m pytest -s