audk/.azurepipelines
Michael Kubacki 7868d509dd .azurepipelines: Disable the PR gate code coverage job
REF:https://bugzilla.tianocore.org/show_bug.cgi?id=4819

Code Coverage was added to PR pipelines in 89c5d90 and is currently
running on every pull request. It is run in a separate job that is
queued after all builds from the build matrix have completed. This
means it extends the entire pipeline run by placing it at the
beginning of the build queue right when it should be finished.

In turn, pipeline runs that should finish in 30 minutes are taking
over 3 hours.

This has a substantial impact on the developer efficiency of the
entire community. This patch disables code coverage until a more
sustainable solution can be swapped in.

Users can still get code coverage locally.

Signed-off-by: Michael Kubacki <michael.kubacki@microsoft.com>
2024-07-27 03:06:53 +00:00
..
templates .azurepipelines: Disable the PR gate code coverage job 2024-07-27 03:06:53 +00:00
ReadMe.md .azurepipelines: Add Platform CI template 2020-04-28 18:07:59 +00:00
Ubuntu-GCC5.yml CI: use ubuntu-22.04 image (Linux only) 2023-01-17 19:06:32 +00:00
Ubuntu-PatchCheck.yml .azurepipelines: Fix Python version (to 3.12) 2023-10-31 14:40:50 +00:00
Windows-VS2019.yml CI: make Python version configurable 2023-01-17 19:06:32 +00:00

ReadMe.md

Azure DevOps Pipelines

These yml files are used to provide CI builds using the Azure DevOps Pipeline Service. Most of the CI leverages edk2-pytools to support cross platform building and execution.

Core CI

Focused on building and testing all packages in Edk2 without an actual target platform.

See .pytools/ReadMe.py for more details

Platform CI

Focused on building a single target platform and confirming functionality on that platform.

Conventions

  • Files extension should be *.yml. *.yaml is also supported but in Edk2 we use those for our package configuration.
  • Platform CI files should be in the <PlatformPkg>/.azurepipelines folder.
  • Core CI files are in the root folder.
  • Shared templates are in the templates folder.
  • Top level CI files should be named <host os>-<tool_chain_tag>.yml

Lessons Learned

Templates and parameters

They are great but evil. If they are used as part of determining the steps of a build they must resolve before the build starts. They can not use variables set in a yml or determined as part of a matrix. If they are used in a step then they can be bound late.

File matching patterns

On Linux this can hang if there are too many files in the search list.

Templates and file splitting

Suggestion is to do one big yaml file that does what you want for one of your targets. Then do the second one and find the deltas. From that you can start to figure out the right split of files, steps, jobs.

Conditional steps

If you want the step to show up in the log but not run, use a step conditional. This is great when a platform doesn't currently support a feature but you want the builders to know that the features exists and maybe someday it will.

If you want the step to not show up use a template step conditional wrapper. Beware this will be evaluated early (at build start). This can hide things not needed on a given OS for example.