Command Line

unfurl

unfurl [OPTIONS] COMMAND [ARGS]...

Options

--home <home>

Path to .unfurl_home

--runtime <runtime>

use this runtime

--no-runtime

ignore runtime settings

-v, --verbose

verbose mode (-vvv for more)

-q, --quiet

Only output errors to the stdout

--logfile <logfile>

Log messages to file (at DEBUG level)

--tmp <tmp>

Directory for saving temporary files

--loglevel <loglevel>

log level (overrides -v)

Environment variables

UNFURL_HOME

Provide a default for --home

UNFURL_RUNTIME

Provide a default for --runtime

UNFURL_NORUNTIME

Provide a default for --no-runtime

UNFURL_TMPDIR

Provide a default for --tmp

UNFURL_LOGGING

Provide a default for --loglevel

check

Check and update the status of the ensemble’s instances

unfurl check [OPTIONS] [ENSEMBLE]

Options

--destroyunmanaged

include unmanaged instances for consideration when destroying

--starttime <starttime>

Set the start time of the job.

--output <output>

How to print summary of job run

Options

text | json | none

--trace <trace>

Set the query’s trace level

--query <query>

Run the given expression upon job completion

--instance <instance>

instance name to target

--template <template>

TOSCA template to target

--jobexitcode <jobexitcode>

Set exit code to 1 if job status is not ok.

Options

error | degraded | never

-m, --message <message>

commit message to use

--dirty <dirty>

Action if there are uncommitted changes before run. (Default: auto)

Options

abort | ok | auto

--commit

Commit modified files to the instance repository. (Default: false)

--dryrun

Do not modify anything, just do a dry run.

Arguments

ENSEMBLE

Optional argument

clone

Create a new ensemble or project from a service template or an existing ensemble or project.

SOURCE Path or git url to a project, ensemble, or service template

DEST Path to the new project or ensemble

unfurl clone [OPTIONS] SOURCE [DEST]

Options

--mono

Create one repository for the project.

--existing

Add project to nearest existing repository.

Arguments

SOURCE

Required argument

DEST

Optional argument

commit

Commit any outstanding changes to this ensemble.

unfurl commit [OPTIONS]

Options

--ensemble <ensemble>
-m, --message <message>

commit message to use

--no-edit

Use default message instead of invoking the editor

--skip-add

Don’t add files for committing (if set, must first manually add)

deploy

Deploy the given ensemble

unfurl deploy [OPTIONS] [ENSEMBLE]

Options

--destroyunmanaged

include unmanaged instances for consideration when destroying

--starttime <starttime>

Set the start time of the job.

--output <output>

How to print summary of job run

Options

text | json | none

--trace <trace>

Set the query’s trace level

--query <query>

Run the given expression upon job completion

--instance <instance>

instance name to target

--template <template>

TOSCA template to target

--prune

destroy instances that are no longer used

--force

(re)run operation regardless of instance’s status or state

--upgrade

run configurations with major version changes or whose spec has changed

--repair <repair>

re-run configurations that are in an error or degraded state

Options

error | degraded | missing | none

--update

run configurations that whose spec has changed but don’t require a major version change

--add

run newly added configurations

--jobexitcode <jobexitcode>

Set exit code to 1 if job status is not ok.

Options

error | degraded | never

-m, --message <message>

commit message to use

--dirty <dirty>

Action if there are uncommitted changes before run. (Default: auto)

Options

abort | ok | auto

--commit

Commit modified files to the instance repository. (Default: false)

--dryrun

Do not modify anything, just do a dry run.

Arguments

ENSEMBLE

Optional argument

discover

Run the “discover” workflow which updates the ensemble’s spec by probing its live instances.

unfurl discover [OPTIONS] [ENSEMBLE]

Options

--destroyunmanaged

include unmanaged instances for consideration when destroying

--starttime <starttime>

Set the start time of the job.

--output <output>

How to print summary of job run

Options

text | json | none

--trace <trace>

Set the query’s trace level

--query <query>

Run the given expression upon job completion

--instance <instance>

instance name to target

--template <template>

TOSCA template to target

--jobexitcode <jobexitcode>

Set exit code to 1 if job status is not ok.

Options

error | degraded | never

-m, --message <message>

commit message to use

--dirty <dirty>

Action if there are uncommitted changes before run. (Default: auto)

Options

abort | ok | auto

--commit

Commit modified files to the instance repository. (Default: false)

--dryrun

Do not modify anything, just do a dry run.

Arguments

ENSEMBLE

Optional argument

git

unfurl git –dir=/path/to/start [gitoptions] [gitcmd] [gitcmdoptions]: Runs command on each project repository.

unfurl git [OPTIONS] [GITARGS]...

Options

--dir <dir>

path to spec repository

Arguments

GITARGS

Optional argument(s)

git-status

Show the git status for repository paths that are relevant to this ensemble.

unfurl git-status [OPTIONS]

Options

--ensemble <ensemble>
--dirty

Only show repositories with uncommitted changes

help

Get help on a command

unfurl help [OPTIONS] [CMD]

Arguments

CMD

Optional argument

home

If no options are set, display the location of current unfurl home. To create a new home project use –init and the global –home option.

unfurl home [OPTIONS]

Options

--render

Generate files only (don’t create repository)

--init

Create a new home project

--replace

Replace (and backup) current home project

init

Create a new project or, if [project_dir] exists or is inside a project, create a new ensemble

unfurl init [OPTIONS] [PROJECTDIR]

Options

--mono

Create one repository for the project.

--existing

Add project to nearest existing repository.

--submodule

Set the ensemble repository as a git submodule.

--empty

Don’t create a default ensemble.

--template <template>

Absolute path to a directory of project templates.

Arguments

PROJECTDIR

Optional argument

plan

Print the given deployment plan

unfurl plan [OPTIONS] [ENSEMBLE]

Options

--destroyunmanaged

include unmanaged instances for consideration when destroying

--starttime <starttime>

Set the start time of the job.

--output <output>

How to print summary of job run

Options

text | json | none

--trace <trace>

Set the query’s trace level

--query <query>

Run the given expression upon job completion

--instance <instance>

instance name to target

--template <template>

TOSCA template to target

--prune

destroy instances that are no longer used

--force

(re)run operation regardless of instance’s status or state

--upgrade

run configurations with major version changes or whose spec has changed

--repair <repair>

re-run configurations that are in an error or degraded state

Options

error | degraded | missing | none

--update

run configurations that whose spec has changed but don’t require a major version change

--add

run newly added configurations

--workflow <workflow>

plan workflow (default: deploy)

Arguments

ENSEMBLE

Optional argument

run

Run an ad-hoc command in the context of the given ensemble. Use “–” to separate the given command line, for example:

> unfurl run – echo ‘hello!’

If –host or –module is set, the ansible configurator will be used. e.g.:

> unfurl run –host=example.com – echo ‘hello!’

unfurl run [OPTIONS] [CMDLINE]...

Options

--ensemble <ensemble>
--jobexitcode <jobexitcode>

Set exit code to 1 if job status is not ok.

Options

error | degraded | never

-m, --message <message>

commit message to use

--dirty <dirty>

Action if there are uncommitted changes before run. (Default: auto)

Options

abort | ok | auto

--commit

Commit modified files to the instance repository. (Default: false)

--dryrun

Do not modify anything, just do a dry run.

--destroyunmanaged

include unmanaged instances for consideration when destroying

--starttime <starttime>

Set the start time of the job.

--output <output>

How to print summary of job run

Options

text | json | none

--trace <trace>

Set the query’s trace level

--query <query>

Run the given expression upon job completion

--instance <instance>

instance name to target

--template <template>

TOSCA template to target

--host <host>

host to run the command on

--operation <operation>

TOSCA operation to run

--module <module>

ansible module to run (default: command)

Arguments

CMDLINE

Optional argument(s)

runtime

If no options are set, display the runtime currently used by the project. To create a new runtime in the project root use –init and the global –runtime option.

unfurl runtime [OPTIONS] [PROJECT_FOLDER]

Options

--init

Create a new runtime

Arguments

PROJECT_FOLDER

Optional argument

stop

Stop running instances.

unfurl stop [OPTIONS] [ENSEMBLE]

Options

--destroyunmanaged

include unmanaged instances for consideration when destroying

--starttime <starttime>

Set the start time of the job.

--output <output>

How to print summary of job run

Options

text | json | none

--trace <trace>

Set the query’s trace level

--query <query>

Run the given expression upon job completion

--instance <instance>

instance name to target

--template <template>

TOSCA template to target

--jobexitcode <jobexitcode>

Set exit code to 1 if job status is not ok.

Options

error | degraded | never

-m, --message <message>

commit message to use

--dirty <dirty>

Action if there are uncommitted changes before run. (Default: auto)

Options

abort | ok | auto

--commit

Commit modified files to the instance repository. (Default: false)

--dryrun

Do not modify anything, just do a dry run.

Arguments

ENSEMBLE

Optional argument

undeploy

Destroy what was deployed.

unfurl undeploy [OPTIONS] [ENSEMBLE]

Options

--destroyunmanaged

include unmanaged instances for consideration when destroying

--starttime <starttime>

Set the start time of the job.

--output <output>

How to print summary of job run

Options

text | json | none

--trace <trace>

Set the query’s trace level

--query <query>

Run the given expression upon job completion

--instance <instance>

instance name to target

--template <template>

TOSCA template to target

--jobexitcode <jobexitcode>

Set exit code to 1 if job status is not ok.

Options

error | degraded | never

-m, --message <message>

commit message to use

--dirty <dirty>

Action if there are uncommitted changes before run. (Default: auto)

Options

abort | ok | auto

--commit

Commit modified files to the instance repository. (Default: false)

--dryrun

Do not modify anything, just do a dry run.

Arguments

ENSEMBLE

Optional argument

version

Print the current version

unfurl version [OPTIONS]

Options

--semver

Print only the semantic version

--remote

Also print the version installed in the current runtime.