Initial commit

Author: bibendi

.gitignore

@@ -0,0 +1,5 @@
+/doc/
+/libs/
+/.crystal/
+/.shards/
+/dip

.travis.yml

@@ -0,0 +1 @@
+language: crystal

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Michail Merkushin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,162 @@
+# DIP
+
+Docker Interaction Process
+
+CLI utility for straightforward provisioning and interacting with application configured by docker-compose.
+
+DIP also contains commands for running support containers such as ssh agent and dns server.
+
+## Installation
+
+```sh
+curl -L https://github.com/bibendi/dip/releases/download/0.1.0/dip-`uname -s`-`uname -m` > /usr/local/bin/dip
+chmod +x /usr/local/bin/dip
+```
+
+## Usage
+
+```sh
+dip --help
+dip SUBCOMMAND --help
+```
+
+### dip compose
+
+Run docker-compose commands that is configured according with application dip.yml
+
+```sh
+dip compose COMMAND [OPTIONS]
+```
+
+### dip ssh
+
+Runs ssh agent container base on https://github.com/whilp/ssh-agent with your ~/.ssh/id_rsa.
+It creates a named volume `ssh_data` with ssh socket.
+An applications docker-compose.yml should define environment variable `SSH_AUTH_SOCK=/ssh/auth/sock` and connect to external volume `ssh_data`.
+
+```sh
+dip ssh add
+```
+
+docker-compose.yml
+
+```yml
+services:
+  web:
+    environment:
+      - SSH_AUTH_SOCK=/ssh/auth/sock
+    volumes:
+      - ssh-data:/ssh:ro
+
+volumes:
+  ssh-data:
+    external:
+      name: ssh_data
+```
+
+## dip dns
+
+Runs DNS server container based on https://github.com/aacebedo/dnsdock
+
+```sh
+dip dns up
+```
+
+### Installation
+
+#### Ubuntu
+
+TODO
+
+#### Mac OS X
+
+First, let's start by configuring the default Docker service DNS server to IP where the DNS server will run (`172.17.0.1`). Currently, this requires SSH'ing into the VM and editing `/etc/default/docker`
+
+```sh
+ssh [email protected]
+
+vi /etc/default/docker
+# Add the DNS server static IP via `--bip` and `--dns`
+# Change DOCKER_ARGS to:
+DOCKER_ARGS="-H unix:///var/run/docker.sock -H tcp://0.0.0.0:2375 -s btrfs --bip=172.17.0.1/24 --dns=172.17.0.1"
+# save :x
+
+exit
+
+dlite stop && dlite start
+```
+
+Lastly, configure OSX so that all `.docker` requests are forwarded to Docker's DNS server. Since routing has already been taken care of, just create a custom resolver under `/etc/resolver/docker` with the following content:
+
+```
+nameserver 172.17.0.1
+```
+
+Then restart OSX's own DNS server:
+
+```sh
+sudo killall -HUP mDNSResponder
+```
+
+By default, Docker creates a virtual interface named `docker0` on the host machine that forwards packets between any other network interface.
+
+However, on OSX, this means you are not able to access the Docker network directly. To be able to do so, you need add a route and allow traffic from any host on the interface that connects to the VM.
+
+Run the following commands on your OSX machine:
+
+```sh
+sudo route -n add 172.17.0.0/8 local.docker
+DOCKER_INTERFACE=$(route get local.docker | grep interface: | cut -f 2 -d: | tr -d ' ')
+DOCKER_INTERFACE_MEMBERSHIP=$(ifconfig ${DOCKER_INTERFACE} | grep member: | cut -f 2 -d: | cut -c 2-4)
+sudo ifconfig "${DOCKER_INTERFACE}" -hostfilter "${DOCKER_INTERFACE_MEMBERSHIP}"
+```
+
+Check:
+
+```sh
+ping dnsdock.docker
+```
+
+# Docker
+
+## Installation
+
+### Ubuntu
+
+TODO
+
+### Mac OS X
+
+```
+sudo brew install docker
+sudo brew switch docker 1.12.1
+```
+
+#### dlite
+
+Download https://github.com/nlf/dlite/releases/download/1.1.5/dlite
+
+```sh
+sudo dlite install -c 2 -m 4 -d 20 -S $HOME
+```
+
+##### Simple
+
+- `dlite stop`
+- download `bzImage` and `rootfs.cpio.xz` https://github.com/bibendi/dhyve-os/releases/tag/2.3.1
+- move in `~/.dlite/`
+- `dlite start`
+
+##### or Advanced (for other docker version)
+
+```sh
+git clone https://github.com/nlf/dhyve-os.git
+cd dhyve-os
+git checkout legacy
+vi Dockerfile
+# find the DOCKER_VERSION and replace with needed version
+make
+dlite stop
+cp output/{bzImage,rootfs.cpio.xz} ~/.dlite/
+dlite start
+```

dip.yml.sample

@@ -0,0 +1,47 @@
+environment:
+  COMPOSE_EXT: development
+  RAILS_ENV: development
+  RAILS_32: "0"
+  RUBY_VERSION: "1.9.3"
+  JOBS: "3"
+  CACHE: ""
+  PROFILE: ""
+  PROJECT: docker
+  DEPLOY: development
+  BUNDLE_PATH: /bundle
+
+compose:
+  files:
+    - docker/docker-compose.yml
+    - docker/docker-compose.$COMPOSE_EXT.yml
+  project_name: pulscen$RAILS_ENV
+
+interaction:
+  exec:
+    service: app
+
+  bundle:
+    service: app
+    command: bundle
+
+  rails:
+    service: app
+    commands:
+      server:
+        alias: s
+        service: web
+
+      console:
+        alias: c
+        start: bundle exec rails c
+
+  psql:
+    service: pg
+    command: psql -h localhost -U postgres pulscen
+
+provision:
+  - docker volume create --name bundle_data
+  - dip exec ./script/config_env
+  - dip compose up -d pg redis
+  - dip bundle install
+  - dip bundle exec rake db:migrate --trace > /dev/null

shard.lock

@@ -0,0 +1,18 @@
+version: 1.0
+shards:
+  cli:
+    github: mosop/cli
+    version: 0.2.3
+
+  optarg:
+    github: mosop/optarg
+    version: 0.3.1
+
+  stdio:
+    github: mosop/stdio
+    version: 0.1.3
+
+  string_inflection:
+    github: mosop/string_inflection
+    version: 0.1.5
+

shard.yml

@@ -0,0 +1,11 @@
+name: dip
+version: 0.1.0
+
+authors:
+  - Michail Merkushin <[email protected]>
+
+license: MIT
+
+dependencies:
+  cli:
+    github: mosop/cli

spec/dip_spec.cr

@@ -0,0 +1,9 @@
+require "./spec_helper"
+
+describe Dip do
+  # TODO: Write tests
+
+  it "works" do
+    false.should eq(true)
+  end
+end

spec/spec_helper.cr

@@ -0,0 +1,2 @@
+require "spec"
+require "../src/dip"

src/dip.cr

@@ -0,0 +1,21 @@
+require "cli"
+require "./dip/version"
+require "./dip/cli"
+require "./dip/config"
+require "./dip/environment"
+
+module Dip
+  def self.config
+    @@config ||= Config.from_yaml(File.read(config_path))
+  end
+
+  def self.config_path
+    ENV.fetch("DIP_FILE", "./dip.yml")
+  end
+
+  def self.env
+    @@env ||= Environment.new(config.environment)
+  end
+end
+
+exit Dip::Cli.run(ARGV).as(Int32)