You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by an...@apache.org on 2017/09/29 20:31:35 UTC
[02/11] mesos git commit: Added documentation about 'MARK_AGENT_GONE'
call.
Added documentation about 'MARK_AGENT_GONE' call.
Review: https://reviews.apache.org/r/62529
Project: http://git-wip-us.apache.org/repos/asf/mesos/repo
Commit: http://git-wip-us.apache.org/repos/asf/mesos/commit/6001e8ae
Tree: http://git-wip-us.apache.org/repos/asf/mesos/tree/6001e8ae
Diff: http://git-wip-us.apache.org/repos/asf/mesos/diff/6001e8ae
Branch: refs/heads/master
Commit: 6001e8aefed87864b6ab289cbacb9dcf394fe538
Parents: c0468b2
Author: Anand Mazumdar <an...@apache.org>
Authored: Fri Sep 29 11:58:34 2017 -0700
Committer: Anand Mazumdar <an...@apache.org>
Committed: Fri Sep 29 13:31:08 2017 -0700
----------------------------------------------------------------------
docs/operator-http-api.md | 35 +++++++++++++++++++++++++++++++++++
1 file changed, 35 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/mesos/blob/6001e8ae/docs/operator-http-api.md
----------------------------------------------------------------------
diff --git a/docs/operator-http-api.md b/docs/operator-http-api.md
index f6cfcf1..37593b3 100644
--- a/docs/operator-http-api.md
+++ b/docs/operator-http-api.md
@@ -2324,6 +2324,41 @@ HTTP/1.1 202 Accepted
```
+### MARK_AGENT_GONE
+
+This call can be used by operators to assert that an agent instance has
+failed and is never coming back (e.g., ephemeral instance from cloud provider).
+The master would shutdown the agent and send `TASK_GONE_BY_OPERATOR` updates
+for all the running tasks. This signal can be used by stateful frameworks to
+re-schedule their workloads (volumes, reservations etc.) to other agent
+instances. It is possible that the tasks might still be running if the
+operator's assertion was wrong and the agent was partitioned away from
+the master. The agent would be shutdown when it tries to re-register with the
+master when the partition heals. This call is idempotent.
+
+```
+MARK_AGENT_GONE HTTP Request (JSON):
+
+POST /api/v1 HTTP/1.1
+
+Host: masterhost:5050
+Content-Type: application/json
+Accept: application/json
+
+{
+ "type": "MARK_AGENT_GONE",
+ "mark_agent_gone": {
+ "agent_id": {
+ "value": "3192b9d1-db71-4699-ae25-e28dfbf42de1"
+ }
+ }
+}
+
+MARK_AGENT_GONE HTTP Response (JSON):
+
+HTTP/1.1 200 OK
+```
+
## Events
Currently, the only call that results in a streaming response is the `SUBSCRIBE` call sent to the master API.