updated coming soon READMEs

jordzn · jordzn · commit 0414058f2b7c · 2016-04-18T08:22:05.000+01:00
diff --git a/aws/environments/dev/compute/README.md b/aws/environments/dev/compute/README.md
@@ -0,0 +1,32 @@
+# Terraform AWS
+
+## Terraform Commands
+
+* [`terraform get`](https://www.terraform.io/docs/commands/get.html)
+* [`terraform plan`](https://www.terraform.io/docs/commands/plan.html)
+* [`terraform apply`](https://www.terraform.io/docs/commands/apply.html)
+* [`terraform destroy`](https://www.terraform.io/docs/commands/destroy.html)
+
+## AWS Basic Compute Demo
+
+This basic compute demo will consist of the orchestration of blank t2.micro (free tier) EC2 instances into AWS.
+
+### Pre-requisites
+
+- It is assumed that this demo is being ran from a UNIX based machine
+- An AWS account [-Sign up here-](https://aws.amazon.com/premiumsupport/signup/)
+  - AWS SSH key-pair created and private key stored locally (this is used as the SSH key placed onto each new instance by Terraform, this key is then used for SSH access after creation is complete)
+- This repository cloned locally (install Git [here](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git))
+- Terraform installed (install it [here](https://www.terraform.io/downloads.html))
+
+### Instructions
+
+1. open 'terraform.tfvars' and enter a value for variable 'owner' and 'ssh_key_name' (the name of the key associated with your AWS account), and save
+2. run command 'export AWS_ACCESS_KEY_ID={your_access_key}'  
+3. run command 'export AWS_SECRET_ACCESS_KEY={your_secret_key}'  
+4. run command 'export AWS_DEFAULT_REGION={your_preferred_region}'  
+5. run command 'terraform get'  
+6. run command 'terraform plan -var-file=./terraform.tfvars'
+7. run command 'terraform apply -state=./terraform.tfstate -var-file=./terraform.tfvars'  
+
+To destroy the infrastructure you have built, run command 'terraform destroy -state=./terraform.tfstate -var-file=./terraform.tfvars'
diff --git a/aws/environments/dev/compute/demo_nodes.tf b/aws/environments/dev/compute/demo_nodes.tf
@@ -9,10 +9,12 @@ variable demo_node_ssh_key_name   { default = "" }
 module "demo-node" {
   source = "../../../modules/compute/nodes/demo_node"
 
+  # instance configuration
   ami           = "${var.ami}"
   instance_type = "${var.demo_node_instance_type}"
   count         = "${var.demo_node_instance_count}"
   key_name      = "${var.demo_node_ssh_key_name}"
 
+  # tagging
   owner = "${var.owner}"
 }
diff --git a/aws/environments/dev/compute/output.tf b/aws/environments/dev/compute/output.tf
@@ -1,2 +1,3 @@
-# outputs produced at the end of a terraform apply: id of the instances, id of
-# security group(s) they are part of
+# outputs produced at the end of a terraform apply: e.g. id and ip of the instances
+output "demo_node_id" { value = "${module.demo-node.demo_node_id}" }
+output "demo_node_ip" { value = "${module.demo-node.demo_node_ip}" }
diff --git a/aws/environments/dev/compute/terraform.tfvars b/aws/environments/dev/compute/terraform.tfvars
@@ -1,7 +1,8 @@
+# General Variables #
 ami      = "ami-8b8c57f8"
-#owner    = "" 
+#owner    = "" # uncomment this variable and provide an identifying value for tagging
 
 # Demo Node #
 demo_node_instance_type  = "t2.micro"
 demo_node_instance_count = "1"
-#demo_node_ssh_key_name   = ""
+#demo_node_ssh_key_name   = "" # uncomment this variable and provide the name of your AWS key-pair
diff --git a/aws/environments/dev/networking/README.md b/aws/environments/dev/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/aws/environments/preprod/compute/README.md b/aws/environments/preprod/compute/README.md
@@ -0,0 +1,32 @@
+# Terraform AWS
+
+## Terraform Commands
+
+* [`terraform get`](https://www.terraform.io/docs/commands/get.html)
+* [`terraform plan`](https://www.terraform.io/docs/commands/plan.html)
+* [`terraform apply`](https://www.terraform.io/docs/commands/apply.html)
+* [`terraform destroy`](https://www.terraform.io/docs/commands/destroy.html)
+
+## AWS Basic Compute Demo
+
+This basic compute demo will consist of the orchestration of blank t2.micro (free tier) EC2 instances into AWS.
+
+### Pre-requisites
+
+- It is assumed that this demo is being ran from a UNIX based machine
+- An AWS account [-Sign up here-](https://aws.amazon.com/premiumsupport/signup/)
+  - AWS SSH key-pair created and private key stored locally (this is used as the SSH key placed onto each new instance by Terraform, this key is then used for SSH access after creation is complete)
+- This repository cloned locally (install Git [here](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git))
+- Terraform installed (install it [here](https://www.terraform.io/downloads.html))
+
+### Instructions
+
+1. open 'terraform.tfvars' and enter a value for variable 'owner' and 'ssh_key_name' (the name of the key associated with your AWS account), and save
+2. run command 'export AWS_ACCESS_KEY_ID={your_access_key}'  
+3. run command 'export AWS_SECRET_ACCESS_KEY={your_secret_key}'  
+4. run command 'export AWS_DEFAULT_REGION={your_preferred_region}'  
+5. run command 'terraform get'  
+6. run command 'terraform plan -var-file=./terraform.tfvars'
+7. run command 'terraform apply -state=./terraform.tfstate -var-file=./terraform.tfvars'  
+
+To destroy the infrastructure you have built, run command 'terraform destroy -state=./terraform.tfstate -var-file=./terraform.tfvars'
diff --git a/aws/environments/preprod/compute/demo_nodes.tf b/aws/environments/preprod/compute/demo_nodes.tf
@@ -9,10 +9,12 @@ variable demo_node_ssh_key_name   { default = "" }
 module "demo-node" {
   source = "../../../modules/compute/nodes/demo_node"
 
+  # instance configuration
   ami           = "${var.ami}"
   instance_type = "${var.demo_node_instance_type}"
   count         = "${var.demo_node_instance_count}"
   key_name      = "${var.demo_node_ssh_key_name}"
 
+  # tagging
   owner = "${var.owner}"
 }
diff --git a/aws/environments/preprod/compute/output.tf b/aws/environments/preprod/compute/output.tf
@@ -1,2 +1,3 @@
-# outputs produced at the end of a terraform apply: id of the instances, id of
-# security group(s) they are part of
+# outputs produced at the end of a terraform apply: e.g. id and ip of the instances
+output "demo_node_id" { value = "${module.demo-node.demo_node_id}" }
+output "demo_node_ip" { value = "${module.demo-node.demo_node_ip}" }
diff --git a/aws/environments/preprod/compute/terraform.tfvars b/aws/environments/preprod/compute/terraform.tfvars
@@ -1,7 +1,8 @@
+# General Variables #
 ami      = "ami-8b8c57f8"
-#owner    = ""
+#owner    = "" # uncomment this variable and provide an identifying value for tagging
 
 # Demo Node #
 demo_node_instance_type  = "t2.micro"
 demo_node_instance_count = "1"
-#demo_node_ssh_key_name   = ""
+#demo_node_ssh_key_name   = "" # uncomment this variable and provide the name of your AWS key-pair
diff --git a/aws/environments/preprod/networking/README.md b/aws/environments/preprod/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/aws/environments/prod/compute/README.md b/aws/environments/prod/compute/README.md
@@ -0,0 +1,32 @@
+# Terraform AWS
+
+## Terraform Commands
+
+* [`terraform get`](https://www.terraform.io/docs/commands/get.html)
+* [`terraform plan`](https://www.terraform.io/docs/commands/plan.html)
+* [`terraform apply`](https://www.terraform.io/docs/commands/apply.html)
+* [`terraform destroy`](https://www.terraform.io/docs/commands/destroy.html)
+
+## AWS Basic Compute Demo
+
+This basic compute demo will consist of the orchestration of blank t2.micro (free tier) EC2 instances into AWS.
+
+### Pre-requisites
+
+- It is assumed that this demo is being ran from a UNIX based machine
+- An AWS account [-Sign up here-](https://aws.amazon.com/premiumsupport/signup/)
+  - AWS SSH key-pair created and private key stored locally (this is used as the SSH key placed onto each new instance by Terraform, this key is then used for SSH access after creation is complete)
+- This repository cloned locally (install Git [here](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git))
+- Terraform installed (install it [here](https://www.terraform.io/downloads.html))
+
+### Instructions
+
+1. open 'terraform.tfvars' and enter a value for variable 'owner' and 'ssh_key_name' (the name of the key associated with your AWS account), and save
+2. run command 'export AWS_ACCESS_KEY_ID={your_access_key}'  
+3. run command 'export AWS_SECRET_ACCESS_KEY={your_secret_key}'  
+4. run command 'export AWS_DEFAULT_REGION={your_preferred_region}'  
+5. run command 'terraform get'  
+6. run command 'terraform plan -var-file=./terraform.tfvars'
+7. run command 'terraform apply -state=./terraform.tfstate -var-file=./terraform.tfvars'  
+
+To destroy the infrastructure you have built, run command 'terraform destroy -state=./terraform.tfstate -var-file=./terraform.tfvars'
diff --git a/aws/environments/prod/compute/demo_nodes.tf b/aws/environments/prod/compute/demo_nodes.tf
@@ -9,10 +9,12 @@ variable demo_node_ssh_key_name   { default = "" }
 module "demo-node" {
   source = "../../../modules/compute/nodes/demo_node"
 
+  # instance configuration
   ami           = "${var.ami}"
   instance_type = "${var.demo_node_instance_type}"
   count         = "${var.demo_node_instance_count}"
   key_name      = "${var.demo_node_ssh_key_name}"
 
+  # tagging
   owner = "${var.owner}"
 }
diff --git a/aws/environments/prod/compute/output.tf b/aws/environments/prod/compute/output.tf
@@ -1,2 +1,3 @@
-# outputs produced at the end of a terraform apply: id of the instances, id of
-# security group(s) they are part of
+# outputs produced at the end of a terraform apply: e.g. id and ip of the instances
+output "demo_node_id" { value = "${module.demo-node.demo_node_id}" }
+output "demo_node_ip" { value = "${module.demo-node.demo_node_ip}" }
diff --git a/aws/environments/prod/compute/terraform.tfvars b/aws/environments/prod/compute/terraform.tfvars
@@ -1,7 +1,8 @@
+# General Variables #
 ami      = "ami-8b8c57f8"
-#owner    = ""
+#owner    = "" # uncomment this variable and provide an identifying value for tagging
 
 # Demo Node #
 demo_node_instance_type  = "t2.micro"
 demo_node_instance_count = "1"
-#demo_node_ssh_key_name   = ""
+#demo_node_ssh_key_name   = "" # uncomment this variable and provide the name of your AWS key-pair
diff --git a/aws/environments/prod/networking/README.md b/aws/environments/prod/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/aws/environments/test/compute/README.md b/aws/environments/test/compute/README.md
@@ -0,0 +1,32 @@
+# Terraform AWS
+
+## Terraform Commands
+
+* [`terraform get`](https://www.terraform.io/docs/commands/get.html)
+* [`terraform plan`](https://www.terraform.io/docs/commands/plan.html)
+* [`terraform apply`](https://www.terraform.io/docs/commands/apply.html)
+* [`terraform destroy`](https://www.terraform.io/docs/commands/destroy.html)
+
+## AWS Basic Compute Demo
+
+This basic compute demo will consist of the orchestration of blank t2.micro (free tier) EC2 instances into AWS.
+
+### Pre-requisites
+
+- It is assumed that this demo is being ran from a UNIX based machine
+- An AWS account [-Sign up here-](https://aws.amazon.com/premiumsupport/signup/)
+  - AWS SSH key-pair created and private key stored locally (this is used as the SSH key placed onto each new instance by Terraform, this key is then used for SSH access after creation is complete)
+- This repository cloned locally (install Git [here](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git))
+- Terraform installed (install it [here](https://www.terraform.io/downloads.html))
+
+### Instructions
+
+1. open 'terraform.tfvars' and enter a value for variable 'owner' and 'ssh_key_name' (the name of the key associated with your AWS account), and save
+2. run command 'export AWS_ACCESS_KEY_ID={your_access_key}'  
+3. run command 'export AWS_SECRET_ACCESS_KEY={your_secret_key}'  
+4. run command 'export AWS_DEFAULT_REGION={your_preferred_region}'  
+5. run command 'terraform get'  
+6. run command 'terraform plan -var-file=./terraform.tfvars'
+7. run command 'terraform apply -state=./terraform.tfstate -var-file=./terraform.tfvars'  
+
+To destroy the infrastructure you have built, run command 'terraform destroy -state=./terraform.tfstate -var-file=./terraform.tfvars'
diff --git a/aws/environments/test/compute/demo_nodes.tf b/aws/environments/test/compute/demo_nodes.tf
@@ -9,10 +9,12 @@ variable demo_node_ssh_key_name   { default = "" }
 module "demo-node" {
   source = "../../../modules/compute/nodes/demo_node"
 
+  # instance configuration
   ami           = "${var.ami}"
   instance_type = "${var.demo_node_instance_type}"
   count         = "${var.demo_node_instance_count}"
   key_name      = "${var.demo_node_ssh_key_name}"
 
+  # tagging
   owner = "${var.owner}"
 }
diff --git a/aws/environments/test/compute/output.tf b/aws/environments/test/compute/output.tf
@@ -1,2 +1,3 @@
-# outputs produced at the end of a terraform apply: id of the instances, id of
-# security group(s) they are part of
+# outputs produced at the end of a terraform apply: e.g. id and ip of the instances
+output "demo_node_id" { value = "${module.demo-node.demo_node_id}" }
+output "demo_node_ip" { value = "${module.demo-node.demo_node_ip}" }
diff --git a/aws/environments/test/compute/terraform.tfvars b/aws/environments/test/compute/terraform.tfvars
@@ -1,7 +1,8 @@
+# General Variables #
 ami      = "ami-8b8c57f8"
-#owner    = ""
+#owner    = "" # uncomment this variable and provide an identifying value for tagging
 
 # Demo Node #
 demo_node_instance_type  = "t2.micro"
 demo_node_instance_count = "1"
-#demo_node_ssh_key_name   = ""
+#demo_node_ssh_key_name   = "" # uncomment this variable and provide the name of your AWS key-pair
diff --git a/aws/environments/test/networking/README.md b/aws/environments/test/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/aws/modules/compute/nodes/demo_node/output.tf b/aws/modules/compute/nodes/demo_node/output.tf
@@ -1,4 +1,3 @@
-# outputs produced at the end of a terraform apply: id of the instances, id of
-# security group(s) they are part of
-output "demo_node_instance_id" { value = "${join(",", aws_instance.demo-node.*.id)}" }
-output "demo_node_sg_id"       { value = "${aws_security_group.demo-sg.id}" }
+# outputs produced at the end of a terraform apply: e.g. the id and ip of an instance
+output "demo_node_id"    { value = "${join(",", aws_instance.demo-node.*.id)}" }
+output "demo_node_sg_id" { value = "${join(",", aws_instance.demo-node.*.public_ip)}" }
diff --git a/azure/README.md b/azure/README.md
@@ -1 +1,5 @@
-COMING SOON!
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
+* Release 4: Terraform Provisioning with Puppet, Chef & Ansible
diff --git a/azure/environments/dev/compute/README.md b/azure/environments/dev/compute/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
diff --git a/azure/environments/dev/networking/README.md b/azure/environments/dev/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/azure/environments/preprod/compute/README.md b/azure/environments/preprod/compute/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
diff --git a/azure/environments/preprod/networking/README.md b/azure/environments/preprod/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/azure/environments/prod/compute/README.md b/azure/environments/prod/compute/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
diff --git a/azure/environments/prod/networking/README.md b/azure/environments/prod/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/azure/environments/test/compute/README.md b/azure/environments/test/compute/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
diff --git a/azure/environments/test/networking/README.md b/azure/environments/test/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/azure/modules/README.md b/azure/modules/README.md
@@ -1 +1,5 @@
-COMING SOON!
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
+* Release 4: Terraform Provisioning with Puppet, Chef & Ansible
diff --git a/gc/README.md b/gc/README.md
@@ -1 +1,5 @@
-COMING SOON!
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
+* Release 4: Terraform Provisioning with Puppet, Chef & Ansible
diff --git a/gc/environments/dev/compute/README.md b/gc/environments/dev/compute/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
diff --git a/gc/environments/dev/networking/README.md b/gc/environments/dev/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/gc/environments/preprod/compute/README.md b/gc/environments/preprod/compute/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
diff --git a/gc/environments/preprod/networking/README.md b/gc/environments/preprod/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/gc/environments/prod/compute/README.md b/gc/environments/prod/compute/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
diff --git a/gc/environments/prod/networking/README.md b/gc/environments/prod/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/gc/environments/test/compute/README.md b/gc/environments/test/compute/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
diff --git a/gc/environments/test/networking/README.md b/gc/environments/test/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/gc/modules/README.md b/gc/modules/README.md
@@ -1 +1,5 @@
-COMING SOON!
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
+* Release 4: Terraform Provisioning with Puppet, Chef & Ansible
diff --git a/rackspace/README.md b/rackspace/README.md
@@ -1 +1,5 @@
-COMING SOON!
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
+* Release 4: Terraform Provisioning with Puppet, Chef & Ansible
diff --git a/rackspace/environments/dev/compute/README.md b/rackspace/environments/dev/compute/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
diff --git a/rackspace/environments/dev/networking/README.md b/rackspace/environments/dev/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/rackspace/environments/preprod/compute/README.md b/rackspace/environments/preprod/compute/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
diff --git a/rackspace/environments/preprod/networking/README.md b/rackspace/environments/preprod/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/rackspace/environments/prod/compute/README.md b/rackspace/environments/prod/compute/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 2: Basic Compute in Microsoft Azure, Google Cloud & Rackspace
diff --git a/rackspace/environments/prod/networking/README.md b/rackspace/environments/prod/networking/README.md
@@ -0,0 +1,3 @@
+# Code & Demos to come soon:
+
+* Release 3: Networking Infrastructure in AWS, Microsoft Azure, Google Cloud & Rackspace
diff --git a/rackspace/environments/test/compute/README.md b/rackspace/environments/test/compute/README.md
diff --git a/rackspace/environments/test/networking/README.md b/rackspace/environments/test/networking/README.md
diff --git a/rackspace/modules/README.md b/rackspace/modules/README.md
