[cli-ref] add solum client

As of now, python-solumclient does not provide
the command help with format that the doc-tool expects,
but it is worth to add it into CLI Reference.

Change-Id: I98dc9aa039c11f396aa87ebe8358c24d028af17a
Closes-Bug: #1519334
This commit is contained in:
KATO Tomoyuki 2016-06-27 19:09:34 +09:00 committed by Tom Fifield
parent 55b02d8c5c
commit 9f289a552b
2 changed files with 118 additions and 0 deletions

View File

@ -38,6 +38,7 @@ Contents
heat.rst
cloudkitty.rst
manila.rst
solum.rst
ceilometer.rst
gnocchi.rst
mistral.rst

View File

@ -0,0 +1,117 @@
.. This file is manually generated, unlike many of the other chapters.
=====================================================================
Software Development Lifecycle Automation service command-line client
=====================================================================
The solum client is the command-line interface (CLI) for
the Software Development Lifecycle Automation service API and its extensions.
This chapter documents :command:`solum` version ``2.0.1``.
.. _solum_command_usage:
solum usage
~~~~~~~~~~~
``solum help``
Show this help message.
``solum info``
Show Solum endpoint and API release version.
``solum --version``
Show current Solum client version and exit.
``solum lp help``
Show a help message specific to languagepack commands.
``solum lp create <NAME> <GIT_REPO_URL>``
Create a new language pack from a git repo.
``solum lp list``
Print and index of all available language packs.
``solum lp show <NAME|UUID>``
Print the details of a language pack.
``solum lp delete <NAME|UUID>``
Destroy a language pack.
``solum lp logs <NAME|UUID>``
Show logs for a language pack.
``solum app help``
Show a help message specific to app commands.
``solum app list``
Print an index of all deployed applications.
``solum app show <NAME|UUID>``
Print detailed information about one application.
``solum app create``
Register a new application with Solum.
.. code-block:: console
solum app create [--app-file <AppFile>] [--git-url <GIT_URL>]
[--lp <LANGUAGEPACK>]
[--param-file <PARAMFILE>]
[--setup-trigger]
[--trigger-workflow <CUSTOM-WORKFLOW>]
<CUSTOM-WORKFLOW>=(unittest | build | unittest+build)
Without the ``--trigger-workflow`` flag, the workflow ``unittest+build+deploy``
is triggered (this is the default workflow).
``solum app deploy <NAME|UUID>``
Deploy an application, building any applicable artifacts first.
du-id is optional flag. It can be used to pass in ID of a previously
created deployment unit. If passed, this command will deploy the du
referenced by the provided ``du-id`` instead of building one first.
``solum app delete <NAME|UUID>``
Delete an application and all related artifacts.
``solum app logs <NAME|UUID> [--wf-id <wf-id>]``
Show the logs of an application for all the workflows.
``wf-id`` is optional flag which can be used to pass in ID of one of
the existing workflows. If provided, the logs only for that workflow
are displayed.
``solum app scale <APP_NAME|UUID> <target>``
``solum workflow list <APP_NAME|UUID>``
List all application workflows.
``solum workflow show <APP_NAME|UUID> <WORKFLOW_ID|UUID>``
Print the details of a workflow.
``solum workflow logs <APP_NAME|UUID> <WORKFLOW_ID|UUID>``
List all the logs of a given workflow.
**SOON TO BE DEPRECATED:**
``solum oldapp create``
Register a new application with Solum.
.. code-block:: console
solum oldapp create [--plan-file <PLANFILE>] [--git-url <GIT_URL>]
[--lp <LANGUAGEPACK>] [--run-cmd <RUN_CMD>]
[--unittest-cmd <UNITTEST_CMD>]
[--name <NAME>] [--port <PORT>]
[--param-file <PARAMFILE>]
[--desc <DESCRIPTION>]
[--setup-trigger]
[--private-repo]
[--trigger-workflow <WORKFLOW>]
``solum assembly list``
Print an index of all available assemblies.
``solum assembly create <NAME|UUID> <PLAN_URI> [--description <DESCRIPTION>]``
Create an assembly from a registered plan.
``solum assembly delete <NAME|UUID>``
Destroy an assembly.