Plugins

Manage plugins on the server.

Methods available on client.plugins:

class PluginCollection
get(name)

Gets a plugin.

Parameters:

name (str) – The name of the plugin.

Returns:

The plugin.

Return type:

(Plugin)

Raises:
  • docker.errors.NotFound If the plugin does not
  • exist.
  • docker.errors.APIError – If the server returns an error.
install(remote_name, local_name=None)

Pull and install a plugin.

Parameters:
  • remote_name (string) – Remote reference for the plugin to install. The :latest tag is optional, and is the default if omitted.
  • local_name (string) – Local name for the pulled plugin. The :latest tag is optional, and is the default if omitted. Optional.
Returns:

The installed plugin

Return type:

(Plugin)

Raises:

docker.errors.APIError – If the server returns an error.

list()

List plugins installed on the server.

Returns:The plugins.
Return type:(list of Plugin)
Raises:docker.errors.APIError – If the server returns an error.

Plugin objects

class Plugin

A plugin on the server.

id

The ID of the object.

short_id

The ID of the object, truncated to 10 characters.

name

The plugin’s name.

enabled

Whether the plugin is enabled.

settings

A dictionary representing the plugin’s configuration.

attrs

The raw representation of this object from the server.

configure(options)

Update the plugin’s settings.

Parameters:options (dict) – A key-value mapping of options.
Raises:docker.errors.APIError – If the server returns an error.
disable()

Disable the plugin.

Raises:docker.errors.APIError – If the server returns an error.
enable(timeout=0)

Enable the plugin.

Parameters:timeout (int) – Timeout in seconds. Default: 0
Raises:docker.errors.APIError – If the server returns an error.
reload()

Load this object from the server again and update attrs with the new data.

push()

Push the plugin to a remote registry.

Returns:A dict iterator streaming the status of the upload.
Raises:docker.errors.APIError – If the server returns an error.
remove(force=False)

Remove the plugin from the server.

Parameters:force (bool) – Remove even if the plugin is enabled. Default: False
Raises:docker.errors.APIError – If the server returns an error.
upgrade(remote=None)

Upgrade the plugin.

Parameters:remote (string) – Remote reference to upgrade to. The :latest tag is optional and is the default if omitted. Default: this plugin’s name.
Returns:A generator streaming the decoded API logs