HN 日本語サマリー

← 一覧へ戻る
インフラ・DevOps

Fakecloud: 統合テスト用のローカルAWSクラウドエミュレーター

Fakecloud: Local AWS cloud emulator for integration tests (fakecloud.dev)

154 pointsby theanonymousone78 コメント

要約

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確認コードなどを検査します。

npmで表示

Python

pip install fakecloud

pytestまたはアプリレベルの統合テスト用の非同期および同期クライアント。同じイントロスペクションとシミュレーションカバレッジを備えています。

PyPIで表示

Go

go get github.com/faiscadev/fakecloud/sdks/go

リセット、イベント履歴、SES受信シミュレーション、およびその他のfakecloudテストサーフェス用のコンテキストフレンドリーなヘルパー。

pkg.go.devで表示

Rust

cargo add fakecloud-sdk

リセット、状態検査、fakecloudイントロスペクションサーフェスへの直接アクセスが必要なテスト用のネイティブRustクライアント。

crates.ioで表示

クイックスタート

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は追加のテスト上の利点であり、そのポジショニングの代替ではありません。

fakecloudLocalStack Community
ライセンスAGPL-3.0プロプライエタリ
認証必須いいえはい(アカウント+トークン)
商用利用無料有料プランのみ
Docker必須いいえ(スタンドアロンバイナリ)はい
起動時間約300ms約3秒
アイドルメモリ約10 MiB約150 MiB
インストールサイズ約19 MBバイナリ約1 GB Dockerイメージ
AWSサービス107(真の100%準拠)30+(Community以降は有料のみ)
テストアサーションSDKTypeScript, Python, Go, PHP, Java, Rust, .NETPython, Java
Cognito User Pools132オペレーション有料のみ
SES v2116オペレーション有料のみ
SES受信メール実際の受信ルールアクション保存されるが実行されない
RDS164オペレーション、PostgreSQL/MySQL/MariaDBはDocker経由、PostgreSQL aws_lambda拡張機能有料のみ
ElastiCache75オペレーション、RedisとValkeyはDocker経由有料のみ
MemoryDB45オペレーション、フルコントロールプレーン有料のみ
EKSクラスターコントロールプレーン(バッチ1)有料のみ
API Gateway v2103オペレーション、HTTP API + 開発者ポータル + JWT/Lambdaオーソライザー有料のみ
Bedrock4つの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プロトコル