[ARVADOS] updated: 1.3.0-714-g0e640f9da
Git user
git at public.curoverse.com
Wed Apr 17 20:23:16 UTC 2019
Summary of changes:
doc/admin/manage-containers.html.textile.liquid | 10 +++++-----
doc/api/methods/containers.html.textile.liquid | 2 +-
2 files changed, 6 insertions(+), 6 deletions(-)
via 0e640f9dae3500a280c60d0a7eeed3b39e55970f (commit)
from 2ab088f74a672910751fd5d9927ddef2b58c4a57 (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 0e640f9dae3500a280c60d0a7eeed3b39e55970f
Author: Eric Biagiotti <ebiagiotti at veritasgenetics.com>
Date: Wed Apr 17 16:23:10 2019 -0400
15002: Improves documentation for container state changing
Arvados-DCO-1.1-Signed-off-by: Eric Biagiotti <ebiagiotti at veritasgenetics.com>
diff --git a/doc/admin/manage-containers.html.textile.liquid b/doc/admin/manage-containers.html.textile.liquid
index fe409cb6c..fe8466677 100644
--- a/doc/admin/manage-containers.html.textile.liquid
+++ b/doc/admin/manage-containers.html.textile.liquid
@@ -1,7 +1,7 @@
---
layout: default
navsection: admin
-title: Managing container state
+title: Controlling container reuse
...
{% comment %}
@@ -10,12 +10,12 @@ 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.
+This page describes how to control container reuse using the @arv@ command. This can be utilized to avoid reusing a completed container without disabling reuse for the corresponding step in your workflow. For example, if a container exited successfully but produced bad output, it may not be feasible to update the workflow immediately. Meanwhile, changing the state of the container from @Completed@ to @Cancelled@ will disable reuse as the workflow continues to run.
-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:
+If a container is in the @Complete@ state, the following @arv@ command will change its state to @Cancelled@, where @xxxxx-xxxxx-xxxxxxxxxxxxxxx@ is the @UUID@ of the container:
<pre>arv container update -u xxxxx-xxxxx-xxxxxxxxxxxxxxx -c '{"state":"Cancelled"}'</pre>
-Use the following command to list all containers that have been cancelled after completion:
+Use the following command to list all containers that exited with 0 and were then cancelled:
-<pre>arv container list --filters='[["state", "=", "Cancelled"], ["exit_code", "=", 0]]'</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
+<pre>arv container list --filters='[["state", "=", "Cancelled"], ["exit_code", "=", 0]]'</pre>See the "arv CLI tool overview":{{site.baseurl}}/sdk/cli/index.html for more details about using the @arv@ command.
diff --git a/doc/api/methods/containers.html.textile.liquid b/doc/api/methods/containers.html.textile.liquid
index 8058123d0..2ddb00c68 100644
--- a/doc/api/methods/containers.html.textile.liquid
+++ b/doc/api/methods/containers.html.textile.liquid
@@ -65,7 +65,7 @@ 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.|Cancelled (admin only)|
+|Complete|Container was running, and the contained process/command has exited.|Cancelled|
|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@
-----------------------------------------------------------------------
hooks/post-receive
--
More information about the arvados-commits
mailing list