README.md in open-dock-0.1.13 vs README.md in open-dock-0.1.14
- old
+ new
@@ -1,6 +1,6 @@
-# 
+# 
Gem for orchestrating the creation of infrastructures of hosts and containers. You can manage CREATION (in any provider: DigitalOcean, Gcloud, vagrant for the moment), SHIPPING (with docker containers) and CONFIGURING (with Chef). All with 3 commands per host:
1. `ops create prod.example.com`: Create hosts from all possible cloud providers (i.e.: DigitalOcean, GCloud, Rackspace, Linode ...).
1. `ops ship prod.example.com`: Ship those hosts with Docker containers.
@@ -41,11 +41,11 @@
example.com.yml
containers
example.com.yml
```
-## Configure PROVIDER
+## Adding PROVIDER (/providers)
`ops list` command will list all providers supported by this gem.
### Digital Ocean
@@ -77,11 +77,11 @@
google_client_email: "850xxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxtauvbl@developer.gserviceaccount.com"
google_project: "project_name"
google_key_location: "path_to_your_p12_file"
```
-## Configure HOST
+## Creating HOST (/hosts)
With these files you can configure your instances/servers/droplets/ships on every provider you have configured in the last point.
Helpful commands:
@@ -137,11 +137,11 @@
public_key_path: ~/.ssh/id_rsa.pub
source_image: coreos-stable-444-5-0-v20141016
disk_size_gb: 10
```
-##Configure hosted CONTAINERS (Docker)
+## Shipping hosted CONTAINERS (/containers)
To use this command you need [Docker](https://docs.docker.com/installation/) installed in the server.
In this file we can configure all containers to run in the host provided in the name:
@@ -185,16 +185,17 @@
By convention:
* If [host_name] includes "localhost" string, it is assumed that containers are shipped as docker containers in local workstation
-## Configure Containers (are nodes for Chef)
+## Configuring Host (/nodes)
-To use this command you need:
+Configuration with Chef:
-* Chef installed in your nodes
-* SSHd running in your nodes
+* Install Chef and configure host from `nodes/[host_name].json` file
+* Configure all containers in a Host from `nodes/[host_name]/*` containers.
+* Configure specific container in a Host from `nodes/[host_name]/[container_name]` containers.
Configuration with chef commands
* `ops configure HOST_NAME`: configure with chef all containers in host. Here you need to install knife-solo gem.
* Equivalent to: knife solo cook root@[HOST_NAME] -p [each container_ssh_port]
@@ -202,12 +203,16 @@
By convention:
* "root" is the user by default in all containers
* Each container configuration is defined in a Chef node: `nodes/[host_name]/[container_name].json`
+* If there is only a json file, is assumed a non-docker host:
+`nodes/[host_name].json`
```
+# Just configure host from example.com.json
+ops configure example.com
# Configure all containers in 'example.com' host
ops configure example.com
# Configure 'www' container in 'example.com' host
ops configure example.com --container www
# == knife solo cook root@example.com nodes/example.com/www.json -p 2222
@@ -327,5 +332,9 @@
* Create ssh connections commands: 'ops ssh [host_name] [container_name]'
### v0.1.8
* Including Vagrant provider
+
+### v0.1.14
+
+* Adding the posibility to configure non-docker hosts.