Difference between revisions of "How To Use Docker Toolbox With MPB"

From MOD Wiki
Jump to navigation Jump to search
Line 14: Line 14:
  
 
<source lang="console">
 
<source lang="console">
$ docker run -l mpb -ti moddevices/mod-plugin-builder
+
$ docker run -ti --name mpb moddevices/mod-plugin-builder
 
</source>
 
</source>
  
 
If you wish to have a local folder accessible inside the docker environment, use the '-v' argument with the local and docker mapped folder joined by a semi-colon. Like this:
 
If you wish to have a local folder accessible inside the docker environment, use the '-v' argument with the local and docker mapped folder joined by a semi-colon. Like this:
 
<source lang="console">
 
<source lang="console">
$ docker run -l mpb -ti moddevices/mod-plugin-builder -v ~/local-mod-folder:/tmp/local-mod-folder
+
$ docker run -ti --name mpb -v ~/local-mod-folder:/tmp/local-mod-folder moddevices/mod-plugin-builder
 
</source>
 
</source>
  

Revision as of 11:33, 25 May 2016

Introduction

This is a quick start guide to get the mod-plugin-plugin working inside docker, running in Windows or MacOS.

We'll be using Docker Toolbox for this.
So before we begin please install that first.

Docker Basics

After you install and run docker toolbox you should be presented with a command-line interface.
This console is actually running Linux inside a virtual machine, but without you having to do any configuration or setup.

To begin, we download the pre-compiled mod-plugin-builder docker image by running:

$ docker run -ti --name mpb moddevices/mod-plugin-builder

If you wish to have a local folder accessible inside the docker environment, use the '-v' argument with the local and docker mapped folder joined by a semi-colon. Like this:

$ docker run -ti --name mpb -v ~/local-mod-folder:/tmp/local-mod-folder moddevices/mod-plugin-builder

Some notes:

  • The image size is around 1Gb, split across several files.
  • The previous commands will create a new docker environment every time you run them. You only need them once.

After you close the console window, you can resume where you left off by running:

$ docker start -i mpb

You can find more information about docker here.