floci-io/floci

これは何？

主な機能

• 01エンドポイントを変更するだけで、標準のAWS SDK、CLI、IaCツールを利用できます。
• 02Lambda、RDS、ElastiCache、ECS、EC2、EKSを、Dockerコンテナを使った実サービスとして実行します。
• 03インメモリ、永続化、ハイブリッド、write-ahead logのストレージモードを利用できます。
• 0412桁のアクセスキーIDを使って、アカウントごとにリソースを分離します。
• 05Java、Node.js、Python、.NET向けのTestcontainersモジュールを提供します。

ユースケース

• クラウドアカウントを使わずに、AWSに依存するアプリケーションコードやテストをローカルで実行する。
• 実際のインフラではなく、エミュレートされたAWSサービスを使ってCIパイプラインを実行する。
• AWSにデプロイする前に、Terraform、CDK、OpenTofuの設定をテストする。
• 既存のDocker Compose環境でLocalStack Communityを置き換える。

クイックスタート

1. 1

   公式CLIでFlociを起動する

   floci start
2. 2

   AWS環境変数をエクスポートする

   eval $(floci env)
3. 3

   標準的なAWS CLIコマンドをFlociに対して実行する

   aws s3 mb s3://my-bucket

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

• !一部のサービスはDockerを使った実際の実行環境を使用するため、Dockerエンジンが起動しており、Dockerソケットにアクセスできる必要があります。
• !READMEに記載されている「Web Console」機能を使うには、Dockerソケットをコンテナにマウントする必要があります。

トピック

よくある質問

floci とは？

アカウントや認証トークンなしで、AWS互換サービスを手元で実行できる無料のオープンソースAWSエミュレーター。 Flociは、開発・テスト・CI向けのローカルAWSエミュレーターです。AWS SDK、CLI、Terraform、CDK、OpenTofu、またはテストスイートの接続先を http://localhost:4566 に変更するだけで、クラウドアカウントや認証トークン、有料プランを必要とせず、既存のワークフローをそのまま使えます。

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

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

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

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

floci は何に使えますか？

クラウドアカウントを使わずに、AWSに依存するアプリケーションコードやテストをローカルで実行する。 実際のインフラではなく、エミュレートされたAWSサービスを使ってCIパイプラインを実行する。 AWSにデプロイする前に、Terraform、CDK、OpenTofuの設定をテストする。 既存のDocker Compose環境でLocalStack Communityを置き換える。

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

公式CLIでFlociを起動する: floci start AWS環境変数をエクスポートする: eval $(floci env) 標準的なAWS CLIコマンドをFlociに対して実行する: aws s3 mb s3://my-bucket

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

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