MicroVMs seguros e rápidos para computação serverless.
<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>
Nossa missão é possibilitar a execução segura, multi-inquilino e com sobrecarga mínima de cargas de trabalho de contêineres e funções.
Leia mais sobre a Carta do Firecracker [aqui](https://github.com/firecracker-microvm/firecracker/blob/main/CHARTER.md).
## O que é o Firecracker?
Firecracker é uma tecnologia de virtualização de código aberto criada especificamente
para criar e gerenciar serviços seguros, multi-inquilino, baseados em contêineres e funções
que oferecem modelos operacionais serverless. O Firecracker executa cargas de trabalho
em máquinas virtuais leves, chamadas microVMs, que combinam as propriedades de segurança e
isolamento fornecidas pela tecnologia de virtualização de hardware com a
velocidade e a flexibilidade dos contêineres.
## Visão geral
O principal componente do Firecracker é um monitor de máquina virtual (VMM) que usa
o Linux Kernel Virtual Machine (KVM) para criar e executar microVMs. O Firecracker
também pode executar um convidado como um [Nitro Sandbox](https://github.com/firecracker-microvm/firecracker/blob/main/docs/nitro-sandboxes/README.md),
isolado pelo AWS Nitro System em vez do KVM. O Firecracker tem um design minimalista.
Ele exclui dispositivos desnecessários e funcionalidades voltadas ao convidado para reduzir
o consumo de memória e a superfície de ataque de cada microVM. Isso melhora
a segurança, diminui o tempo de inicialização e aumenta a utilização de hardware.
O Firecracker também foi integrado a runtimes de contêineres, por exemplo
[Kata Containers](https://github.com/kata-containers/kata-containers) e
[Flintlock](https://github.com/liquidmetal-dev/flintlock).
O Firecracker foi desenvolvido na Amazon Web Services para acelerar a velocidade e
a eficiência de serviços como [AWS Lambda](https://aws.amazon.com/lambda/) e
[AWS Fargate](https://aws.amazon.com/fargate/). O Firecracker é de código aberto
sob a [licença Apache versão 2.0](https://github.com/firecracker-microvm/firecracker/blob/main/LICENSE).
Para ler mais sobre o Firecracker, confira
[firecracker-microvm.io](https://firecracker-microvm.github.io).
## Primeiros passos
Para começar a usar o Firecracker, baixe os binários da versão
[mais recente](https://github.com/firecracker-microvm/firecracker/releases)
ou compile-o a partir do código-fonte.
Você pode compilar o Firecracker em qualquer sistema Unix/Linux que tenha o Docker em execução (nós
usamos um contêiner de desenvolvimento) e o `bash` instalado, da seguinte forma:
```bash
git clone https://github.com/firecracker-microvm/firecracker
cd firecracker
tools/devtool build
toolchain="$(uname -m)-unknown-linux-musl"
```
O binário do Firecracker será colocado em
`build/cargo_target/${toolchain}/debug/firecracker`. Para mais informações sobre
como compilar, testar e executar o Firecracker, consulte o
[guia de início rápido](https://github.com/firecracker-microvm/firecracker/blob/main/docs/getting-started.md).
A segurança geral das microVMs do Firecracker, incluindo a capacidade de atender
aos critérios para computação multi-inquilino segura, depende de um sistema
operacional host Linux bem configurado. Uma configuração que acreditamos atender
a esse requisito está incluída no
[documento de configuração do host de produção](https://github.com/firecracker-microvm/firecracker/blob/main/docs/prod-host-setup.md).
## Contribuindo
O Firecracker já está executando cargas de trabalho de produção na AWS, mas ainda
está no Dia 1 da jornada guiada pela nossa [missão](https://github.com/firecracker-microvm/firecracker/blob/main/CHARTER.md). Há muito mais a
construir e damos as boas-vindas a todas as contribuições.
Para contribuir com o Firecracker, consulte a seção de configuração de
desenvolvimento no [guia de início](https://github.com/firecracker-microvm/firecracker/blob/main/docs/getting-started.md) e, em seguida, as
[diretrizes de contribuição](https://github.com/firecracker-microvm/firecracker/blob/main/CONTRIBUTING.md) do Firecracker.
## Versões
Novas versões do Firecracker são lançadas por meio da página de
[releases](https://github.com/firecracker-microvm/firecracker/releases) do
repositório no GitHub, normalmente a cada dois ou três meses. Um histórico de
alterações é registrado em nosso [changelog](https://github.com/firecracker-microvm/firecracker/blob/main/CHANGELOG.md).
A política de lançamento do Firecracker está detalhada [aqui](https://github.com/firecracker-microvm/firecracker/blob/main/docs/RELEASE_POLICY.md).
## Design
A arquitetura geral do Firecracker está descrita no
[documento de design](https://github.com/firecracker-microvm/firecracker/blob/main/docs/design.md).
## Recursos e capacidades
O Firecracker consiste em um único processo de micro Virtual Machine Manager que
expõe um endpoint de API ao host após ser iniciado. A API é
[especificada no formato OpenAPI](https://github.com/firecracker-microvm/firecracker/blob/main/src/firecracker/swagger/firecracker.yaml). Leia
mais sobre ela na [documentação da API](https://github.com/firecracker-microvm/firecracker/blob/main/docs/api_requests).
O **endpoint da API** pode ser usado para:
- Configurar a microVM por meio de:
- Definição do número de vCPUs (o padrão é 1).
- Definição do tamanho da memória (o padrão é 128 MiB).
- Configuração de um [template de CPU](https://github.com/firecracker-microvm/firecracker/blob/main/docs/cpu_templates/cpu-templates.md).
- Adicionar uma ou mais interfaces de rede à microVM.
- Adicionar um ou mais discos de leitura-escrita ou somente leitura à microVM,
cada um representado por um dispositivo de bloco com suporte em arquivo.
- Acionar uma nova varredura do dispositivo de bloco enquanto o guest está em
execução. Isso permite que o sistema operacional do guest detecte alterações
de tamanho no arquivo de suporte do dispositivo de bloco.
- Alterar o arquivo de suporte de um dispositivo de bloco, antes ou depois da
inicialização do guest.
- Configurar limitadores de taxa para dispositivos virtio, que podem limitar a
largura de banda, as operações por segundo, ou ambos.
- Configurar o sistema de logging e de métricas.
- `[BETA]` Configurar a árvore de dados do serviço de metadados voltado ao
guest. O serviço só fica disponível ao guest se este recurso estiver
configurado.
- Adicionar um [socket vsock](https://github.com/firecracker-microvm/firecracker/blob/main/docs/vsock.md) à microVM.
- Adicionar um [dispositivo de entropia](https://github.com/firecracker-microvm/firecracker/blob/main/docs/entropy.md) à microVM.
- Adicionar um [dispositivo pmem](https://github.com/firecracker-microvm/firecracker/blob/main/docs/pmem.md) à microVM.
- Configurar e gerenciar [hotplug de memória](https://github.com/firecracker-microvm/firecracker/blob/main/docs/memory-hotplug.md).
- `[Developer Preview]` [Hot-plug e hot-unplug](https://github.com/firecracker-microvm/firecracker/blob/main/docs/device-hotplug.md) de
dispositivos virtio PCI enquanto a VM está em execução.
- Executar o guest como um [Nitro Sandbox](https://github.com/firecracker-microvm/firecracker/blob/main/docs/nitro-sandboxes/README.md) em
uma instância EC2, isolado pelo AWS Nitro System em vez do KVM, com atestação
opcional.
- Iniciar a microVM usando uma determinada imagem de kernel, sistema de arquivos
raiz e argumentos de inicialização.
- [somente x86_64] Parar a microVM.
**Capacidades integradas**:
- Paginação por falta sob demanda e oversubscription de CPU habilitados por
padrão.
- Filtros seccomp avançados e específicos por thread para maior segurança.
- Processo [Jailer](https://github.com/firecracker-microvm/firecracker/blob/main/docs/jailer.md) para iniciar o Firecracker em cenários de
produção; aplica uma barreira de isolamento de cgroup/namespace e, em seguida,
descarta privilégios.
## Plataformas testadas
Testamos todas as combinações de:
| Instância | SO do host e kernel | Rootfs do convidado | Kernel do convidado |
| :------------------------------------------ | :---------------- | :----------- | :----------- |
| 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) | | | |
**\***: Suportamos **apenas** instâncias AWS EC2 Intel de 8ª geração (\*8i) usando um kernel de host 6.1
ou 6.18. Isso se deve ao suporte limitado do kernel para CPUs Granite Rapids
no 5.10.
## Problemas conhecidos e limitações
- O dispositivo RTC `pl031` em aarch64 não suporta interrupções, portanto programas
convidados que usam um alarme RTC (por exemplo, `hwclock`) não funcionarão.
## Desempenho
As características de desempenho do Firecracker estão listadas como parte da
[documentação de especificação](https://github.com/firecracker-microvm/firecracker/blob/main/SPECIFICATION.md). Todas as especificações fazem parte
do nosso compromisso de oferecer suporte a cargas de trabalho de contêineres e funções em modelos
operacionais serverless e, portanto, são aplicadas por meio de testes de integração contínua.
## Política de Divulgação de Segurança
A segurança do Firecracker é nossa principal prioridade. Se você suspeitar ter
descoberto uma vulnerabilidade, entre em contato conosco de forma privada, conforme descrito em nosso
[documento de política de segurança](https://github.com/firecracker-microvm/firecracker/blob/main/SECURITY.md); priorizaremos imediatamente sua
divulgação.
## Perguntas frequentes e contato
As perguntas frequentes estão reunidas em nosso [documento de FAQ](https://github.com/firecracker-microvm/firecracker/blob/main/FAQ.md).
Você pode entrar em contato com a comunidade do Firecracker das seguintes formas:
- Questões relacionadas à segurança, consulte nosso [documento de política de segurança](https://github.com/firecracker-microvm/firecracker/blob/main/SECURITY.md).
- Converse conosco em nosso
[espaço de trabalho no Slack](https://join.slack.com/t/firecracker-microvm/shared_invite/zt-3v81btcpe-usCf8Qk7k1gUlSAEKKdYMg)
_Observação: a maioria dos mantenedores está em um fuso horário europeu._
- Abra uma issue no GitHub neste repositório.
- Envie um e-mail aos mantenedores para
[[email protected]](mailto:[email protected]).
Ao se comunicar dentro da comunidade Firecracker, por favor, respeite nosso
[código de conduta](https://github.com/firecracker-microvm/firecracker/blob/main/CODE_OF_CONDUCT.md).