DEV Community

Cover image for How to use parameters in AWS CDK?
Binh Bui
Binh Bui

Posted on • Updated on • Originally published at codewithyou.com

How to use parameters in AWS CDK?

Defining CDK Parameters

Use the optional Parameters section to customize your templates. Parameters enable you to input custom values to your template each time you create or update a stack.

To define a parameter, you use the CfnParameter construct.

// parameter of type String
const applicationPrefix = new CfnParameter(this, 'prefix', {
  description: 'parameter of type String',
  type: 'String',
  allowedPattern: '^[a-z0-9]*$', // allowed pattern for the parameter
  minLength: 3, // minimum length of the parameter
  maxLength: 20, // maximum length of the parameter
}).valueAsString // get the value of the parameter as string

console.log('application Prefix 👉', applicationPrefix)

// parameter of type Number
const applicationPort = new CfnParameter(this, 'port', {
  description: 'parameter of type Number',
  type: 'Number',
  minValue: 1, // minimum value of the parameter
  maxValue: 65535, // maximum value of the parameter
  allowedValues: ['8080', '8081'], // allowed values of the parameter
}).valueAsNumber // get the value of the parameter as number

console.log('application Port 👉', applicationPort)

// parameter of type CommaDelimitedList
const applicationDomains = new CfnParameter(this, 'domains', {
  description: 'parameter of type CommaDelimitedList',
  type: 'CommaDelimitedList',
}).valueAsList // get the value of the parameter as list of strings

console.log('application Domains 👉', applicationDomains)
Enter fullscreen mode Exit fullscreen mode

Note that the name (logical ID) of the parameter will derive from its name and location within the stack. Therefore, it is recommended that parameters are defined at the stack level.

Let's over go what we did in the code snippet above.

We defined 3 parameters:

  • prefix: a parameter of type String, with a minimum length of 3 and a maximum length of 20.
  • port: a parameter of type Number, with a minimum value of 1 and a maximum value of 65535.
  • domains: a parameter of type CommaDelimitedList.

CloudFormation currently supports the following parameter types:

  • String – A literal string
  • Number – An integer or float
  • List – An array of integers or floats
  • CommaDelimitedList – An array of literal strings that are separated by * commas
  • AWS-specific parameter types
  • SSM parameter types

If you try to deploy the stack without defining the parameters, the stack will fail.

CdkStarterStackStack failed: Error: The following CloudFormation Parameters are missing a value: port, domains

The parameter prefix is not required because it has a default value.

Deploy a stack with parameters

npx aws-cdk deploy \
    --parameters prefix=demo \
    --parameters port=8081 \
    --parameters domains=www.codewithyou.com,www.freedevtool.com \
    --outputs-file ./cdk-outputs.json
Enter fullscreen mode Exit fullscreen mode

Note that we have to use the --parameters flag for every parameter we pass into the template.

Now that we've successfully deployed our CDK application, we can inspect the parameters section in the CloudFormation console:

Parameters in the CloudFormation console

Or we can use the cdk-outputs.json file to get the values of the parameters:

CdkStarterStackStack.applicationDomains = www.codewithyou.com,www.freedevtool.com
CdkStarterStackStack.applicationPort = 8081
CdkStarterStackStack.applicationPrefix = demo
Enter fullscreen mode Exit fullscreen mode

If you are look into the cdk.out/CdkStarterStackStack.template.json file, you will see that parameters are defined in the Parameters section.

{
  "Parameters": {
    "prefix": {
      "Type": "String",
      "Default": "sample",
      "AllowedPattern": "^[a-z0-9]*$",
      "Description": "parameter of type String",
      "MaxLength": 20,
      "MinLength": 3
    },
    "port": {
      "Type": "Number",
      "AllowedValues": ["8080", "8081"],
      "Description": "parameter of type Number",
      "MaxValue": 65535,
      "MinValue": 1
    },
    "domains": {
      "Type": "CommaDelimitedList",
      "Description": "parameter of type CommaDelimitedList"
    },
    "BootstrapVersion": {
      "Type": "AWS::SSM::Parameter::Value<String>",
      "Default": "/cdk-bootstrap/hnb659fds/version",
      "Description": "Version of the CDK Bootstrap resources in this environment, automatically retrieved from SSM Parameter Store. [cdk:skip]"
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Cleanup

Don't forget to delete the stack before leaving this article. Thanks for reading!

npx aws-cdk destroy
Enter fullscreen mode Exit fullscreen mode

The code for this article is available on GitHub

Top comments (0)