Skip to content

adding a note to minimum ip target #2739

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

Merged
merged 2 commits into from
Jan 2, 2024
Merged

adding a note to minimum ip target #2739

merged 2 commits into from
Jan 2, 2024

Conversation

haouc
Copy link
Contributor

@haouc haouc commented Jan 2, 2024

What type of PR is this?

documentation
Which issue does this PR fix:
Clarifying the best practice to setup warm target parameters.

What does this PR do / Why do we need it:
Customers may be confused and impacted if the variables are set incorrectly.

If an issue # is not available please add repro steps and logs from IPAMD/CNI showing the issue:

Testing done on this change:

Will this PR introduce any new dependencies?:

Will this break upgrades or downgrades? Has updating a running cluster been tested?:

Does this change require updates to the CNI daemonset config files to work?:

Does this PR introduce any user-facing change?:


By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

@haouc haouc requested a review from a team as a code owner January 2, 2024 18:51
README.md Outdated
@@ -333,6 +334,8 @@ elasticity, but uses roughly half as many IPs as using WARM_IP_TARGET alone (32
This also improves the reliability of the EKS cluster by reducing the number of calls necessary to allocate or deallocate
private IPs, which may be throttled, especially at scaling-related times.

**NOTE!** If MINIMUM_IP_TARGET is set WARM_ENI_TARGET will be ignored, please utilize WARM_IP_TARGET instead. Please also referring `WARM_ENI_TARGET`.
Copy link
Contributor

@jdn5126 jdn5126 Jan 2, 2024

Choose a reason for hiding this comment

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

format nit: "NOTE! If MINIMUM_IP_TARGET is set, WARM_ENI_TARGET will be ignored. Please utilize WARM_IP_TARGET instead. Please also refer to WARM_ENI_TARGET."

Copy link
Contributor

@jayanthvn jayanthvn Jan 2, 2024

Choose a reason for hiding this comment

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

Nit: referring -> refer

I don't think we need -> Please also refer to WARM_ENI_TARGET... Lets also add a note in best practices guide..

Copy link
Contributor

Choose a reason for hiding this comment

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

Let's also add that if MINIMUM_IP_TARGET is set, but WARM_IP_TARGET is not set, WARM_IP_TARGET is assumed to be 0, which will prevent future ENIs from being allocated. We should strongly recommend that WARM_IP_TARGET is configured when MINIMUM_IP_TARGET is

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Updated the content, can you check again? Thanks.

@haouc haouc force-pushed the master branch 2 times, most recently from 6ce456b to ef02ac5 Compare January 2, 2024 19:22
@haouc haouc requested review from jdn5126 and jayanthvn January 2, 2024 19:23
README.md Outdated
@@ -333,6 +334,10 @@ elasticity, but uses roughly half as many IPs as using WARM_IP_TARGET alone (32
This also improves the reliability of the EKS cluster by reducing the number of calls necessary to allocate or deallocate
private IPs, which may be throttled, especially at scaling-related times.

**NOTE!**
1. If `MINIMUM_IP_TARGET` is set, `WARM_ENI_TARGET` will be ignored. Please utilize `WARM_IP_TARGET` instead.
2. If `MINIMUM_IP_TARGET` is set and `WARM_IP_TARGET` is not set, `WARM_IP_TARGET` is assumed to be 0, which will prevent future ENIs from being allocated. It is strongly recommended that `WARM_IP_TARGET` should be set greater than 0 when `MINIMUM_IP_TARGET` is set.
Copy link
Contributor

Choose a reason for hiding this comment

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

We can further clarify this...something like..

If `MINIMUM_IP_TARGET` is set and `WARM_IP_TARGET` is not set, `WARM_IP_TARGET` is assumed to be 0, leading to the number of IPs attached to the node will be the value of `MINIMUM_IP_TARGET`. This configuration will prevent future ENIs/IPs from being allocated. It is strongly recommended that `WARM_IP_TARGET` should be set greater than 0 when `MINIMUM_IP_TARGET` is set.

@haouc haouc force-pushed the master branch 2 times, most recently from 44b46d5 to 4416ca3 Compare January 2, 2024 23:08
README.md Outdated
@@ -333,6 +334,10 @@ elasticity, but uses roughly half as many IPs as using WARM_IP_TARGET alone (32
This also improves the reliability of the EKS cluster by reducing the number of calls necessary to allocate or deallocate
private IPs, which may be throttled, especially at scaling-related times.

**NOTE!**
1. If `MINIMUM_IP_TARGET` is set, `WARM_ENI_TARGET` will be ignored. Please utilize `WARM_IP_TARGET` instead.
2. If `MINIMUM_IP_TARGET` is set and `WARM_IP_TARGET` is not set, `WARM_IP_TARGET` is assumed to be 0, which leads to the number of IPs attached to the node will be the value of `MINIMUM_IP_TARGET`. This configuration will prevent future ENIs from being allocated. It is strongly recommended that `WARM_IP_TARGET` should be set greater than 0 when `MINIMUM_IP_TARGET` is set.
Copy link
Contributor

Choose a reason for hiding this comment

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

Minor nit : "will prevent future ENIs" -> "will prevent future ENIs/IPs"

But rest lgtm

jayanthvn
jayanthvn previously approved these changes Jan 2, 2024
@haouc haouc merged commit babd43f into aws:master Jan 2, 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.

3 participants