AWS CloudFormation Template

Creates a stack from a CloudFormation template on Amazon Web Services (AWS).

Object Representation (YAML)

id: String
name: String
depends: [String]
tags: [String]
condition: String
ignore_errors: Boolean
properties:
  credential: Credential
  name: String
  action: String
  region: String
  on_failure: String
  capabilities: [String]
  template_content: [String]
  template_path: String
  template_url: String
  parameters_content: String
  parameters_path: String

Fields

PropertyDetails
id *

String

A unique identifier for the step.

Can contain hyphens and underscores, but not spaces.

name *

String

A friendly name for the step. This name will appear in the pipeline designer and run output.

depends[]

[String]

A list of dependencies of this step.

This step will not be executed until all steps with ids in this list are finished executing.

tags[]

[String]

Tags are used to group related steps. Steps with the same tag can be retrieved using the findStepsByTag() helper function.

Can contain hyphens and underscores, but not spaces.

condition

String

An expression which is evaluated before the step executes. If it evaluates to false, the step will be skipped. The step.result.status field will be "Skipped".

ignore_errors

Boolean

If true, errors in the step module will not halt pipeline execution, and subsequent steps will still be executed. The step.result.status field will be "Failed" if the step encounters an error.

properties.credential *

Credential

The ID of an AWS IAM Access Key credential. See here for more information.

properties.name *

String

Name of the stack.

properties.action *

String

Whether to create/update or delete the stack resources. One of create or delete.

properties.region *

String

AWS Region in which to deploy the stack.

properties.on_failure *

String

Action to take if the stack deployment fails. One of DO_NOTHING, ROLLBACK, or DELETE.

properties.capabilities *

[String]

List of capabilities. Any of CAPABILITY_IAM, CAPABILITY_NAMED_IAM, or CAPABILITY_AUTO_EXPAND.

properties.template_content *

[String]

Inline CloudFormation template content. Provide exactly one of template_content or template_path, or template_url.

properties.template_path

String

Path to an existing CloudFormation template on the agent. Provide exactly one of template_content, template_path, or template_url.

properties.template_url

String

Public URL of an existing CloudFormation template. Provide exactly one of template_content, template_path, or template_url.

properties.parameters_content

String

Inline CloudFormation parameters content. Provide exactly one of parameters_content or parameters_path.

properties.parameters_path

String

Path to an existing CloudFormation parameters file on the agent. Provide exactly one of parameters_content or parameters_path.

Result Fields

The following are the step execution result fields available at step.result after a step executes.

KeyDetails
result.status

String

A string indicating the step execution status. Can be Succeeded, Failed, or Skipped.