From 5ea613b9dfb402666adb88b3d5e531bce86f5401 Mon Sep 17 00:00:00 2001 From: Lucas Di Pentima Date: Mon, 6 Aug 2018 14:45:43 -0300 Subject: [PATCH] 13773: Add documentation. Arvados-DCO-1.1-Signed-off-by: Lucas Di Pentima --- doc/_includes/_container_runtime_status.liquid | 18 ++++++++++++++++++ doc/api/methods/containers.html.textile.liquid | 6 ++++++ 2 files changed, 24 insertions(+) create mode 100644 doc/_includes/_container_runtime_status.liquid diff --git a/doc/_includes/_container_runtime_status.liquid b/doc/_includes/_container_runtime_status.liquid new file mode 100644 index 0000000000..77051beb3f --- /dev/null +++ b/doc/_includes/_container_runtime_status.liquid @@ -0,0 +1,18 @@ +{% comment %} +Copyright (C) The Arvados Authors. All rights reserved. + +SPDX-License-Identifier: CC-BY-SA-3.0 +{% endcomment %} + +h2. Runtime status + +Runtime status provides container's relevant information about its progress even while it's still in Running state. This is used to avoid reusing containers that have not yet failed but will definitely do, and also for easier workflow debugging. + +The following keys have well known meanings: + +table(table table-bordered table-condensed). +|_. Key|_. Type|_. Description|_. Notes| +|error|string|The existance of this key indicates the container will definitely fail, or has already failed.|Optional.| +|warning|string|Indicates something unusual happened or is currently happening, but isn't considered fatal.|Optional.| +|activity|string|A message for the end user about what state the container is currently in.|Optional.| +|errorDetails|string|Additional structured error details.|Optional.| diff --git a/doc/api/methods/containers.html.textile.liquid b/doc/api/methods/containers.html.textile.liquid index 30ec055a6b..3384f9377e 100644 --- a/doc/api/methods/containers.html.textile.liquid +++ b/doc/api/methods/containers.html.textile.liquid @@ -41,6 +41,10 @@ Generally this will contain additional keys that are not present in any correspo "vcpus":2, "API":true }See "Runtime constraints":#runtime_constraints for more details.| +|runtime_status|hash|Information related to the container's run, including its steps. Some keys have specific meaning and are described later in this page.|e.g., +
{
+  "error": "This container won't be successful because at least one step have already failed."
+}
See "Runtime status":#runtime_status for more details.| |scheduling_parameters|hash|Parameters to be passed to the container scheduler when running this container.|e.g.,
{
 "partitions":["fastcpu","vfastcpu"]
 }
See "Scheduling parameters":#scheduling_parameters for more details.| @@ -66,6 +70,8 @@ h2(#mount_types). {% include 'mount_types' %} h2(#runtime_constraints). {% include 'container_runtime_constraints' %} +h2(#runtime_status). {% include 'container_runtime_status' %} + h2(#scheduling_parameters). {% include 'container_scheduling_parameters' %} h2. Methods -- 2.39.5