Sequence Run Manager Stack

Overview

The root of the project is an AWS CDK project where the main application logic lives inside the ./app folder.

Setup

Requirements

node --version
v22.15.0

# Update corepack if necessary (from pnpm docs)
npm install --global corepack@latest

# Enable corepack
corepack enable pnpm

Install Dependencies

To install all required dependencies, run:

make install

CDK Commands

You can access CDK commands using the pnpm wrapper script. For example:

pnpm cdk <command>

This ensures the correct context is set for CDK to execute.

Stacks

The following stacks are managed within this CDK project. The root stack (excluding the DeploymentPipeline) deploys a stack in the toolchain account, which then deploys a CodePipeline for cross-environment deployments to beta, gamma, and prod.

To list all stacks, run:

pnpm cdk ls

Example output:

OrcaBusStatelessSequenceRunManagerStack
OrcaBusStatelessSequenceRunManagerStack/DeploymentPipeline/OrcaBusBeta/SequenceRunManagerStack (OrcaBusBeta-SequenceRunManagerStack)
OrcaBusStatelessSequenceRunManagerStack/DeploymentPipeline/OrcaBusGamma/SequenceRunManagerStack (OrcaBusGamma-SequenceRunManagerStack)
OrcaBusStatelessSequenceRunManagerStack/DeploymentPipeline/OrcaBusProd/SequenceRunManagerStack (OrcaBusProd-SequenceRunManagerStack)

To build the CICD pipeline for workflow manager

pnpm cdk deploy -e OrcaBusStatelessSequenceRunManagerStack

To build (test) in the dev account

pnpm cdk synth -e OrcaBusStatelessSequenceRunManagerStack/DeploymentPipeline/OrcaBusBeta/SequenceRunManagerStack
pnpm cdk diff -e OrcaBusStatelessSequenceRunManagerStack/DeploymentPipeline/OrcaBusBeta/SequenceRunManagerStack
pnpm cdk deploy -e OrcaBusStatelessSequenceRunManagerStack/DeploymentPipeline/OrcaBusBeta/SequenceRunManagerStack

Linting and Formatting

Run Checks

To run linting and formatting checks on the root project, use:

make check

Fix Issues

To automatically fix issues with ESLint and Prettier, run:

make fix