|
|
@@ -4403,7 +4403,8 @@ List services
|
|
|
"Reservations": {}
|
|
|
},
|
|
|
"RestartPolicy": {
|
|
|
- "Condition": "ANY"
|
|
|
+ "Condition": "any",
|
|
|
+ "MaxAttempts": 0
|
|
|
},
|
|
|
"Placement": {}
|
|
|
},
|
|
|
@@ -4413,26 +4414,36 @@ List services
|
|
|
}
|
|
|
},
|
|
|
"UpdateConfig": {
|
|
|
- "Parallelism": 1
|
|
|
+ "Parallelism": 1,
|
|
|
+ "FailureAction": "pause"
|
|
|
},
|
|
|
"EndpointSpec": {
|
|
|
- "Mode": "VIP",
|
|
|
- "Ingress": "PUBLICPORT",
|
|
|
- "ExposedPorts": [
|
|
|
+ "Mode": "vip",
|
|
|
+ "Ports": [
|
|
|
{
|
|
|
"Protocol": "tcp",
|
|
|
- "Port": 6379
|
|
|
+ "TargetPort": 6379,
|
|
|
+ "PublishedPort": 30001
|
|
|
}
|
|
|
]
|
|
|
}
|
|
|
},
|
|
|
"Endpoint": {
|
|
|
- "Spec": {},
|
|
|
- "ExposedPorts": [
|
|
|
+ "Spec": {
|
|
|
+ "Mode": "vip",
|
|
|
+ "Ports": [
|
|
|
+ {
|
|
|
+ "Protocol": "tcp",
|
|
|
+ "TargetPort": 6379,
|
|
|
+ "PublishedPort": 30001
|
|
|
+ }
|
|
|
+ ]
|
|
|
+ },
|
|
|
+ "Ports": [
|
|
|
{
|
|
|
"Protocol": "tcp",
|
|
|
- "Port": 6379,
|
|
|
- "PublicPort": 30000
|
|
|
+ "TargetPort": 6379,
|
|
|
+ "PublishedPort": 30001
|
|
|
}
|
|
|
],
|
|
|
"VirtualIPs": [
|
|
|
@@ -4618,13 +4629,13 @@ image](#create-an-image) section for more details.
|
|
|
- **FailureAction** - Action to take if an updated task fails to run, or stops running during the
|
|
|
update. Values are `continue` and `pause`.
|
|
|
- **Networks** – Array of network names or IDs to attach the service to.
|
|
|
-- **Endpoint** – Properties that can be configured to access and load balance a service.
|
|
|
- - **Spec** –
|
|
|
- - **Mode** – The mode of resolution to use for internal load balancing
|
|
|
- between tasks (`vip` or `dnsrr`).
|
|
|
- - **Ports** – Exposed ports that this service is accessible on from the outside, in the form
|
|
|
- of: `"Ports": { "<port>/<tcp|udp>: {}" }`
|
|
|
- - **VirtualIPs**
|
|
|
+- **EndpointSpec** – Properties that can be configured to access and load balance a service.
|
|
|
+ - **Mode** – The mode of resolution to use for internal load balancing
|
|
|
+ between tasks (`vip` or `dnsrr`). Defaults to `vip` if not provided.
|
|
|
+ - **Ports** – List of exposed ports that this service is accessible on from
|
|
|
+ the outside, in the form of:
|
|
|
+ `{"Protocol": <"tcp"|"udp">, "PublishedPort": <port>, "TargetPort": <port>}`.
|
|
|
+ Ports can only be provided if `vip` resolution mode is used.
|
|
|
|
|
|
**Request Headers**:
|
|
|
|
|
|
@@ -4677,7 +4688,7 @@ Return information on the service `id`.
|
|
|
"UpdatedAt": "2016-06-07T21:10:20.276301259Z",
|
|
|
"Spec": {
|
|
|
"Name": "redis",
|
|
|
- "Task": {
|
|
|
+ "TaskTemplate": {
|
|
|
"ContainerSpec": {
|
|
|
"Image": "redis"
|
|
|
},
|
|
|
@@ -4686,7 +4697,8 @@ Return information on the service `id`.
|
|
|
"Reservations": {}
|
|
|
},
|
|
|
"RestartPolicy": {
|
|
|
- "Condition": "ANY"
|
|
|
+ "Condition": "any",
|
|
|
+ "MaxAttempts": 0
|
|
|
},
|
|
|
"Placement": {}
|
|
|
},
|
|
|
@@ -4696,26 +4708,36 @@ Return information on the service `id`.
|
|
|
}
|
|
|
},
|
|
|
"UpdateConfig": {
|
|
|
- "Parallelism": 1
|
|
|
+ "Parallelism": 1,
|
|
|
+ "FailureAction": "pause"
|
|
|
},
|
|
|
"EndpointSpec": {
|
|
|
- "Mode": "VIP",
|
|
|
- "Ingress": "PUBLICPORT",
|
|
|
- "ExposedPorts": [
|
|
|
+ "Mode": "vip",
|
|
|
+ "Ports": [
|
|
|
{
|
|
|
"Protocol": "tcp",
|
|
|
- "Port": 6379
|
|
|
+ "TargetPort": 6379,
|
|
|
+ "PublishedPort": 30001
|
|
|
}
|
|
|
]
|
|
|
}
|
|
|
},
|
|
|
"Endpoint": {
|
|
|
- "Spec": {},
|
|
|
- "ExposedPorts": [
|
|
|
+ "Spec": {
|
|
|
+ "Mode": "vip",
|
|
|
+ "Ports": [
|
|
|
+ {
|
|
|
+ "Protocol": "tcp",
|
|
|
+ "TargetPort": 6379,
|
|
|
+ "PublishedPort": 30001
|
|
|
+ }
|
|
|
+ ]
|
|
|
+ },
|
|
|
+ "Ports": [
|
|
|
{
|
|
|
"Protocol": "tcp",
|
|
|
- "Port": 6379,
|
|
|
- "PublicPort": 30001
|
|
|
+ "TargetPort": 6379,
|
|
|
+ "PublishedPort": 30001
|
|
|
}
|
|
|
],
|
|
|
"VirtualIPs": [
|
|
|
@@ -4829,7 +4851,7 @@ image](#create-an-image) section for more details.
|
|
|
as part of this service.
|
|
|
- **Condition** – Condition for restart (`none`, `on-failure`, or `any`).
|
|
|
- **Delay** – Delay between restart attempts.
|
|
|
- - **Attempts** – Maximum attempts to restart a given container before giving up (default value
|
|
|
+ - **MaxAttempts** – Maximum attempts to restart a given container before giving up (default value
|
|
|
is 0, which is ignored).
|
|
|
- **Window** – Windows is the time window used to evaluate the restart policy (default value is
|
|
|
0, which is unbounded).
|
|
|
@@ -4840,13 +4862,13 @@ image](#create-an-image) section for more details.
|
|
|
parallelism).
|
|
|
- **Delay** – Amount of time between updates.
|
|
|
- **Networks** – Array of network names or IDs to attach the service to.
|
|
|
-- **Endpoint** – Properties that can be configured to access and load balance a service.
|
|
|
- - **Spec** –
|
|
|
- - **Mode** – The mode of resolution to use for internal load balancing
|
|
|
- between tasks (`vip` or `dnsrr`).
|
|
|
- - **Ports** – Exposed ports that this service is accessible on from the outside, in the form
|
|
|
- of: `"Ports": { "<port>/<tcp|udp>: {}" }`
|
|
|
- - **VirtualIPs**
|
|
|
+- **EndpointSpec** – Properties that can be configured to access and load balance a service.
|
|
|
+ - **Mode** – The mode of resolution to use for internal load balancing
|
|
|
+ between tasks (`vip` or `dnsrr`). Defaults to `vip` if not provided.
|
|
|
+ - **Ports** – List of exposed ports that this service is accessible on from
|
|
|
+ the outside, in the form of:
|
|
|
+ `{"Protocol": <"tcp"|"udp">, "PublishedPort": <port>, "TargetPort": <port>}`.
|
|
|
+ Ports can only be provided if `vip` resolution mode is used.
|
|
|
|
|
|
**Query parameters**:
|
|
|
|
|
|
@@ -4865,7 +4887,7 @@ image](#create-an-image) section for more details.
|
|
|
- **200** – no error
|
|
|
- **404** – no such service
|
|
|
- **500** – server error
|
|
|
-
|
|
|
+
|
|
|
## 3.10 Tasks
|
|
|
|
|
|
**Note**: Task operations require the engine to be part of a swarm.
|
|
|
@@ -4891,7 +4913,6 @@ List tasks
|
|
|
},
|
|
|
"CreatedAt": "2016-06-07T21:07:31.171892745Z",
|
|
|
"UpdatedAt": "2016-06-07T21:07:31.376370513Z",
|
|
|
- "Name": "hopeful_cori",
|
|
|
"Spec": {
|
|
|
"ContainerSpec": {
|
|
|
"Image": "redis"
|
|
|
@@ -4901,21 +4922,24 @@ List tasks
|
|
|
"Reservations": {}
|
|
|
},
|
|
|
"RestartPolicy": {
|
|
|
- "Condition": "ANY"
|
|
|
+ "Condition": "any",
|
|
|
+ "MaxAttempts": 0
|
|
|
},
|
|
|
"Placement": {}
|
|
|
},
|
|
|
"ServiceID": "9mnpnzenvg8p8tdbtq4wvbkcz",
|
|
|
- "Instance": 1,
|
|
|
- "NodeID": "24ifsmvkjbyhk",
|
|
|
- "ServiceAnnotations": {},
|
|
|
+ "Slot": 1,
|
|
|
+ "NodeID": "60gvrl6tm78dmak4yl7srz94v",
|
|
|
"Status": {
|
|
|
"Timestamp": "2016-06-07T21:07:31.290032978Z",
|
|
|
- "State": "FAILED",
|
|
|
- "Message": "execution failed",
|
|
|
- "ContainerStatus": {}
|
|
|
+ "State": "running",
|
|
|
+ "Message": "started",
|
|
|
+ "ContainerStatus": {
|
|
|
+ "ContainerID": "e5d62702a1b48d01c3e02ca1e0212a250801fa8d67caca0b6f35919ebc12f035",
|
|
|
+ "PID": 677
|
|
|
+ }
|
|
|
},
|
|
|
- "DesiredState": "SHUTDOWN",
|
|
|
+ "DesiredState": "running",
|
|
|
"NetworksAttachments": [
|
|
|
{
|
|
|
"Network": {
|
|
|
@@ -4931,12 +4955,12 @@ List tasks
|
|
|
"com.docker.swarm.internal": "true"
|
|
|
},
|
|
|
"DriverConfiguration": {},
|
|
|
- "IPAM": {
|
|
|
+ "IPAMOptions": {
|
|
|
"Driver": {},
|
|
|
"Configs": [
|
|
|
{
|
|
|
- "Family": "UNKNOWN",
|
|
|
- "Subnet": "10.255.0.0/16"
|
|
|
+ "Subnet": "10.255.0.0/16",
|
|
|
+ "Gateway": "10.255.0.1"
|
|
|
}
|
|
|
]
|
|
|
}
|
|
|
@@ -4947,14 +4971,14 @@ List tasks
|
|
|
"com.docker.network.driver.overlay.vxlanid_list": "256"
|
|
|
}
|
|
|
},
|
|
|
- "IPAM": {
|
|
|
+ "IPAMOptions": {
|
|
|
"Driver": {
|
|
|
"Name": "default"
|
|
|
},
|
|
|
"Configs": [
|
|
|
{
|
|
|
- "Family": "UNKNOWN",
|
|
|
- "Subnet": "10.255.0.0/16"
|
|
|
+ "Subnet": "10.255.0.0/16",
|
|
|
+ "Gateway": "10.255.0.1"
|
|
|
}
|
|
|
]
|
|
|
}
|
|
|
@@ -4964,26 +4988,6 @@ List tasks
|
|
|
]
|
|
|
}
|
|
|
],
|
|
|
- "Endpoint": {
|
|
|
- "Spec": {},
|
|
|
- "ExposedPorts": [
|
|
|
- {
|
|
|
- "Protocol": "tcp",
|
|
|
- "Port": 6379,
|
|
|
- "PublicPort": 30000
|
|
|
- }
|
|
|
- ],
|
|
|
- "VirtualIPs": [
|
|
|
- {
|
|
|
- "NetworkID": "4qvuz4ko70xaltuqbt8956gd1",
|
|
|
- "Addr": "10.255.0.2/16"
|
|
|
- },
|
|
|
- {
|
|
|
- "NetworkID": "4qvuz4ko70xaltuqbt8956gd1",
|
|
|
- "Addr": "10.255.0.3/16"
|
|
|
- }
|
|
|
- ]
|
|
|
- }
|
|
|
},
|
|
|
{
|
|
|
"ID": "1yljwbmlr8er2waf8orvqpwms",
|
|
|
@@ -5002,21 +5006,23 @@ List tasks
|
|
|
"Reservations": {}
|
|
|
},
|
|
|
"RestartPolicy": {
|
|
|
- "Condition": "ANY"
|
|
|
+ "Condition": "any",
|
|
|
+ "MaxAttempts": 0
|
|
|
},
|
|
|
"Placement": {}
|
|
|
},
|
|
|
"ServiceID": "9mnpnzenvg8p8tdbtq4wvbkcz",
|
|
|
- "Instance": 1,
|
|
|
- "NodeID": "24ifsmvkjbyhk",
|
|
|
- "ServiceAnnotations": {},
|
|
|
+ "Slot": 1,
|
|
|
+ "NodeID": "60gvrl6tm78dmak4yl7srz94v",
|
|
|
"Status": {
|
|
|
"Timestamp": "2016-06-07T21:07:30.202183143Z",
|
|
|
- "State": "FAILED",
|
|
|
- "Message": "execution failed",
|
|
|
- "ContainerStatus": {}
|
|
|
+ "State": "shutdown",
|
|
|
+ "Message": "shutdown",
|
|
|
+ "ContainerStatus": {
|
|
|
+ "ContainerID": "1cf8d63d18e79668b0004a4be4c6ee58cddfad2dae29506d8781581d0688a213"
|
|
|
+ }
|
|
|
},
|
|
|
- "DesiredState": "SHUTDOWN",
|
|
|
+ "DesiredState": "shutdown",
|
|
|
"NetworksAttachments": [
|
|
|
{
|
|
|
"Network": {
|
|
|
@@ -5032,12 +5038,12 @@ List tasks
|
|
|
"com.docker.swarm.internal": "true"
|
|
|
},
|
|
|
"DriverConfiguration": {},
|
|
|
- "IPAM": {
|
|
|
+ "IPAMOptions": {
|
|
|
"Driver": {},
|
|
|
"Configs": [
|
|
|
{
|
|
|
- "Family": "UNKNOWN",
|
|
|
- "Subnet": "10.255.0.0/16"
|
|
|
+ "Subnet": "10.255.0.0/16",
|
|
|
+ "Gateway": "10.255.0.1"
|
|
|
}
|
|
|
]
|
|
|
}
|
|
|
@@ -5048,14 +5054,14 @@ List tasks
|
|
|
"com.docker.network.driver.overlay.vxlanid_list": "256"
|
|
|
}
|
|
|
},
|
|
|
- "IPAM": {
|
|
|
+ "IPAMOptions": {
|
|
|
"Driver": {
|
|
|
"Name": "default"
|
|
|
},
|
|
|
"Configs": [
|
|
|
{
|
|
|
- "Family": "UNKNOWN",
|
|
|
- "Subnet": "10.255.0.0/16"
|
|
|
+ "Subnet": "10.255.0.0/16",
|
|
|
+ "Gateway": "10.255.0.1"
|
|
|
}
|
|
|
]
|
|
|
}
|
|
|
@@ -5064,27 +5070,7 @@ List tasks
|
|
|
"10.255.0.5/16"
|
|
|
]
|
|
|
}
|
|
|
- ],
|
|
|
- "Endpoint": {
|
|
|
- "Spec": {},
|
|
|
- "ExposedPorts": [
|
|
|
- {
|
|
|
- "Protocol": "tcp",
|
|
|
- "Port": 6379,
|
|
|
- "PublicPort": 30000
|
|
|
- }
|
|
|
- ],
|
|
|
- "VirtualIPs": [
|
|
|
- {
|
|
|
- "NetworkID": "4qvuz4ko70xaltuqbt8956gd1",
|
|
|
- "Addr": "10.255.0.2/16"
|
|
|
- },
|
|
|
- {
|
|
|
- "NetworkID": "4qvuz4ko70xaltuqbt8956gd1",
|
|
|
- "Addr": "10.255.0.3/16"
|
|
|
- }
|
|
|
- ]
|
|
|
- }
|
|
|
+ ]
|
|
|
}
|
|
|
]
|
|
|
|
|
|
@@ -5124,7 +5110,6 @@ Get details on a task
|
|
|
},
|
|
|
"CreatedAt": "2016-06-07T21:07:31.171892745Z",
|
|
|
"UpdatedAt": "2016-06-07T21:07:31.376370513Z",
|
|
|
- "Name": "hopeful_cori",
|
|
|
"Spec": {
|
|
|
"ContainerSpec": {
|
|
|
"Image": "redis"
|
|
|
@@ -5134,21 +5119,24 @@ Get details on a task
|
|
|
"Reservations": {}
|
|
|
},
|
|
|
"RestartPolicy": {
|
|
|
- "Condition": "ANY"
|
|
|
+ "Condition": "any",
|
|
|
+ "MaxAttempts": 0
|
|
|
},
|
|
|
"Placement": {}
|
|
|
},
|
|
|
"ServiceID": "9mnpnzenvg8p8tdbtq4wvbkcz",
|
|
|
- "Instance": 1,
|
|
|
- "NodeID": "24ifsmvkjbyhk",
|
|
|
- "ServiceAnnotations": {},
|
|
|
+ "Slot": 1,
|
|
|
+ "NodeID": "60gvrl6tm78dmak4yl7srz94v",
|
|
|
"Status": {
|
|
|
"Timestamp": "2016-06-07T21:07:31.290032978Z",
|
|
|
- "State": "FAILED",
|
|
|
- "Message": "execution failed",
|
|
|
- "ContainerStatus": {}
|
|
|
+ "State": "running",
|
|
|
+ "Message": "started",
|
|
|
+ "ContainerStatus": {
|
|
|
+ "ContainerID": "e5d62702a1b48d01c3e02ca1e0212a250801fa8d67caca0b6f35919ebc12f035",
|
|
|
+ "PID": 677
|
|
|
+ }
|
|
|
},
|
|
|
- "DesiredState": "SHUTDOWN",
|
|
|
+ "DesiredState": "running",
|
|
|
"NetworksAttachments": [
|
|
|
{
|
|
|
"Network": {
|
|
|
@@ -5164,12 +5152,12 @@ Get details on a task
|
|
|
"com.docker.swarm.internal": "true"
|
|
|
},
|
|
|
"DriverConfiguration": {},
|
|
|
- "IPAM": {
|
|
|
+ "IPAMOptions": {
|
|
|
"Driver": {},
|
|
|
"Configs": [
|
|
|
{
|
|
|
- "Family": "UNKNOWN",
|
|
|
- "Subnet": "10.255.0.0/16"
|
|
|
+ "Subnet": "10.255.0.0/16",
|
|
|
+ "Gateway": "10.255.0.1"
|
|
|
}
|
|
|
]
|
|
|
}
|
|
|
@@ -5180,14 +5168,14 @@ Get details on a task
|
|
|
"com.docker.network.driver.overlay.vxlanid_list": "256"
|
|
|
}
|
|
|
},
|
|
|
- "IPAM": {
|
|
|
+ "IPAMOptions": {
|
|
|
"Driver": {
|
|
|
"Name": "default"
|
|
|
},
|
|
|
"Configs": [
|
|
|
{
|
|
|
- "Family": "UNKNOWN",
|
|
|
- "Subnet": "10.255.0.0/16"
|
|
|
+ "Subnet": "10.255.0.0/16",
|
|
|
+ "Gateway": "10.255.0.1"
|
|
|
}
|
|
|
]
|
|
|
}
|
|
|
@@ -5196,27 +5184,7 @@ Get details on a task
|
|
|
"10.255.0.10/16"
|
|
|
]
|
|
|
}
|
|
|
- ],
|
|
|
- "Endpoint": {
|
|
|
- "Spec": {},
|
|
|
- "ExposedPorts": [
|
|
|
- {
|
|
|
- "Protocol": "tcp",
|
|
|
- "Port": 6379,
|
|
|
- "PublicPort": 30000
|
|
|
- }
|
|
|
- ],
|
|
|
- "VirtualIPs": [
|
|
|
- {
|
|
|
- "NetworkID": "4qvuz4ko70xaltuqbt8956gd1",
|
|
|
- "Addr": "10.255.0.2/16"
|
|
|
- },
|
|
|
- {
|
|
|
- "NetworkID": "4qvuz4ko70xaltuqbt8956gd1",
|
|
|
- "Addr": "10.255.0.3/16"
|
|
|
- }
|
|
|
- ]
|
|
|
- }
|
|
|
+ ]
|
|
|
}
|
|
|
|
|
|
**Status codes**:
|
Sebastiaan van Stijn