tvansteenburgh/charmbox repository overview

⁠Charmbox

Charmbox is an extension of the jujubox⁠ container which adds tools for development, testing, and review of Juju Charms.

⁠Usage

⁠Juju Inside Docker

If you already have Docker installed (see below), and you don't want to install Juju on your host machine, the container can be run directly from Docker Hub:

sudo docker run --rm -ti jujusolutions/charmbox

Once inside the container, you can use quickstart to set up Juju with any provider except local, and use bundletester to test a charm:

$ubuntu@ab3d:~/$ juju quickstart
$ubuntu@ab3d:~/$ bundletester -t cs:trusty/ubuntu

Note that local provider is not currently available within the container, but it is possible to use an existing local provider with Charmbox (see below).

⁠Using Charmbox with Existing Juju

If you already have Juju configured, you can use your existing Juju installation, including any environments, with a few extra arguments to the run command:

sudo docker run --rm -ti --net=host -v $HOME/.juju:/home/ubuntu/.juju jujusolutions/charmbox

⁠Using Charmbox with Existing Juju and Local Provider

If you wish to use local provider, you will need to bootstrap from outside the container, but all subsequent operations will work normally within the container:

juju switch local
juju bootstrap
sudo docker run --rm --net=host -v $HOME/.juju:/home/ubuntu/.juju -ti charmbox

Once inside the container, you can use bundletester to test a charm:

$ubuntu@ab3d:~/$ bundletester -t lp:~user/charms/trusty/foo/branch
$ubuntu@ab3d:~/$ exit

Once you are done with the container, make sure you destroy the local provider that you bootstrapped:

juju destroy-environment local

⁠Using Charmbox with Charms on your Host Machine

If you have charms already checked out on your host machine, you can mount the Juju repository subdirectory:

sudo docker run --rm -ti -v $JUJU_REPOSITORY/trusty:/home/ubuntu/trusty jujusolutions/charmbox

At this time, you cannot directly mount $JUJU_REPOSITORY inside the container because it would overwrite /home/ubuntu. Thus, it is recommended that you mount the trusty or precise subdirectories.

⁠Building Charmbox from Source

git clone https://github.com/juju-solutions/charmbox.git && cd charmbox
sudo docker build -t charmbox .
sudo docker run --rm -ti charmbox

⁠Installing Docker

⁠Linux

Install Docker using the package manager for your distro, or get.docker.com⁠.

Docker >= 1.4.1 recommended.

⁠OS X

Docker does not run natively in OS X, so we'll need to use VirtualBox and boot2docker. This is relatively easy for users of brew:

brew install cask
brew cask install virtualbox
brew install docker
brew install boot2docker

boot2docker init
boot2docker up

When boot2docker finishes, it will prompt you to export Docker environment variables. With that done, you're ready to use docker. You do not need to run the docker commands using sudo because boot2docker runs as root.

docker run  -ti jujusolutions/charmbox