fix: add new example to use existing kms (#389)

* fix: add new example to use existing kms"

* fix: pre-commit failure

---------

Co-authored-by: shikha-mah <shikha.mah@in.ibm.com>

README.md

@@ -42,6 +42,7 @@ You need the following permissions to run this module.
 ## Examples
 
 - [ End to end example with default values](examples/default)
+- [ An example that uses existing KMS](examples/existing-kms)
 <!-- END EXAMPLES HOOK -->
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Requirements

examples/existing-kms/README.md

@@ -0,0 +1,3 @@
+# An example that uses existing KMS
+
+An example that uses the existing KMS and create a Key Ring within the provided KMS Instance.

examples/existing-kms/main.tf

@@ -0,0 +1,11 @@
+
+
+##############################################################################
+# Key Ring module
+##############################################################################
+
+module "kms_key_ring" {
+  source      = "../.."
+  instance_id = var.existing_kms_instance_guid
+  key_ring_id = "${var.prefix}-key-ring"
+}

examples/existing-kms/outputs.tf

@@ -0,0 +1,8 @@
+##############################################################################
+# Outputs
+##############################################################################
+
+output "kms_key_ring_id" {
+  description = "KMS Key Ring ID"
+  value       = module.kms_key_ring.key_ring_id
+}

examples/existing-kms/provider.tf

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

examples/existing-kms/variables.tf

@@ -0,0 +1,17 @@
+variable "ibmcloud_api_key" {
+  type        = string
+  description = "The IBM Cloud API Key"
+  sensitive   = true
+}
+
+variable "prefix" {
+  type        = string
+  description = "Prefix to append to all resources created by this example"
+  default     = "kms-kr"
+}
+
+variable "existing_kms_instance_guid" {
+  type        = string
+  description = "GUID of an existing KMS instance."
+  default     = null
+}

examples/existing-kms/version.tf

@@ -0,0 +1,10 @@
+terraform {
+  required_version = ">= 1.3.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.49.0"
+    }
+  }
+}