cloudreach/sceptre repository overview

⁠Sceptre

⁠About

Sceptre is a tool to drive AWS CloudFormation⁠. It automates the mundane, repetitive and error-prone tasks, enabling you to concentrate on building better infrastructure.

⁠Features

• Code reuse by separating a Stack's template and its configuration
• Support for templates written in JSON, YAML, Jinja2 or Python DSLs such as Troposphere
• Dependency resolution by passing of Stack outputs to parameters of dependent Stacks
• Stack Group support by bundling related Stacks into logical groups (e.g. dev and prod)
• Stack Group-level commands, such as creating multiple Stacks with a single command
• Fast, highly parallelised builds
• Built in support for working with Stacks in multiple AWS accounts and regions
• Infrastructure visibility with meta-operations such as Stack querying protection
• Support for inserting dynamic values in templates via customisable Resolvers
• Support for running arbitrary code as Hooks before/after Stack builds

⁠Benefits

• Utilises cloud-native Infrastructure as Code engines (CloudFormation)
• You do not need to manage state
• Simple templates using popular templating syntax - Yaml & Jinja
• Powerful flexibility using a mature programming language - Python
• Easy to integrate as part of a CI/CD pipeline by using Hooks
• Simple CLI and API
• Unopinionated - Sceptre does not force a specific project structure

⁠Use Docker Image

To use our Docker image follow these instructions:

1. Pull the image docker pull cloudreach/sceptre:[SCEPTRE_VERSION_NUMBER] e.g. docker pull cloudreach/sceptre:2.1.3. Leave out the version number if you wish to run latest.

2. Run the image. You will need to mount the working directory where your project resides to a directory called project. You will also need to mount a volume with your AWS config to your docker container. E.g.

docker run -v $(pwd):/project -v /Users/me/.aws/:/root/.aws/:ro cloudreach/sceptre:latest --help

If you want to use a custom ENTRYPOINT simply amend the Docker command:

docker run -ti --entrypoint='' cloudreach:test sh

The above command will enter you into the shell of the Docker container where you can execute sceptre commands - useful for development.

If you have any other environment variables in your non-docker shell you will need to pass these in on the Docker CLI using the -e flag. See Docker documentation on how to achieve this.