microsoft/azurelinuxDistribuição Linux endurecida e otimizada para Azure, construída a partir das fontes do Fedora com empacotamento RPM, segurança da cadeia de suprimentos e configuração declarativa para cargas de trabalho nativas em nuvem.
<h1>
<img src="https://assets.kitploit.com/production/public/readmes/11216/92b4b68d723b4cc70e55b00121168d032dbd153dfa2fd8bf4344abfc2fdf27dc.png" alt="Logotipo do Azure Linux" align="left" height="44" /> Azure Linux 4
</h1>
**Uma distribuição Linux de código aberto criada e otimizada para o [Azure](https://azure.microsoft.com/), com fontes derivadas do [Fedora Linux](https://fedoraproject.org/).** O Azure Linux fornece um sistema operacional seguro e confiável para máquinas virtuais, contêineres e plataformas bare-metal.
O Azure Linux é construído sobre uma base sólida de código aberto do ecossistema Fedora e aprimorado com inovações específicas do Azure. Isso proporciona a familiaridade do ecossistema de pacotes RPM, ao mesmo tempo que adiciona recursos de segurança, conformidade e operacionais nativos do Azure.
Os principais recursos do Azure Linux incluem: postura de segurança reforçada, um kernel otimizado para o Azure, segurança da cadeia de suprimentos, integração nativa com o Azure e um ciclo de vida previsível.
> **Este branch contém as fontes em desenvolvimento do Azure Linux 4.** Para o Azure Linux 3, consulte o [branch `3.0`](https://github.com/microsoft/azurelinux/tree/3.0).
## Primeiros passos
Os links abaixo ajudarão você a começar a usar o Azure Linux:
| | |
|---|---|
| **Documentação do produto** | <https://aka.ms/azurelinux> |
| **Informações de versão** | [GitHub Releases](https://github.com/microsoft/azurelinux/releases) |
| **Registrar um bug / enviar feedback** | [GitHub Issues](https://github.com/microsoft/azurelinux/issues) |
| **Fazer uma pergunta / obter ajuda** | [SUPPORT.md](https://github.com/microsoft/azurelinux/blob/4.0/SUPPORT.md) |
| **Começar como desenvolvedor de distro** | [DEVELOPING.md](https://github.com/microsoft/azurelinux/blob/4.0/DEVELOPING.md) |
| **Diretrizes de contribuição** | [CONTRIBUTING.md](https://github.com/microsoft/azurelinux/blob/4.0/CONTRIBUTING.md) |
| **Relatar um problema de segurança** | [SECURITY.md](https://github.com/microsoft/azurelinux/blob/4.0/SECURITY.md) |
## Usando o Azure Linux
*Nota: O Azure Linux 4 ainda está em desenvolvimento*
<details open>
<summary><b>🖥️ VM do Azure</b></summary>
Para experimentar o Azure Linux em uma VM do Azure, visite [nossa página do Azure Linux 4.0](https://aka.ms/azure-linux-4-marketplace) no Microsoft Marketplace.
</details>
<details open>
<summary><b>📦 Contêiner</b></summary>
Para experimentar o contêiner base do Azure Linux, use a seguinte referência de imagem: `mcr.microsoft.com/azurelinux-beta/base/core:4.0`
</details>
<details>
<summary><b>💿 Instalador ISO</b></summary>
Para experimentar o Azure Linux em uma VM local, baixe o Instalador ISO: [x86_64](https://aka.ms/azurelinux-4.0-x86_64.iso) / [ARM64](https://aka.ms/azurelinux-4.0-aarch64.iso)
Antes de usar uma ISO baixada, [verifique o checksum e a assinatura da ISO](https://github.com/microsoft/azurelinux/blob/4.0/docs/verify-iso-signature-and-checksum.md).
Após baixar e verificar a ISO, siga as [instruções do instalador ISO](https://github.com/microsoft/azurelinux/blob/4.0/docs/iso-installer-in-local-vm.md) para instalar e usar o Azure Linux em uma VM local (Hyper-V no Windows ou QEMU/KVM no Linux). A ISO executa o instalador [Anaconda](https://anaconda-installer.readthedocs.io/).
_Nota: O suporte para a ISO é baseado na comunidade. Antes de registrar um novo bug ou solicitação de recurso, pesquise na lista de GitHub Issues. Se você não conseguir encontrar um problema correspondente, registre novos bugs clicando [aqui](https://github.com/microsoft/azurelinux/issues). Para informações adicionais, consulte o arquivo [SUPPORT.md](https://github.com/microsoft/azurelinux/blob/4.0/SUPPORT.md)._
</details>
<details>
<summary><b>🐧 Subsistema Windows para Linux (WSL)</b></summary>
Para experimentar o Azure Linux no Subsistema Windows para Linux, baixe o pacote de distribuição `.wsl` para sua arquitetura:
- [x86_64](https://aka.ms/azurelinux-4.0-x86_64.wsl)
- [ARM64](https://aka.ms/azurelinux-4.0-aarch64.wsl)
Antes de instalar um pacote baixado, [verifique o checksum e a assinatura do pacote `.wsl`](https://github.com/microsoft/azurelinux/blob/4.0/docs/verify-wsl-signature-and-checksum.md).
Instale a distribuição usando `wsl`:
```powershell
wsl --install --from-file "C:\Path\To\AzureLinux-4.0-ARCH.wsl"
```
Para listar todas as distribuições instaladas:
```powershell
wsl --list
```
Para usar a distro:
```powershell
wsl -d AzureLinux-4
```
Consulte [Padrões do Systemd em imagens WSL](https://github.com/microsoft/azurelinux/blob/4.0/docs/wsl-systemd-policy.md) para as políticas de rede, console e arquivos temporários.
</details>
## O que há neste branch?
O Azure Linux 4 é uma distribuição baseada em RPM otimizada para o Azure e cargas de trabalho modernas de nuvem. Ela é definida por um conjunto de arquivos de configuração TOML e *overlays* direcionados aplicados ao [Fedora Linux](https://fedoraproject.org/), sua base upstream.
Os desvios em relação ao upstream são definidos de forma declarativa e delimitados para evitar divergências ou forks desnecessários. Este repositório contém um conjunto renderizado mecanicamente de arquivos spec de pacotes RPM derivados da aplicação desta camada às fontes de empacotamento upstream do Fedora.
## Como o Azure Linux é definido
A distribuição é descrita quase inteiramente em arquivos de configuração baseados em TOML. Nossa ferramenta de desenvolvimento de código aberto, [`azldev`](https://github.com/microsoft/azure-linux-dev-tools), é usada para aplicar esta configuração aos arquivos spec do Fedora upstream e às fontes de empacotamento.
```text
azldev.toml # Top-level entry point
├── distro/ # Distro-wide configs (e.g., sources, mock configs)
└── base/ # The "base" project: components, images, tests
└── comps/ # Component definitions (one per source package)
└── images/ # Base image definitions
```
### Conceitos/termos
- **Componentes** (também conhecidos como pacotes de origem) são a unidade de empacotamento.
A maioria é importada em forma de código-fonte a partir dos repositórios dist-git upstream do Fedora; cada componente produz um ou mais RPMs. O Azure Linux compila todos os componentes a partir do código-fonte para produzir um conjunto completo de pacotes RPM instaláveis.
- **Overlays** são modificações declarativas em specs e fontes upstream
(por exemplo, patches, adições/remoções, parâmetros de compilação). Eles ficam ao lado da definição do componente e sempre carregam uma `description` explicando *por que* a mudança é necessária. Os overlays nos permitem evitar o fork de specs upstream e são mais flexíveis do que patches textuais simples.
- **Specs renderizadas** são os arquivos `.spec` finais produzidos pela aplicação de overlays às fontes upstream. Elas são geradas mecanicamente pelo `azldev`, versionadas para visibilidade e auditabilidade, e ficam em [`specs/`](https://github.com/microsoft/azurelinux/blob/4.0/specs). Trate-as como saída derivada e não como fontes para edição. Nós as usamos como entrada para serviços/ferramentas padrão de compilação de RPM (`mock` + `rpmbuild`, `koji`).
Para um tour mais aprofundado das ferramentas, do sistema de overlays e de como começar a desenvolver dentro desta distro, consulte
[DEVELOPING.md](https://github.com/microsoft/azurelinux/blob/4.0/DEVELOPING.md).
## Estrutura do repositório
| Caminho | O que há lá |
|---|---|
| [`azldev.toml`](https://github.com/microsoft/azurelinux/blob/4.0/azldev.toml) | Configuração de nível superior — inclui `distro/` e `base/`. |
| [`distro/`](https://github.com/microsoft/azurelinux/blob/4.0/distro) | Definições de distro (Azure Linux + Fedora upstream), configurações `mock` compartilhadas. |
| [`base/`](https://github.com/microsoft/azurelinux/blob/4.0/base) | O projeto `base`: componentes, imagens, testes. |
| [`base/comps/`](https://github.com/microsoft/azurelinux/blob/4.0/base/comps) | **Definições de componentes** — o coração da distro. |
| [`base/images/`](https://github.com/microsoft/azurelinux/blob/4.0/base/images) | Definições de imagens (VM, contêiner, etc.) construídas a partir do conjunto de componentes usando [`KIWI NG`](https://osinside.github.io/kiwi/). |
| [`specs/`](https://github.com/microsoft/azurelinux/blob/4.0/specs) | **Specs renderizadas** — arquivos `.spec` gerados após a aplicação dos overlays. Versionadas para visibilidade; não edite manualmente. |
| [`locks/`](https://github.com/microsoft/azurelinux/blob/4.0/locks) | Arquivos de lock por componente que fixam commits upstream + impressões digitais de entrada; não edite manualmente. |
| [`external/schemas/`](https://github.com/microsoft/azurelinux/blob/4.0/external/schemas) | Cópia em cache do JSON Schema para arquivos de configuração TOML; espelhada de `azldev`. |
| [`.github/`](https://github.com/microsoft/azurelinux/blob/4.0/.github) | Workflows de CI, além de prompts do Copilot, skills e instruções de agente usadas pelo desenvolvimento assistido por IA. |
## Primeiros passos como desenvolvedor da distro
Se você quer compilar ou desenvolver dentro da distro, comece por **[DEVELOPING.md](https://github.com/microsoft/azurelinux/blob/4.0/DEVELOPING.md)**. Não se preocupe com isso se o seu objetivo principal é *usar* a distro.
## Engajamento e suporte
- **Bugs e solicitações de recursos:** abra uma
[issue no GitHub](https://github.com/microsoft/azurelinux/issues). Pesquise primeiro as issues existentes para evitar duplicatas. Compartilhe conosco o máximo possível sobre o que você tentou e o que está vendo.
- **Suporte:** consulte [SUPPORT.md](https://github.com/microsoft/azurelinux/blob/4.0/SUPPORT.md) para o conjunto completo de canais.
- **Vulnerabilidades de segurança:** **não** abra uma issue pública. Siga o processo em [SECURITY.md](https://github.com/microsoft/azurelinux/blob/4.0/SECURITY.md) para relatar de forma privada ao Microsoft Security Response Center.
- **Pull requests:** consulte [CONTRIBUTING.md](https://github.com/microsoft/azurelinux/blob/4.0/CONTRIBUTING.md) para o fluxo de trabalho de séries de patches, convenções de mensagens de commit e expectativas de revisão.
- **Chamadas da comunidade:** o Azure Linux realiza chamadas da comunidade onde os usuários podem se conectar com nossas equipes de produto e suporte, discutir novos recursos, compartilhar feedback e aprender como outros estão usando o Azure Linux.
Cada sessão também inclui uma demonstração em destaque. Próximas chamadas da comunidade (08:00–09:00 PT):
- 2026-07-23 — [Clique para entrar][community-call-join]
- 2026-09-24 — [Clique para entrar][community-call-join]
- 2026-11-19 — [Clique para entrar][community-call-join]
- 2027-01-28 — [Clique para entrar][community-call-join]
- 2027-03-25 — [Clique para entrar][community-call-join]
- 2027-05-27 — [Clique para entrar][community-call-join]
[community-call-join]: https://teams.microsoft.com/l/meetup-join/19:meeting_ZDcyZjRkYWMtOWQxYS00OTk3LWFhNmMtMTMwY2VhMTA4OTZi@thread.v2/0?context=%7B%22Tid%22:%2272f988bf-86f1-41af-91ab-2d7cd011db47%22,%22Oid%22:%2271a6ce92-58a5-4ea0-96f4-bd4a0401370a%22%7D
Este projeto adotou o [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). Para mais informações, consulte o [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) ou entre em contato com [[email protected]](mailto:[email protected]) para quaisquer dúvidas
ou comentários adicionais.
## Marcas registradas
Este projeto pode conter marcas registradas ou logotipos de projetos, produtos ou serviços. O uso autorizado de marcas registradas ou logotipos da Microsoft está sujeito e deve seguir as [Diretrizes de Marca e Logotipo da Microsoft](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). O uso de marcas registradas ou logotipos da Microsoft em versões modificadas deste projeto não deve causar confusão nem implicar patrocínio da Microsoft. Qualquer uso de marcas registradas ou logotipos de terceiros está sujeito às políticas desses terceiros.
## Agradecimentos
Qualquer distribuição Linux, incluindo o Azure Linux, se beneficia das contribuições da comunidade de software de código aberto. Agradecemos reconhecidamente todas as contribuições feitas pela comunidade em geral.
Agradecemos especificamente ao [Fedora Project](https://start.fedoraproject.org/) por nos fornecer uma base sólida em componentes, arquivos spec, ferramentas, serviços e comunidade. Temos orgulho de participar e contribuir com esta comunidade.
O ícone do pinguim do Azure Linux é inspirado no mascote do Linux ("Tux"), criado por Larry Ewing.
## Licença
Salvo indicação em contrário, o conteúdo da distribuição Azure Linux e deste repositório são distribuídos sob uma [licença MIT](https://github.com/microsoft/azurelinux/blob/4.0/LICENSE).
Os pacotes individuais dentro da distribuição são distribuídos sob licenças especificadas em seus arquivos spec e fontes.
Este repositório contém arquivos derivados do Fedora Linux. Para detalhes sobre os termos de licenciamento do Fedora Project, consulte [fedoraproject.org](https://docs.fedoraproject.org/en-US/legal/fedora-linux-license/).