Using Jujuna

Deploy a local bundle, execute upgrade procedure, run the deployment through a suite of tests to ensure that it can handle the types of operations and failures that are common for all deployments.

usage: jujuna [-h] {deploy,upgrade,test,clean} ...

Positional Arguments

action

Possible choices: deploy, upgrade, test, clean

Action to be executed

Sub-commands:

deploy

Deploy a local bundle to the current or selected model

jujuna deploy [-h] [-c CTRL_NAME] [-m MODEL_NAME] [-w] [-t TIMEOUT]
              [--error-timeout ERROR_TIMEOUT] [--endpoint ENDPOINT]
              [--username USERNAME] [--password PASSWORD] [--cacert CACERT]
              [--debug]
              bundle_file

Positional Arguments

bundle_file Path to bundle file (i.e. bundle.yaml)

Named Arguments

-c, --controller
 Controller (def: current)
-m, --model Model to use instead of current
-w, --wait

Wait for deploy to finish

Default: False

-t, --timeout

Timeout after N seconds.

Default: 0

--error-timeout
 

Timeout after N seconds in error state.

Default: 1800

--endpoint Juju endpoint (requires model uuid instead of name)
--username Juju username
--password Juju password
--cacert Juju CA certificate
--debug

Log level debug.

Default: False

upgrade

Upgrade applications deployed in the current or selected model

jujuna upgrade [-h] [-c CTRL_NAME] [-m MODEL_NAME] [-o ORIGIN]
               [-a [APPS [APPS ...]]] [-i] [-p] [-e] [--upgrade-only]
               [--charms-only] [--upgrade-action UPGRADE_ACTION]
               [--upgrade-params UPGRADE_PARAMS] [--origin-keys ORIGIN_KEYS]
               [--dry-run] [-t TIMEOUT] [-s SETTINGS] [--endpoint ENDPOINT]
               [--username USERNAME] [--password PASSWORD] [--cacert CACERT]
               [--debug]

Named Arguments

-c, --controller
 Controller (def: current)
-m, --model Model to use instead of current
-o, --origin
Openstack origin:
‘cloud:xenial-newton’, ‘cloud:xenial-ocata’, ‘cloud:xenial-pike’, ‘cloud:xenial-queens’, ‘cloud:bionic-rocky’, ‘cloud:bionic-stein’, ‘cloud:bionic-train’,

Default: “”

-a, --apps

Apps to be upgraded (ordered)

Default: []

-i, --ignore-errors
 

Ignore errors during charms upgrade and continue with upgrade procedure

Default: False

-p, --pause

Pause unit before upgrade (incl. HA)

Default: False

-e, --evacuate

Evacuate nova-compute nodes during upgrade

Default: False

--upgrade-only

Upgrade using upgrade hooks without changing the revision

Default: False

--charms-only

Upgrade only charms without running upgrade hooks

Default: False

--upgrade-action
 Action name to upgrade application
--upgrade-params
 Action parameters comma separated e.g. ‘service=name,version=2’
--origin-keys Config keys to set origin in apps e.g. ‘ceph-mon=source,ceph-mon=source’
--dry-run

Dry run - only show changes without upgrading

Default: False

-t, --timeout

Timeout after N seconds.

Default: 0

-s, --settings Path to settings file that overrides default settings (i.e. settings.yaml)
--endpoint Juju endpoint (requires model uuid instead of name)
--username Juju username
--password Juju password
--cacert Juju CA certificate
--debug

Log level debug.

Default: False

test

Test applications in the current or selected model

jujuna test [-h] [-c CTRL_NAME] [-m MODEL_NAME] [-t TIMEOUT]
            [--endpoint ENDPOINT] [--username USERNAME] [--password PASSWORD]
            [--cacert CACERT] [--debug]
            test_suite

Positional Arguments

test_suite Path to test suite (i.e. ceph/suite.yaml)

Named Arguments

-c, --controller
 Controller (def: current)
-m, --model Model to use instead of current
-t, --timeout

Timeout after N seconds.

Default: 0

--endpoint Juju endpoint (requires model uuid instead of name)
--username Juju username
--password Juju password
--cacert Juju CA certificate
--debug

Log level debug.

Default: False

clean

Clean the model by removing all applications present in the current or selected model

jujuna clean [-h] [-c CTRL_NAME] [-m MODEL_NAME] [-w] [-f]
             [-i [IGNORE [IGNORE ...]]] [--dry-run] [-t TIMEOUT]
             [--endpoint ENDPOINT] [--username USERNAME] [--password PASSWORD]
             [--cacert CACERT] [--debug]

Named Arguments

-c, --controller
 Controller (def: current)
-m, --model Model to use instead of current
-w, --wait

Wait for deploy to finish

Default: False

-f, --force

Force cleanup (remove all machines in the model).

Default: False

-i, --ignore

Apps to be ignored during removal

Default: []

--dry-run

Dry run - only show changes without removing applications

Default: False

-t, --timeout

Timeout after N seconds.

Default: 0

--endpoint Juju endpoint (requires model uuid instead of name)
--username Juju username
--password Juju password
--cacert Juju CA certificate
--debug

Log level debug.

Default: False