microsoft/azurelinuxDistribución Linux reforzada, optimizada para Azure, construida a partir de fuentes de Fedora con empaquetado RPM, seguridad en la cadena de suministro y configuración declarativa para cargas de trabajo nativas de la nube.
<h1>
<img src="https://assets.kitploit.com/production/public/readmes/11216/92b4b68d723b4cc70e55b00121168d032dbd153dfa2fd8bf4344abfc2fdf27dc.png" alt="Logotipo de Azure Linux" align="left" height="44" /> Azure Linux 4
</h1>
**Una distribución de Linux de código abierto creada y optimizada para [Azure](https://azure.microsoft.com/), con fuentes derivadas de [Fedora Linux](https://fedoraproject.org/).** Azure Linux proporciona un sistema operativo seguro y confiable para máquinas virtuales, contenedores y plataformas de hardware físico.
Azure Linux se basa en una sólida base de código abierto del ecosistema Fedora y se mejora con innovaciones específicas de Azure. Esto proporciona la familiaridad del ecosistema de paquetes RPM, a la vez que añade capacidades de seguridad, cumplimiento y operativas nativas de Azure.
Las características clave de Azure Linux incluyen: una postura de seguridad reforzada, un kernel optimizado para Azure, seguridad de la cadena de suministro, integración nativa con Azure y un ciclo de vida predecible.
> **Esta rama contiene las fuentes en desarrollo de Azure Linux 4.** Para Azure Linux 3, consulte la [rama `3.0`](https://github.com/microsoft/azurelinux/tree/3.0).
## Primeros pasos
Los siguientes enlaces le ayudarán a comenzar con Azure Linux:
| | |
|---|---|
| **Documentación del producto** | <https://aka.ms/azurelinux> |
| **Información de la versión** | [GitHub Releases](https://github.com/microsoft/azurelinux/releases) |
| **Reportar un error / enviar comentarios** | [GitHub Issues](https://github.com/microsoft/azurelinux/issues) |
| **Hacer una pregunta / obtener ayuda** | [SUPPORT.md](https://github.com/microsoft/azurelinux/blob/4.0/SUPPORT.md) |
| **Comenzar como desarrollador de la distro** | [DEVELOPING.md](https://github.com/microsoft/azurelinux/blob/4.0/DEVELOPING.md) |
| **Directrices de contribución** | [CONTRIBUTING.md](https://github.com/microsoft/azurelinux/blob/4.0/CONTRIBUTING.md) |
| **Reportar un problema de seguridad** | [SECURITY.md](https://github.com/microsoft/azurelinux/blob/4.0/SECURITY.md) |
## Uso de Azure Linux
*Nota: Azure Linux 4 aún está en desarrollo*
<details open>
<summary><b>🖥️ Máquina virtual de Azure</b></summary>
Para probar Azure Linux en una máquina virtual de Azure, visite [nuestra página de Azure Linux 4.0](https://aka.ms/azure-linux-4-marketplace) en Microsoft Marketplace.
</details>
<details open>
<summary><b>📦 Contenedor</b></summary>
Para probar el contenedor base de Azure Linux, utilice la siguiente referencia de imagen: `mcr.microsoft.com/azurelinux-beta/base/core:4.0`
</details>
<details>
<summary><b>💿 Instalador ISO</b></summary>
Para probar Azure Linux en una máquina virtual local, descargue el 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 una ISO descargada, [verifique la suma de comprobación y la firma de la ISO](https://github.com/microsoft/azurelinux/blob/4.0/docs/verify-iso-signature-and-checksum.md).
Después de descargar y verificar la ISO, siga las [instrucciones del instalador ISO](https://github.com/microsoft/azurelinux/blob/4.0/docs/iso-installer-in-local-vm.md) para instalar y usar Azure Linux en una máquina virtual local (Hyper-V en Windows o QEMU/KVM en Linux). La ISO ejecuta el instalador [Anaconda](https://anaconda-installer.readthedocs.io/).
_Nota: El soporte para la ISO está basado en la comunidad. Antes de reportar un nuevo error o solicitud de función, busque en la lista de GitHub Issues. Si no encuentra un issue coincidente, reporte nuevos errores haciendo clic [aquí](https://github.com/microsoft/azurelinux/issues). Para información adicional, consulte el archivo [SUPPORT.md](https://github.com/microsoft/azurelinux/blob/4.0/SUPPORT.md)._
</details>
<details>
<summary><b>🐧 Subsistema de Windows para Linux (WSL)</b></summary>
Para probar Azure Linux en el Subsistema de Windows para Linux, descargue el paquete de distribución `.wsl` para su arquitectura:
- [x86_64](https://aka.ms/azurelinux-4.0-x86_64.wsl)
- [ARM64](https://aka.ms/azurelinux-4.0-aarch64.wsl)
Antes de instalar un paquete descargado, [verifique la suma de comprobación y la firma del paquete `.wsl`](https://github.com/microsoft/azurelinux/blob/4.0/docs/verify-wsl-signature-and-checksum.md).
Instale la distribución usando `wsl`:
```powershell
wsl --install --from-file "C:\Path\To\AzureLinux-4.0-ARCH.wsl"
```
Para listar todas las distribuciones instaladas:
```powershell
wsl --list
```
Para usar la distro:
```powershell
wsl -d AzureLinux-4
```
Consulta [Systemd defaults in WSL images](https://github.com/microsoft/azurelinux/blob/4.0/docs/wsl-systemd-policy.md) para conocer las políticas de red, consola y archivos temporales.
</details>
## ¿Qué hay en esta rama?
Azure Linux 4 es una distribución basada en RPM optimizada para Azure y cargas de trabajo modernas en la nube. Se define mediante un conjunto de archivos de configuración TOML y *overlays* específicos aplicados a [Fedora Linux](https://fedoraproject.org/), su base upstream.
Las desviaciones respecto a upstream se definen de forma declarativa y se delimitan para evitar divergencias o bifurcaciones innecesarias. Este repositorio contiene un conjunto generado mecánicamente de archivos spec de paquetes RPM derivados de aplicar esta capa a las fuentes de empaquetado upstream de Fedora.
## Cómo se define Azure Linux
La distribución se describe casi por completo en archivos de configuración basados en TOML. Nuestra herramienta de desarrollo de código abierto, [`azldev`](https://github.com/microsoft/azure-linux-dev-tools), se utiliza para aplicar esta configuración a los archivos spec de Fedora upstream y a las fuentes de empaquetado.
```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
```
### Conceptos/términos
- **Componentes** (también conocidos como paquetes fuente) son la unidad de empaquetado.
La mayoría se importan en forma de código fuente desde los repositorios dist-git upstream de Fedora; cada componente produce uno o más RPM. Azure Linux compila todos los componentes desde el código fuente para producir un conjunto completo de paquetes RPM instalables.
- **Overlays** son modificaciones declarativas a los specs y fuentes upstream
(por ejemplo, parches, adiciones/eliminaciones, parámetros de compilación). Se ubican junto a la definición del componente y siempre incluyen una `description` que explica *por qué* se necesita el cambio. Los overlays nos permiten evitar bifurcar los specs upstream y son más flexibles que los parches textuales simples.
- **Specs renderizados** son los archivos `.spec` finales producidos al aplicar los overlays a las fuentes upstream. Son generados mecánicamente por `azldev`, se registran para visibilidad y auditabilidad, y se ubican en [`specs/`](https://github.com/microsoft/azurelinux/blob/4.0/specs). Trátalos como salida derivada y no como fuentes para editar. Los usamos como entrada para los servicios/herramientas estándar de compilación de RPM (`mock` + `rpmbuild`, `koji`).
Para un recorrido más profundo por las herramientas, el sistema de overlays y cómo empezar a desarrollar dentro de esta distro, consulta
[DEVELOPING.md](https://github.com/microsoft/azurelinux/blob/4.0/DEVELOPING.md).
## Estructura del repositorio
| Ruta | Qué hay allí |
|---|---|
| [`azldev.toml`](https://github.com/microsoft/azurelinux/blob/4.0/azldev.toml) | Configuración de nivel superior — incluye `distro/` y `base/`. |
| [`distro/`](https://github.com/microsoft/azurelinux/blob/4.0/distro) | Definiciones de distro (Azure Linux + Fedora upstream), configuraciones compartidas de `mock`. |
| [`base/`](https://github.com/microsoft/azurelinux/blob/4.0/base) | El proyecto `base`: componentes, imágenes, pruebas. |
| [`base/comps/`](https://github.com/microsoft/azurelinux/blob/4.0/base/comps) | **Definiciones de componentes** — el corazón de la distro. |
| [`base/images/`](https://github.com/microsoft/azurelinux/blob/4.0/base/images) | Definiciones de imágenes (VM, contenedor, etc.) construidas a partir del conjunto de componentes usando [`KIWI NG`](https://osinside.github.io/kiwi/). |
| [`specs/`](https://github.com/microsoft/azurelinux/blob/4.0/specs) | **Specs renderizados** — archivos `.spec` generados tras aplicar los overlays. Registrados para visibilidad; no editar a mano. |
| [`locks/`](https://github.com/microsoft/azurelinux/blob/4.0/locks) | Archivos de bloqueo por componente que fijan commits upstream + huellas de entrada; no editar a mano. |
| [`external/schemas/`](https://github.com/microsoft/azurelinux/blob/4.0/external/schemas) | Copia en caché del JSON Schema para archivos de configuración TOML; replicada desde `azldev`. |
| [`.github/`](https://github.com/microsoft/azurelinux/blob/4.0/.github) | Flujos de trabajo de CI, además de prompts de Copilot, skills e instrucciones de agentes usados por el desarrollo asistido por IA. |
## Primeros pasos como desarrollador de la distro
Si quieres compilar o desarrollar dentro de la distro, comienza con **[DEVELOPING.md](https://github.com/microsoft/azurelinux/blob/4.0/DEVELOPING.md)**. No te preocupes por esto si tu objetivo principal es *usar* la distro.
## Participación y soporte
- **Errores y solicitudes de funciones:** abre un
[issue de GitHub](https://github.com/microsoft/azurelinux/issues). Por favor, busca primero en los issues existentes para evitar duplicados. Comparte con nosotros todo lo que puedas sobre lo que intentaste y lo que estás viendo.
- **Soporte:** consulta [SUPPORT.md](https://github.com/microsoft/azurelinux/blob/4.0/SUPPORT.md) para el conjunto completo de canales.
- **Vulnerabilidades de seguridad:** **no** abras un issue público. Sigue el proceso en [SECURITY.md](https://github.com/microsoft/azurelinux/blob/4.0/SECURITY.md) para reportar de forma privada al Microsoft Security Response Center.
- **Pull requests:** consulta [CONTRIBUTING.md](https://github.com/microsoft/azurelinux/blob/4.0/CONTRIBUTING.md) para el flujo de trabajo de series de parches, las convenciones de mensajes de commit y las expectativas de revisión.
- **Llamadas comunitarias:** Azure Linux organiza llamadas comunitarias donde los usuarios pueden conectar con nuestros equipos de producto y soporte, discutir nuevas funciones, compartir comentarios y aprender cómo otros usan Azure Linux.
Cada sesión también incluye una demostración destacada. Próximas llamadas comunitarias (08:00–09:00 PT):
- 2026-07-23 — [Haz clic para unirte][community-call-join]
- 2026-09-24 — [Haz clic para unirte][community-call-join]
- 2026-11-19 — [Haz clic para unirte][community-call-join]
- 2027-01-28 — [Haz clic para unirte][community-call-join]
- 2027-03-25 — [Haz clic para unirte][community-call-join]
- 2027-05-27 — [Haz clic para unirte][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 proyecto ha adoptado el [Código de Conducta de Código Abierto de Microsoft](https://opensource.microsoft.com/codeofconduct/). Para obtener más información, consulte las [Preguntas frecuentes sobre el Código de Conducta](https://opensource.microsoft.com/codeofconduct/faq/) o contacte con [[email protected]](mailto:[email protected]) si tiene alguna pregunta
o comentario adicional.
## Marcas registradas
Este proyecto puede contener marcas registradas o logotipos de proyectos, productos o servicios. El uso autorizado de las marcas registradas o logotipos de Microsoft está sujeto a las [Directrices de marca y marcas registradas de Microsoft](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general) y debe cumplirlas. El uso de marcas registradas o logotipos de Microsoft en versiones modificadas de este proyecto no debe causar confusión ni implicar el patrocinio de Microsoft. Cualquier uso de marcas registradas o logotipos de terceros está sujeto a las políticas de dichos terceros.
## Agradecimientos
Cualquier distribución de Linux, incluida Azure Linux, se beneficia de las contribuciones de la comunidad de software de código abierto. Agradecemos enormemente todas las contribuciones realizadas por la comunidad en general.
Queremos agradecer especialmente a [el Proyecto Fedora](https://start.fedoraproject.org/) por proporcionarnos una base sólida en componentes, archivos spec, herramientas, servicios y comunidad. Estamos orgullosos de participar y contribuir a esta comunidad.
El icono del pingüino de Azure Linux está inspirado en la mascota de Linux ("Tux"), creada por Larry Ewing.
## Licencia
Salvo que se especifique lo contrario, el contenido de la distribución Azure Linux y de este repositorio se distribuyen bajo una [licencia MIT](https://github.com/microsoft/azurelinux/blob/4.0/LICENSE).
Los paquetes individuales dentro de la distribución se distribuyen bajo las licencias especificadas en sus archivos spec y fuentes.
Este repositorio contiene archivos derivados de Fedora Linux. Para obtener detalles sobre los términos de licencia del Proyecto Fedora, consulte [fedoraproject.org](https://docs.fedoraproject.org/en-US/legal/fedora-linux-license/).