samstacks

Declarative infrastructure orchestration for AWS SAM deployments.

samstacks is a declarative infrastructure orchestration tool for AWS SAM deployments. It enables teams to define multi-stack deployment pipelines using familiar GitHub Actions syntax with automatic dependency resolution.

Get Started

Key Capabilities

  • Declarative pipeline configuration - Define deployment sequences using YAML manifests
  • GitHub Actions compatibility - Leverage familiar workflow syntax and expressions
  • Native AWS SAM integration - First-class support for SAM templates and configurations
  • Intelligent dependency resolution - Automatic stack ordering based on output dependencies
  • Multi-environment deployments - Parameterized configuration for development lifecycle

Quick Example

pipeline_name: Deploy Application
pipeline_description: Multi-stack deployment pipeline

stacks:
  - id: vpc-stack
    dir: ./infrastructure/vpc
    
  - id: app-stack
    dir: ./application/app
    params:
      VpcId: ${{ stacks.vpc-stack.outputs.VpcId }}
      SubnetIds: ${{ stacks.vpc-stack.outputs.PrivateSubnetIds }}

[!NOTE] This is a work in progress, and the implementation is subject to change.

For more information, visit the documentation.