Fakecloud: 統合テスト用のローカルAWSクラウドエミュレーター
Fakecloud: Local AWS cloud emulator for integration tests (fakecloud.dev)
要約
Fakecloudは、ローカル環境でAWSクラウドの動作をエミュレートするツールです。通常のAWSクライアントやIaCツールを使用しながら、完全にローカルで開発・テストを行うことができます。106のAWSサービスをサポートし、高い互換性を誇ります。アカウントや認証トークン、有料プランなしでコア開発フローをローカルに保てる点が特徴です。
全文翻訳
fakecloud
統合テスト用のローカルAWSクラウドエミュレーター。
通常のAWSクライアントでアプリを実行し、完全にローカルに留まり、テストでより深い可視性が必要な場合はfakecloud SDKを使用します。
107サービス。7,657オペレーション。258,545/258,545のSmithyバリアントが合格 — 真の100%準拠。
なぜfakecloudか?
fakecloudは、モックではなくインフラストラクチャのように振る舞うローカルAWS環境を提供します。アプリは通常のAWS SDK、CLI、IaCツールを使用します。今日のLocalStack Communityセットアップとは異なり、コア開発フローをローカルに保つためだけにアカウント、認証トークン、または有料プランは必要ありません。
SDKは、そのワークフローをより良くしますが、狭めるものではありません。 fakecloudを起動し、実際にデプロイするコードを実行し、後でメール/メッセージ/呼び出しを検査し、オンデマンドで発生する非同期AWSスタイルの動作を強制します。
リアルなローカルテストのために構築
アプリ用のリアルなAPI、テスト用の専用ツール。
ワークフロー
アプリが実際に行うことをテストする
localhostに対して通常のAWSクライアントを使用し、ポーリング、フィクスチャ、またはプライベートテストフックを組み合わせる代わりに、fakecloudで効果を検証します。
SDK
ファーストパーティのテストクライアント
TypeScript、Python、Go、PHP、Java、Rust、.NET SDKは、アプリが通常のAWS APIをすでに使用した後、リセット、アサーション、非同期プロセッサの手動制御のために/_fakecloud/*エンドポイントをラップします。
カバレッジ
107のAWSサービス
S3、SQS、SNS、EventBridge、EventBridge Pipes、EventBridge Scheduler、Lambda、EC2、DynamoDB、IAM、STS、Organizations、SSM、Secrets Manager、CloudWatch Logs、CloudWatch (Metrics & Alarms)、KMS、CloudFormation、Cloud Control API、SES、Cognito User Pools、Cognito Identity、Kinesis、Firehose、RDS、RDS Data API、Aurora DSQL、Resource Groups、Resource Groups Tagging API、ElastiCache、MemoryDB、EKS、Cloud Map、Step Functions、API Gateway v1 (REST)、API Gateway v2 (HTTP)、Bedrock、Bedrock Agent、Bedrock Agent Runtime、Bedrock Runtime、ECR、ECS、Elastic Load Balancing v2、CloudFront、Route 53、WAF v2、Application Auto Scaling、Athena、ACM、Glue、その他多数。
テスト済み
準拠テスト済み
実装されたすべての7,657のAPIオペレーション全体で真の100%準拠:258,545/258,545のSmithyモデル生成テストバリアントがコミットごとに合格し、公式AWS SDKに対するエンドツーエンドテストによって裏付けられています。
実際の動作
クロスサービスフローが接続されている
30以上のサービス間統合:S3通知、SNSファンアウト、EventBridgeターゲット、DynamoDBストリーム、CloudWatch Logsサブスクリプション、Cognitoトリガー、Step Functionsタスク統合、API Gateway → Lambdaなど — すべてが実際のサービスインタラクションを実行します。
シンプル
認証不要、ロックインなし、有料プランなし
単一のバイナリまたはDockerイメージを実行し、任意のダミー認証情報を使用し、誰かのプラットフォームにサインインすることなく、ワークフロー全体をローカルに保ちます。
テストアサーション用のSDK
アプリでAWS SDKを使い続けてください。エミュレーター自体に対する可視性と制御が必要なテストでは、fakecloud SDKを使用します。
TypeScript
npm install fakecloud
SESメール、SNSメッセージ、SQSキュー、Lambda呼び出し、Cognito確認コードなどを検査します。
Python
pip install fakecloud
pytestまたはアプリレベルの統合テスト用の非同期および同期クライアント。同じイントロスペクションとシミュレーションカバレッジを備えています。
Go
go get github.com/faiscadev/fakecloud/sdks/go
リセット、イベント履歴、SES受信シミュレーション、およびその他のfakecloudテストサーフェス用のコンテキストフレンドリーなヘルパー。
Rust
cargo add fakecloud-sdk
リセット、状態検査、fakecloudイントロスペクションサーフェスへの直接アクセスが必要なテスト用のネイティブRustクライアント。
クイックスタート
fakecloudを起動し、AWSクライアントをlocalhostに向け、何が起こったかをアサートします。
$ curl -fsSL https://fakecloud.dev/install.sh | bash
$ fakecloud
$ aws --endpoint-url http://localhost:4566 sqs create-queue
--queue-name my-queue
$ npm install fakecloud
比較
アカウント要件なしで、完全にローカルなワークフローと実際のAWS APIが必要な場合、fakecloudはそのパスのために構築されています。SDKは追加のテスト上の利点であり、そのポジショニングの代替ではありません。
| fakecloud | LocalStack Community | |
|---|---|---|
| ライセンス | AGPL-3.0 | プロプライエタリ |
| 認証必須 | いいえ | はい(アカウント+トークン) |
| 商用利用 | 無料 | 有料プランのみ |
| Docker必須 | いいえ(スタンドアロンバイナリ) | はい |
| 起動時間 | 約300ms | 約3秒 |
| アイドルメモリ | 約10 MiB | 約150 MiB |
| インストールサイズ | 約19 MBバイナリ | 約1 GB Dockerイメージ |
| AWSサービス | 107(真の100%準拠) | 30+(Community以降は有料のみ) |
| テストアサーションSDK | TypeScript, Python, Go, PHP, Java, Rust, .NET | Python, Java |
| Cognito User Pools | 132オペレーション | 有料のみ |
| SES v2 | 116オペレーション | 有料のみ |
| SES受信メール | 実際の受信ルールアクション | 保存されるが実行されない |
| RDS | 164オペレーション、PostgreSQL/MySQL/MariaDBはDocker経由、PostgreSQL aws_lambda拡張機能 | 有料のみ |
| ElastiCache | 75オペレーション、RedisとValkeyはDocker経由 | 有料のみ |
| MemoryDB | 45オペレーション、フルコントロールプレーン | 有料のみ |
| EKS | クラスターコントロールプレーン(バッチ1) | 有料のみ |
| API Gateway v2 | 103オペレーション、HTTP API + 開発者ポータル + JWT/Lambdaオーソライザー | 有料のみ |
| Bedrock | 4つのAPI(Bedrock + Bedrock Runtime + Bedrock Agent + Bedrock Agent Runtime)にわたる222オペレーション | 利用不可 |
サポートされているサービス
実装されているすべてのAPIは、準拠および動作テストでカバーされており、サービスミックスはローカル開発および統合テストに合わせて調整されています。
S3
RESTプロトコル · XML
SQS
Queryプロトコル · XML
SNS
Queryプロトコル · XML
EventBridge
JSONプロトコル
EventBridge Scheduler
JSONプロトコル
SSM
JSONプロトコル
DynamoDB
JSONプロトコル
IAM
Queryプロトコル
STS
Queryプロトコル
Lambda
RESTプロトコル · JSON
Secrets Manager
JSONプロトコル
CloudWatch Logs
JSONプロトコル
KMS
JSONプロトコル
CloudFormation
Queryプロトコル
SES
REST + Queryプロトコル
Cognito User Pools
JSONプロトコル
Kinesis
JSONプロトコル
RDS
Queryプロトコル
ElastiCache
Queryプロトコル
MemoryDB
JSON 1.1プロトコル
EKS
REST-JSONプロトコル
Step Functions
JSONプロトコル
API Gateway v1 (REST)
RESTプロトコル · JSON
API Gateway v2
RESTプロトコル · JSON
Bedrock
RESTプロトコル · JSON
Bedrock Runtime
RESTプロトコル · JSON
Bedrock Agent
RESTプロトコル · JSON
Bedrock Agent Runtime
RESTプロトコル · JSON
ECR
RESTプロトコル · JSON
ECS
JSONプロトコル
Elastic Load Balancing v2
Queryプロトコル
CloudFront
RESTプロトコル · XML
Route 53
RESTプロトコル · XML
ACM
JSONプロトコル
ACM PCA
JSONプロトコル
Application Auto Scaling
JSONプロトコル
WAF v2
JSONプロトコル
Athena
JSONプロトコル
Glue
JSONプロトコル
Cognito Identity
JSONプロトコル
CloudWatch (Metrics & Alarms)
Queryプロトコル
Firehose
JSONプロトコル
EC2
Queryプロトコル · XML
Organizations
JSONプロトコル
Cloud Control API
JSONプロトコル
EventBridge Pipes
RESTプロトコル · JSON
RDS Data API
RESTプロトコル · JSON
Aurora DSQL
RESTプロトコル · JSON
Resource Groups
RESTプロトコル · JSON
Resource Groups Tagging API
JSONプロトコル