MachineConfigure
Export or import your docker-machine's configuration files,
and share them with others.
Table of Contents
- Description
- Installation
- Install manually
- Usage
- Exporting
- Example
- Importing
- Example
- Exporting
- TODO
- License
Description
This gem is heavily inspired by machine-share,
a nodejs package, which does basically the same thing as this gem.
I just had some minor inconveniences with it,
so I decided I would write my own version in Ruby.
If you use docker-machine, this might come in handy,
if you ever want to share your remote docker-machine instance
with a collegue or across multiple machines.
With this gem, you can export your configuration files for a specific
docker-machine instance into a zip file. You can then share the created
zip file with others / other computers and import it again.
Installation
Install from rubygems with ...
$ gem install machine_configure
Install manually
If you want to install the gem manually from this repository directly,
you'll need to:
- Clone the repository,
- install all dependencies,
- build the gem, and
- install it.
Here's a command to copy/paste, it does all of the above ...
git clone https://github.com/Noah2610/MachineConfigure.git && \
cd MachineConfigure && \
bundle install --with development && \
rake build && \
gems=($(ls pkg/machine_configure-*)); \
gem install "${gems[-1]}"; \
unset gems
Once this completes, you should have the gem installed.
You can try using it by executing maccon
.
Usage
Exporting
To export the configurations of an existing docker-machine instance,
use the export
keyword, pass the machine's name,
and optionally, the output zip file.
Example
$ maccon export my_machine # Creates my_machine.zip
$ maccon export my_machine my_machine_configs.zip # Creates my_machine_configs.zip
Importing
To import a docker-machine's configuration files from a zip file,
use the import
keyword, and pass the target zip file.
Example
$ maccon import my_machine_configs.zip
For all command-line options, see --help
.
TODO
See the Trello Board for open tasks.
License
The gem is available as open source under the terms of the MIT License.