Merge pull request #313 from robertojrojas/issue-75

issue #75: docs on footloose/ignite integration

docs/footloose-ignite-integration.md

@@ -0,0 +1,52 @@
+# Run Ignite VMs declaratively using Footloose
+
+This how you can have Footloose invoke Ignite in a _declaratively_ manner, using a file containing
+an API object.
+
+An example file as follows: 
+
+```yaml
+cluster:
+  name: cluster
+  privateKey: cluster-key
+machines:
+- count: 1
+  spec:
+    image: weaveworks/ignite-kubeadm:latest
+    name: master%d
+    portMappings:
+    - containerPort: 22
+    backend: ignite
+    ignite:
+      cpus: 2
+      memory: 4GB
+      diskSize: 30GB
+      kernel: "weaveworks/ignite-kernel:4.19.47"
+      copyFiles:
+        "<ABSOLUTE_PATH>/run/pki/ca.crt": "/etc/kubernetes/pki/ca.crt"
+        "<ABSOLUTE_PATH>/run/pki/ca.key": "/etc/kubernetes/pki/ca.key"
+```
+
+This Footloose API object specifies an Ignite VM with 2 vCPUs, 4GB of RAM, `weaveworks/ignite-kernel:4.19.47` kernel and 30GB of disk.
+You can specify the files that need to be copied to the VM using the `copyFiles` property.
+
+We can tell Footloose to fire up Ignite using simply:
+
+```console
+$ footloose --config footloose.k8s.yaml create
+```
+
+Run the following to stop the vm:
+```console
+$ footloose --config footloose.k8s.yaml stop
+```
+
+Run the following to delete the vm:
+```console
+$ footloose --config footloose.k8s.yaml delete
+```
+
+Here is an [Kubernetes VMs Example](https://github.com/ignite/docs/footloose.k8s.yaml) that configures a 2 VMs cluster.
+
+For more information on [Footloose](https://github.com/weaveworks/footloose/).
+

docs/footloose.k8s.yaml

@@ -0,0 +1,38 @@
+cluster:
+  name: cluster
+  privateKey: cluster-key
+machines:
+- count: 1
+  spec:
+    image: weaveworks/ignite-kubeadm:latest
+    name: master%d
+    portMappings:
+    - containerPort: 22
+    backend: ignite
+    ignite:
+      cpus: 2
+      memory: 4GB
+      diskSize: 30GB
+      kernel: "weaveworks/ignite-kernel:4.19.47"
+      copyFiles:
+        "<ABSOLUTE_PATH>/run/config.yaml": "/kubeadm.yaml"
+        "<ABSOLUTE_PATH>/run/pki/ca.crt": "/etc/kubernetes/pki/ca.crt"
+        "<ABSOLUTE_PATH>/run/pki/ca.key": "/etc/kubernetes/pki/ca.key"
+        "<ABSOLUTE_PATH>/k8s-master.sh": "/usr/bin/kluster.sh"
+- count: 1
+  spec:
+    image: weaveworks/ignite-kubeadm:latest
+    name: worker%d
+    portMappings:
+    - containerPort: 22
+    backend: ignite
+    ignite:
+      cpus: 2
+      memory: 2GB
+      diskSize: 30GB
+      kernel: "weaveworks/ignite-kernel:4.19.47"
+      copyFiles:
+        "<ABSOLUTE_PATH>/run/k8s-vars.sh": "/etc/profile.d/02-k8s.sh"
+        "<ABSOLUTE_PATH>/run/config-join.yaml": "/kubeadm-join.yaml"
+        "<ABSOLUTE_PATH>/k8s-worker.sh": "/usr/bin/kluster.sh"
+        "<ABSOLUTE_PATH>/run/admin.conf": "/admin.conf"