0a100bd2c3
Regenerate ch_cli_sahara_commands.xml with python-sahara 0.7.1 version release. Change-Id: Id54b4fbb02d2cd08f0701d53f9b61a7a630202a7
1406 lines
40 KiB
XML
1406 lines
40 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<chapter xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
version="5.0"
|
|
xml:id="saharaclient_commands">
|
|
|
|
<!-- This file is automatically generated, do not edit -->
|
|
|
|
<?dbhtml stop-chunking?>
|
|
|
|
<title>Data processing command-line client</title>
|
|
<para>The <command>sahara</command> client is the command-line interface
|
|
(CLI) for the Data processing API and its extensions. This chapter documents
|
|
<command>sahara</command> version 0.7.1.
|
|
</para>
|
|
<para>For help on a specific <command>sahara</command>
|
|
command, enter:
|
|
</para>
|
|
<screen><prompt>$</prompt> <userinput><command>sahara</command> <option>help</option> <replaceable>COMMAND</replaceable></userinput></screen>
|
|
|
|
<section xml:id="saharaclient_command_usage">
|
|
<title>sahara usage</title>
|
|
<screen><computeroutput>usage: sahara [--version] [--debug] [--os-cache]
|
|
[--os-username <auth-user-name>] [--os-password <auth-password>]
|
|
[--os-tenant-name <auth-tenant-name>]
|
|
[--os-tenant-id <auth-tenant-id>] [--os-auth-url <auth-url>]
|
|
[--os-auth-system <auth-system>] [--service-type <service-type>]
|
|
[--endpoint-type <endpoint-type>]
|
|
[--sahara-api-version <sahara-api-ver>]
|
|
[--os-cacert <ca-certificate>] [--bypass-url <bypass-url>]
|
|
<subcommand> ...</computeroutput></screen>
|
|
<variablelist wordsize="10">
|
|
<title>Subcommands</title>
|
|
<varlistentry>
|
|
<term><command>cluster-create</command></term>
|
|
<listitem>
|
|
<para>
|
|
Create a cluster.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>cluster-delete</command></term>
|
|
<listitem>
|
|
<para>
|
|
Delete a cluster.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>cluster-list</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print a list of available clusters.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>cluster-show</command></term>
|
|
<listitem>
|
|
<para>
|
|
Show details of a cluster.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>cluster-template-create</command></term>
|
|
<listitem>
|
|
<para>
|
|
Create a cluster template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>cluster-template-delete</command></term>
|
|
<listitem>
|
|
<para>
|
|
Delete a cluster template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>cluster-template-list</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print a list of available cluster templates.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>cluster-template-show</command></term>
|
|
<listitem>
|
|
<para>
|
|
Show details of a cluster template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>data-source-create</command></term>
|
|
<listitem>
|
|
<para>
|
|
Create a data source that provides job input or
|
|
receives job output.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>data-source-delete</command></term>
|
|
<listitem>
|
|
<para>
|
|
Delete a data source.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>data-source-list</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print a list of available data sources.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>data-source-show</command></term>
|
|
<listitem>
|
|
<para>
|
|
Show details of a data source.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>image-add-tag</command></term>
|
|
<listitem>
|
|
<para>
|
|
Add a tag to an image.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>image-list</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print a list of available images.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>image-register</command></term>
|
|
<listitem>
|
|
<para>
|
|
Register an image from the Image index.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>image-remove-tag</command></term>
|
|
<listitem>
|
|
<para>
|
|
Remove a tag from an image.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>image-show</command></term>
|
|
<listitem>
|
|
<para>
|
|
Show details of an image.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>image-unregister</command></term>
|
|
<listitem>
|
|
<para>
|
|
Unregister an image.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-binary-create</command></term>
|
|
<listitem>
|
|
<para>
|
|
Record a job binary.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-binary-data-create</command></term>
|
|
<listitem>
|
|
<para>
|
|
Store data in the internal DB. Store data in the
|
|
internal DB. Use 'swift upload' instead of this
|
|
command. Use this command only if Swift is not
|
|
available.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-binary-data-delete</command></term>
|
|
<listitem>
|
|
<para>
|
|
Delete an internally stored job binary data.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-binary-data-list</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print a list of internally stored job binary data.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-binary-delete</command></term>
|
|
<listitem>
|
|
<para>
|
|
Delete a job binary.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-binary-list</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print a list of job binaries.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-binary-show</command></term>
|
|
<listitem>
|
|
<para>
|
|
Show details of a job binary.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-create</command></term>
|
|
<listitem>
|
|
<para>
|
|
Create a job.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-delete</command></term>
|
|
<listitem>
|
|
<para>
|
|
Delete a job.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-list</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print a list of jobs.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-show</command></term>
|
|
<listitem>
|
|
<para>
|
|
Show details of a job.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-template-create</command></term>
|
|
<listitem>
|
|
<para>
|
|
Create a job template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-template-delete</command></term>
|
|
<listitem>
|
|
<para>
|
|
Delete a job template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-template-list</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print a list of job templates.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>job-template-show</command></term>
|
|
<listitem>
|
|
<para>
|
|
Show details of a job template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>node-group-template-create</command></term>
|
|
<listitem>
|
|
<para>
|
|
Create a node group template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>node-group-template-delete</command></term>
|
|
<listitem>
|
|
<para>
|
|
Delete a node group template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>node-group-template-list</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print a list of available node group templates.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>node-group-template-show</command></term>
|
|
<listitem>
|
|
<para>
|
|
Show details of a node group template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>plugin-list</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print a list of available plugins.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>plugin-show</command></term>
|
|
<listitem>
|
|
<para>
|
|
Show details of a plugin.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>bash-completion</command></term>
|
|
<listitem>
|
|
<para>
|
|
Prints all of the commands to stdout to support bash
|
|
completion. Prints all of the commands and options to
|
|
stdout so that the sahara.bash_completion script
|
|
doesn't have to hard code them.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>help</command></term>
|
|
<listitem>
|
|
<para>
|
|
Display help about this program or one of its
|
|
subcommands.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_command_optional">
|
|
<title>sahara optional arguments</title>
|
|
<variablelist wordsize="10">
|
|
<varlistentry>
|
|
<term><command>--version</command></term>
|
|
<listitem>
|
|
<para>
|
|
show program's version number and exit
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--debug</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print debugging output.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-cache</command></term>
|
|
<listitem>
|
|
<para>
|
|
Use the auth token cache. Defaults to False if
|
|
<code>env[OS_CACHE]</code> is not set.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-username <auth-user-name></command></term>
|
|
<listitem>
|
|
<para>
|
|
Defaults to <code>env[OS_USERNAME]</code>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-password <auth-password></command></term>
|
|
<listitem>
|
|
<para>
|
|
Defaults to <code>env[OS_PASSWORD]</code>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-tenant-name <auth-tenant-name></command></term>
|
|
<listitem>
|
|
<para>
|
|
Defaults to <code>env[OS_TENANT_NAME]</code>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-tenant-id <auth-tenant-id></command></term>
|
|
<listitem>
|
|
<para>
|
|
Defaults to <code>env[OS_TENANT_ID]</code>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-auth-url <auth-url></command></term>
|
|
<listitem>
|
|
<para>
|
|
Defaults to <code>env[OS_AUTH_URL]</code>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-auth-system <auth-system></command></term>
|
|
<listitem>
|
|
<para>
|
|
Defaults to <code>env[OS_AUTH_SYSTEM]</code>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--service-type <service-type></command></term>
|
|
<listitem>
|
|
<para>
|
|
Defaults to data_processing for all actions.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--endpoint-type <endpoint-type></command></term>
|
|
<listitem>
|
|
<para>
|
|
Defaults to <code>env[SAHARA_ENDPOINT_TYPE]</code> or publicURL.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--sahara-api-version <sahara-api-ver></command></term>
|
|
<listitem>
|
|
<para>
|
|
Accepts "api", defaults to <code>env[SAHARA_API_VERSION]</code>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--os-cacert <ca-certificate></command></term>
|
|
<listitem>
|
|
<para>
|
|
Specify a CA bundle file to use in verifying a TLS
|
|
(https) server certificate. Defaults to
|
|
<code>env[OS_CACERT]</code>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--bypass-url <bypass-url></command></term>
|
|
<listitem>
|
|
<para>
|
|
Use this API endpoint instead of the Service Catalog.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_cluster-create">
|
|
<title>sahara cluster-create command</title>
|
|
<screen><computeroutput>usage: sahara cluster-create [--json JSON]</computeroutput></screen>
|
|
<para>
|
|
Create a cluster.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--json JSON JSON</command></term>
|
|
<listitem>
|
|
<para>
|
|
representation of cluster.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_cluster-delete">
|
|
<title>sahara cluster-delete command</title>
|
|
<screen><computeroutput>usage: sahara cluster-delete [--name NAME] [--id <cluster_id>]</computeroutput></screen>
|
|
<para>
|
|
Delete a cluster.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the cluster.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id <cluster_id> ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the cluster to delete.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_cluster-list">
|
|
<title>sahara cluster-list command</title>
|
|
<screen><computeroutput>usage: sahara cluster-list</computeroutput></screen>
|
|
<para>
|
|
Print a list of available clusters.
|
|
</para>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_cluster-show">
|
|
<title>sahara cluster-show command</title>
|
|
<screen><computeroutput>usage: sahara cluster-show [--name NAME] [--id <cluster_id>] [--json]</computeroutput></screen>
|
|
<para>
|
|
Show details of a cluster.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the cluster.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id <cluster_id> ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the cluster to show.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--json</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print JSON representation of the cluster.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_cluster-template-create">
|
|
<title>sahara cluster-template-create command</title>
|
|
<screen><computeroutput>usage: sahara cluster-template-create [--json JSON]</computeroutput></screen>
|
|
<para>
|
|
Create a cluster template.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--json JSON JSON</command></term>
|
|
<listitem>
|
|
<para>
|
|
representation of cluster template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_cluster-template-delete">
|
|
<title>sahara cluster-template-delete command</title>
|
|
<screen><computeroutput>usage: sahara cluster-template-delete [--name NAME] [--id <template_id>]</computeroutput></screen>
|
|
<para>
|
|
Delete a cluster template.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the cluster template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id <template_id> ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the cluster template to delete.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_cluster-template-list">
|
|
<title>sahara cluster-template-list command</title>
|
|
<screen><computeroutput>usage: sahara cluster-template-list</computeroutput></screen>
|
|
<para>
|
|
Print a list of available cluster templates.
|
|
</para>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_cluster-template-show">
|
|
<title>sahara cluster-template-show command</title>
|
|
<screen><computeroutput>usage: sahara cluster-template-show [--name NAME] [--id <template_id>]
|
|
[--json]</computeroutput></screen>
|
|
<para>
|
|
Show details of a cluster template.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the cluster template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id <template_id> ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the cluster template to show.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--json</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print JSON representation of cluster template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_data-source-create">
|
|
<title>sahara data-source-create command</title>
|
|
<screen><computeroutput>usage: sahara data-source-create --name NAME --type TYPE --url URL
|
|
[--description DESCRIPTION] [--user USER]
|
|
[--password PASSWORD]</computeroutput></screen>
|
|
<para>
|
|
Create a data source that provides job input or receives job output.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the data source.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--type TYPE</command></term>
|
|
<listitem>
|
|
<para>
|
|
Type of the data source.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--url URL URL</command></term>
|
|
<listitem>
|
|
<para>
|
|
for the data source.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--description DESCRIPTION</command></term>
|
|
<listitem>
|
|
<para>
|
|
Description of the data source.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--user USER</command></term>
|
|
<listitem>
|
|
<para>
|
|
Username for accessing the data source URL.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--password PASSWORD</command></term>
|
|
<listitem>
|
|
<para>
|
|
Password for accessing the data source URL.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_data-source-delete">
|
|
<title>sahara data-source-delete command</title>
|
|
<screen><computeroutput>usage: sahara data-source-delete [--name NAME] [--id ID]</computeroutput></screen>
|
|
<para>
|
|
Delete a data source.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the data source.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id ID ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of data source to delete.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_data-source-list">
|
|
<title>sahara data-source-list command</title>
|
|
<screen><computeroutput>usage: sahara data-source-list</computeroutput></screen>
|
|
<para>
|
|
Print a list of available data sources.
|
|
</para>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_data-source-show">
|
|
<title>sahara data-source-show command</title>
|
|
<screen><computeroutput>usage: sahara data-source-show [--name NAME] [--id ID]</computeroutput></screen>
|
|
<para>
|
|
Show details of a data source.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the data source.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id ID ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the data source.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_image-add-tag">
|
|
<title>sahara image-add-tag command</title>
|
|
<screen><computeroutput>usage: sahara image-add-tag [--name NAME] [--id <image_id>] --tag <tag></computeroutput></screen>
|
|
<para>
|
|
Add a tag to an image.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the image.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id <image_id> ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of image to tag.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--tag <tag></command></term>
|
|
<listitem>
|
|
<para>
|
|
Tag to add.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_image-list">
|
|
<title>sahara image-list command</title>
|
|
<screen><computeroutput>usage: sahara image-list</computeroutput></screen>
|
|
<para>
|
|
Print a list of available images.
|
|
</para>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_image-register">
|
|
<title>sahara image-register command</title>
|
|
<screen><computeroutput>usage: sahara image-register --id <image_id> [--username <name>]
|
|
[--description <desc>]</computeroutput></screen>
|
|
<para>
|
|
Register an image from the Image index.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--id <image_id> ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of image, run "glance image-list" to see all IDs.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--username <name></command></term>
|
|
<listitem>
|
|
<para>
|
|
Username of privileged user in the image.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--description <desc></command></term>
|
|
<listitem>
|
|
<para>
|
|
Description of the image.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_image-remove-tag">
|
|
<title>sahara image-remove-tag command</title>
|
|
<screen><computeroutput>usage: sahara image-remove-tag [--name NAME] [--id <image_id>] --tag <tag></computeroutput></screen>
|
|
<para>
|
|
Remove a tag from an image.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the image.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id <image_id></command></term>
|
|
<listitem>
|
|
<para>
|
|
Image to tag.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--tag <tag></command></term>
|
|
<listitem>
|
|
<para>
|
|
Tag to remove.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_image-show">
|
|
<title>sahara image-show command</title>
|
|
<screen><computeroutput>usage: sahara image-show [--name NAME] [--id <image_id>]</computeroutput></screen>
|
|
<para>
|
|
Show details of an image.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the image.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id <image_id> ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the image.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_image-unregister">
|
|
<title>sahara image-unregister command</title>
|
|
<screen><computeroutput>usage: sahara image-unregister [--name NAME] [--id <image_id>]</computeroutput></screen>
|
|
<para>
|
|
Unregister an image.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the image.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id <image_id> ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of image to unregister.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-binary-create">
|
|
<title>sahara job-binary-create command</title>
|
|
<screen><computeroutput>usage: sahara job-binary-create --name NAME --url URL
|
|
[--description DESCRIPTION] [--user USER]
|
|
[--password PASSWORD]</computeroutput></screen>
|
|
<para>
|
|
Record a job binary.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the job binary.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--url URL URL</command></term>
|
|
<listitem>
|
|
<para>
|
|
for the job binary.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--description DESCRIPTION</command></term>
|
|
<listitem>
|
|
<para>
|
|
Description of the job binary.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--user USER</command></term>
|
|
<listitem>
|
|
<para>
|
|
Username for accessing the job binary URL.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--password PASSWORD</command></term>
|
|
<listitem>
|
|
<para>
|
|
Password for accessing the job binary URL.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-binary-data-create">
|
|
<title>sahara job-binary-data-create command</title>
|
|
<screen><computeroutput>usage: sahara job-binary-data-create [--file FILE]</computeroutput></screen>
|
|
<para>
|
|
Store data in the internal DB. Store data in the internal DB. Use 'swift
|
|
upload' instead of this command. Use this command only if Swift is not
|
|
available.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--file FILE</command></term>
|
|
<listitem>
|
|
<para>
|
|
Data to store.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-binary-data-delete">
|
|
<title>sahara job-binary-data-delete command</title>
|
|
<screen><computeroutput>usage: sahara job-binary-data-delete --id ID</computeroutput></screen>
|
|
<para>
|
|
Delete an internally stored job binary data.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--id ID ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of internally stored job binary data.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-binary-data-list">
|
|
<title>sahara job-binary-data-list command</title>
|
|
<screen><computeroutput>usage: sahara job-binary-data-list</computeroutput></screen>
|
|
<para>
|
|
Print a list of internally stored job binary data.
|
|
</para>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-binary-delete">
|
|
<title>sahara job-binary-delete command</title>
|
|
<screen><computeroutput>usage: sahara job-binary-delete [--name NAME] [--id ID]</computeroutput></screen>
|
|
<para>
|
|
Delete a job binary.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the job binary.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id ID ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the job binary to delete.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-binary-list">
|
|
<title>sahara job-binary-list command</title>
|
|
<screen><computeroutput>usage: sahara job-binary-list</computeroutput></screen>
|
|
<para>
|
|
Print a list of job binaries.
|
|
</para>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-binary-show">
|
|
<title>sahara job-binary-show command</title>
|
|
<screen><computeroutput>usage: sahara job-binary-show [--name NAME] [--id ID]</computeroutput></screen>
|
|
<para>
|
|
Show details of a job binary.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the job binary.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id ID ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the job binary.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-create">
|
|
<title>sahara job-create command</title>
|
|
<screen><computeroutput>usage: sahara job-create --job-template JOB_TEMPLATE --cluster CLUSTER
|
|
[--input-data INPUT_DATA] [--output-data OUTPUT_DATA]
|
|
[--param name=value] [--arg ARG]
|
|
[--config name=value]</computeroutput></screen>
|
|
<para>
|
|
Create a job.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--job-template JOB_TEMPLATE</command></term>
|
|
<listitem>
|
|
<para>
|
|
ID of the job template to run.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--cluster CLUSTER ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the cluster to run the job in.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--input-data INPUT_DATA</command></term>
|
|
<listitem>
|
|
<para>
|
|
ID of the input data source.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--output-data OUTPUT_DATA</command></term>
|
|
<listitem>
|
|
<para>
|
|
ID of the output data source.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--param</command></term>
|
|
<listitem>
|
|
<para>
|
|
name=value Parameters to add to the job, repeatable.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--arg ARG</command></term>
|
|
<listitem>
|
|
<para>
|
|
Arguments to add to the job, repeatable.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--config</command></term>
|
|
<listitem>
|
|
<para>
|
|
name=value Config parameters to add to the job, repeatable.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-delete">
|
|
<title>sahara job-delete command</title>
|
|
<screen><computeroutput>usage: sahara job-delete --id ID</computeroutput></screen>
|
|
<para>
|
|
Delete a job.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--id ID ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of a job.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-list">
|
|
<title>sahara job-list command</title>
|
|
<screen><computeroutput>usage: sahara job-list</computeroutput></screen>
|
|
<para>
|
|
Print a list of jobs.
|
|
</para>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-show">
|
|
<title>sahara job-show command</title>
|
|
<screen><computeroutput>usage: sahara job-show --id ID</computeroutput></screen>
|
|
<para>
|
|
Show details of a job.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--id ID ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the job.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-template-create">
|
|
<title>sahara job-template-create command</title>
|
|
<screen><computeroutput>usage: sahara job-template-create --name NAME --type TYPE [--main MAIN]
|
|
[--lib LIB] [--description DESCRIPTION]</computeroutput></screen>
|
|
<para>
|
|
Create a job template.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the job template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--type TYPE</command></term>
|
|
<listitem>
|
|
<para>
|
|
Type of the job template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--main MAIN ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
for job's main job-binary.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--lib LIB ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of job's lib job-binary, repeatable.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--description DESCRIPTION</command></term>
|
|
<listitem>
|
|
<para>
|
|
Description of the job template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-template-delete">
|
|
<title>sahara job-template-delete command</title>
|
|
<screen><computeroutput>usage: sahara job-template-delete [--name NAME] [--id ID]</computeroutput></screen>
|
|
<para>
|
|
Delete a job template.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the job template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id ID ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the job template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-template-list">
|
|
<title>sahara job-template-list command</title>
|
|
<screen><computeroutput>usage: sahara job-template-list</computeroutput></screen>
|
|
<para>
|
|
Print a list of job templates.
|
|
</para>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_job-template-show">
|
|
<title>sahara job-template-show command</title>
|
|
<screen><computeroutput>usage: sahara job-template-show [--name NAME] [--id ID]</computeroutput></screen>
|
|
<para>
|
|
Show details of a job template.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the job template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id ID ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the job template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_node-group-template-create">
|
|
<title>sahara node-group-template-create command</title>
|
|
<screen><computeroutput>usage: sahara node-group-template-create [--json JSON]</computeroutput></screen>
|
|
<para>
|
|
Create a node group template.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--json JSON JSON</command></term>
|
|
<listitem>
|
|
<para>
|
|
representation of node group template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_node-group-template-delete">
|
|
<title>sahara node-group-template-delete command</title>
|
|
<screen><computeroutput>usage: sahara node-group-template-delete [--name NAME] [--id <template_id>]</computeroutput></screen>
|
|
<para>
|
|
Delete a node group template.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the node group template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id <template_id> ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the node group template to delete.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_node-group-template-list">
|
|
<title>sahara node-group-template-list command</title>
|
|
<screen><computeroutput>usage: sahara node-group-template-list</computeroutput></screen>
|
|
<para>
|
|
Print a list of available node group templates.
|
|
</para>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_node-group-template-show">
|
|
<title>sahara node-group-template-show command</title>
|
|
<screen><computeroutput>usage: sahara node-group-template-show [--name NAME] [--id <template_id>]
|
|
[--json]</computeroutput></screen>
|
|
<para>
|
|
Show details of a node group template.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name NAME</command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the node group template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--id <template_id> ID</command></term>
|
|
<listitem>
|
|
<para>
|
|
of the node group template to show.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><command>--json</command></term>
|
|
<listitem>
|
|
<para>
|
|
Print JSON representation of node group template.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_plugin-list">
|
|
<title>sahara plugin-list command</title>
|
|
<screen><computeroutput>usage: sahara plugin-list</computeroutput></screen>
|
|
<para>
|
|
Print a list of available plugins.
|
|
</para>
|
|
</section>
|
|
<section xml:id="saharaclient_subcommand_plugin-show">
|
|
<title>sahara plugin-show command</title>
|
|
<screen><computeroutput>usage: sahara plugin-show --name <plugin></computeroutput></screen>
|
|
<para>
|
|
Show details of a plugin.
|
|
</para> <variablelist wordsize="10">
|
|
<title>Optional arguments</title>
|
|
<varlistentry>
|
|
<term><command>--name <plugin></command></term>
|
|
<listitem>
|
|
<para>
|
|
Name of the plugin.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
</chapter>
|