Module: ssm-parameter-store

Terraform module for providing read and write access to the AWS SSM Parameter Store.

Introduction

• AWS Details on what values can be used
• AWS API for PutParameter
• Terraform aws_ssm_parameter resource page
• Terraform aws_ssm_parameter data page

Usage

For a complete example, see examples/complete.

For automated tests of the complete example using bats and Terratest (which tests and deploys the example on AWS), see test.

This example creates a new String parameter called /cp/prod/app/database/master_password with the value of password1.

module "store_write" {
  source  = "cloudposse/ssm-parameter-store/aws"
  # Cloud Posse recommends pinning every module to a specific version
  # version = "x.x.x"

  parameter_write = [
    {
      name        = "/cp/prod/app/database/master_password"
      value       = "password1"
      type        = "String"
      overwrite   = "true"
      description = "Production database master password"
    }
  ]

  tags = {
    ManagedBy = "Terraform"
  }
}

This example reads a value from the parameter store with the name /cp/prod/app/database/master_password

module "store_read" {
  source  = "cloudposse/ssm-parameter-store/aws"
  # Cloud Posse recommends pinning every module to a specific version
  # version = "x.x.x"

  parameter_read = ["/cp/prod/app/database/master_password"]
}