[ARVADOS] updated: 1.3.0-712-ge1b8a1b0b

[Git user]

Summary of changes:
 doc/_config.yml                                 |  1 +
 doc/admin/manage-containers.html.textile.liquid | 16 ++++++++++++++++
 doc/api/methods/containers.html.textile.liquid  |  4 +++-
 3 files changed, 20 insertions(+), 1 deletion(-)
 create mode 100644 doc/admin/manage-containers.html.textile.liquid

       via  e1b8a1b0bdb46d0e162ef7794c06b08d0a5fffa5 (commit)
      from  15f97929f3cbc1697cd816ddda7c7e941951b3f8 (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 e1b8a1b0bdb46d0e162ef7794c06b08d0a5fffa5
Author: Eric Biagiotti <ebiagiotti at veritasgenetics.com>
Date:   Fri Apr 12 15:08:14 2019 -0400

    15002: Updates documentation
    
    Arvados-DCO-1.1-Signed-off-by: Eric Biagiotti <ebiagiotti at veritasgenetics.com>

diff --git a/doc/_config.yml b/doc/_config.yml
index a5b53442c..0b93e5fab 100644
--- a/doc/_config.yml
+++ b/doc/_config.yml
@@ -174,6 +174,7 @@ navbar:
     - Other:
       - admin/collection-versioning.html.textile.liquid
       - admin/federation.html.textile.liquid
+      - admin/manage-containers.html.textile.liquid
   installguide:
     - Overview:
       - install/index.html.textile.liquid
diff --git a/doc/admin/manage-containers.html.textile.liquid b/doc/admin/manage-containers.html.textile.liquid
new file mode 100644
index 000000000..dcc96fc2c
--- /dev/null
+++ b/doc/admin/manage-containers.html.textile.liquid
@@ -0,0 +1,16 @@
+---
+layout: default
+navsection: admin
+title: Managing container state
+...
+
+{% comment %}
+Copyright (C) The Arvados Authors. All rights reserved.
+
+SPDX-License-Identifier: CC-BY-SA-3.0
+{% endcomment %}
+
+This page describes how to change the state of a container from @Complete@ to @Cancelled at . This can be useful to avoid reusing a specific completed container without disabling reuse for the corresponding step in a workflow. For example, if a container exited successfully but produced bad output, it may not be worth updating the workflow to use a new image/version. Instead, changing the state of a container to @Cancelled@ will disable reuse of the specific container.
+
+If a container is in the @Complete@ state, the following @arv@ command will change it's state to @Cancelled@, where @-u@ is the @UUID@ of the container.
+<pre>arv container update -u xxxxx-xxxxx-xxxxxxxxxxxxxxx -c '{"state":"Cancelled"}'</pre> See the "arv CLI tool overview":{{site.baseurl}}/sdk/cli/index.html for more details about using the @arv@ command.
\ No newline at end of file
diff --git a/doc/api/methods/containers.html.textile.liquid b/doc/api/methods/containers.html.textile.liquid
index f0ce8e362..8058123d0 100644
--- a/doc/api/methods/containers.html.textile.liquid
+++ b/doc/api/methods/containers.html.textile.liquid
@@ -65,9 +65,11 @@ table(table table-bordered table-condensed).
 |Queued|Waiting for a dispatcher to lock it and try to run the container.|Locked, Cancelled|
 |Locked|A dispatcher has "taken" the container and is allocating resources for it. The container has not started yet.|Queued, Running, Cancelled|
 |Running|Resources have been allocated and the contained process has been started (or is about to start). Crunch-run _must_ set state to Running _before_ there is any possibility that user code will run in the container.|Complete, Cancelled|
-|Complete|Container was running, and the contained process/command has exited.|-|
+|Complete|Container was running, and the contained process/command has exited.|Cancelled (admin only)|
 |Cancelled|The container did not run long enough to produce an exit code. This includes cases where the container didn't even start, cases where the container was interrupted/killed before it exited by itself (e.g., priority changed to 0), and cases where some problem prevented the system from capturing the contained process's exit status (exit code and output).|-|
 
+See "Managing container state":{{site.baseurl}}/admin/manage-containers.html for details about changing state from @Complete@ to @Cancelled@
+
 h2(#mount_types). {% include 'mount_types' %}
 
 h2(#runtime_constraints). {% include 'container_runtime_constraints' %}

-----------------------------------------------------------------------


hooks/post-receive
--