EDK II Continuous Integration Administration

Configuring edk2 repository

1. Azure Pipelines Configuration Steps Part I

   1. Goto https://dev.azure.com/tianocore
   2. Create new project in TianoCore org called edk2-ci
   3. Disable Boards
   4. Disable Repositories

2. GitHub Configuration Steps Part I

   1. Goto https://github.com/tianocore
   2. Select Settings
   3. Select Installed GitHub Apps
   4. Select Azure Pipelines -> Configure
      • Enable tianocore/edk2 repository
      • Redirects to Azure Pipelines login. Select TianoCore org and edk2-ci project to complete link and authentication between Azure Pipelines TianoCore organization and GitHub TianoCore organization.

3. Azure Pipelines Configuration Steps Part II

   1. Goto https://dev.azure.com/tianocore/edk2-ci/_build
   2. Create New Pipeline called Ubuntu GCC5 CI for post commit checks
      • YAML: Select file https://github.com/tianocore/edk2/blob/master/.azurepipelines/Ubuntu-GCC5.yml
      • Name: Set to Ubuntu GCC5 CI
      • Triggers:
        • CI - No changes
        • PR - Override + Disable
      • Variables: No changes
      • Save pipeline changes
      • Run pipeline and verify all checks pass
   3. Create New Pipeline called Windows VS2019 CI for post commit checks
      • YAML: Select file https://github.com/tianocore/edk2/blob/master/.azurepipelines/Windows-VS2019.yml
      • Name: Windows VS2019 CI
      • Triggers
        • CI - No changes
        • PR - Override + Disable
      • Variables: No changes
      • Save pipeline changes
      • Run pipeline and verify all checks pass
   4. Create New Pipeline called Ubuntu GCC5 PR for pre commit checks
      • YAML: Select file https://github.com/tianocore/edk2/blob/master/.azurepipelines/Ubuntu-GCC5.yml
      • Name: Ubuntu GCC5 PR
      • Triggers
        • CI - Override + Disable
        • PR - No changes
      • Variables: No changes
      • Save pipeline changes
      • Run pipeline. Pipeline will fail because it requires a GitHub PR. Must run for pipeline name to show up in GitHub Branch Protection Rules.
   5. Create New Pipeline called Windows VS2019 PR for pre commit checks
      • YAML: Select file https://github.com/tianocore/edk2/blob/master/.azurepipelines/Windows-VS2019.yml
      • Name: Windows VS2019 PR
      • Triggers
        • CI - Override + Disable
        • PR - No changes
      • Variables: No changes
      • Save pipeline changes
      • Run pipeline. Pipeline will fail because it requires a GitHub PR. Must run for pipeline name to show up in GitHub Branch Protection Rules.
   6. Add PatchCheck pipeline for pre commit checks
      • YAML: Select file https://github.com/tianocore/edk2/blob/master/.azurepipelines/Ubuntu-PatchCheck.yml
      • Name: tianocore.PatchCheck
      • Triggers
        • CI - Override + Disable
        • PR - No changes
      • Variables: No changes
      • Save pipeline changes
      • Run pipeline. Pipeline will fail because it requires a GitHub PR. Must run for pipeline name to show up in GitHub Branch Protection Rules.

4. GitHub Configuration Steps Part II

   1. Goto https://github.com/tianocore/edk2
   2. Select Settings
   3. Select Branches
   4. Select Branch Protection Rules
   5. Select master -> Edit
      • Enable Require status checks to pass before merging
      • Enable Require branches to be up to date before merging
      • Enable Windows VS2019 PR check
      • Enable Ubuntu GCC5 PR check
      • Enable tianocore.PatchCheck check
   6. Goto https://github.com/tianocore
   7. Select Settings
   8. Select Installed GitHub Apps
   9. Select Mergify -> Configure
      • Enable tianocore/edk2 repo

5. Update Status Badge Links

   1. Goto https://dev.azure.com/tianocore/edk2-ci/_build
   2. Select Windows VS2019 CI
      • Use '...' menu in upper right and select Status badge
      • Copy Sample markdown
      • Update links in Build Status section of https://github.com/tianocore/edk2/blob/master/Readme.md
   3. Select Ubuntu GCC5 CI
      • Use '...' menu in upper right and select Status badge
      • Copy Sample markdown
      • Update links in Build Status section of https://github.com/tianocore/edk2/blob/master/Readme.md
   4. Submit changes to Readme.md for EDK II code review and submit GitHub PR to test personal build and Mergify commit once review passes.