This is a Concourse CI resource that controls the deployment of CloudFormation
stacks.
Resource type
You need to add this as a resource type to use it in your pipeline.
resource_types:
- name: cloudformation-resource
type: docker-image
source:
repository: pipelineci/cloudformation-resource
Source Configuration
-
name
: Required. The stack name
-
aws_access_key_id
: Required.
-
aws_secret_access_key
: Required.
-
region
: Required.
aws_access_key_id
and aws_secret_access_key
may be omitted if the EC2
instance has an IAM role with the correct permissions.
Example
Resource configuration for a CloudFormation stack:
resources:
- name: my-stack
type: cloudformation
source: name: my-stack
aws_access_key_id: AUDFDQ7CA7JO6U56EQFW
aws_secret_access_key: VY1SazRkI8M1JEIIUnwmxzMhfjaIzZABNVcqanj8
region: ap-southeast-2
Creating/updating the stack:
jobs:
- name: update-stack
plan:
- get: repo
trigger: true
- put: my-stack
params:
template: repo/my-stack.template
parameters: repo/my-stack-parameters.json
Delete the stack:
jobs:
- name: delete-stack
plan:
- put: my-stack
params:
delete: true
Get stack outputs:
jobs:
- name: get-stack-outputs
plan:
- get: my-stack
Behaviour
check
: Check for new stack events.
If a stack is updated or created this resource is triggered.
in
: Not implemented
There is no in behaviour implemented.
out
: Modify stack.
Create, update or delete the stack.
Parameters
template
: Required. The path of the CloudFormation template.
parameters
: Optional. The path of the CloudFormation parameters.
tags
: Optional. The path of the CloudFormation tags.
capabilities
: Optional. List of capabilities.
delete
: Optional. Set to true
to delete the stack.
wait
: Optional. Defaults to true. If false is set it will update/create
the stack and not wait for it to complete.
changeset
: Optional. If set it will apply changeset operations instead of
create/update. Takes a list of operations: create
or execute
or both i.e.
[create, execute].