Skip to content

Rename CBL-Mariner to Azure Linux in documentation #68

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

Copilot
Copy link

@Copilot Copilot AI commented May 20, 2025

This PR updates all references of 'CBL-Mariner' to 'Azure Linux' throughout the documentation in this repository. These changes include:

  • Updated all Markdown files (.md) to use "Azure Linux" instead of "CBL-Mariner"
  • Updated script references from CBL-MarinerTutorials to azurelinux-tutorials
  • Renamed customizeMariner.sh to customizeAzureLinux.sh in the imaging-from-packer directory
  • Updated URLs and repo references to reflect the Azure Linux naming
  • Updated distribution references in spec files

This ensures that all documentation in the repository consistently uses the "Azure Linux" name and is clear for users following the tutorials.

Changes include:

  • README.md with updated repo references and decision tree
  • build-in-container documentation and scripts
  • Getting started guides and environment setup instructions
  • Package management documentation
  • Kernel modification instructions
  • Image building tutorials
  • Booting documentation

Fixes #67.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

@Copilot Copilot AI changed the title [WIP] Rename CBL-Mariner to Azure Linux in documentation Rename CBL-Mariner to Azure Linux in documentation May 20, 2025
@Copilot Copilot AI requested a review from christopherco May 20, 2025 05:42
@christopherco christopherco requested a review from Copilot May 20, 2025 23:06
Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR renames all occurrences of “CBL-Mariner” to “Azure Linux” across documentation, scripts, and specs to ensure consistent branding and updated references.

  • Renamed script files and parameters to Azure Linux (e.g., customizeMariner.sh → customizeAzureLinux.sh)
  • Updated Markdown files, URLs, and repository paths to reflect Azure Linux naming
  • Adjusted spec metadata and container build scripts accordingly

Reviewed Changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
imaging-from-packer/provisioners/customizeAzureLinux.sh Updated comments and package repo name to Azure Linux
imaging-from-packer/Readme.md Replaced CBL-Mariner mentions with Azure Linux
imaging-from-packer/Create-VM.ps1 Updated parameter defaults and comments for Azure Linux
docs/packages/working_with_packages.md Changed package list docs and repo names to Azure Linux
docs/kernel/modify_kernel.md Updated kernel download link text to Azure Linux
docs/getting_started/boot.md Updated boot instructions to Azure Linux
docs/building/building.md Updated build instructions and paths to Azure Linux
build-in-container/scripts/setup.sh Updated toolkit clone/build commands to Azure Linux
build-in-container/README.md Updated container tool instructions to Azure Linux
SPECS/os-subrelease/os-subrelease.spec Changed spec distribution metadata to Azure Linux
README.md Updated introduction and decision tree to Azure Linux
Comments suppressed due to low confidence (1)

imaging-from-packer/Readme.md:13

  • The original "" command was removed from the boot_command snippet and the code fence formatting looks off. Restore the initial key sequence and ensure proper markdown fencing around the two commands.
"<rightCtrlOn>c<rightCtrlOff><tab><enter><wait>",`` commands at the beggining of the "boot_command" section will exit Azure Linux attended configuration.

@@ -15,7 +15,7 @@ The following assumes you have already completed the [Prepare your Environment](
user@machine:~/git$ rsync -a --exclude 'CVE*' azurelinux/SPECS/kernel azurelinux-tutorials/SPECS/
```

Next, you will need to download a source tarball from [CBL-Mariner-Linux-Kernel](https://github.com/microsoft/CBL-Mariner-Linux-Kernel). The tags on this repo follow the format `/rolling-lts/mariner<-2 or -3>/<kernel version>`. This translates to
Next, you will need to download a source tarball from [Azure-Linux-Kernel](https://github.com/microsoft/CBL-Mariner-Linux-Kernel). The tags on this repo follow the format `/rolling-lts/mariner<-2 or -3>/<kernel version>`. This translates to
Copy link
Preview

Copilot AI May 20, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The link URL still points to the CBL-Mariner-Linux-Kernel repo while the link text is Azure-Linux-Kernel. Update the URL to the Azure Linux kernel repository or adjust the link text to match the existing repo.

Suggested change
Next, you will need to download a source tarball from [Azure-Linux-Kernel](https://github.com/microsoft/CBL-Mariner-Linux-Kernel). The tags on this repo follow the format `/rolling-lts/mariner<-2 or -3>/<kernel version>`. This translates to
Next, you will need to download a source tarball from [Azure-Linux-Kernel](https://github.com/microsoft/Azure-Linux-Kernel). The tags on this repo follow the format `/rolling-lts/mariner<-2 or -3>/<kernel version>`. This translates to

Copilot uses AI. Check for mistakes.

@@ -98,13 +98,13 @@ Boot the image and verify that the latest version of zip is now provided:

By default the _latest_ version of any package specified in a package list will be included in your image. It is important to note that each time you rebuild your image it may differ from your previous build as the packages on packages.microsoft.com are periodically updated to resolve security vulnerabilities. This behavior may or may not be desired, but you can always be assured that the most recent build is also the most up to date with respect to CVE's.

If you want to guarantee that your next build will be reproduced the same way at a later time, CBL-Mariner provides some support for this. Each time an image is built, a summary file is generated that lists the explicit packages included in the build. The default location of this file is at: _CBL-MarinerTutorials/build/pkg_artifacts/graph_external_deps.json_. To capture your build's explicit contents and reproduce the build later, it's important to save this file for later use. See [Reproducing a Build](https://github.com/microsoft/CBL-Mariner/blob/-/toolkit/docs/building/building.md#reproducing-a-build) in the CBL-Mariner git repository for advanced details.
If you want to guarantee that your next build will be reproduced the same way at a later time, Azure Linux provides some support for this. Each time an image is built, a summary file is generated that lists the explicit packages included in the build. The default location of this file is at: _Azure LinuxTutorials/build/pkg_artifacts/graph_external_deps.json_. To capture your build's explicit contents and reproduce the build later, it's important to save this file for later use. See [Reproducing a Build](https://github.com/microsoft/Azure Linux/blob/-/toolkit/docs/building/building.md#reproducing-a-build) in the Azure Linux git repository for advanced details.
Copy link
Preview

Copilot AI May 20, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The URL contains a space in 'Azure Linux' which will break the link. It should use 'azurelinux' (no space) in the GitHub path.

Suggested change
If you want to guarantee that your next build will be reproduced the same way at a later time, Azure Linux provides some support for this. Each time an image is built, a summary file is generated that lists the explicit packages included in the build. The default location of this file is at: _Azure LinuxTutorials/build/pkg_artifacts/graph_external_deps.json_. To capture your build's explicit contents and reproduce the build later, it's important to save this file for later use. See [Reproducing a Build](https://github.com/microsoft/Azure Linux/blob/-/toolkit/docs/building/building.md#reproducing-a-build) in the Azure Linux git repository for advanced details.
If you want to guarantee that your next build will be reproduced the same way at a later time, Azure Linux provides some support for this. Each time an image is built, a summary file is generated that lists the explicit packages included in the build. The default location of this file is at: _Azure LinuxTutorials/build/pkg_artifacts/graph_external_deps.json_. To capture your build's explicit contents and reproduce the build later, it's important to save this file for later use. See [Reproducing a Build](https://github.com/microsoft/azurelinux/blob/-/toolkit/docs/building/building.md#reproducing-a-build) in the Azure Linux git repository for advanced details.

Copilot uses AI. Check for mistakes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Rename CBL-Mariner to Azure Linux in documentation
2 participants