Backend tier stack: Lambda function with API Gateway v2 and optional DynamoDB tables.
Stack Identity
| Property | Value |
|---|
| Stack name | {APP_NAMESPACE}-{APP_ENV}-backend |
| Template | infra/cfn/backend/backend.yml |
| Capabilities | CAPABILITY_NAMED_IAM |
| Lifecycle | deploy |
Parameters
Wirable Parameters
These parameters are automatically wired from other stack outputs by /ipa-compose:
| Parameter | Source | Required |
|---|
ImageUri | ecr.RepositoryUri | Yes |
AuthIssuer | cognito.IssuerUrl | Yes |
AuthAudience | cognito.UserPoolClientId | Yes |
SqsQueueUrl | queue.QueueUrl | Conditional (when EnableSqsIntegration is true) |
SqsSendQueueArns | queue.QueueArn | Conditional (when EnableSqsIntegration is true) |
Configurable Parameters
| Parameter | Default | Description |
|---|
FunctionName | {namespace}-{env}-api | Lambda function name |
MemorySize | 512 | Lambda memory in MB |
Timeout | 30 | Lambda timeout in seconds |
ImageCommand | (template default) | Container image command override |
Feature Flags
| Flag | Default | Effect |
|---|
EnablePassengersTable | false | Creates a DynamoDB Passengers table |
EnableSqsIntegration | false | Grants SQS send permissions and injects SQS_QUEUE_URL environment variable |
Outputs
| Output | Description |
|---|
ApiUrl | HTTP API Gateway invoke URL |
FunctionArn | Lambda function ARN |
FunctionName | Lambda function name |
PassengersTableArn | DynamoDB table ARN (only when EnablePassengersTable is true) |
Deploy Order
Backend deploys after Queue when both stacks are in the same pattern, because backend may need the Queue URL for SQS integration wiring.