microsoft/azurelinux강화된, Azure에 최적화된 Linux 배포판으로, Fedora 소스에서 빌드되었으며 RPM 패키징, 공급망 보안, 클라우드 네이티브 워크로드를 위한 선언적 구성을 갖추고 있습니다.
<h1>
<img src="https://assets.kitploit.com/production/public/readmes/11216/92b4b68d723b4cc70e55b00121168d032dbd153dfa2fd8bf4344abfc2fdf27dc.png" alt="Azure Linux 로고" align="left" height="44" /> Azure Linux 4
</h1>
**[Azure](https://azure.microsoft.com/)를 위해 구축되고 최적화된 오픈 소스 Linux 배포판으로, 소스는 [Fedora Linux](https://fedoraproject.org/)에서 파생되었습니다.** Azure Linux는 가상 머신, 컨테이너, 베어메탈 플랫폼을 위한 안전하고 신뢰할 수 있는 운영 체제를 제공합니다.
Azure Linux는 Fedora 생태계의 견고한 오픈 소스 기반 위에 구축되었으며 Azure 전용 혁신 기능으로 강화되었습니다. 이를 통해 RPM 패키지 생태계의 친숙함을 제공하는 동시에 Azure 네이티브 보안, 규정 준수, 운영 기능을 추가합니다.
Azure Linux의 주요 기능은 다음과 같습니다: 강화된 보안 태세, Azure에 최적화된 커널, 공급망 보안, 네이티브 Azure 통합, 예측 가능한 수명 주기.
> **이 브랜치는 Azure Linux 4의 개발 중인 소스를 담고 있습니다.** Azure Linux 3의 경우 [`3.0` 브랜치](https://github.com/microsoft/azurelinux/tree/3.0)를 참조하세요.
## 시작하기
아래 링크는 Azure Linux를 시작하는 데 도움이 됩니다:
| | |
|---|---|
| **제품 문서** | <https://aka.ms/azurelinux> |
| **릴리스 정보** | [GitHub Releases](https://github.com/microsoft/azurelinux/releases) |
| **버그 신고 / 피드백** | [GitHub Issues](https://github.com/microsoft/azurelinux/issues) |
| **질문 / 도움 받기** | [SUPPORT.md](https://github.com/microsoft/azurelinux/blob/4.0/SUPPORT.md) |
| **배포판 개발자로 시작하기** | [DEVELOPING.md](https://github.com/microsoft/azurelinux/blob/4.0/DEVELOPING.md) |
| **기여 가이드라인** | [CONTRIBUTING.md](https://github.com/microsoft/azurelinux/blob/4.0/CONTRIBUTING.md) |
| **보안 문제 신고** | [SECURITY.md](https://github.com/microsoft/azurelinux/blob/4.0/SECURITY.md) |
## Azure Linux 사용하기
*참고: Azure Linux 4는 아직 개발 중입니다*
<details open>
<summary><b>🖥️ Azure VM</b></summary>
Azure VM에서 Azure Linux를 사용해 보려면 Microsoft Marketplace의 [Azure Linux 4.0 페이지](https://aka.ms/azure-linux-4-marketplace)를 방문하세요.
</details>
<details open>
<summary><b>📦 컨테이너</b></summary>
Azure Linux 기본 컨테이너를 사용해 보려면 다음 이미지 참조를 사용하세요: `mcr.microsoft.com/azurelinux-beta/base/core:4.0`
</details>
<details>
<summary><b>💿 ISO 설치 프로그램</b></summary>
로컬 VM에서 Azure Linux를 사용해 보려면 ISO 설치 프로그램을 다운로드하세요: [x86_64](https://aka.ms/azurelinux-4.0-x86_64.iso) / [ARM64](https://aka.ms/azurelinux-4.0-aarch64.iso)
다운로드한 ISO를 사용하기 전에 [ISO의 체크섬과 서명을 확인](https://github.com/microsoft/azurelinux/blob/4.0/docs/verify-iso-signature-and-checksum.md)하세요.
ISO를 다운로드하고 확인한 후, [ISO 설치 프로그램 지침](https://github.com/microsoft/azurelinux/blob/4.0/docs/iso-installer-in-local-vm.md)에 따라 로컬 VM(Windows의 Hyper-V 또는 Linux의 QEMU/KVM)에서 Azure Linux를 설치하고 사용하세요. ISO는 [Anaconda](https://anaconda-installer.readthedocs.io/) 설치 프로그램을 실행합니다.
_참고: ISO 지원은 커뮤니티 기반입니다. 새로운 버그나 기능 요청을 제출하기 전에 GitHub Issues 목록을 검색해 주세요. 일치하는 이슈를 찾을 수 없는 경우 [여기](https://github.com/microsoft/azurelinux/issues)를 클릭하여 새 버그를 신고해 주세요. 추가 정보는 [SUPPORT.md](https://github.com/microsoft/azurelinux/blob/4.0/SUPPORT.md) 파일을 참조하세요._
</details>
<details>
<summary><b>🐧 WSL(Linux용 Windows 하위 시스템)</b></summary>
WSL(Linux용 Windows 하위 시스템)에서 Azure Linux를 사용해 보려면 사용 중인 아키텍처에 맞는 `.wsl` 배포 패키지를 다운로드하세요:
- [x86_64](https://aka.ms/azurelinux-4.0-x86_64.wsl)
- [ARM64](https://aka.ms/azurelinux-4.0-aarch64.wsl)
다운로드한 패키지를 설치하기 전에 [`.wsl` 패키지의 체크섬과 서명을 확인](https://github.com/microsoft/azurelinux/blob/4.0/docs/verify-wsl-signature-and-checksum.md)하세요.
`wsl`을 사용하여 배포판을 설치하세요:
```powershell
wsl --install --from-file "C:\Path\To\AzureLinux-4.0-ARCH.wsl"
```
설치된 모든 배포판을 나열하려면:
```powershell
wsl --list
```
배포판을 사용하려면:
```powershell
wsl -d AzureLinux-4
```
네트워킹, 콘솔 및 임시 파일 정책은 [WSL 이미지의 Systemd 기본값](https://github.com/microsoft/azurelinux/blob/4.0/docs/wsl-systemd-policy.md)을 참조하세요.
</details>
## 이 브랜치에는 무엇이 있나요?
Azure Linux 4는 Azure 및 최신 클라우드 워크로드에 최적화된 RPM 기반 배포판입니다. 이는 일련의 TOML 구성 파일과 업스트림 기반인 [Fedora Linux](https://fedoraproject.org/)에 적용되는 특정 *오버레이*로 정의됩니다.
업스트림과의 차이는 불필요한 분기나 포크를 피하기 위해 선언적으로 정의되고 범위가 한정됩니다. 이 저장소에는 이 계층을 Fedora의 업스트림 패키징 소스에 적용하여 기계적으로 렌더링된 RPM 패키지 spec 파일 세트가 포함되어 있습니다.
## Azure Linux가 정의되는 방식
이 배포판은 거의 전적으로 TOML 기반 구성 파일로 설명됩니다. 오픈소스 개발 도구인 [`azldev`](https://github.com/microsoft/azure-linux-dev-tools)를 사용하여 이 구성을 업스트림 Fedora spec 파일 및 패키징 소스에 적용합니다.
```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
```
### 개념/용어
- **컴포넌트**(소스 패키지라고도 함)는 패키징의 단위입니다.
대부분은 Fedora의 업스트림 dist-git 저장소에서 소스 형태로 가져오며, 각 컴포넌트는 하나 이상의 RPM을 생성합니다. Azure Linux는 모든 컴포넌트를 소스에서 빌드하여 설치 가능한 전체 RPM 패키지 세트를 생성합니다.
- **오버레이**는 업스트림 스펙과 소스에 대한 선언적 수정입니다
(예: 패치, 추가/제거, 빌드 매개변수). 오버레이는 컴포넌트 정의와 함께 위치하며, 변경이 *왜* 필요한지 설명하는 `description`을 항상 포함합니다. 오버레이를 통해 업스트림 스펙을 포크하지 않아도 되며, 단순한 텍스트 패치보다 유연합니다.
- **렌더링된 스펙**은 오버레이를 업스트림 소스에 적용하여 생성된 최종 `.spec` 파일입니다. 이는 `azldev`에 의해 기계적으로 생성되고, 가시성과 감사 가능성을 위해 체크인되며, [`specs/`](https://github.com/microsoft/azurelinux/blob/4.0/specs) 아래에 위치합니다. 이는 파생된 출력물로 취급하며 편집용 소스로 사용하지 않습니다. 표준 RPM 빌드 서비스/도구(`mock` + `rpmbuild`, `koji`)의 입력으로 사용합니다.
도구, 오버레이 시스템, 그리고 이 배포판 내에서 개발을 시작하는 방법에 대한 자세한 안내는
[DEVELOPING.md](https://github.com/microsoft/azurelinux/blob/4.0/DEVELOPING.md)를 참조하세요.
## 저장소 레이아웃
| 경로 | 내용 |
|---|---|
| [`azldev.toml`](https://github.com/microsoft/azurelinux/blob/4.0/azldev.toml) | 최상위 설정 — `distro/`와 `base/`를 포함합니다. |
| [`distro/`](https://github.com/microsoft/azurelinux/blob/4.0/distro) | 배포판 정의(Azure Linux + 업스트림 Fedora), 공유 `mock` 설정. |
| [`base/`](https://github.com/microsoft/azurelinux/blob/4.0/base) | `base` 프로젝트: 컴포넌트, 이미지, 테스트. |
| [`base/comps/`](https://github.com/microsoft/azurelinux/blob/4.0/base/comps) | **컴포넌트 정의** — 배포판의 핵심입니다. |
| [`base/images/`](https://github.com/microsoft/azurelinux/blob/4.0/base/images) | [`KIWI NG`](https://osinside.github.io/kiwi/)를 사용하여 컴포넌트 세트로부터 빌드되는 이미지 정의(VM, 컨테이너 등). |
| [`specs/`](https://github.com/microsoft/azurelinux/blob/4.0/specs) | **렌더링된 스펙** — 오버레이가 적용된 후 생성된 `.spec` 파일입니다. 가시성을 위해 체크인되며, 직접 편집하지 마세요. |
| [`locks/`](https://github.com/microsoft/azurelinux/blob/4.0/locks) | 업스트림 커밋 + 입력 지문을 고정하는 컴포넌트별 잠금 파일입니다. 직접 편집하지 마세요. |
| [`external/schemas/`](https://github.com/microsoft/azurelinux/blob/4.0/external/schemas) | TOML 설정 파일용 JSON Schema의 캐시된 사본으로, `azldev`에서 미러링됩니다. |
| [`.github/`](https://github.com/microsoft/azurelinux/blob/4.0/.github) | CI 워크플로와 AI 지원 개발에 사용되는 Copilot 프롬프트, 스킬, 에이전트 지침. |
## 배포판 개발자로 시작하기
배포판 내에서 빌드하거나 개발하려면 **[DEVELOPING.md](https://github.com/microsoft/azurelinux/blob/4.0/DEVELOPING.md)**부터 시작하세요. 주로 배포판을 *사용*하려는 경우라면 이 부분은 신경 쓰지 않아도 됩니다.
## 참여 및 지원
- **버그 및 기능 요청:** [GitHub 이슈](https://github.com/microsoft/azurelinux/issues)를 등록하세요. 중복을 피하기 위해 먼저 기존 이슈를 검색해 주세요. 무엇을 시도했고 무엇을 보고 있는지 최대한 자세히 공유해 주세요.
- **지원:** 전체 채널 목록은 [SUPPORT.md](https://github.com/microsoft/azurelinux/blob/4.0/SUPPORT.md)를 참조하세요.
- **보안 취약점:** 공개 이슈를 **열지 마세요**. Microsoft 보안 대응 센터에 비공개로 보고하려면 [SECURITY.md](https://github.com/microsoft/azurelinux/blob/4.0/SECURITY.md)의 절차를 따르세요.
- **풀 리퀘스트:** 패치 시리즈 워크플로, 커밋 메시지 규칙, 리뷰 기대 사항은 [CONTRIBUTING.md](https://github.com/microsoft/azurelinux/blob/4.0/CONTRIBUTING.md)를 참조하세요.
- **커뮤니티 콜:** Azure Linux는 사용자가 제품 및 지원 팀과 소통하고, 새로운 기능을 논의하고, 피드백을 공유하고, 다른 사람들이 Azure Linux를 어떻게 사용하는지 배울 수 있는 커뮤니티 콜을 개최합니다.
각 세션에는 특별 데모도 포함됩니다. 예정된 커뮤니티 콜(08:00–09:00 PT):
- 2026-07-23 — [참여하려면 클릭][community-call-join]
- 2026-09-24 — [참여하려면 클릭][community-call-join]
- 2026-11-19 — [참여하려면 클릭][community-call-join]
- 2027-01-28 — [참여하려면 클릭][community-call-join]
- 2027-03-25 — [참여하려면 클릭][community-call-join]
- 2027-05-27 — [참여하려면 클릭][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
이 프로젝트는 [Microsoft 오픈 소스 행동 강령](https://opensource.microsoft.com/codeofconduct/)을 채택했습니다. 자세한 내용은 [행동 강령 FAQ](https://opensource.microsoft.com/codeofconduct/faq/)를 참조하거나 추가 질문이나 의견이 있으면 [[email protected]](mailto:[email protected])으로 문의하세요.
## 상표
이 프로젝트에는 프로젝트, 제품 또는 서비스에 대한 상표나 로고가 포함되어 있을 수 있습니다. Microsoft 상표 또는 로고의 승인된 사용은 [Microsoft의 상표 및 브랜드 가이드라인](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general)의 적용을 받으며 이를 준수해야 합니다. 이 프로젝트의 수정된 버전에서 Microsoft 상표 또는 로고를 사용하는 경우 혼동을 일으키거나 Microsoft의 후원을 암시해서는 안 됩니다. 타사 상표 또는 로고의 사용은 해당 타사의 정책을 따릅니다.
## 감사의 말
Azure Linux를 포함한 모든 Linux 배포판은 오픈 소스 소프트웨어 커뮤니티의 기여로부터 이점을 얻습니다. 더 넓은 커뮤니티에서 이루어진 모든 기여에 감사드립니다.
특히 구성 요소, spec 파일, 도구, 서비스 및 커뮤니티 전반에 걸쳐 강력한 기반을 제공해 주신 [Fedora 프로젝트](https://start.fedoraproject.org/)에 감사드립니다. 이 커뮤니티에 참여하고 기여하게 되어 자랑스럽게 생각합니다.
Azure Linux 펭귄 아이콘은 Larry Ewing이 만든 Linux 마스코트("Tux")에서 영감을 받았습니다.
## 라이선스
별도로 명시되지 않는 한, Azure Linux 배포판 및 이 저장소의 콘텐츠는 [MIT 라이선스](https://github.com/microsoft/azurelinux/blob/4.0/LICENSE)에 따라 배포됩니다.
배포판 내의 개별 패키지는 해당 패키지의 spec 파일 및 소스에 명시된 라이선스에 따라 배포됩니다.
이 저장소에는 Fedora Linux에서 파생된 파일이 포함되어 있습니다. Fedora 프로젝트의 라이선스 조건에 대한 자세한 내용은 [fedoraproject.org](https://docs.fedoraproject.org/en-US/legal/fedora-linux-license/)를 참조하세요.