Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[YUNIKORN-2726] Add How to check E2E test logs? to developer guide #450

Closed
wants to merge 4 commits into from

Conversation

ryankert01
Copy link
Contributor

What is this PR for?

After YUNIKORN-2305 , the logs of failed E2E test are dumped to local and upload to Github Action Artifact. We should let new developers know how to retrieve them.

We should add some explaination to developer guide(https://yunikorn.apache.org/docs/next/developer_guide/e2e_test), below should be included:

Where to find the local e2e test logs after make e2e_test failed? (In yunikorn-k8shim/build/e2e/{suite}/)
What's logs types we have
a. {specName}_k8sClusterInfo.txt
b.{specName}_ykContainerLog.txt
c.{specName}_ykFullStateDump.json
How to download logs in Github Action (Check below screenshot in the failed CI Link)

What type of PR is it?

  • - Bug Fix
  • - Improvement
  • - Feature
  • - Documentation
  • - Hot Fix
  • - Refactoring

Todos

  • - Task

What is the Jira issue?

https://issues.apache.org/jira/browse/YUNIKORN-2726

How should this be tested?

Screenshots (if appropriate)

image
image

Questions:

  • - The licenses files need update.
  • - There is breaking changes for older versions.
  • - It needs documentation.

Copy link
Contributor

@craigcondit craigcondit left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mostly good, minor nit.

## Checking E2E Test Logs

After implementing [YUNIKORN-2305](https://issues.apache.org/jira/browse/YUNIKORN-2305), the logs of failed E2E tests are stored locally and uploaded to the GitHub Action Artifact. This section explains how to retrieve and understand these logs.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't need to mention the JIRA that implemented this. It's fine to have it in the docs without that.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

@ryankert01 ryankert01 requested a review from craigcondit July 12, 2024 02:27
Copy link
Member

@chia7712 chia7712 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ryankert01 thanks for this nice documents!

### Steps to Retrieve Local Logs

1. Run the E2E test using `make e2e_test`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we recommend to use ./scripts/run-e2e-tests.sh -a "test" -n "yk8s" instead of make e2e_test? run-e2e-tests.sh is easy to use. Also it is the command used by CI.

Copy link
Contributor Author

@ryankert01 ryankert01 Jul 18, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done! Great suggestion. Totally agreed with aligning with CI.

@ryankert01 ryankert01 requested a review from chia7712 July 18, 2024 15:53
Copy link
Member

@chia7712 chia7712 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@chia7712 chia7712 closed this in b5e5ee9 Jul 18, 2024
github-actions bot pushed a commit that referenced this pull request Jul 19, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants