Developer Guide (Version 1.12)

Resource Manager Resource Group Parameters

Cloud Canvas Resource Manager uses AWS CloudFormation templates to describe the AWS resources needed for a project. AWS CloudFormation templates can have parameters. You provide the values for these parameters when a template creates or updates a stack.

AWS CloudFormation template parameters are useful when you want separate deployments of a resource group to be configured differently. For example, you could configure an internal test instance of Amazon DynamoDB to use lower throughput than a public instance.

Follow the steps below to use AWS CloudFormation template parameters for your resource groups.

To use template parameters

  1. Define a parameter in the AWS CloudFormation template. You must provide a default value for the parameter. Be sure not to remove or modify the parameter definitions used by Cloud Canvas (for example, ConfigurationBucket or ConfigurationKey).

  2. Reference the parameter when you define a resource. You can use parameters to provide values for resource properties, including passing settings to Lambda functions through the Cloud Canvas Custom::LambdaConfiguration resource.

  3. Use the lmbr_aws parameter list, parameter set, and parameter clear commands to view and set parameter values. These commands are described later in this document.

  4. Update (or create) the resource group stack using the lmbr_aws resource-group upload command, or click Upload Resources in the Cloud Canvas Resource Manager window in Lumberyard Editor.

Parameter Configuration

A project's parameter configuration is stored in a project-settings.json file object in the project's configuration bucket. The bucket is defined by the project's AWS CloudFormation stack template.

You can specify parameter values for a specific deployment or for all deployments by using the * character as a wildcard in place of a deployment name. You can also specify parameter values for a specific resource group or for all resource groups by using the * in place of a resource group name. If you provide a parameter value for both a wildcard (*) entry and a named entry, the value from the named entry overrides the value from the wildcard entry.

The following table shows the lmbr_aws commands for listing, setting, and clearing parameter values. Your project must be initialized (that is, a project stack must have been created) before you can list, set, or clear parameter values. For usage details, visit the corresponding links in the table.

lmbr_aws command Description
parameter list Lists the parameters currently configured for your project.
parameter set Sets parameter configuration for your project.
parameter clear Clears the specified parameter configuration for your project.

On this page: