Quickstart

Deploy your first multi-stack pipeline with samstacks in under 5 minutes.

Create Your Pipeline

Create a manifest file pipeline.yml:

pipeline.yml

pipeline_name: My SAM Application Deployment
pipeline_description: Deploys the backend and frontend for My SAM Application.

pipeline_settings:
  default_sam_config:
    version: 0.1
    default:
      deploy:
        parameters:
          capabilities: CAPABILITY_IAM
          confirm_changeset: false

stacks:
  - id: backend
    dir: my_sam_app/backend/
    params:
      TableName: ${{ env.TABLE_NAME || 'MyTable' }}
  - id: frontend
    dir: my_sam_app/frontend/
    params:
      ApiEndpoint: ${{ stacks.backend.outputs.ApiUrl }}

Deploy Your Pipeline

# Using uvx (recommended)
uvx samstacks deploy pipeline.yml

# Or if installed globally
samstacks deploy pipeline.yml

Execution Flow

samstacks will:

Dependency analysis - Construct deployment dependency graph
Backend stack deployment - Provision API and database infrastructure
Frontend stack deployment - Resolve backend outputs as input parameters
Status reporting - Display deployment results and stack outputs

Next Steps

Installation Guide - Install samstacks locally
Manifest Reference - Complete configuration options
Examples - Real-world use cases

Installation