add terraform book example

Author: niqdev

docs/terraform.md

@@ -30,7 +30,8 @@ Terraform's core building blocks:
 Docker example
 ```sh
 # formatting/linting
-terraform fmt -check 
+terraform fmt
+terraform fmt -check
 
 # initializing a configuration directory downloads and installs the providers defined in the configuration
 cd terraform/docker-example

terraform/book/.terraform.lock.hcl

@@ -0,0 +1,50 @@
+terraform {
+  required_providers {
+    random = {
+      source = "hashicorp/random"
+    }
+  }
+}
+
+# type coercion is the ability to convert any primitive type to its string representation
+variable "words" {
+  description = "A word pool to use for Mad Libs"
+  type = object({
+    nouns      = list(string),
+    adjectives = list(string),
+    verbs      = list(string),
+    adverbs    = list(string),
+    numbers    = list(number),
+  })
+
+  validation {
+    condition     = length(var.words["nouns"]) >= 10
+    error_message = "At least 10 nouns must be supplied."
+  }
+}
+
+resource "random_shuffle" "random_nouns" {
+  input = var.words["nouns"]
+}
+resource "random_shuffle" "random_adjectives" {
+  input = var.words["adjectives"]
+}
+resource "random_shuffle" "random_verbs" {
+  input = var.words["verbs"]
+}
+resource "random_shuffle" "random_adverbs" {
+  input = var.words["adverbs"]
+}
+resource "random_shuffle" "random_numbers" {
+  input = var.words["numbers"]
+}
+
+output "mad_libs" {
+  value = templatefile("${path.module}/templates/alice.txt", {
+    nouns      = random_shuffle.random_nouns.result
+    adjectives = random_shuffle.random_adjectives.result
+    verbs      = random_shuffle.random_verbs.result
+    adverbs    = random_shuffle.random_adverbs.result
+    numbers    = random_shuffle.random_numbers.result
+  })
+}

terraform/book/madlibs.tf

@@ -0,0 +1,14 @@
+ALICE'S UPSIDE-DOWN WORLD
+Lewis Carroll's classic, "Alice's Adventures in Wonderland", as well
+as its ${adjectives[0]} sequel, "Through the Looking ${nouns[0]}",
+have enchanted both the young and old ${nouns[1]}s for the last
+${numbers[0]} years, Alice's ${adjectives[1]} adventures begin
+when she ${verbs[0]}s down a/an ${adjectives[2]} hole and lands
+in a strange and topsy-turvy ${nouns[2]}. There she discovers she
+can become a tall ${nouns[3]} or a small ${nouns[4]} simply by
+nibbling on alternate sides of a magic ${nouns[5]}. In her travels
+through Wonderland, Alice ${verbs[1]}s such remarkable
+characters as the White ${nouns[6]}, the ${adjectives[3]} Hatter,
+the Cheshire ${nouns[7]}, and even the Queen of ${nouns[8]}s.
+Unfortunately, Alice's adventures come to a/an ${adjectives[4]}
+end when Alice awakens from her ${nouns[8]}.