ministackorg/ministack

これは何？

主な機能

• 01S3、SQS、DynamoDB、Lambda、Step Functionsなど、60以上のAWSサービスを単一ポートでエミュレートします。
• 02エンドポイントURLを変更するだけで、boto3、AWS CLI、Terraform、CDK、Pulumiを利用できます。
• 03アクセスキーに基づいてアカウントごと、リージョンごとに状態を分離します。
• 04RDSとElastiCache向けに、実際のPostgres、MySQL、Redis、Valkeyコンテナを実行します。
• 05テストスイートで使えるリセットエンドポイントと確認用エンドポイントを提供します。

ユースケース

• 実際のAWS認証情報を使わずに、CIでAWS依存の統合テストを実行する。
• エミュレートされたSQS、SNS、EventBridgeを使って、Lambda関数やイベント駆動型ワークフローをローカルで開発する。
• AWSにデプロイする前に、TerraformやCDKのインフラコードをテストする。
• ローカル開発環境で、有料のLocalStack環境を置き換える。

クイックスタート

1. 1

   PyPIからインストール

   pip install ministack
2. 2

   MiniStackを起動（ポート4566で実行）

   ministack
3. 3

   サーバーが実行中であることを確認

   curl http://localhost:4566/_ministack/health

使う前に知っておきたいこと

• !Athena SQLクエリと一部の実データベース機能には、サイズの大きいフルDockerイメージが必要です。
• !RDS、ElastiCache、ECS、Lambdaのコンテナを使用するには、Dockerソケットをマウントする必要があります。

収録されている特集

トピック

よくある質問

ministack とは？

60以上のAWSサービスを単一ポートで動かせる、boto3、AWS CLI、Terraform互換の無料オープンソースAWSローカルエミュレーター。 MiniStackは、AWSアカウントなしで、S3、SQS、SNS、DynamoDB、Lambda、IAM、EC2、Step Functionsをはじめとする数十のAWSサービスを、開発者のマシンやCI上で実行できるローカルAWSエミュレーターです。すべてのサービスがデフォルトではポート4566の単一エンドポイントで公開されるため、既存のboto3、AWS CLI、Terraform、CDK、Pulumiの設定はエンドポイントURLを変更するだけで使えます。

ministack は無料で使えますか？ライセンスは？

ministack は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

ministack は今もメンテナンスされていますか？

活発にメンテナンス中。ministack の最終コミットは 2026年11月6日 です。

ministack は何に使えますか？

実際のAWS認証情報を使わずに、CIでAWS依存の統合テストを実行する。 エミュレートされたSQS、SNS、EventBridgeを使って、Lambda関数やイベント駆動型ワークフローをローカルで開発する。 AWSにデプロイする前に、TerraformやCDKのインフラコードをテストする。 ローカル開発環境で、有料のLocalStack環境を置き換える。

ministack のインストール方法は？

PyPIからインストール: pip install ministack MiniStackを起動（ポート4566で実行）: ministack サーバーが実行中であることを確認: curl http://localhost:4566/_ministack/health

ministack はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/ministackorg/ministack