Registry / devops / awscdk-v1-stack-finder

awscdk-v1-stack-finder

library1.0.358jsnpmunverified

Command line tool to identify AWS CloudFormation stacks deployed with AWS CDK V1, useful for migration to CDK V2. Current stable version is 1.0.358, released via npm with no predefined cadence. It scans specified or all AWS regions, examining CloudFormation stack template metadata for CDK v1 bootstrapping patterns. Different from manual inspection by automating region-wide discovery and filtering V1 stacks. Requires AWS credentials and permissions to describe stacks in target regions.

devops

npm install awscdk-v1-stack-finder

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · AWSCDK-V1-STACK-FI

awscdk-v1-stack-finder

devopsjavascriptv1.0.358

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

awscdk-v1-stack-finder

✓ npx awscdk-v1-stack-finder

✗ npm install -g awscdk-v1-stack-finder && awscdk-v1-stack-finder

CLI tool primarily used via npx. No programmatic API exposed.

default

✓ npx awscdk-v1-stack-finder

✗ import awscdk-v1-stack-finder from 'awscdk-v1-stack-finder'

No JavaScript/TypeScript imports; only as a CLI command.

Shows basic usage of the CLI tool with default region scanning and output format.

# Ensure AWS credentials are configured (e.g., via environment variables or ~/.aws/credentials) # Then run: npx awscdk-v1-stack-finder # To scan specific regions: AWS_REGIONS=us-east-1,eu-west-1 npx awscdk-v1-stack-finder # Example output: # us-east-1: fetching stacks # ... # Found 12 AWS CDK V1 stacks: # name: my-stack | id: arn:aws:cloudformation:us-east-1:123456789012:stack/my-stack/...

Debug

Known issues

gotchaTool requires AWS credentials with permissions to describe stacks in target regions. Without proper IAM permissions (cloudformation:DescribeStacks, sts:GetCallerIdentity), the tool will fail silently or with auth errors.

fix

Ensure IAM user/role has policy allowing cloudformation:DescribeStacks and sts:GetCallerIdentity.

affects: all

gotchaScanning all regions can be slow if there are many regions and stacks. The tool makes API calls sequentially, so it may take minutes for accounts with many regions.

fix

Use the AWS_REGIONS environment variable to limit scanning to specific regions relevant to your migration.

affects: all

gotchaThe tool may miss stacks if the stack was created with a custom bootstrap template that doesn't include the standard CDK v1 metadata in the stack description. It relies on stack description containing 'CDKToolkit' or 'cdk-', but heuristic may change.

fix

Manually verify stacks identified and consider checking CloudFormation template metadata if needed.

affects: all

deprecatedThe package name 'awscdk-v1-stack-finder' includes 'v1' but the tool is still actively maintained as of version 1.0.358. No deprecation announced yet.

fix

No action needed; continue using as CLI tool.

affects: all

gotchaIf you use the tool in a CI/CD pipeline, ensure that the AWS credentials used have the necessary permissions and that the tool is invoked with correct environment variables. Running without AWS_REGIONS set may cause full region scan which could be charged by AWS API calls.

fix

Set AWS_REGIONS to a limited set of regions to avoid unnecessary API calls and costs.

affects: all

Errors

Common errors & fixes

Error: CredentialsError: Missing credentials in config, if using AWS_CONFIG_FILE, set AWS_SDK_LOAD_CONFIG=1

AWS credentials not configured or not loaded when using a profile without setting AWS_SDK_LOAD_CONFIG.

fix

Set AWS_SDK_LOAD_CONFIG=1 and AWS_PROFILE=<profile> environment variables before running npx command.

Error: AccessDenied: User: arn:aws:iam::123456789012:user/foo is not authorized to perform: cloudformation:DescribeStacks

IAM user lacks permission to describe CloudFormation stacks in the target account/region.

fix

Attach an IAM policy that grants cloudformation:DescribeStacks action to the user/role.

Upgrade

Version history

1.0.358latest on npm

Audit

Dependencies

aws-sdkrequiredUsed to interact with AWS CloudFormation and STS APIs to list and describe stacks across regions.

Agent activity

14 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/cdklabs/awscdk-v1-stack-finder ↗

packageawscdk-v1-stack-finder ↗

homepagehttps://github.com/cdklabs/awscdk-v1-stack-finder#readme ↗