v6.0.0

What's Changed

• .sync/Version.njk: Update Mu repos to Mu DevOps v6.0.0 (and container) @makubacki (#230)
  
  Change Details

    Changes since last release: https://github.com/microsoft/mu_devops/compare/v5.0.6...v6.0.0

  General release info: https://github.com/microsoft/mu_devops/releases

  • The ubuntu-22-build container image is also updated to the latest: 9ab29bc.
    • Note: This is the first release with Rust dev support.
  • v6.0.0 also brings some new changes in the pipelines for Project Mu repos to build rust in CI.
    

  
  

  ---

🚀 Features & ✨ Enhancements

• Add Rust Support [Rebase \& FF] @makubacki (#226)
  
  Change Details

    This pull request adds Rust support to mu_devops with patterns that extend to Rust adoption in additional Project Mu repos.

  The changes can be grouped into three high-level parts:

  1. Sync Rust environment files to repos
  2. Add pipeline support to build and test Rust code
  3. Update the build container to incorporate Rust support

  These changes extend existing Rust efforts in Project Mu and improve user experience outside the CI environment.

  ---

  Commit/Change Overview

  ---

  .azurepipelines: Add YAML to cache Cargo tools

  These files are added so dedicated pipelines can download the latest
  release from each tools GitHub repository and push the binaries to
  the pipeline artifacts.

  Project Mu pipelines dependent on Rust tools can access the tools
  directly from the Project Mu pipeline artifacts which is faster
  than building and more reliable than depending on infrastructure
  outside the pipelines.

  ---

  .sync/Files.yml: Move dev container section

  Moves the section higher in the file to maintain alphabetic ordering
  of sections.

  ---

  .sync: Sync common Rust files

  Syncs the following files to repos that support Rust builds.

  • Makefile.toml - Cargo makefile configuration. Repos will no
    longer extend from MU_BASECORE.
  • rustfmt.toml - The Rust formatting settings for the repo.

  ---

  Jobs/PrGate.yml: Give the linux container a reliable name

  Passes the --name parameter as a container creation option in
  pipelines so steps that may need to operate on the container instance
  have a fixed name to refer to the container by.

  The name is: mu_devops_build_container

  ---

  Steps: Add Rust templates

  Adds two new step templates.

  1. RustSetupSteps.yml - Prepare Cargo for Rust builds including
     build during the edk build process and perform other actions
     available during pre-firmware build.
  2. RustCargoSteps.yml.yml - Steps to run common Cargo commands
     on the workspace. Cargo should be installed and the workspace
     source cloned before running these steps.

  ---

  .sync/azure_pipelines/MuDevOpsWrapper.yml: Add rust support

  Allows repos that extend the YAML template to pass a new parameter
  rust_build. By default, the option is false. If true, then
  the repo will be set up to build for Rust and Cargo commands will
  be run at the workspace level to build and test code.

  ---

  Dockerfile: Add Rust support

  Updates the build container image to be able to build Rust code
  (including Rust UEFI code).

  The following additional applications are installed to assist with
  setting up Rust dependencies:

  curl, jq, and unzip

  The CARGO_HOME and RUSTUP_HOME environment variables are set in
  the image and the cargo directory is added to the system path.

  The version of Rust specified in Version.njk is installed alongside
  support for other tools used in Project Mu Rust builds such as
  cargo-make and cargo-tarpaulin. The latest release binaries are
  pulled directly from their GitHub releases to minimze container
  size impact.

  The resulting container images can be used for local development and
  within pipelines.

  ---

  Notes

  • The Rust toolchain version is defined in Version.njk. The version is used in:

    • The Dockerfile to ensure the container version is in sync
    • The YAML pipeline files to ensure (Windows) pipelines are in sync
    • The rust-toolchain.toml file to ensure local builds in repos are in sync

  • The Cargo make makefile is no longer defined in MU_BASECORE and extended to repos. It is synced in whole to repos. Extending from MU_BASECORE unnecessarily complicated pipeline logic and required pulling MU_BASECORE through a submodule (or worse, an external git dependency) on an agent increasing build time.

  • The container image build is structured to provide a ready-to-go Rust dev environment while also minimizing space. The previous build container size was ~1.94GB. Adding the Rust tools initially increased size to 3.41GB. With a variety of adjustments, the size now is ~2.58GB.

  • After this PR completes, a docker container build will happen and a follow up PR will update the Version.njk file to use the new container build. After that PR is completed, repos dependent on the container will be able to access it.

  ---

  File sync tested in the following PRs:

  • mu_basecore
  • mu_plus
  • mu_devops
    

  
  

  ---

Full Changelog: v5.0.10...v6.0.0

v5.0.10

What's Changed

• Version.njk: Add Rust toolchain version @makubacki (#229)
  
  Change Details

    Adds the Rust toolchain version to the file so it can be referenced in future changes that add Rust support to the repo.

  This change needs to be broken out because the upcoming change will
  refer to this entry in Version.njk in the main branch when testing
  the container build in its PR checks.
  

  
  

  ---

  
  

Full Changelog: v5.0.9...v5.0.10

v5.0.9

What's Changed

🐛 Bug Fixes

• Containers/Ubuntu-22/Dockerfile: Get iasl from Project Mu NuGet feed @makubacki (#227)
  
  Change Details

    Resolves #228

  Recently acpica.org has been unavailable, see:
  acpica/acpica#888

  Project Mu already publishes iasl to a NuGet feed. To fix the
  immediate container build issue and reduce external dependencies for
  the future, this change gets iasl from the NuGet feed instead of from
  acpica.org. A NuGet client application is not involved to keep the
  container build steps light.

  The executable is moved to /usr/bin which is already on the system
  path.

  Signed-off-by: Michael Kubacki [email protected]
  

  
  

  ---

  
  

Full Changelog: v5.0.8...v5.0.9

v5.0.8

What's Changed

• Fix missing newline in contributors in tag generation @cfernald (#225)
  
  Change Details

   

  ---

Full Changelog: v5.0.7...v5.0.8

v5.0.7

What's Changed

• Create simple tag generator for ADO pipelines @cfernald (#222)
  
  Change Details

    Creates a script and pipeline that allows for automated tagging based on release version and commit messages. This template should be called for an Azure Devops hosted repository. The consumer of this template is expected to ensure the proper permissions for the build agent to be able to create the tag and commit tag notes.

  The TagGenerator Script provides the following functionality:

  • Scans git history for the most recent matching tag, e.g. 202302.5.10
  • Generates the new tag version, incrementing the "major" version based on the presence of breaking changes.
  • Generates release notes including commits by type, links to Azure Devops PRs, and contributors.
    

  
  

  ---

• .sync/Version.njk: Update Mu repos to Mu DevOps v5.0.6 (and container) @makubacki (#223)
  
  Change Details

    Changes since last release: https://github.com/microsoft/mu_devops/compare/v5.0.4...v5.0.6

  General release info: https://github.com/microsoft/mu_devops/releases

  • The ubuntu-22-build container image is also updated to the latest: 3bf70b5.
    

  
  

  ---

Full Changelog: v5.0.6...v5.0.7

v5.0.6

What's Changed

• Add checkout\_self parameter to prevent additional checkouts @apop5 (#221)
  
  Change Details

    A specific container that does checkout prior to running mu_devops runs into problems with multiple checkout statements. It places the repo under multiple directories.

  Adding a parameter to prevent checkout of the repo again for the code coverage step.
  

  
  

  ---

  
  

• Added fetchdepth to disable default shallow checkout in new pipelines @apop5 (#220)
  
  Change Details

    https://learn.microsoft.com/en-us/azure/devops/pipelines/yaml-schema/steps-checkout?view=azure-pipelines#shallow-fetch

  New pipelines created after the [September 2022 Azure DevOps sprint 209 update](https://learn.microsoft.com/en-us/azure/devops/release-notes/2022/sprint-209-update) have Shallow fetch enabled by default and configured with a depth of 1. Previously the default was not to shallow fetch. To check your pipeline, view the Shallow fetch setting in the [pipeline settings UI](https://learn.microsoft.com/en-us/azure/devops/pipelines/repos/azure-repos-git#shallow-fetch).

  Adding fetchdepth of 0 to disable default of shallow checkout for new pipelines using mu_devops.
  

  
  

  ---

  
  

Full Changelog: v5.0.5...v5.0.6

v5.0.5

What's Changed

• Upgrading markdownlint to v0.32.2 for MD051 - link fragments checking @apop5 (#218)
  
  Change Details

    Upgrade markdownlint to v0.32.2 for MD051 link checking.

  fixes #217

    </blockquote>
    <hr>
  </details>
  

• .sync/Version.njk: Update Mu repos to Mu DevOps v5.0.4 @makubacki (#215)
  
  Change Details

    Changes since last release: https://github.com/microsoft/mu_devops/compare/v5.0.1...v5.0.4

  General release info: https://github.com/microsoft/mu_devops/releases

  • The ubuntu-22-build container image is also updated to the latest: ea6d2e6.
    

  
  

  ---

Full Changelog: v5.0.4...v5.0.5

v5.0.4

What's Changed

• GitHub Action: Bump actions/stale from 7 to 8 @dependabot (#153)
• GitHub Action: Bump actions/labeler from 4.1.0 to 4.2.0 @dependabot (#210)
• GitHub Action: Bump release-drafter/release-drafter from 5.23.0 to 5.24.0 @dependabot (#211)

Full Changelog: v5.0.3...v5.0.4

v5.0.3

What's Changed

• .sync/dependabot: Ignore additional submodules with versioned releases @makubacki (#209)
  
  Change Details

    Adds more Project Mu repos to the dependabot submodule ignore list that have transitioned to versioned releases.

  These will automatically be picked up by the Submoodule Release
  Updater action which tracks release information. Dependabot only
  looks at raw commit diffs instead of release points.

  Added a note to the beginning of the file that this dependabot
  configuration expects submodules at these paths relative to the
  workspace to ignore them properly.
  

  
  

  ---

  
  

Full Changelog: v5.0.2...v5.0.3

v5.0.2

What's Changed

• Add CPP alternative to ubuntu container. @cfernald (#208)
  
  Change Details

    Adds missing alternatives for the cpp tool which is used when building TF-A.

  ---

Full Changelog: v5.0.1...v5.0.2