सर्वरलेस कंप्यूटिंग के लिए सुरक्षित और तेज़ माइक्रो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 Logo Title" 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 वर्कलोड को हल्के वर्चुअल मशीनों में चलाता है, जिन्हें microVM कहा जाता है, जो हार्डवेयर वर्चुअलाइज़ेशन तकनीक द्वारा प्रदान की जाने वाली सुरक्षा और आइसोलेशन विशेषताओं को कंटेनर की गति और लचीलेपन के साथ जोड़ते हैं।
## अवलोकन
Firecracker का मुख्य घटक एक वर्चुअल मशीन मॉनिटर (VMM) है जो microVM बनाने और चलाने के लिए Linux Kernel Virtual Machine (KVM) का उपयोग करता है। Firecracker एक गेस्ट को [Nitro Sandbox](https://github.com/firecracker-microvm/firecracker/blob/main/docs/nitro-sandboxes/README.md) के रूप में भी चला सकता है, जिसे KVM के बजाय AWS Nitro System द्वारा आइसोलेट किया जाता है। Firecracker का डिज़ाइन मिनिमलिस्ट है। यह प्रत्येक microVM की मेमोरी फ़ुटप्रिंट और अटैक सरफेस क्षेत्र को कम करने के लिए अनावश्यक डिवाइस और गेस्ट-फेसिंग कार्यक्षमता को बाहर रखता है। यह सुरक्षा में सुधार करता है, स्टार्टअप समय को कम करता है, और हार्डवेयर उपयोग को बढ़ाता है। Firecracker को कंटेनर रनटाइम में भी एकीकृत किया गया है, उदाहरण के लिए [Kata Containers](https://github.com/kata-containers/kata-containers) और [Flintlock](https://github.com/liquidmetal-dev/flintlock)।
Firecracker को Amazon Web Services में [AWS Lambda](https://aws.amazon.com/lambda/) और [AWS Fargate](https://aws.amazon.com/fargate/) जैसी सेवाओं की गति और दक्षता को तेज़ करने के लिए विकसित किया गया था। 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 को किसी भी Unix/Linux सिस्टम पर बिल्ड कर सकते हैं जिसमें Docker चल रहा हो (हम एक डेवलपमेंट कंटेनर का उपयोग करते हैं) और `bash` इंस्टॉल हो, निम्नानुसार:
```bash
git clone https://github.com/firecracker-microvm/firecracker
cd firecracker
tools/devtool build
toolchain="$(uname -m)-unknown-linux-musl"
```
The Firecracker binary will be placed at
`build/cargo_target/${toolchain}/debug/firecracker`. For more information on
building, testing, and running Firecracker, go to the
[quickstart guide](https://github.com/firecracker-microvm/firecracker/blob/main/docs/getting-started.md).
The overall security of Firecracker microVMs, including the ability to meet the
criteria for safe multi-tenant computing, depends on a well configured Linux
host operating system. A configuration that we believe meets this bar is
included in [the production host setup document](https://github.com/firecracker-microvm/firecracker/blob/main/docs/prod-host-setup.md).
## Contributing
Firecracker is already running production workloads within AWS, but it's still
Day 1 on the journey guided by our [mission](https://github.com/firecracker-microvm/firecracker/blob/main/CHARTER.md). There's a lot more to
build and we welcome all contributions.
To contribute to Firecracker, check out the development setup section in the
[getting started guide](https://github.com/firecracker-microvm/firecracker/blob/main/docs/getting-started.md) and then the Firecracker
[contribution guidelines](https://github.com/firecracker-microvm/firecracker/blob/main/CONTRIBUTING.md).
## Releases
New Firecracker versions are released via the GitHub repository
[releases](https://github.com/firecracker-microvm/firecracker/releases) page,
typically every two or three months. A history of changes is recorded in our
[changelog](https://github.com/firecracker-microvm/firecracker/blob/main/CHANGELOG.md).
The Firecracker release policy is detailed [here](https://github.com/firecracker-microvm/firecracker/blob/main/docs/RELEASE_POLICY.md).
## Design
Firecracker's overall architecture is described in
[the design document](https://github.com/firecracker-microvm/firecracker/blob/main/docs/design.md).
## Features & Capabilities
Firecracker consists of a single micro Virtual Machine Manager process that
exposes an API endpoint to the host once started. The API is
[specified in OpenAPI format](https://github.com/firecracker-microvm/firecracker/blob/main/src/firecracker/swagger/firecracker.yaml). Read
more about it in the [API docs](https://github.com/firecracker-microvm/firecracker/blob/main/docs/api_requests).
The **API endpoint** can be used to:
- Configure the microvm by:
- Setting the number of vCPUs (the default is 1).
- Setting the memory size (the default is 128 MiB).
- Configuring a [CPU template](https://github.com/firecracker-microvm/firecracker/blob/main/docs/cpu_templates/cpu-templates.md).
- Add one or more network interfaces to the microVM.
- Add one or more read-write or read-only disks to the microVM, each represented
by a file-backed block device.
- Trigger a block device re-scan while the guest is running. This enables the
guest OS to pick up size changes to the block device's backing file.
- Change the backing file for a block device, before or after the guest boots.
- Configure rate limiters for virtio devices which can limit the bandwidth,
operations per second, or both.
- Configure the logging and metric system.
- `[BETA]` Configure the data tree of the guest-facing metadata service. The
service is only available to the guest if this resource is configured.
- Add a [vsock socket](https://github.com/firecracker-microvm/firecracker/blob/main/docs/vsock.md) to the microVM.
- Add a [entropy device](https://github.com/firecracker-microvm/firecracker/blob/main/docs/entropy.md) to the microVM.
- Add a [pmem device](https://github.com/firecracker-microvm/firecracker/blob/main/docs/pmem.md) to the microVM.
- Configure and manage [memory hotplugging](https://github.com/firecracker-microvm/firecracker/blob/main/docs/memory-hotplug.md).
- `[Developer Preview]` [Hot-plug and hot-unplug](https://github.com/firecracker-microvm/firecracker/blob/main/docs/device-hotplug.md) virtio
PCI devices while the VM is running.
- Run the guest as a [Nitro Sandbox](https://github.com/firecracker-microvm/firecracker/blob/main/docs/nitro-sandboxes/README.md) on an EC2
instance, isolated by the AWS Nitro System rather than by KVM, with optional
attestation.
- Start the microVM using a given kernel image, root file system, and boot
arguments.
- [x86_64 only] Stop the microVM.
**Built-in Capabilities**:
- Demand fault paging and CPU oversubscription enabled by default.
- Advanced, thread-specific seccomp filters for enhanced security.
- [Jailer](https://github.com/firecracker-microvm/firecracker/blob/main/docs/jailer.md) process for starting Firecracker in production
scenarios; applies a cgroup/namespace isolation barrier and then drops
privileges.
## Tested platforms
We test all combinations of:
| इंस्टेंस | होस्ट OS और कर्नेल | गेस्ट रूटफ़्स | गेस्ट कर्नेल |
| :------------------------------------------ | :---------------- | :----------- | :----------- |
| 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 CPUs के लिए खराब कर्नेल समर्थन के कारण है।
## ज्ञात समस्याएँ और सीमाएँ
- 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 दस्तावेज़](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) का ध्यान रखें।