From 9fcd61774324e132c212ba9bcb39922f44f99fe9 Mon Sep 17 00:00:00 2001
From: Chris Doherty <chris.doherty4@gmail.com>
Date: Mon, 13 Mar 2023 20:50:42 -0500
Subject: [PATCH 1/7] Add Tink Worker failure reason communication channel

Signed-off-by: Chris Doherty <chris.doherty4@gmail.com>
---
 design/20230313_tink_worker_failure_reason.md |  28 ++++++++++++++++++
 .../reason_propagation.png                    | Bin 0 -> 25938 bytes
 .../tink_worker_failure_reasons/sequence.puml |  24 +++++++++++++++
 3 files changed, 52 insertions(+)
 create mode 100644 design/20230313_tink_worker_failure_reason.md
 create mode 100644 design/images/tink_worker_failure_reasons/reason_propagation.png
 create mode 100644 design/images/tink_worker_failure_reasons/sequence.puml

diff --git a/design/20230313_tink_worker_failure_reason.md b/design/20230313_tink_worker_failure_reason.md
new file mode 100644
index 0000000..ec484b1
--- /dev/null
+++ b/design/20230313_tink_worker_failure_reason.md
@@ -0,0 +1,28 @@
+# Tink Worker Failure Reasons
+
+## Context
+
+Tink Worker is the client launched by an Operating System Installation Environment (OSIE) that communicates with Tink Server to retrieve actions to run on the node. Actions are OCI images that Tink Worker can launch using a container runtime such as Docker. In the event an action fails, Tinkerbell does not provide mechanisms for the user defined action to communicate why it failed. This makes debugging `Workflow`s difficult as users leveraging `kubectl` cannot observe a specific failure reason and must resort to running commands directly on the node.
+
+As part of the Tink CRD Refactor proposal we introduced `Reason` and `Message` fields to indiciate why an action entered a failure state. The proposal does not detail how these fields are populated but envisages at minimum the `Reason` being used to communicate timeout failures. 
+
+* A `Reason` is a machine readable CamelCase word or phrase that succinctly describes the failure reason. 
+* A `Message` is a human readable string that elaborates on the failure reason to provide specifics.
+
+This proposal lays out a contract for action containers to communicate why it exited with a non-zero exit code.
+
+## Goals/Non-goals
+
+**Goals**
+
+- Define a contract for action images to communicate failure information that is exposed via associated custom resource definitions and is therefore inspectable with `kubectl`.
+
+## Proposal
+
+Actions can communicate a failure reason by writing to `/dev/reason`.
+
+Actions can communicate a failure message by writing to `/dev/message`.
+
+When an action exits with a non-zero exit code, Tink Worker will arrange to read the reason and message provided by the action image and transmit them, with the action result, to Tink Server. Tink Server will update the action state, reason and message. Providing the reason and message on the action status will ensure the controller populates the `Succeeded` condition as detailed in the Tink CRD Refactor proposal.
+
+![Reason propagation]()
\ No newline at end of file
diff --git a/design/images/tink_worker_failure_reasons/reason_propagation.png b/design/images/tink_worker_failure_reasons/reason_propagation.png
new file mode 100644
index 0000000000000000000000000000000000000000..06cabb2fb1e7a84d9e5e70250f02f6b958d08105
GIT binary patch
literal 25938
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
Jk-GKxzW_>tK)C<_

literal 0
HcmV?d00001

diff --git a/design/images/tink_worker_failure_reasons/sequence.puml b/design/images/tink_worker_failure_reasons/sequence.puml
new file mode 100644
index 0000000..6e66566
--- /dev/null
+++ b/design/images/tink_worker_failure_reasons/sequence.puml
@@ -0,0 +1,24 @@
+@startuml reason_propagation
+
+participant Action as action
+participant "Tink Worker" as worker
+participant "Tink Server" as server
+entity "Workflow" as workflow
+
+
+worker -> server ++ : Request actions
+activate worker
+server -> workflow : Get actions
+server <-- workflow
+worker <-- server -- : Actions
+loop for every action
+worker -> action ++ : Execute
+action -> action : Write to /dev/reason\nWrite to /dev/message
+worker <- action -- : Exit non-zero
+worker -> action : Extract reason and message
+worker <-- action --
+worker -> server -- : Report status, reason\nand message
+server -> workflow : Update action
+end
+
+@enduml
\ No newline at end of file

From 95948d410e356ba2a76653b94b0a82f3f61004aa Mon Sep 17 00:00:00 2001
From: Chris Doherty <chris.doherty4@gmail.com>
Date: Mon, 13 Mar 2023 21:21:47 -0500
Subject: [PATCH 2/7] Add image

Signed-off-by: Chris Doherty <chris.doherty4@gmail.com>
---
 design/20230313_tink_worker_failure_reason.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/design/20230313_tink_worker_failure_reason.md b/design/20230313_tink_worker_failure_reason.md
index ec484b1..adbc15a 100644
--- a/design/20230313_tink_worker_failure_reason.md
+++ b/design/20230313_tink_worker_failure_reason.md
@@ -25,4 +25,4 @@ Actions can communicate a failure message by writing to `/dev/message`.
 
 When an action exits with a non-zero exit code, Tink Worker will arrange to read the reason and message provided by the action image and transmit them, with the action result, to Tink Server. Tink Server will update the action state, reason and message. Providing the reason and message on the action status will ensure the controller populates the `Succeeded` condition as detailed in the Tink CRD Refactor proposal.
 
-![Reason propagation]()
\ No newline at end of file
+![Reason propagation](https://raw.githubusercontent.com/tinkerbell/roadmap/7e4e769305edf5c5679a406ebf0564eb754fe57a/design/images/tink_worker_failure_reasons/reason_propagation.png)
\ No newline at end of file

From 6f679be657ddd542fbb41614d1b6de28a740f397 Mon Sep 17 00:00:00 2001
From: Chris Doherty <chris.doherty4@gmail.com>
Date: Tue, 14 Mar 2023 07:54:11 -0500
Subject: [PATCH 3/7] Clarify permissions and backend for files

Signed-off-by: Chris Doherty <chris.doherty4@gmail.com>
---
 design/20230313_tink_worker_failure_reason.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/design/20230313_tink_worker_failure_reason.md b/design/20230313_tink_worker_failure_reason.md
index adbc15a..fa61d62 100644
--- a/design/20230313_tink_worker_failure_reason.md
+++ b/design/20230313_tink_worker_failure_reason.md
@@ -25,4 +25,8 @@ Actions can communicate a failure message by writing to `/dev/message`.
 
 When an action exits with a non-zero exit code, Tink Worker will arrange to read the reason and message provided by the action image and transmit them, with the action result, to Tink Server. Tink Server will update the action state, reason and message. Providing the reason and message on the action status will ensure the controller populates the `Succeeded` condition as detailed in the Tink CRD Refactor proposal.
 
-![Reason propagation](https://raw.githubusercontent.com/tinkerbell/roadmap/7e4e769305edf5c5679a406ebf0564eb754fe57a/design/images/tink_worker_failure_reasons/reason_propagation.png)
\ No newline at end of file
+![Reason propagation](https://raw.githubusercontent.com/tinkerbell/roadmap/7e4e769305edf5c5679a406ebf0564eb754fe57a/design/images/tink_worker_failure_reasons/reason_propagation.png)
+
+The files will be mounted with `0666` permissions granting read write access to everyone. This ensures images launched with a different UID will still be able to write a reason and message.
+
+The implementation behind the reason and message files will be transparent to the action maintainer. For example, the file may be backed by unix domain sockets or a host text file.
\ No newline at end of file

From c18e1bf903acb04916ebd878d591133a33973858 Mon Sep 17 00:00:00 2001
From: Chris Doherty <chris.doherty4@gmail.com>
Date: Tue, 14 Mar 2023 08:01:13 -0500
Subject: [PATCH 4/7] Clarify expectations of reasons

Signed-off-by: Chris Doherty <chris.doherty4@gmail.com>
---
 design/20230313_tink_worker_failure_reason.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/design/20230313_tink_worker_failure_reason.md b/design/20230313_tink_worker_failure_reason.md
index fa61d62..0b92e85 100644
--- a/design/20230313_tink_worker_failure_reason.md
+++ b/design/20230313_tink_worker_failure_reason.md
@@ -19,7 +19,7 @@ This proposal lays out a contract for action containers to communicate why it ex
 
 ## Proposal
 
-Actions can communicate a failure reason by writing to `/dev/reason`.
+Actions can communicate a failure reason by writing to `/dev/reason`. The reason must follow the formatting expectations defined by the Tink API (it must be a CamelCase word or phrase). If the reason does not follow the convention we will report `InvalidActionReason` in-place of the reported reason.
 
 Actions can communicate a failure message by writing to `/dev/message`.
 

From f9ba09ef51b82c74e14bf64910442b529eca8c71 Mon Sep 17 00:00:00 2001
From: Chris Doherty <chris.doherty4@gmail.com>
Date: Tue, 14 Mar 2023 08:02:07 -0500
Subject: [PATCH 5/7] Clarify what files have specific permissions

Signed-off-by: Chris Doherty <chris.doherty4@gmail.com>
---
 design/20230313_tink_worker_failure_reason.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/design/20230313_tink_worker_failure_reason.md b/design/20230313_tink_worker_failure_reason.md
index 0b92e85..b4b27f3 100644
--- a/design/20230313_tink_worker_failure_reason.md
+++ b/design/20230313_tink_worker_failure_reason.md
@@ -27,6 +27,6 @@ When an action exits with a non-zero exit code, Tink Worker will arrange to read
 
 ![Reason propagation](https://raw.githubusercontent.com/tinkerbell/roadmap/7e4e769305edf5c5679a406ebf0564eb754fe57a/design/images/tink_worker_failure_reasons/reason_propagation.png)
 
-The files will be mounted with `0666` permissions granting read write access to everyone. This ensures images launched with a different UID will still be able to write a reason and message.
+The reason and message files will be mounted with `0666` permissions granting read write access to everyone. This ensures images launched with a different UID will still be able to write a reason and message.
 
 The implementation behind the reason and message files will be transparent to the action maintainer. For example, the file may be backed by unix domain sockets or a host text file.
\ No newline at end of file

From 8ae916c761b94ac22f713a5ae64439c264263b55 Mon Sep 17 00:00:00 2001
From: Chris Doherty <chris.doherty4@gmail.com>
Date: Tue, 14 Mar 2023 09:34:52 -0500
Subject: [PATCH 6/7] Update names

Signed-off-by: Chris Doherty <chris.doherty4@gmail.com>
---
 ...20230313_action_failure_reason_communication.md} |   2 +-
 .../reason_propagation.png                          | Bin
 .../sequence.puml                                   |   0
 3 files changed, 1 insertion(+), 1 deletion(-)
 rename design/{20230313_tink_worker_failure_reason.md => 20230313_action_failure_reason_communication.md} (98%)
 rename design/images/{tink_worker_failure_reasons => action_failure_reason_communication}/reason_propagation.png (100%)
 rename design/images/{tink_worker_failure_reasons => action_failure_reason_communication}/sequence.puml (100%)

diff --git a/design/20230313_tink_worker_failure_reason.md b/design/20230313_action_failure_reason_communication.md
similarity index 98%
rename from design/20230313_tink_worker_failure_reason.md
rename to design/20230313_action_failure_reason_communication.md
index b4b27f3..5dbf058 100644
--- a/design/20230313_tink_worker_failure_reason.md
+++ b/design/20230313_action_failure_reason_communication.md
@@ -1,4 +1,4 @@
-# Tink Worker Failure Reasons
+# Action Failure Reason Communication
 
 ## Context
 
diff --git a/design/images/tink_worker_failure_reasons/reason_propagation.png b/design/images/action_failure_reason_communication/reason_propagation.png
similarity index 100%
rename from design/images/tink_worker_failure_reasons/reason_propagation.png
rename to design/images/action_failure_reason_communication/reason_propagation.png
diff --git a/design/images/tink_worker_failure_reasons/sequence.puml b/design/images/action_failure_reason_communication/sequence.puml
similarity index 100%
rename from design/images/tink_worker_failure_reasons/sequence.puml
rename to design/images/action_failure_reason_communication/sequence.puml

From 605fe614c560c17334cdc1e8033ded0521107b2b Mon Sep 17 00:00:00 2001
From: Chris Doherty <chris.doherty4@gmail.com>
Date: Tue, 14 Mar 2023 18:58:08 -0500
Subject: [PATCH 7/7] Add expectations elaboration on reason and message

Signed-off-by: Chris Doherty <chris.doherty4@gmail.com>
---
 design/20230313_action_failure_reason_communication.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/design/20230313_action_failure_reason_communication.md b/design/20230313_action_failure_reason_communication.md
index 5dbf058..6c76ba5 100644
--- a/design/20230313_action_failure_reason_communication.md
+++ b/design/20230313_action_failure_reason_communication.md
@@ -19,9 +19,9 @@ This proposal lays out a contract for action containers to communicate why it ex
 
 ## Proposal
 
-Actions can communicate a failure reason by writing to `/dev/reason`. The reason must follow the formatting expectations defined by the Tink API (it must be a CamelCase word or phrase). If the reason does not follow the convention we will report `InvalidActionReason` in-place of the reported reason.
+Actions communicate a `Reason` by writing it to `/tinkerbell/failure-reason`. The reason must follow the same formatting expectations as defined in the CRD refactor proposal: most importantly, it must not contain spaces or new lines. If the reason does not follow the convention we will report `InvalidActionReason` in-place of the reported reason.
 
-Actions can communicate a failure message by writing to `/dev/message`.
+Actions communicate a failure message by writing to `/tinkerbell/failure-message`. It must not contain new lines.
 
 When an action exits with a non-zero exit code, Tink Worker will arrange to read the reason and message provided by the action image and transmit them, with the action result, to Tink Server. Tink Server will update the action state, reason and message. Providing the reason and message on the action status will ensure the controller populates the `Succeeded` condition as detailed in the Tink CRD Refactor proposal.