Documentation
Manifest Reference

Manifest Reference

Complete reference for pipeline manifest configuration.

Pipeline Metadata

pipeline.yml
pipeline_name: My SAM Application Deployment
pipeline_description: Description of the pipeline
summary: |-
  Optional post-deployment summary shown in console

Pipeline Settings

Configure global settings that apply to all stacks:

pipeline.yml
pipeline_settings:
  stack_name_prefix: myapp-        # Prefix for all stack names
  default_region: us-east-1        # Default AWS region
  default_sam_config:              # Shared SAM configuration
    version: 0.1
    default:
      deploy:
        parameters:
          capabilities: CAPABILITY_IAM
          confirm_changeset: false
  inputs:                          # Pipeline input parameters
    environment:
      type: string
      default: development

Stack Configuration

Define your deployment stacks:

pipeline.yml
stacks:
  - id: network                    # Unique stack identifier
    dir: infrastructure/network    # Directory containing SAM template
    if: ${{ env.DEPLOY_NETWORK }}  # Conditional deployment
    params:                        # Stack parameters
      Environment: ${{ inputs.environment }}
    run: |-                       # Post-deployment actions
      echo "Network deployed successfully"

Stack Properties

Required Properties

PropertyTypeDescription
idstringUnique identifier for the stack
dirstringDirectory containing the SAM template

Optional Properties

PropertyTypeDescription
namestringHuman-readable name for the stack
descriptionstringDescription of the stack
ifstringConditional expression for deployment
paramsobjectParameters to pass to the stack
runstringCommands to run after deployment
regionstringAWS region override for this stack
profilestringAWS profile override for this stack
stack_name_suffixstringStack-specific suffix for naming
sam_config_overridesobjectStack-specific SAM configuration

Expression Language

samstacks supports GitHub Actions-style expressions:

Environment Variables 

params:
  Environment: ${{ env.ENVIRONMENT || 'development' }}

Stack Outputs 

params:
  VpcId: ${{ stacks.network.outputs.VpcId }}
  DatabaseUrl: ${{ stacks.database.outputs.ConnectionString }}

Input Parameters 

params:
  InstanceType: ${{ inputs.instance_type }}

Conditional Logic 

if: ${{ env.ENVIRONMENT == 'production' }}
if: ${{ inputs.deploy_database == 'true' }}

Mathematical Operations 

params:
  DesiredCapacity: ${{ inputs.base_capacity * 2 }}
  MaxSize: ${{ inputs.base_capacity + 10 }}

Complete Example

pipeline.yml
pipeline_name: Multi-Tier Application
pipeline_description: Web application with database and API

pipeline_settings:
  stack_name_prefix: myapp-
  default_region: us-west-2
  inputs:
    environment:
      type: string
      default: development

stacks:
  - id: network
    dir: infrastructure/network
    params:
      Environment: ${{ inputs.environment }}
      
  - id: database
    dir: infrastructure/database
    if: ${{ inputs.environment != 'test' }}
    params:
      VpcId: ${{ stacks.network.outputs.VpcId }}
      SubnetIds: ${{ stacks.network.outputs.PrivateSubnetIds }}
      
  - id: api
    dir: application/api
    params:
      DatabaseUrl: ${{ stacks.database.outputs.ConnectionString }}
      Environment: ${{ inputs.environment }}
    run: |-
      echo "API deployed to: ${{ stacks.api.outputs.ApiUrl }}"

Next Steps

ExamplesCLI Reference