majiayu000 TOPSAIL CI artifacts retriever
To troubleshoot TOPSAIL CI runs, you need to download the CI logs, and if necessary to investigate further, download the CI artifacts to better understand what happened.
To download the CI logs, you need to ask the user the PR number (PR_NUMBER).
- With the PR number, find the list of available tests, by fetching this listing page:
usually, there's only one test TEST_NAME
- With the test name, find the latest build ID (the build ID is a timestamp)
BUILD_ID
- With the Build ID, look up the steps on this page:
- The following steps
STEP_NAMEare the setup of the infrastructure (thejump-ci):
lock-clusterprepare-jump-ciunlock-cluster
If they fail, it's an infra-structure failure. This should be clearly specified to the user, but she'll nonetheless need help to know which part failed. Their artifacts directory is at this location:
- These steps are the actual test steps:
pre-cleanuppreparetestpost-cleanup(optional)
Their artifacts are at this location:
Notice the trailing test-artifacts directory name. This directory is created by the Jump-CI. Anything inside it is the actual test artifacts. Anything at the same level is the artifacts of the Jump-CI infrastructure.
- Inside the test artifacts directory, the
run.logfile shows the full trace of the
this file might be long and hard to grasp (for the user).
- Inside the test artifacts directory, the
FAILURESfile, if present, gives an indication of what failed:
- This command helps downloading locally a full directory
DIRECTORYof artifacts:
gsutil -m cp -r gs://test-platform-results/pr-logs/pull/openshift-psap_topsail/PR_NUMBER/TEST_NAME/BUILD_ID/artifacts/jump-ci/STEP_NAME/artifacts/test-artifacts/DIRECTORY .
(the command is also shown at the bottom of the directory listing).