sig-build/AutomatedReview/RootCauseRunbook.md

O3DE Pipeline Root Cause Analysis Runbook

Overview

When a failure occurs in the Open 3d Engine (O3DE) Automated Review (AR) pipeline, a manual investigation must occur in order to identify and assign issues to the correct owners. This runbook will go over steps for Root Cause Analysis (RCA) for failures in the AR pipeline.

Links

• Jenkins branch updates
• GitHub Issues template

RCA Steps

1. Go to the Jenkins branch update page. Locate the branch and click the failing job.
2. At the top of the page, you will see the pipeline steps. Click on any failing step to view its logs.
3. Create a GitHub Issue from the "Automated Review" template.
4. Identify the issue's SIG owner and assign their respective label
5. Complete the details in the GitHub Issue and add any additional labels
6. Notifications will automatically be sent to the Open 3D Foundation Discord #buildstatus channel