节点

获取并列出群中的节点。在使用这些方法之前，您首先需要 join or initialize a swarm 。

上提供的方法 client.nodes ：

class NodeCollection

get(id_or_name)

获取一个节点。

参数:

node_id (string) -- 要检查的节点的ID。

返回:

A Node 对象。

抛出:

docker.errors.APIError -- 如果服务器返回错误。

list(**kwargs)

列出群节点。

参数:

filters (dict) -- 要在节点列表上处理的筛选器。有效筛选器： id ， name ， membership 和 role 。默认： None

返回:

一份名单 Node 物体。

抛出:

docker.errors.APIError -- 如果服务器返回错误。

示例

>>> client.nodes.list(filters={'role': 'manager'})

节点对象

class Node

蜂群中的一个节点。

id

对象的ID。

short_id

对象的ID，截断为12个字符。

attrs

服务器中此对象的原始表示形式。

version

服务的版本号。如果这与服务器不同，则 update() 函数将不起作用，您需要调用 reload() 然后再打一次电话。

reload()

再次从服务器加载此对象并更新 attrs 使用新的数据。

update(node_spec)

更新节点的配置。

参数:

node_spec (dict) -- 要更新的配置设置。任何未提供的值都将被删除。默认： None

返回:

True 如果请求通过的话。

抛出:

docker.errors.APIError -- 如果服务器返回错误。

示例

>>> node_spec = {'Availability': 'active',
                 'Name': 'node-name',
                 'Role': 'manager',
                 'Labels': {'foo': 'bar'}
                }
>>> node.update(node_spec)