Standard configuration files proposal for a vagrant booot2docker environment
Shell
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
ash
bootlocal.sh.d
daemons
lib
param.d
provision.sh.d
proxy
vagrant
.gitattributes
.gitignore
CHANGELOG.md
README.md
VERSION
bootlocal.sh
environment.sh
param.sh
provision.sh

README.md

boot2docker-vagrant-extension

Introduction

Standard extension files proposal for a vagrant boot2docker environment.

It should run with vagrant-boot2docker-box and a project with vagrant-boot2docker-template included all with appropriate versions.

This extension is the heart of environment features and commands but the finest part will come from docker-toolbox that you can run with dk tb command. This will bring you in a custom container with compose and lot of other commands. To exit, just type exit.

Important: please note that all indications below consider that you are in your box run with the vagrant-boot2docker-template.

Available commands

Each command has integrated help, just type the command to see detailed usage.

Box commands

b2d = commands to manage your boot2docker environment.

Just type b2d to see available commands list.

Custom docker commands

dk = docker alias with enhancements.

For all the docker commands please refer to the official documentation.

Just type dk to see available commands list.

Custom docker compose commands

dc = docker-compose utilities for your boot2docker environment.

Just type dc to see available commands list.

Files and folders description

ash

Here you have all custom commands loaded in your environment by this extension.

Deamons

Provide some custom services that run in background to ease the life in the boot2docker world. See inside the folder to know available daemons.

bootlocal.sh.d

Contains all scripts dynamically run by bootlocal.sh.

param.d

All persistent parameter requested by the extension.

provision.sh.d

Contains all scripts dynamically run by provision.sh.

proxy

Contains all your custom proxy definition files. See inside the folder to know which files can be put here with their related usage.

bootlocal.sh, param.sh, provision.sh

Twin script with same ones in the boot2docker-vagrant-template project.

Their twin's in the template project will execute them one in the same stage. Read their docs to know what are their goals.

Known bugs and built-in workaround

Files synchronization between your host and the box

By default, files are shared between your host and your box with Virtualbox Guest additions system.

For very small modifications on your files on your host, it may not sync with your boot2docker. Since 1.10.2 I have added some syncd daemon to refresh regularly the files (every 2 sec). This can do some small overload so you can stop it with b2d syncd stop and do a manual b2d sync when requested.