stack-deploy 0.0.3

AWS CloudFormation stack deployment orchestration library with change set review, event monitoring, and Lambda deployment support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# stack-deploy - CloudFormation Stack Manager

> **Status**: Pre-1.0 - exists to serve [mbj/mrs](https://github.com/mbj/mrs) monorepo, expect breaking changes without notice.

A CLI tool for managing AWS CloudFormation stacks with enhanced workflow support.

## Features

- **Stack Management**: Create, update, sync, and delete CloudFormation stacks
- **Change Sets**: Interactive change set review before applying updates
- **Event Watching**: Real-time monitoring of stack events during deployments
- **Template Upload**: Automatic S3 upload for large templates
- **Lambda Deployment**: Built-in Lambda function deployment utilities
- **Parameter Management**: Type-safe parameter handling
- **Secrets Integration**: AWS Secrets Manager integration

## Commands

### Instance Management

```bash
# List all registered stack instances
stack-deploy instance list

# Sync stack (create if absent, update if exists)
stack-deploy instance sync --stack-name <name> --parameter Key=Value

# Update existing stack
stack-deploy instance update --stack-name <name> --parameter Key=Value

# Delete stack
stack-deploy instance delete --stack-name <name>

# Watch stack events in real-time
stack-deploy instance watch --stack-name <name>
```

### Change Set Operations

```bash
# Create a change set
stack-deploy instance change-set --stack-name <name> create --change-set-name <cs-name> --parameter Key=Value

# List change sets
stack-deploy instance change-set --stack-name <name> list

# Describe a change set
stack-deploy instance change-set --stack-name <name> describe --change-set-name <cs-name>

# Delete a change set
stack-deploy instance change-set --stack-name <name> delete --change-set-name <cs-name>
```

## Review Modes

When updating or syncing stacks, you can control the change set review behavior:

- `--review-change-set interactive` (default): Review changes before applying
- `--review-change-set no-review`: Apply changes without review

## Integration

Works seamlessly with the [stratosphere](https://github.com/mbj/mrs/tree/main/stratosphere) library for type-safe CloudFormation template generation.