TER-263: Add import example and update Readme

README.md

@@ -38,6 +38,29 @@ Examples are available in the examples directory:
 - `basic`: shows how to define a simple ghost application
 - `shared_modules_features`: shows how modules and features can be shared across ghost\_app resources using `locals`. It also shows how to write or import scripts.
 
+Create a new Ghost App
+---------------------------
+First make sure the provider is installed as described above.
+
+Create your app configuration using the examples available.
+
+Run
+```sh
+$ terraform init # or tfwrapper init
+$ terraform apply # or tfwrapper apply
+```
+
+Import an existing Ghost App
+---------------------------
+First make sure the provider is installed as described above.
+
+Create your app configuration using the import examples available.
+
+Run terraform import ghost_app.your_app app_id. Example:
+```sh
+$ terraform import ghost_app.basic_import 5accabf63d7eba00014e5679 # or tfwrapper import
+```
+
 Developing the Provider
 ---------------------------
 

examples/basic/main.tf

@@ -4,7 +4,7 @@ provider "ghost" {
   endpoint = "https://localhost"
 }
 
-resource "ghost_app" "test" {
+resource "ghost_app" "basic" {
   name = "wordpress"
   env  = "dev"
   role = "webfront"

examples/basic_import/inputs.tf

@@ -0,0 +1 @@
+variable "password" {}

examples/basic_import/main.tf

@@ -0,0 +1,120 @@
+provider "ghost" {
+  user     = "demo"
+  password = "${var.password}"
+  endpoint = "https://localhost"
+}
+
+resource "ghost_app" "basic_import" {
+  // You can ignore parameters using lifecycle.ignore_changes meta-parameter
+  lifecycle {
+    ignore_changes = ["log_notifications", "safe_deployment"]
+  }
+
+  name = "wordpress"
+  env  = "dev"
+  role = "webfront"
+
+  region        = "eu-west-1"
+  instance_type = "t2.micro"
+  vpc_id        = "vpc-1234567"
+
+  build_infos = {
+    subnet_id    = "subnet-1234567"
+    ssh_username = "admin"
+    source_ami   = "ami-1234567"
+  }
+
+  environment_infos = {
+    instance_profile  = "iam.ec2.demo"
+    key_name          = "ghost-demo"
+    public_ip_address = true
+
+    root_block_device = {
+      name = "testblockdevice"
+      size = 20
+    }
+
+    optional_volumes = [
+      {
+        device_name = "/dev/xvdd"
+        volume_type = "gp2"
+        volume_size = 20
+        iops        = 0
+      },
+    ]
+
+    subnet_ids      = ["subnet-1234567"]
+    security_groups = ["sg-1234567", "sg-1234567"]
+
+    instance_tags = [
+      {
+        tag_name  = "Name"
+        tag_value = "wordpress"
+      },
+    ]
+  }
+
+  autoscale = {
+    name           = "autoscale"
+    min            = 1
+    max            = 3
+    enable_metrics = true
+  }
+
+  modules = [
+    {
+      name             = "wordpress"
+      path             = "/var/www"
+      scope            = "code"
+      git_repo         = "https://github.com/KnpLabs/KnpIpsum.git"
+      uid              = 0
+      gid              = 0
+      build_pack       = ""
+      pre_deploy       = ""
+      post_deploy      = ""
+      after_all_deploy = ""
+    },
+  ]
+
+  features = [
+    {
+      name        = "php5"
+      version     = "5.4"
+      provisioner = "salt"
+    },
+    {
+      name        = "package"
+      provisioner = "ansible"
+
+      parameters = <<-JSON
+                      {
+                        "package_name" : [
+                          "nano",
+                          "cowsay",
+                          "ffmpeg",
+                          "curl"
+                        ]
+                      }
+                      JSON
+    },
+  ]
+
+  lifecycle_hooks = {
+    pre_buildimage = "echo PRE_BUILD >> /var/www/html/wp-config.php"
+
+    post_buildimage = <<-SCRIPT
+                         #!/bin/bash
+                         echo "EXAMPLE_CONFIG" >> /var/www/html/wp-config.php
+                         SCRIPT
+
+    pre_bootstrap  = ""
+    post_bootstrap = ""
+  }
+
+  environment_variables = [
+    {
+      key   = "myvar"
+      value = "myvalue"
+    },
+  ]
+}

examples/shared_modules_features/main.tf

@@ -4,7 +4,7 @@ provider "ghost" {
   endpoint = "https://localhost"
 }
 
-resource "ghost_app" "test" {
+resource "ghost_app" "shared_modules_features" {
   name = "wordpress"
   env  = "dev"
   role = "webfront"
@@ -25,6 +25,13 @@ resource "ghost_app" "test" {
 
     subnet_ids      = ["subnet-1234567"]
     security_groups = ["sg-1234567"]
+
+    instance_tags = [
+      {
+        tag_name  = "Name"
+        tag_value = "wordpress"
+      },
+    ]
   }
 
   // Several modules and/or lists of modules can be merged together.