[
    {
        "ParameterKey": "pName",
        "ParameterValue": "MyName"
    },
    {
        "ParameterKey": "pStack",
        "ParameterValue": "MyStack"
    },
    {
        "ParameterKey": "pWorkspace",
        "ParameterValue": "dev"
    }
]

{
    "Statement" : [
        {
        "Effect" : "Allow",
        "Action" : ["Update:*"],
        "Principal": "*",
        "Resource" : "*"
        }
    ]
}

# AWS CloudFormation <Name_Of_Template> Template

## Table of contents

* [Summary](#summary)
* [Usage](#usage)
* [Components](#components)
* [Structure](#structure)
* [Issues](#issues)
* [Contributions](#contributions)
* [Questions](#questions)

## Summary

Author(s): Author Name (@Alias)
Email(s): Email Address

Use this section to provide a detailed overview of your template.

* What use case(s) or problem(s) does your solution pattern solve?
* What resources does your template provision?

## Usage

Examples of how to use this template:

## Components

Use this section to provide a detailed review of the core components of your template.

* Describe the 'resources' that are deployed using this template
* Describe the dependencies between resources
* Describe the default configuration of the resources
* Describe any special policy considerations (UpdatePolicy, DeletePolicy, etc)

## Structure

CloudFormation templates describe your AWS resources and their properties.  

Use this section to describe the structure of your Service Template:

    /stack                  # Stack Template Root.
            
        /parameters         # Parameters Directory for the CloudFormation Template
            default.json    # Default Parameters to be used when Environment Specific Parameters File Does Not Exist
                            # Environment Specific Parameter Files can be implemented via dev.json, tst.json, prd.json

        /policy             # Policy Directory for the CloudFormation Stack Policy
            default.json    # Default Stack Policy to be used when Environment Specific Policy File Does Not Exist
                            # Environment Specific Policy Files can be implemented via dev.json, tst.json, prd.json
            
        service.yaml        # Service Template Configuration File
        template.yaml       # CloudFormation Template for the Service
        README.md           # README File describing the service template

## Issues

Describe how users should report any issues that are identified while using this Service Template

Example:

If you identify an issue using this template please contact support@example.com

Detailed information is very helpful to understand and prioritize issues.

    How to reproduce the issue, step-by-step.
    The expected behavior (or what is wrong).
    The error message(s)
    The operating system
    Screenshots if applicable

## Contributions

Pull Requests (PRs) are always welcome.  Please create a new branch and submit a pull-request for review.

## Questions

Still have questions?  Please contact support@example.com

---
# CloudFormation Stack Template

AWSTemplateFormatVersion: "2010-09-09"
 
Description: >
  Here is a description and 
  some additional details
  about this template.   
Metadata:
  template metadata

Parameters:
  pName:
    Description: Sets the Name. Default is <blank>
    Type: String
    Default: <blank>
  pStack:
    Description: Sets the Stack. Default is <blank>
    Type: String
    Default: <blank>
  pWorkspace:
    Description: Sets the Workspace. Default is dev.
    Type: String
    Default: dev
    ConstraintDescription: Must be an allowed value. (dev|tst|stg|prd|ops)
    AllowedValues: 
      - dev     # Development
      - tst     # Testing
      - stg     # Staging
      - prd     # Production
      - ops     # Operations 

Mappings:
  set of mappings

Conditions:
  set of conditions

Transform:
  set of transforms

Resources:
  set of resources

Outputs:
  set of outputs

#!/usr/bin/env bash

## ARGUMENTS
## ====================================
ACTION=$1
STACK=$2
WORKSPACE=$3
if [ -z "$WORKSPACE" ]
then
      echo "Workspace argument not specified, using 'default'"
      WORKSPACE="default"
fi

## FUNCTIONS
## ====================================
function help () {
    echo "Description:"
    echo "    CloudFormation Script is a simple programmatic workflow"
    echo ""
    echo "Usage: "
    echo "    ./cloudformation.sh <ACTION> <STACK> <WORKSPACE>"
    echo ""
    echo "Example:"
    echo "    ./cloudformation.sh list-stacks"
    echo "    ./cloudformation.sh list-stack s3-bucket"
    echo "    ./cloudformation.sh list-parameters s3-bucket dev"
    echo "    ./cloudformation.sh deploy-stack s3-bucket dev"
    echo "    ./cloudformation.sh describe-stack s3-bucket"
    echo "    ./cloudformation.sh describe-stacks"
    echo "    ./cloudformation.sh destroy-stack s3-bucket dev"
    echo "    ./cloudformation.sh stage-stack s3-bucket dev"
    echo "    ./cloudformation.sh validate-template s3-bucket"
    echo ""
}

function describeStack () {
    echo ""
    echo "CloudFormation Script is Describing Stack '$STACK' in $WORKSPACE"
    COMMAND="aws cloudformation describe-stacks --stack-name $STACK "
    echo $COMMAND
    eval $COMMAND
}

function describeStacks () {
    echo ""
    echo "CloudFormation Script is Describing Stacks"
    COMMAND="aws cloudformation describe-stacks"
    echo $COMMAND
    eval $COMMAND
}

function stageStack () {
    echo ""
    echo "CloudFormation Script is getting Parameters for $STACK in $WORKSPACE "
    PARAMS=$(jq -r '.[] | [.ParameterKey, .ParameterValue] | "\(.[0])=\"\(.[1])\""' ./stacks/$STACK/params/$WORKSPACE.json)
    echo "-------------------------------------"
    echo "./stacks/$STACK/params/$WORKSPACE.json"
    echo "-------------------------------------"
    echo "$PARAMS"

    echo ""
    echo "CloudFormation Script is Staging Stack '$STACK' in $WORKSPACE "
    COMMAND="aws cloudformation deploy --stack-name $STACK --template-file ./stacks/$STACK/template.yaml --no-execute-changeset --parameter-overrides $PARAMS"
    echo $COMMAND
    echo ""
    eval $COMMAND
}

function deployStack () {
    echo ""
    echo "CloudFormation Script is getting Parameters for $STACK in $WORKSPACE "
    PARAMS=$(jq -r '.[] | [.ParameterKey, .ParameterValue] | "\(.[0])=\"\(.[1])\""' ./stacks/$STACK/params/$WORKSPACE.json)
    echo "-------------------------------------"
    echo "./stacks/$STACK/params/$WORKSPACE.json"
    echo "-------------------------------------"
    echo "$PARAMS"

    echo ""
    echo "CloudFormation Script is Deploying Stack '$STACK' in $WORKSPACE "
    COMMAND="aws cloudformation deploy --stack-name $STACK --template-file ./stacks/$STACK/template.yaml --capabilities CAPABILITY_IAM CAPABILITY_NAMED_IAM --parameter-overrides $PARAMS"
    echo $COMMAND
    echo ""
    eval $COMMAND
}

function destroyStack () {
    echo ""
    echo "CloudFormation Script is Destroying Stack '$STACK' in $WORKSPACE"
    COMMAND="aws cloudformation delete-stack --stack-name $STACK "
    echo $COMMAND
    eval $COMMAND
}

function describeStacks () {
    echo ""
    echo "CloudFormation Script is Describing Stacks"
    COMMAND="aws cloudformation describe-stacks"
    echo $COMMAND
    eval $COMMAND
}

function describeStack () {
    echo ""
    echo "CloudFormation Script is Describing Stack '$STACK'"
    COMMAND="aws cloudformation describe-stack --stack-name $STACK"
    echo $COMMAND
    eval $COMMAND
}

function listParameters () {
    echo ""
    echo "CloudFormation Script is Listing Parameters for Stack '$STACK' in $WORKSPACE"
    PARAMS=$(jq -r '.[] | [.ParameterKey, .ParameterValue] | "\(.[0])=\"\(.[1])\""' ./stacks/$STACK/params/$WORKSPACE.json)
    echo "-------------------------------------"
    echo "./stacks/$STACK/params/$WORKSPACE.json"
    echo "-------------------------------------"
    echo $PARAMS
    echo ""
}

function validateTemplate () {
    echo ""
    echo "CloudFormation Script is Validating Template for Stack '$STACK'"
    COMMAND="aws cloudformation validate-template --template-body file://./stacks/$STACK/template.yaml"
    echo $COMMAND
    eval $COMMAND
}

case "$ACTION" in
        stage-stack)
            stageStack
            ;;
        deploy-stack)
            deployStack
            ;;
        describe-stack)
            describeStack
            ;;
        describe-stacks)
            describeStacks
            ;;    
        destroy-stack)
            destroyStack
            ;;
        list-stack)
            describeStack
            ;;
        list-stacks)
            describeStacks
            ;;
        list-parameters)
            listParameters
            ;;
        validate-template)
            validateTemplate
            ;;        
        *)
            help
            ;;
esac