CLI that simplifies the use of Docker Machine, Swarm, and Compose
CoffeeScript
Latest commit 744607c Aug 6, 2016 @dyoder dyoder committed on GitHub Update README.md
Permalink
Failed to load latest commit information.
bin
doc
share
src
test
.gitignore
LICENSE
README.md
package.json

README.md

p42

IMPORTANT This project is no longer under active development. Based on what we've learned building this, we recommend looking at Convox instead.

A CLI for simplifying the use of AWS with Docker Swarm.

Getting Started

Prerequites

  • Bash version 3 or later
  • Docker version 1.10
  • Docker Machine version 0.6 release candidate (see below)
  • AWS CLI version 1.10.8
  • Node version 4 or later
  • NPM version 2 or later
  • yaml (via npm install yaml -g) version 1 or later

To install the Docker Machine release candidate, run the following from the shell:

curl -L https://github.com/docker/machine/releases/download/v0.6.0-rc4/docker-machine-`uname -s`-`uname -m` > /usr/local/bin/docker-machine && \\
chmod +x /usr/local/bin/docker-machine

Installation

$ npm install -g p42

Creating A Cluster

$ p42 cluster create
Creating VPC [red-ghost]...

Add Nodes To The Cluster

To add 3 nodes to a cluster:

$ p42 cluster add red-ghost -n 3

To add just one:

$ p42 cluster add red-ghost

Using Docker Commands

If you want to use Docker commands directly:

$ eval $(p42 cluster env red-ghost)

which will select the Swarm master, if possible, or the default machine otherwise.

Examining Your Cluster

p42 cluster ls red-ghost

Running An App

Initialize Your App

$ p42 init
Application name [blurb9]:
Organization repository [pandastrike]:

Add Mixins

Provide the git cloneable URL for the mixin repo:

$ p42 mixin add git@github.com:pandastrike/p42-mixin-nginx.git
Document root [www]:

Add Target

Add the cluster as a target for your app.

$ p42 target add master red-ghost

Run Your App

The run command will build and run all the images described in your launch directory.

$ p42 run

Example

Let's build a simple Web page and deploy it using p42.

We'll assume we've already run a cluster (see Creating A Cluster).

Let's create an application directory and initialize it.

$ mkdir hello-world
$ cd hello-world
$ p42 init
Application name [hello-world]:
Organization repository []: pandastrike

Add the Nginx mixin.

$ p42 mixin add git@github.com:pandastrike/p42-mixin-nginx.git
Document root [www]:

This will create a launch/www directory that includes a Dockerfile for running Nginx.

Create an index HTML file.

$ mkdir www
$ cat >> www/index.html
<h1>Hello, World!</h1>

Run your application.

$ p42 run

This will take a minute to build and run the image described by launch/www/Dockerfile.

Get the IP and port of your Nginx container.

$ p42 ps
swarm-01/hello-world-www 159.203.247.225:32769->80/tcp, 159.203.247.225:32768->443/tcp
$ curl 159.203.247.225:32769
<h1>Hello, World!</h1>

Autocomplete

You can add autocomplete to your shell by running:

$ eval $(p42 env -)

Status

p42 is under heavy development.

Reference

Run p42 help to get a list of commands and what they do.