tests: Added backup restore from backup id example (#158)

Author: Ak-sky

README.md

@@ -20,6 +20,7 @@ This module implements an instance of the IBM Cloud Messages for RabbitMQ servic
     * [Basic example](./examples/basic)
     * [Complete example with BYOK encryption, CBR rules, autoscaling, and service credentials creation](./examples/complete)
     * [Financial Services Cloud profile example with autoscaling enabled](./examples/fscloud)
+    * [Restore from backup example](./examples/backup-restore)
 * [Contributing](#contributing)
 <!-- END OVERVIEW HOOK -->
 

common-dev-assets

@@ -0,0 +1,6 @@
+# Restore from backup example
+
+This example provides an end-to-end executable flow of how a RabbitMQ DB can be created from a backup instance. This example uses the IBM Cloud terraform provider to:
+
+- Create a new resource group if one is not passed in.
+- Create a restored ICD RabbitMQ database instance pointing to the lastest backup of the existing RabbitMQ database instance crn passed.

examples/backup-restore/README.md

@@ -0,0 +1,27 @@
+##############################################################################
+# Resource Group
+##############################################################################
+
+module "resource_group" {
+  source  = "terraform-ibm-modules/resource-group/ibm"
+  version = "1.1.5"
+  # if an existing resource group is not set (null) create a new one using prefix
+  resource_group_name          = var.resource_group == null ? "${var.prefix}-resource-group" : null
+  existing_resource_group_name = var.resource_group
+}
+
+data "ibm_database_backups" "backup_database" {
+  deployment_id = var.rabbitmq_db_crn
+}
+
+# New RabbitMQ db instance pointing to the backup instance
+module "restored_rabbitmq_db" {
+  source            = "../.."
+  resource_group_id = module.resource_group.resource_group_id
+  instance_name     = "${var.prefix}-rabbitmq-restored"
+  region            = var.region
+  rabbitmq_version  = var.rabbitmq_version
+  access_tags       = var.access_tags
+  tags              = var.resource_tags
+  backup_crn        = data.ibm_database_backups.backup_database.backups[0].backup_id
+}

examples/backup-restore/main.tf

@@ -0,0 +1,13 @@
+##############################################################################
+# Outputs
+##############################################################################
+
+output "restored_rabbitmq_db_id" {
+  description = "Restored RabbitMQ db instance id"
+  value       = module.restored_rabbitmq_db.id
+}
+
+output "restored_rabbitmq_db_version" {
+  description = "Restored RabbitMQ instance version"
+  value       = module.restored_rabbitmq_db.version
+}

examples/backup-restore/outputs.tf

@@ -0,0 +1,4 @@
+provider "ibm" {
+  ibmcloud_api_key = var.ibmcloud_api_key
+  region           = var.region
+}

examples/backup-restore/provider.tf

@@ -0,0 +1,46 @@
+variable "ibmcloud_api_key" {
+  type        = string
+  description = "The IBM Cloud API Key"
+  sensitive   = true
+}
+
+variable "region" {
+  type        = string
+  description = "Region to provision all resources created by this example"
+  default     = "us-south"
+}
+
+variable "prefix" {
+  type        = string
+  description = "Prefix to append to all resources created by this example"
+  default     = "rabbitmq-restore"
+}
+
+variable "resource_group" {
+  type        = string
+  description = "An existing resource group name to use for this example, if unset a new resource group will be created"
+  default     = null
+}
+
+variable "rabbitmq_version" {
+  type        = string
+  description = "Version of rabbitmq to deploy"
+  default     = null
+}
+
+variable "resource_tags" {
+  type        = list(string)
+  description = "Optional list of tags to be added to created resources"
+  default     = []
+}
+
+variable "access_tags" {
+  type        = list(string)
+  description = "A list of access tags to apply to the rabbitmq instance created by the module, see https://cloud.ibm.com/docs/account?topic=account-access-tags-tutorial for more details"
+  default     = []
+}
+
+variable "rabbitmq_db_crn" {
+  type        = string
+  description = "The existing CRN of a rabbitMQ instance to fetch the latest backup crn."
+}

examples/backup-restore/variables.tf

@@ -0,0 +1,10 @@
+terraform {
+  required_version = ">= 1.3.0, <1.7.0"
+  required_providers {
+    # Pin to the lowest provider version of the range defined in the main module's version.tf to ensure lowest version still works
+    ibm = {
+      source  = "IBM-Cloud/ibm"
+      version = ">=1.62.0, <2.0.0"
+    }
+  }
+}

examples/backup-restore/version.tf

@@ -2,6 +2,7 @@
 package test
 
 import (
+	"fmt"
 	"testing"
 
 	"github.com/stretchr/testify/assert"
@@ -50,3 +51,23 @@ func TestPlanICDVersions(t *testing.T) {
 		t.Run(version, func(t *testing.T) { testPlanICDVersions(t, version) })
 	}
 }
+
+func TestRunRestoredDBExample(t *testing.T) {
+	t.Parallel()
+
+	options := testhelper.TestOptionsDefaultWithVars(&testhelper.TestOptions{
+		Testing:       t,
+		TerraformDir:  "examples/backup-restore",
+		Prefix:        "rabbitmq-restored",
+		ResourceGroup: resourceGroup,
+		Region:        fmt.Sprint(permanentResources["rabbitmqRegion"]),
+		TerraformVars: map[string]interface{}{
+			"rabbitmq_db_crn": permanentResources["rabbitmqCrn"],
+		},
+		CloudInfoService: sharedInfoSvc,
+	})
+
+	output, err := options.RunTestConsistency()
+	assert.Nil(t, err, "This should not have errored")
+	assert.NotNil(t, output, "Expected some output")
+}