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

docs: correct the dominator of memory and examples in resource-durati… #11432

Merged
merged 1 commit into from
Jul 24, 2023

Conversation

jayin92
Copy link
Contributor

@jayin92 jayin92 commented Jul 24, 2023

Motivation

The dominator of memory should be 100Mi instead of 1Gi. Source code

Modifications

  • Fix the wrong examples in the document
  • Remove "Rounding Down" section, because it's not likely to happen

Verification

These changes are consisitent with the source code.

…on.md

- The dominator of memory should be `100Mi` instead of `1Gi`. [Source code](https://github.com/argoproj/argo-workflows/blob/7f22085d16316bdd77bdb1060455140d9d6e1664/pkg/apis/workflow/v1alpha1/workflow_types.go#L2012)
- Fix the wrong examples in the document
- Remove "Rounding Down" section, because it's not likely to happen

Signed-off-by: Jay Lee <jayin920805@gmail.com>
@jayin92 jayin92 marked this pull request as ready for review July 24, 2023 13:22
@jayin92
Copy link
Contributor Author

jayin92 commented Jul 24, 2023

@agilgur5 Can help me review this?

@agilgur5
Copy link
Member

Follow up from Slack where OP found this inconsistency (nice find!) and I found the correct amounts in the source code 🙂

@terrytangyuan terrytangyuan merged commit 12af30c into argoproj:master Jul 24, 2023
24 checks passed
Copy link
Member

@agilgur5 agilgur5 left a comment

Choose a reason for hiding this comment

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

Great find again! Two small changes requested, otherwise LGTM

Comment on lines 56 to 57
For example, `memory` means "amount of time a resource requested 1Gi of memory." If a container only
uses 100Mi, each second it runs will only count as a tenth-second of `memory`.
Copy link
Member

Choose a reason for hiding this comment

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

this example could also be fixed

Copy link
Member

Choose a reason for hiding this comment

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

Fixed in #11449

Comment on lines -58 to -62

## Rounding Down

For short running pods (<10s), the memory value may be 0s. This is because the default is `100Mi`,
but the denominator is `1Gi`.
Copy link
Member

Choose a reason for hiding this comment

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

Hmm I still think this section is useful. I definitely have Pods that run for less than 10s

Copy link
Member

Choose a reason for hiding this comment

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

Fixed in #11449

@agilgur5
Copy link
Member

Oops, @terrytangyuan we got an IRL race condition; you happened to merge while I was still reviewing 😅

@terrytangyuan
Copy link
Member

Oops feel free to submit follow up PR!

@jayin92
Copy link
Contributor Author

jayin92 commented Jul 25, 2023

I will file another PR later for the review @agilgur5 metioned above.

@agilgur5
Copy link
Member

agilgur5 commented Jul 25, 2023

Followed up in #11449. Thanks!

@agilgur5 agilgur5 added the area/docs Incorrect, missing, or mistakes in docs label Oct 8, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/docs Incorrect, missing, or mistakes in docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants