docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Add swarm task state REMOVE (#6206)

This commit is contained in:
Gwendolynne Barr 2018-04-11 13:46:29 -07:00 committed by GitHub
parent 246e8e2e3a
commit 542032cf21
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 14 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
engine/swarm/how-swarm-mode-works/swarm-task-states.md
View File

@ -6,23 +6,18 @@ redirect_from:
- /datacenter/ucp/2.2/guides/admin/monitor-and-troubleshoot/troubleshoot-task-state/
---
Docker lets you create services, which can start tasks.
A service is a description of a desired state, and a task does the work.
Docker lets you create services, which can start tasks. A service is a description of a desired state, and a task does the work.
Work is scheduled on swarm nodes in this sequence:
1. Create a service by using `docker service create` or the UCP web UI or CLI.
2. The request goes to a Docker manager node.
2. The Docker manager node schedules the service to run on particular nodes.
3. Each service can start multiple tasks.
4. Each task has a life cycle, with states like `NEW`, `PENDING`, and `COMPLETE`.
1. Create a service by using `docker service create` or the UCP web UI or CLI.
2. The request goes to a Docker manager node.
3. The Docker manager node schedules the service to run on particular nodes.
4. Each service can start multiple tasks.
5. Each task has a life cycle, with states like `NEW`, `PENDING`, and `COMPLETE`.
Tasks are execution units that run once to completion. When a task stops,
it isn't executed again, but a new task may take its place.
Tasks are execution units that run once to completion. When a task stops, it isn't executed again, but a new task may take its place.
Tasks advance through a number of states until they complete or fail. Tasks
are initialized in the `NEW` state. The task progresses forward through a
number of states, and its state doesn't go backward. For example, a task never
goes from `COMPLETE` to `RUNNING`.
Tasks advance through a number of states until they complete or fail. Tasks are initialized in the `NEW` state. The task progresses forward through a number of states, and its state doesn't go backward. For example, a task never goes from `COMPLETE` to `RUNNING`.
Tasks go through the states in the following order:
@ -40,21 +35,22 @@ Tasks go through the states in the following order:
| `SHUTDOWN` | Docker requested the task to shut down. |
| `REJECTED` | The worker node rejected the task. |
| `ORPHANED` | The node was down for too long. |
| `REMOVE` | The task is not terminal but the associated service was removed or scaled down. |
## View task state
Run `docker service ps <service-name>` to get the state of a task. The
`CURRENT STATE` field shows the task's state and how long it's been
`CURRENT STATE` field shows the task's state and how long it's been
there.
```bash
$ docker service ps webserver
ID NAME IMAGE NODE DESIRED STATE CURRENT STATE ERROR PORTS
owsz0yp6z375 webserver.1 nginx UbuntuVM Running Running 44 seconds ago
j91iahr8s74p \_ webserver.1 nginx UbuntuVM Shutdown Failed 50 seconds ago "No such container: webserver.…"
7dyaszg13mw2 \_ webserver.1 nginx UbuntuVM Shutdown Failed 5 hours ago "No such container: webserver.…"
owsz0yp6z375 webserver.1 nginx UbuntuVM Running Running 44 seconds ago
j91iahr8s74p \_ webserver.1 nginx UbuntuVM Shutdown Failed 50 seconds ago "No such container: webserver.…"
7dyaszg13mw2 \_ webserver.1 nginx UbuntuVM Shutdown Failed 5 hours ago "No such container: webserver.…"
```
## Where to go next
- [Learn about swarm tasks](https://github.com/docker/swarmkit/blob/master/design/task_model.md)
- [Learn about swarm tasks](https://github.com/docker/swarmkit/blob/master/design/task_model.md)