Name: ubiquity-docker-plugin
Owner: International Business Machines
Description: Ubiquity Docker Plugin
Created: 2017-03-31 22:28:56.0
Updated: 2018-05-08 19:48:05.0
Pushed: 2017-12-06 20:40:22.0
Homepage: null
Size: 38063
Language: Go
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
The Ubiquity Docker volume plugin provides access to persistent storage for Docker containers. This plugin communicates with the Ubiquity service for the creation and management of volumes in storage system.
The code is provided as is, without warranty. Any issue will be handled on a best-effort basis.
Install and configure the plugin on each node in the Docker Swarm cluster that requires access to Ubiquity volumes.
Ubiquity Docker volume plugin is supported on the following operating systems:
Ubiquity Docker volume plugin requires Docker version 17+.
The following sudoers configuration /etc/sudoers is required to run the plugin as root user:
Defaults !requiretty
For non-root users, such as USER, configure the sudoers as follows:
USER ALL= NOPASSWD: /usr/bin/, /bin/, /usr/sbin/
Defaults:%USER !requiretty
Defaults:%USER secure_path = /sbin:/bin:/usr/sbin:/usr/bin
The Docker node must have access to the storage backends. Follow the configuration procedures detailed in the Available Storage Systems section, according to your storage system type.
Download and unpack the application package.
r -p /etc/ubiquity
etc/ubiquity
-L https://github.com/IBM/ubiquity-docker-plugin/releases/download/v0.4.0/ubiquity-docker-plugin-0.4.0.tar.gz | tar xzf -
d u+x ubiquity-docker-plugin
biquity-docker-plugin /usr/bin
wn USER:GROUP /usr/bin/ubiquity-docker-plugin ### Run this command only a non-root user.
biquity-docker-plugin.service /usr/lib/systemd/system/
To run the plugin as non-root user, add the User=USER line under the [Service] item in the /usr/lib/systemd/system/ubiquity-docker-plugin.service file.
Enable the plugin service.
emctl enable ubiquity-docker-plugin.service
Before running the plugin service, you must create and configure the /etc/ubiquity/ubiquity-client.conf file, according to your storage system type.
Follow the configuration procedures detailed in the Available Storage Systems section.
emctl start ubiquity-docker-plugin
ice docker restart
For examples on how to create, remove, list Ubiquity Docker volumes, as well as start and stop stateful containers, refer to the Available Storage Systems section, according to your storage system type.
If the Error looking up volume plugin ubiquity: Plugin does not implement the requested driver error is displayed and the Error in activate remote call &url.Error message is stored in the ubiquity-docker-plugin.log file, verify comminication link between the plugin and Ubiqutiy server nodes. The loss of communication may occur if the relevant TCP ports are not open. The port numbers are detailed in the plugin and Ubiquity server configuration files.
For any questions, suggestions, or issues, use github.
Copyright 2016, 2017 IBM Corp.
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.