ironic-inspector/doc/source/cli/ironic-inspector-status.rst
Julia Kreger 901c816b23 Add upgrade check, and json2yaml policy handling
Adds the ironic-inspector-status command as well with the
requried upgrade check.

Mostly based upon https://review.opendev.org/#/c/763262/
which is based upon https://review.opendev.org/#/c/748059/

Note: Also had to update the version of eventlet because
existing minimum requirement was seemingly incompatible with
prior versions and would prevent lower constraints testing
to proceed due to issues with ``os`` being patched by eventlet.

Change-Id: I1f479f834f1d79e9eeb591c58a52b6ab80c24534
2021-01-04 13:56:28 -08:00

2.1 KiB

ironic-inspector-status

Synopsis

ironic-inspector-status <category> <command> [<args>]

Description

ironic-inspector-status is a tool that provides routines for checking the status of the ironic-inspector deployment.

Options

The standard pattern for executing a ironic-inspector-status command is:

ironic-inspector-status <category> <command> [<args>]

Run without arguments to see a list of available command categories:

ironic-inspector-status

Categories are:

  • upgrade

Detailed descriptions are below.

You can also run with a category argument such as upgrade to see a list of all commands in that category:

ironic-inspector-status upgrade

These sections describe the available categories and arguments for ironic-inspector-status.

Upgrade

ironic-status upgrade check

Performs a release-specific readiness check before restarting services with new code. This command expects to have complete configuration and access to databases and services.

Return Codes

Return code Description
0 All upgrade readiness checks passed successfully and there is nothing to do.
1 At least one check encountered an issue and requires further investigation. This is considered a warning but the upgrade may be OK.
2 There was an upgrade status check failure that needs to be investigated. This should be considered something that stops an upgrade.
255 An unexpected error occurred.

History of Checks

Wallaby

  • Adds initial status check command as it was not previously needed as the database structure and use of ironic-inspector's of ironic-inspector did not require the command previously.
  • Adds a check to validate the configured policy file is not JSON based as JSON based policies have been deprecated.