Linux OS for Azure 1P services and edge appliances
Перейти к файлу
Kanika Nema 738126b46e
Add fontawesome v4.7.0 (#7987)
There are packages like python-sphinx_rtd_theme that rely
on the older 4.x version of fontawesome. Support both 6.x and
4.x versions in azl 3.0.
2024-02-26 12:51:31 +05:30
.config Added signing stage for livepatches pipeline. (#5101) 2023-03-24 19:31:42 -07:00
.github containerd: rename from moby-containerd and upgrade to 1.7.13 (#8056) 2024-02-23 18:12:28 -08:00
.pipelines Add compatibility flag to all createrepo commands (#7837) 2024-02-13 14:55:43 -08:00
LICENSES-AND-NOTICES Update licenses for the new specs 2020-08-19 01:48:59 +00:00
SPECS Add fontawesome v4.7.0 (#7987) 2024-02-26 12:51:31 +05:30
SPECS-EXTENDED Updated `%patch` macros for 4.18+ versions of RPM. (#7688) 2024-02-13 13:57:20 -08:00
SPECS-SIGNED feat: EnableGrubMkconfig by default; deprecate legacy tools-grub.cfg flow (#7618) 2024-02-22 12:17:15 -08:00
toolkit python3: upgrade to 3.12.0 (#7858) 2024-02-23 18:55:01 -08:00
.gitattributes Add .gitattributes file for GitHub linguist attributes (#4510) 2023-01-24 09:33:13 -08:00
.gitignore Ignored `ccache` directory. (#4912) 2023-02-23 16:18:26 -08:00
CODE_OF_CONDUCT.md Initial CODE_OF_CONDUCT.md commit 2020-07-22 12:27:23 -07:00
CONTRIBUTING.md Update contribution guide to include more detailed instructions (#5169) 2023-03-31 15:06:55 -07:00
CodeQL.yml CodeQL Mariner toolkit (#6885) (#6904) 2023-12-04 15:37:45 -08:00
LICENSE Initial LICENSE commit 2020-07-22 12:27:24 -07:00
README.md TEMPORARY SQUASH MERGE: Cherry-pick tooling changes into 3.0-dev (#7008) 2023-12-18 00:22:39 -08:00
SECURITY.md Initial SECURITY.md commit 2020-07-22 12:27:25 -07:00
SUPPORT.md packages.microsoft.com repo structure info (#4597) 2023-01-24 15:30:45 -08:00
cgmanifest.json Add fontawesome v4.7.0 (#7987) 2024-02-26 12:51:31 +05:30

README.md

CBL-Mariner

CBL-Mariner is an internal Linux distribution for Microsofts cloud infrastructure and edge products and services. CBL-Mariner is designed to provide a consistent platform for these devices and services and will enhance Microsofts ability to stay current on Linux updates. This initiative is part of Microsofts increasing investment in a wide range of Linux technologies, such as SONiC and Windows Subsystem for Linux (WSL). CBL-Mariner is being shared publicly as part of Microsofts commitment to Open Source and to contribute back to the Linux community. CBL-Mariner does not change our approach or commitment to any existing third-party Linux distribution offerings.

CBL-Mariner has been engineered with the notion that a small common core set of packages can address the universal needs of first party cloud and edge services while allowing individual teams to layer additional packages on top of the common core to produce images for their workloads. This is made possible by a simple build system that enables:

  • Package Generation: This produces the desired set of RPM packages from SPEC files and source files.
  • Image Generation: This produces the desired image artifacts like ISOs or VHDs from a given set of packages.

Whether deployed as a container or a container host, CBL-Mariner consumes limited disk and memory resources. The lightweight characteristics of CBL-Mariner also provides faster boot times and a minimal attack surface. By focusing the features in the core image to just what is needed for our internal cloud customers there are fewer services to load, and fewer attack vectors.

When security vulnerabilities arise, CBL-Mariner supports both a package-based update model and an image based update model. Leveraging the common RPM Package Manager system, CBL-Mariner makes the latest security patches and fixes available for download with the goal of fast turn-around times.

Getting Started with CBL-Mariner

Build

Instructions for building CBL-Mariner may be found here: Toolkit Documentation.

ISO

You can try CBL-Mariner with the following ISO images:

Before using a downloaded ISO, verify the checksum and signature of the image.

After downloading the ISO, use the quickstart instructions to install and use the image in a Hyper-V VM.

Note: Support for the ISO is community based. Before filing a new bug or feature request, please search the list of Github Issues. If you are unable to find a matching issue, please report new bugs by clicking here or create a new feature request by clicking here. For additional information refer to the support.md file.

Getting Help

  • Bugs, feature requests and questions can be filed as GitHub issues.
  • We are starting a public community call for Mariner users to get together and discuss new features, provide feedback, and learn more about how others are using Mariner. In each session, we will feature a new demo. The schedule for the upcoming community calls are:
  • 1/25/24 from 8-9am (PST) Click to join
  • 3/28/24 from 8-9am (PST) Click to join
  • 5/23/24 from 8-9am (PST) Click to join
  • 7/25/24 from 8-9am (PST) Click to join
  • 9/26/24 from 8-9am (PST) Click to join

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

Acknowledgments

Any Linux distribution, including CBL-Mariner, benefits from contributions by the open software community. We gratefully acknowledge all contributions made from the broader open source community, in particular:

  1. The Photon OS Project for SPEC files originating from the Photon distribution.

  2. The Fedora Project for SPEC files, particularly with respect to Qt, DNF and content in the SPECS-EXTENDED folder.

  3. GNU and the Free Software Foundation

  4. Linux from Scratch

  5. Openmamba for SPEC files