サーバーレスコンピューティングのための、セキュアで高速なマイクロVM。
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/images/fc_logo_full_transparent-bg_white-fg.png">
<source media="(prefers-color-scheme: light)" srcset="docs/images/fc_logo_full_transparent-bg.png">
<img alt="Firecracker ロゴタイトル" width="750" src="https://assets.kitploit.com/production/public/readmes/50781/a1a37e8c64a72ced259fe81774e5ca8ebf93dd800a4c74037fdaeec6bda58425/6bc161c18b454a0f6d6be893381c8be7c2ecf45371096b4e0ccca4625282984c-display-v1.webp">
</picture>
私たちの使命は、コンテナおよび関数ワークロードの安全でマルチテナントな、最小限のオーバーヘッドでの実行を可能にすることです。
Firecracker 憲章の詳細は[こちら](https://github.com/firecracker-microvm/firecracker/blob/main/CHARTER.md)をご覧ください。
## Firecracker とは?
Firecracker は、サーバーレスの運用モデルを提供する、安全でマルチテナントなコンテナおよび関数ベースのサービスの作成と管理のために専用に設計されたオープンソースの仮想化技術です。Firecracker は、マイクロ VM と呼ばれる軽量な仮想マシンでワークロードを実行します。マイクロ VM は、ハードウェア仮想化技術が提供するセキュリティと分離の特性を、コンテナのスピードと柔軟性と組み合わせたものです。
## 概要
Firecracker の主要コンポーネントは、Linux Kernel Virtual Machine(KVM)を使用してマイクロ VM を作成および実行する仮想マシンモニタ(VMM)です。Firecracker は、KVM の代わりに AWS Nitro System によって分離された[Nitro Sandbox](https://github.com/firecracker-microvm/firecracker/blob/main/docs/nitro-sandboxes/README.md)としてゲストを実行することもできます。Firecracker はミニマリストな設計になっています。各マイクロ VM のメモリフットプリントと攻撃対象領域を削減するため、不要なデバイスやゲスト向けの機能を排除しています。これにより、セキュリティが向上し、起動時間が短縮され、ハードウェアの利用率が高まります。Firecracker は、例えば [Kata Containers](https://github.com/kata-containers/kata-containers) や [Flintlock](https://github.com/liquidmetal-dev/flintlock) など、コンテナランタイムにも統合されています。
Firecracker は、[AWS Lambda](https://aws.amazon.com/lambda/) や [AWS Fargate](https://aws.amazon.com/fargate/) のようなサービスのスピードと効率を加速するために Amazon Web Services で開発されました。Firecracker は [Apache version 2.0](https://github.com/firecracker-microvm/firecracker/blob/main/LICENSE) の下でオープンソース化されています。
Firecracker の詳細については、[firecracker-microvm.io](https://firecracker-microvm.github.io) をご覧ください。
## はじめに
Firecracker を使い始めるには、最新の[リリース](https://github.com/firecracker-microvm/firecracker/releases)バイナリをダウンロードするか、ソースからビルドしてください。
Firecracker は、Docker が実行されており(私たちは開発コンテナを使用しています)、`bash` がインストールされている任意の Unix/Linux システム上で、次のようにビルドできます:
```bash
git clone https://github.com/firecracker-microvm/firecracker
cd firecracker
tools/devtool build
toolchain="$(uname -m)-unknown-linux-musl"
```
Firecracker バイナリは
`build/cargo_target/${toolchain}/debug/firecracker` に配置されます。ビルド、テスト、および Firecracker の実行に関する詳細については、
[クイックスタートガイド](https://github.com/firecracker-microvm/firecracker/blob/main/docs/getting-started.md)を参照してください。
安全なマルチテナントコンピューティングの基準を満たす能力を含む、Firecracker microVM の全体的なセキュリティは、適切に設定された Linux ホストオペレーティングシステムに依存します。この基準を満たすと私たちが考える構成は、
[本番ホストセットアップドキュメント](https://github.com/firecracker-microvm/firecracker/blob/main/docs/prod-host-setup.md)に含まれています。
## コントリビューション
Firecracker はすでに AWS 内で本番ワークロードを実行していますが、私たちの[ミッション](https://github.com/firecracker-microvm/firecracker/blob/main/CHARTER.md)に導かれた旅はまだ Day 1 です。構築すべきことはまだ多くあり、あらゆるコントリビューションを歓迎します。
Firecracker にコントリビュートするには、
[はじめにガイド](https://github.com/firecracker-microvm/firecracker/blob/main/docs/getting-started.md)の開発セットアップセクションを確認し、次に Firecracker の
[コントリビューションガイドライン](https://github.com/firecracker-microvm/firecracker/blob/main/CONTRIBUTING.md)を参照してください。
## リリース
新しい Firecracker バージョンは、GitHub リポジトリの
[releases](https://github.com/firecracker-microvm/firecracker/releases)ページを通じて、通常 2〜3 か月ごとにリリースされます。変更履歴は私たちの
[changelog](https://github.com/firecracker-microvm/firecracker/blob/main/CHANGELOG.md)に記録されています。
Firecracker のリリースポリシーは[こちら](https://github.com/firecracker-microvm/firecracker/blob/main/docs/RELEASE_POLICY.md)に詳述されています。
## 設計
Firecracker の全体的なアーキテクチャは
[設計ドキュメント](https://github.com/firecracker-microvm/firecracker/blob/main/docs/design.md)に記載されています。
## 機能とケイパビリティ
Firecracker は、起動後にホストへ API エンドポイントを公開する単一のマイクロ仮想マシンマネージャプロセスで構成されています。API は
[OpenAPI 形式で仕様が定義されて](https://github.com/firecracker-microvm/firecracker/blob/main/src/firecracker/swagger/firecracker.yaml)います。詳細については
[API ドキュメント](https://github.com/firecracker-microvm/firecracker/blob/main/docs/api_requests)を参照してください。
**API エンドポイント**は以下の用途に使用できます:
- 以下により microVM を構成する:
- vCPU の数を設定する (デフォルトは 1)。
- メモリサイズを設定する (デフォルトは 128 MiB)。
- [CPU テンプレート](https://github.com/firecracker-microvm/firecracker/blob/main/docs/cpu_templates/cpu-templates.md)を構成する。
- microVM に 1 つ以上のネットワークインターフェースを追加する。
- microVM に 1 つ以上の読み書き可能または読み取り専用のディスクを追加する。各ディスクはファイルバックエンドのブロックデバイスで表されます。
- ゲストの実行中にブロックデバイスの再スキャンをトリガーする。これにより、ゲスト OS はブロックデバイスのバッキングファイルのサイズ変更を認識できます。
- ゲストの起動前または起動後に、ブロックデバイスのバッキングファイルを変更する。
- 帯域幅、毎秒の操作数、またはその両方を制限できる virtio デバイスのレートリミッターを構成する。
- ログおよびメトリクスシステムを構成する。
- `[BETA]` ゲスト向けメタデータサービスのデータツリーを構成する。このサービスは、このリソースが構成されている場合にのみゲストが利用できます。
- microVM に [vsock ソケット](https://github.com/firecracker-microvm/firecracker/blob/main/docs/vsock.md)を追加する。
- microVM に [エントロピーデバイス](https://github.com/firecracker-microvm/firecracker/blob/main/docs/entropy.md)を追加する。
- microVM に [pmem デバイス](https://github.com/firecracker-microvm/firecracker/blob/main/docs/pmem.md)を追加する。
- [メモリホットプラグ](https://github.com/firecracker-microvm/firecracker/blob/main/docs/memory-hotplug.md)を構成および管理する。
- `[Developer Preview]` VM の実行中に virtio PCI デバイスを[ホットプラグおよびホットアンプラグ](https://github.com/firecracker-microvm/firecracker/blob/main/docs/device-hotplug.md)する。
- EC2 インスタンス上で、KVM ではなく AWS Nitro System によって分離された [Nitro Sandbox](https://github.com/firecracker-microvm/firecracker/blob/main/docs/nitro-sandboxes/README.md)としてゲストを実行する (オプションでアテステーション付き)。
- 指定されたカーネルイメージ、ルートファイルシステム、および起動引数を使用して microVM を起動する。
- [x86_64 のみ] microVM を停止する。
**組み込みのケイパビリティ**:
- デマンドフォールトページングと CPU オーバーサブスクリプションがデフォルトで有効。
- セキュリティを強化するための、高度でスレッド固有の seccomp フィルター。
- 本番シナリオで Firecracker を起動するための [Jailer](https://github.com/firecracker-microvm/firecracker/blob/main/docs/jailer.md)プロセス。cgroup/namespace 分離バリアを適用してから特権をドロップします。
## テスト済みプラットフォーム
私たちは以下のすべての組み合わせをテストしています:
| インスタンス | ホスト OS とカーネル | ゲスト rootfs | ゲストカーネル |
| :------------------------------------------ | :---------------- | :----------- | :----------- |
| m5n.metal (Intel Cascade Lake) | al2 linux_5.10 | ubuntu 24.04 | linux_5.10 |
| m6i.metal (Intel Ice Lake) | al2023 linux_6.1 | | linux_6.1 |
| | al2023 linux_6.18 | | |
| m7i.metal-24xl (Intel Sapphire Rapids) | | | |
| m7i.metal-48xl (Intel Sapphire Rapids) | | | |
| **m8i.metal-48xl (Intel Granite Rapids)\*** | | | |
| **m8i.metal-96xl (Intel Granite Rapids)\*** | | | |
| m6a.metal (AMD Milan) | | | |
| m7a.metal-48xl (AMD Genoa) | | | |
| m6g.metal (Graviton 2) | | | |
| m7g.metal (Graviton 3) | | | |
| m8g.metal-24xl (Graviton 4) | | | |
| m8g.metal-48xl (Graviton 4) | | | |
| m9g.metal-48xl (Graviton 5) | | | |
**\***: 6.1 または 6.18 のホストカーネルを使用する AWS EC2 第8世代 Intel (\*8i) インスタンス**のみ**をサポートしています。これは、5.10 における Granite Rapids CPU のカーネルサポートが不十分であるためです。
## 既知の問題と制限事項
- aarch64 上の `pl031` RTC デバイスは割り込みをサポートしていないため、RTC アラームを使用するゲストプログラム (例: `hwclock`) は動作しません。
## パフォーマンス
Firecracker のパフォーマンス特性は
[仕様ドキュメント](https://github.com/firecracker-microvm/firecracker/blob/main/SPECIFICATION.md)の一部として記載されています。すべての仕様は、
サーバーレスの運用モデルにおいてコンテナおよび関数ワークロードをサポートするという
私たちのコミットメントの一部であり、したがって継続的インテグレーションテストによって
強制されています。
## セキュリティ開示に関するポリシー
Firecracker のセキュリティは私たちの最優先事項です。脆弱性を発見したと思われる場合は、
[セキュリティポリシードキュメント](https://github.com/firecracker-microvm/firecracker/blob/main/SECURITY.md)に記載されている方法で非公開でご連絡ください。
私たちはあなたの開示を直ちに優先的に扱います。
## FAQ と連絡先
よくある質問は [FAQ ドキュメント](https://github.com/firecracker-microvm/firecracker/blob/main/FAQ.md)にまとめられています。
Firecracker コミュニティとは以下の方法で連絡を取ることができます:
- セキュリティ関連の問題については、[セキュリティポリシードキュメント](https://github.com/firecracker-microvm/firecracker/blob/main/SECURITY.md)をご覧ください。
- [Slack ワークスペース](https://join.slack.com/t/firecracker-microvm/shared_invite/zt-3v81btcpe-usCf8Qk7k1gUlSAEKKdYMg)で
私たちとチャットできます。
_注: メンテナのほとんどはヨーロッパのタイムゾーンにいます。_
- このリポジトリで GitHub issue を作成してください。
- メンテナに
[[email protected]](mailto:[email protected]) までメールしてください。
Firecracker コミュニティ内でコミュニケーションを取る際は、
[行動規範](https://github.com/firecracker-microvm/firecracker/blob/main/CODE_OF_CONDUCT.md)にご留意ください。