Updated to Terraform Client 0.7 Updated docs

.gitignore

@@ -20,3 +20,4 @@ _projects
 _steps
 _book
 node_modules
+npm-debug.log

docs/getting-started-guides/aws/public.md

@@ -74,14 +74,34 @@ ansible-galaxy install -r requirements.yml
 To run the Ansible playbook (to configure the cluster):
 
 ```
-ansible-playbook -u core --ssh-common-args="-i /tmp/kubeform/terraform/aws/public-cloud/id_rsa -q" --inventory-file=inventory site.yml -e kube_apiserver_vip=$(cd /tmp/kubeform/terraform/aws/public-cloud && terraform output master_elb_hostname)
+ansible-playbook -u core --private-key=/tmp/kubeform/terraform/aws/public-cloud/id_rsa --inventory-file=inventory site.yml -e kube_apiserver_vip=$(cd /tmp/kubeform/terraform/aws/public-cloud && terraform output master_elb_hostname)
 ```
 
 This will run the playbook (using the credentials output by terraform and the terraform state as a dynamic inventory) and inject the AWS ELB (for the master API servers) address as a variable ```kube_apiserver_vip```.
 
+###?| Log in
+
+Once you're set up, you can log into the dashboard by running:
+
+```
+kubectl proxy
+```
+
+and visiting the following URL [http://localhost:8001/ui](http://localhost:8001/ui)
+
 ## Cluster Destroy
 
 ```
 cd /tmp/kubeform/terraform/aws/public-cloud
 terraform destroy
 ```
+
+## Troubleshooting
+
+If the ```ansible-playbook``` command fails all steps with:
+
+```
+skipping: no hosts matched
+```
+
+Check that your ```TF_VAR_STATE_ROOT``` variable is defined correctly (see config section above) and ensure that the directory contains terraform.tfstate, which should have been created during the ```terraform apply``` execution.

docs/getting-started-guides/digitalocean.md

@@ -8,7 +8,7 @@ The cluster is provisioned in separate stages as follows:
 ## Prerequisites
 
 1. You need a Digitalocean account. Visit [https://cloud.digitalocean.com/registrations/new](https://cloud.digitalocean.com/registrations/new) to get started
-2. You need to have installed and configured Terraform (>= 0.6.16 recommended). Visit [https://www.terraform.io/intro/getting-started/install.html](https://www.terraform.io/intro/getting-started/install.html) to get started.
+2. You need to have installed and configured Terraform (>= 0.7.13 recommended). Visit [https://www.terraform.io/intro/getting-started/install.html](https://www.terraform.io/intro/getting-started/install.html) to get started.
 3. You need to have [Python](https://www.python.org/) >= 2.7.5 installed along with [pip](https://pip.pypa.io/en/latest/installing.html).
 4. Kubectl installed in and your PATH:
 
@@ -71,14 +71,34 @@ ansible-galaxy install -r requirements.yml
 To run the Ansible playbook (to configure the cluster):
 
 ```
-ansible-playbook -u core --ssh-common-args="-i /tmp/kubeform/terraform/digitalocean/id_rsa -q" --inventory-file=inventory site.yml
+ansible-playbook -u core --private-key=/tmp/kubeform/terraform/digitalocean/id_rsa --inventory-file=inventory site.yml
 ```
 
 This will run the playbook (using the credentials output by terraform and the terraform state as a dynamic inventory).
 
+###?| Log in
+
+Once you're set up, you can log into the dashboard by running:
+
+```
+kubectl proxy
+```
+
+and visiting the following URL [http://localhost:8001/ui](http://localhost:8001/ui)
+
 ## Cluster Destroy
 
 ```
 cd /tmp/kubeform/terraform/digitalocean
 terraform destroy
 ```
+
+## Troubleshooting
+
+If the ```ansible-playbook``` command fails all steps with:
+
+```
+skipping: no hosts matched
+```
+
+Check that your ```TF_VAR_STATE_ROOT``` variable is defined correctly (see config section above) and ensure that the directory contains terraform.tfstate, which should have been created during the ```terraform apply``` execution.

docs/getting-started-guides/docker-compose.md

@@ -21,6 +21,15 @@ KUBERNETES_VERSION=1.2.4 docker-compose up -d
 
 replace with the relevant Kubernetes version.
 
+###?| Troubleshooting
+
+When working with Docker for mac on OSX, you may find that you need to replace two lines in the docker-compose.yml with the following:
+
+```
+      - /private/var/lib/docker/:/var/lib/docker:ro
+      - /private/var/lib/kubelet/:/var/lib/kubelet:rw/
+```
+
 ## Cluster Destroy
 
 ```

terraform/digitalocean/etcd_discovery_url.txt

@@ -1 +1 @@
-
+https://discovery.etcd.io/1b1e5527389535df10ed556cd6cca18c

terraform/digitalocean/main.tf

@@ -47,7 +47,7 @@ resource "template_file" "etcd_discovery_url" {
 }
 
 module "ca" {
-  source            = "github.com/Capgemini/tf_tls//ca"
+  source            = "github.com/tamsky/tf_tls/ca"
   organization      = "${var.organization}"
   ca_count          = "${var.masters + var.workers + var.edge-routers}"
   deploy_ssh_hosts  = "${concat(digitalocean_droplet.edge-router.*.ipv4_address, concat(digitalocean_droplet.master.*.ipv4_address, digitalocean_droplet.worker.*.ipv4_address))}"
@@ -62,12 +62,12 @@ module "etcd_cert" {
 }
 
 module "kube_master_certs" {
-  source                = "github.com/Capgemini/tf_tls/kubernetes/master"
+  source                = "github.com/tamsky/tf_tls/kubernetes/master"
   ca_cert_pem           = "${module.ca.ca_cert_pem}"
   ca_private_key_pem    = "${module.ca.ca_private_key_pem}"
   ip_addresses          = "${compact(digitalocean_droplet.master.*.ipv4_address)}"
   deploy_ssh_hosts      = "${compact(digitalocean_droplet.master.*.ipv4_address)}"
-  dns_names             = "test"
+  dns_names             = ["test"]
   master_count          = "${var.masters}"
   validity_period_hours = "8760"
   early_renewal_hours   = "720"
@@ -76,7 +76,7 @@ module "kube_master_certs" {
 }
 
 module "kube_kubelet_certs" {
-  source                = "github.com/Capgemini/tf_tls/kubernetes/kubelet"
+  source                = "github.com/tamsky/tf_tls/kubernetes/kubelet"
   ca_cert_pem           = "${module.ca.ca_cert_pem}"
   ca_private_key_pem    = "${module.ca.ca_private_key_pem}"
   ip_addresses          = "${concat( digitalocean_droplet.edge-router.*.ipv4_address, concat(digitalocean_droplet.master.*.ipv4_address, digitalocean_droplet.worker.*.ipv4_address))}"
@@ -89,14 +89,14 @@ module "kube_kubelet_certs" {
 }
 
 module "kube_admin_cert" {
-  source                = "github.com/Capgemini/tf_tls/kubernetes/admin"
+  source                = "github.com/tamsky/tf_tls/kubernetes/admin"
   ca_cert_pem           = "${module.ca.ca_cert_pem}"
   ca_private_key_pem    = "${module.ca.ca_private_key_pem}"
   kubectl_server_ip     = "${digitalocean_droplet.master.0.ipv4_address}"
 }
 
 module "docker_daemon_certs" {
-  source                = "github.com/Capgemini/tf_tls//docker/daemon"
+  source                = "github.com/tamsky/tf_tls/docker/daemon"
   ca_cert_pem           = "${module.ca.ca_cert_pem}"
   ca_private_key_pem    = "${module.ca.ca_private_key_pem}"
   ip_addresses_list     = "${concat(digitalocean_droplet.edge-router.*.ipv4_address, concat(digitalocean_droplet.master.*.ipv4_address, digitalocean_droplet.worker.*.ipv4_address))}"
@@ -109,7 +109,7 @@ module "docker_daemon_certs" {
 }
 
 module "docker_client_certs" {
-  source                = "github.com/Capgemini/tf_tls//docker/client"
+  source                = "github.com/tamsky/tf_tls/docker/client"
   ca_cert_pem           = "${module.ca.ca_cert_pem}"
   ca_private_key_pem    = "${module.ca.ca_private_key_pem}"
   ip_addresses_list     = "${concat(digitalocean_droplet.edge-router.*.ipv4_address, concat(digitalocean_droplet.master.*.ipv4_address, digitalocean_droplet.worker.*.ipv4_address))}"
@@ -128,9 +128,9 @@ resource "template_file" "master_cloud_init" {
     etcd_discovery_url = "${file(var.etcd_discovery_url_file)}"
     size               = "${var.masters}"
     region             = "${var.region}"
-    etcd_ca            = "${replace(module.ca.ca_cert_pem, \"\n\", \"\\n\")}"
-    etcd_cert          = "${replace(module.etcd_cert.etcd_cert_pem, \"\n\", \"\\n\")}"
-    etcd_key           = "${replace(module.etcd_cert.etcd_private_key, \"\n\", \"\\n\")}"
+    etcd_ca            = "${replace(module.ca.ca_cert_pem, "\n", "\\n")}"
+    etcd_cert          = "${replace(module.etcd_cert.etcd_cert_pem, "\n", "\\n")}"
+    etcd_key           = "${replace(module.etcd_cert.etcd_private_key, "\n", "\\n")}"
   }
 }
 
@@ -141,9 +141,9 @@ resource "template_file" "worker_cloud_init" {
     etcd_discovery_url = "${file(var.etcd_discovery_url_file)}"
     size               = "${var.masters}"
     region             = "${var.region}"
-    etcd_ca            = "${replace(module.ca.ca_cert_pem, \"\n\", \"\\n\")}"
-    etcd_cert          = "${replace(module.etcd_cert.etcd_cert_pem, \"\n\", \"\\n\")}"
-    etcd_key           = "${replace(module.etcd_cert.etcd_private_key, \"\n\", \"\\n\")}"
+    etcd_ca            = "${replace(module.ca.ca_cert_pem, "\n", "\\n")}"
+    etcd_cert          = "${replace(module.etcd_cert.etcd_cert_pem, "\n", "\\n")}"
+    etcd_key           = "${replace(module.etcd_cert.etcd_private_key, "\n", "\\n")}"
   }
 }
 
@@ -154,9 +154,9 @@ resource "template_file" "edge-router_cloud_init" {
     etcd_discovery_url = "${file(var.etcd_discovery_url_file)}"
     size               = "${var.masters}"
     region             = "${var.region}"
-    etcd_ca            = "${replace(module.ca.ca_cert_pem, \"\n\", \"\\n\")}"
-    etcd_cert          = "${replace(module.etcd_cert.etcd_cert_pem, \"\n\", \"\\n\")}"
-    etcd_key           = "${replace(module.etcd_cert.etcd_private_key, \"\n\", \"\\n\")}"
+    etcd_ca            = "${replace(module.ca.ca_cert_pem, "\n", "\\n")}"
+    etcd_cert          = "${replace(module.etcd_cert.etcd_cert_pem, "\n", "\\n")}"
+    etcd_key           = "${replace(module.etcd_cert.etcd_private_key, "\n", "\\n")}"
   }
 }