소스 검색

Adding AR runbook and images

Signed-off-by: evanchia <[email protected]>
evanchia 4 년 전
부모
커밋
ab9090f35e
4개의 변경된 파일41개의 추가작업 그리고 0개의 파일을 삭제
  1. 41 0
      AutomatedReview/AutomatedReviewRootCausing.md
  2. BIN
      AutomatedReview/images/rca_1.png
  3. BIN
      AutomatedReview/images/rca_2.png
  4. BIN
      AutomatedReview/images/rca_3.png

+ 41 - 0
AutomatedReview/AutomatedReviewRootCausing.md

@@ -0,0 +1,41 @@
+---
+linktitle: "AR RCA Runbook"
+title: "Automated Review Root Cause Analysis Runbook"
+description: ' Runbook on how to manually debug failures in the Automated Review pipeline. '
+date: 2021-05-07
+toc: true
+weight: 200
+---
+
+## O3DE Pipeline Root Cause Analysis Runbook
+
+### Overview
+
+When a failure occurs in the Open 3d Engine (O3DE) main branch 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 main branch updates](https://jenkins-o3de.agscollab.com/job/O3DE/job/main/)
+* [Jenkins nightly updates](https://jenkins-pipeline.agscollab.com/job/O3DE-LY-Fork_nightly/)
+* TODO[GitHub Issues template]()
+
+### RCA Steps
+
+1. **Go to the [Jenkins main branch update page](https://jenkins-o3de.agscollab.com/job/O3DE/job/main/). Locate and click the failing job.**
+![Jenkins page](./images/rca_1.png)
+1. **Click "Open Ocean Blue" for a visual pipeline view.**
+![Ocean Blue](./images/rca_2.png)
+1. **At the top of the page, you will see the pipeline steps. Click on any failing step to view its logs.**
+![Failing jobs](./images/rca_3.png)
+1. **Create a GitHub Issue from the "Automated Review" TODO[template]().**
+1. **Identify the type of issue based on the classifications.**
+    * **Infrastructure** - An issue with the underlying pipeline framework e.g. Jenkins timeouts, EBS mounting errors, and out of disk space errors.
+        * Add "Infrastructure" label
+    * **Flaky Test** - A test itself is proven to be incorrectly failing e.g. race conditions, test ordering errors, intermittent failures.
+        * Add label for the Special Interest Group's (SIG) test owner
+    * **Tooling** - Errors with pipeline scripts or test dependencies e.g. build scripts, LyTestTools, * Editor Python Bindings.
+        * Add "Test Tools" label
+    * **Legitimate** - A test catches a relevant bug in the pull request.
+        * Add label for the SIG issue owner
+1. **Complete the details in the GitHub Issue and add any additional labels**
+1. **If it's a blocking Issue, notify TODO(email?)**

BIN
AutomatedReview/images/rca_1.png


BIN
AutomatedReview/images/rca_2.png


BIN
AutomatedReview/images/rca_3.png