[ARVADOS] updated: e8db2a47dd834640eeafeb7fa6741d725c1fac9c
Git user
git at public.curoverse.com
Tue Sep 13 12:17:58 EDT 2016
Summary of changes:
.../_container_runtime_constraints.liquid | 6 ++---
doc/_includes/_mount_types.liquid | 31 +++++++++++++---------
2 files changed, 21 insertions(+), 16 deletions(-)
via e8db2a47dd834640eeafeb7fa6741d725c1fac9c (commit)
from f00a2304c3668e74c6ab53e27793166b02b709d2 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
commit e8db2a47dd834640eeafeb7fa6741d725c1fac9c
Author: radhika <radhika at curoverse.com>
Date: Tue Sep 13 12:17:34 2016 -0400
9835: mount_types improvements.
diff --git a/doc/_includes/_container_runtime_constraints.liquid b/doc/_includes/_container_runtime_constraints.liquid
index 5c86e8f..fbf4b74 100644
--- a/doc/_includes/_container_runtime_constraints.liquid
+++ b/doc/_includes/_container_runtime_constraints.liquid
@@ -4,6 +4,6 @@ Runtime constraints restrict the container's access to compute resources and the
table(table table-bordered table-condensed).
|_. Key|_. Type|_. Description|_. Notes|
-|ram|integer|Number of ram bytes to be used to run this process.|Required when in "Committed" state.|
-|vcpus|integer|Number of cores to be used to run this process.|Required when in "Committed" state.|
-|API|boolean|When set, use Crunch2 to run this process.|Optional.|
+|ram|integer|Number of ram bytes to be used to run this process.|Optional. However, a ContainerRequest that is in "Committed" state must provide this.|
+|vcpus|integer|Number of cores to be used to run this process.|Optional. However, a ContainerRequest that is in "Committed" state must provide this.|
+|API|boolean|When set, ARVADOS_API_HOST and ARVADOS_API_TOKEN will be set, and container will have networking enabled to access the Arvados API server.|Optional.|
diff --git a/doc/_includes/_mount_types.liquid b/doc/_includes/_mount_types.liquid
index 33765c4..3ad810d 100644
--- a/doc/_includes/_mount_types.liquid
+++ b/doc/_includes/_mount_types.liquid
@@ -5,10 +5,11 @@ The "mounts" hash is the primary mechanism for adding data to the container at r
Each value of the "mounts" hash is itself a hash, whose "kind" key determines the handler used to attach data to the container.
table(table table-bordered table-condensed).
-|_. Mount type|_.Kind|_. Expected keys|_. Description|_. Examples|_. Discussion|
+|_. Mount type|_. Kind|_. Description|_. Examples|
|Arvados data collection|@collection@|@"portable_data_hash"@ _or_ @"uuid"@ _may_ be provided. If not provided, a new collection will be created. This is useful when @"writable":true@ and the container's @output_path@ is (or is a subdirectory of) this mount target.
@"writable"@ may be provided with a @true@ or @false@ to indicate the path must (or must not) be writable. If not specified, the system can choose.
-@"path"@ may be provided, and defaults to @"/"@.|At container startup, the target path will have the same directory structure as the given path within the collection. Even if the files/directories are writable in the container, modifications will _not_ be saved back to the original collections when the container ends.|<pre><code>{
+@"path"@ may be provided, and defaults to @"/"@.
+At container startup, the target path will have the same directory structure as the given path within the collection. Even if the files/directories are writable in the container, modifications will _not_ be saved back to the original collections when the container ends.|<pre><code>{
"kind":"collection",
"uuid":"...",
"path":"/foo.txt"
@@ -16,10 +17,11 @@ table(table table-bordered table-condensed).
{
"kind":"collection",
"uuid":"..."
-}</code></pre>||
+}</code></pre>|
|Git tree|@git_tree@|One of { @"git-url"@, @"repository_name"@, @"uuid"@ } must be provided.
One of { @"commit"@, @"revisions"@ } must be provided.
-"path" may be provided. The default path is "/".|At container startup, the target path will have the source tree indicated by the given revision. The @.git@ metadata directory _will not_ be available: typically the system will use @git-archive@ rather than @git-checkout@ to prepare the target directory.
+"path" may be provided. The default path is "/".
+At container startup, the target path will have the source tree indicated by the given revision. The @.git@ metadata directory _will not_ be available: typically the system will use @git-archive@ rather than @git-checkout@ to prepare the target directory.
- If a value is given for @"revisions"@, it will be resolved to a set of commits (as desribed in the "ranges" section of git-revisions(1)) and the container request will be satisfiable by any commit in that set.
- If a value is given for @"commit"@, it will be resolved to a single commit, and the tree resulting from that commit will be used.
- @"path"@ can be used to select a subdirectory or a single file from the tree indicated by the selected commit.
@@ -34,9 +36,10 @@ One of { @"commit"@, @"revisions"@ } must be provided.
"uuid":"zzzzz-s0uqq-xxxxxxxxxxxxxxx",
"commit_range":"bugfix^..master",
"path":"/crunch_scripts/grep"
-}</code></pre>||
+}</code></pre>|
|Temporary directory|@tmp@|@"capacity"@: capacity (in bytes) of the storage device.
-@"device_type"@ (optional, default "network"): one of @{"ram", "ssd", "disk", "network"}@ indicating the acceptable level of performance.|At container startup, the target path will be empty. When the container finishes, the content will be discarded. This will be backed by a storage mechanism no slower than the specified type.|<pre><code>{
+@"device_type"@ (optional, default "network"): one of @{"ram", "ssd", "disk", "network"}@ indicating the acceptable level of performance.
+At container startup, the target path will be empty. When the container finishes, the content will be discarded. This will be backed by a storage mechanism no slower than the specified type.|<pre><code>{
"kind":"tmp",
"capacity":100000000000
}
@@ -44,15 +47,17 @@ One of { @"commit"@, @"revisions"@ } must be provided.
"kind":"tmp",
"capacity":1000000000,
"device_type":"ram"
-}</code></pre>||
-|Keep|@keep@|Expose all readable collections via arv-mount.|Requires suitable runtime constraints.|<pre><code>{
+}</code></pre>|
+|Keep|@keep@|Expose all readable collections via arv-mount.
+Requires suitable runtime constraints.|<pre><code>{
"kind":"keep"
-}</code></pre>||
-|Mounted file or directory|@file@|@"path"@: absolute path (inside the container) of a file or directory that is (or is inside) another mount target.|Can be used for "stdin" and "stdout" targets.|<pre><code>{
+}</code></pre>|
+|Mounted file or directory|@file@|@"path"@: absolute path (inside the container) of a file or directory that is (or is inside) another mount target.
+Can be used for "stdin" and "stdout" targets.|<pre><code>{
"kind":"file",
"path":"/mounted_tmp/a.out"
-}</code></pre>||
-|JSON document|@json@|A JSON-encoded string, array, or object.||<pre>{
+}</code></pre>|
+|JSON document|@json@|A JSON-encoded string, array, or object.|<pre>{
"kind":"json",
"content":{"foo":"bar"}
-}</pre>||
+}</pre>|
-----------------------------------------------------------------------
hooks/post-receive
--
More information about the arvados-commits
mailing list