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