# p42

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:

```sh
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.

```tty
$ 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](#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.