p42

# 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.