108 lines
2.9 KiB
Python
108 lines
2.9 KiB
Python
from .resource import Model, Collection
|
|
|
|
|
|
class Node(Model):
|
|
"""A node in a swarm."""
|
|
id_attribute = 'ID'
|
|
|
|
@property
|
|
def version(self):
|
|
"""
|
|
The version number of the service. If this is not the same as the
|
|
server, the :py:meth:`update` function will not work and you will
|
|
need to call :py:meth:`reload` before calling it again.
|
|
"""
|
|
return self.attrs.get('Version').get('Index')
|
|
|
|
def update(self, node_spec):
|
|
"""
|
|
Update the node's configuration.
|
|
|
|
Args:
|
|
node_spec (dict): Configuration settings to update. Any values
|
|
not provided will be removed. Default: ``None``
|
|
|
|
Returns:
|
|
`True` if the request went through.
|
|
|
|
Raises:
|
|
:py:class:`docker.errors.APIError`
|
|
If the server returns an error.
|
|
|
|
Example:
|
|
|
|
>>> node_spec = {'Availability': 'active',
|
|
'Name': 'node-name',
|
|
'Role': 'manager',
|
|
'Labels': {'foo': 'bar'}
|
|
}
|
|
>>> node.update(node_spec)
|
|
|
|
"""
|
|
return self.client.api.update_node(self.id, self.version, node_spec)
|
|
|
|
def remove(self, force=False):
|
|
"""
|
|
Remove this node from the swarm.
|
|
|
|
Args:
|
|
force (bool): Force remove an active node. Default: `False`
|
|
|
|
Returns:
|
|
`True` if the request was successful.
|
|
|
|
Raises:
|
|
:py:class:`docker.errors.NotFound`
|
|
If the node doesn't exist in the swarm.
|
|
|
|
:py:class:`docker.errors.APIError`
|
|
If the server returns an error.
|
|
"""
|
|
return self.client.api.remove_node(self.id, force=force)
|
|
|
|
|
|
class NodeCollection(Collection):
|
|
"""Nodes on the Docker server."""
|
|
model = Node
|
|
|
|
def get(self, node_id):
|
|
"""
|
|
Get a node.
|
|
|
|
Args:
|
|
node_id (string): ID of the node to be inspected.
|
|
|
|
Returns:
|
|
A :py:class:`Node` object.
|
|
|
|
Raises:
|
|
:py:class:`docker.errors.APIError`
|
|
If the server returns an error.
|
|
"""
|
|
return self.prepare_model(self.client.api.inspect_node(node_id))
|
|
|
|
def list(self, *args, **kwargs):
|
|
"""
|
|
List swarm nodes.
|
|
|
|
Args:
|
|
filters (dict): Filters to process on the nodes list. Valid
|
|
filters: ``id``, ``name``, ``membership`` and ``role``.
|
|
Default: ``None``
|
|
|
|
Returns:
|
|
A list of :py:class:`Node` objects.
|
|
|
|
Raises:
|
|
:py:class:`docker.errors.APIError`
|
|
If the server returns an error.
|
|
|
|
Example:
|
|
|
|
>>> client.nodes.list(filters={'role': 'manager'})
|
|
"""
|
|
return [
|
|
self.prepare_model(n)
|
|
for n in self.client.api.nodes(*args, **kwargs)
|
|
]
|