openstack
/
sahara
Code Issues Proposed changes

Merge "Adding doc about data source placeholders"

This commit is contained in:
Jenkins 2015-12-30 08:41:41 +00:00 committed by Gerrit Code Review
parent a573e6d8a1 af773f3fd0
commit 7fd7feefab
1 changed files with 17 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/source/userdoc/features.rst
View File

@ -233,3 +233,20 @@ Public objects created in one tenant can be used from other tenants (for
example, a cluster can be created from a public cluster template which is
created in another tenant), but modification operations are possible only from
the tenant in which object was created.
Data source placeholders support
--------------------------------
Sahara supports special strings that can be used in data source URLs. These
strings will be replaced with appropriate values during job execution which
allows the use of the same data source as an output multiple times.
There are 2 types of string currently supported:
* ``%JOB_EXEC_ID%`` - this string will be replaced with the job execution ID.
* ``%RANDSTR(len)%`` - this string will be replaced with random string of
lowercase letters of length ``len``.
After placeholders are replaced, the real URLs are stored in the
``data_source_urls`` field of the job execution object. This is used later to
find objects created by a particular job run.