Skip to content

Conversation

@yk-mt12
Copy link

@yk-mt12 yk-mt12 commented Oct 13, 2025

Description

Add comprehensive documentation for configuring allowedUnsafeSysctls in EC2NodeClass using NodeConfig for AL2023 AMI family.

This documentation includes:

  • Security warning about using unsafe sysctls and their potential impact on node stability
  • Use case examples (high-performance networking applications, connection handling optimization)
  • EC2NodeClass configuration example showing how to configure allowedUnsafeSysctls via UserData
  • Reference to Kubernetes documentation for Pod usage to avoid redundancy

This addresses the documentation gap for configuring unsafe sysctls, which is not available in spec.kubelet but can be configured through UserData using the NodeConfig format.

How was this change tested?

  • netlify

Does this change impact docs?

  • Yes, PR includes docs updates
  • Yes, issue opened: #
  • No

Related Issues

#2099


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

@yk-mt12 yk-mt12 requested a review from a team as a code owner October 13, 2025 03:58
@yk-mt12 yk-mt12 requested a review from ryan-mist October 13, 2025 03:58
@netlify
Copy link

netlify bot commented Oct 13, 2025

Deploy Preview for karpenter-docs-prod canceled.

Name Link
🔨 Latest commit 6dd5a63
🔍 Latest deploy log https://app.netlify.com/projects/karpenter-docs-prod/deploys/68f71e8e1c2c320008bbe1f0

@yk-mt12 yk-mt12 force-pushed the docs/add-allowed-unsafe-sysctls-example branch from 7710901 to ee2b49f Compare October 13, 2025 04:07
Add comprehensive documentation showing how to configure allowedUnsafeSysctls
using NodeConfig in EC2NodeClass userData for AL2023 AMI family.

This documentation includes:
- Security warning about using unsafe sysctls
- Use case examples (high-performance networking, connection handling)
- EC2NodeClass configuration example with allowedUnsafeSysctls
- Reference to Kubernetes documentation for Pod usage
- Specific error type (SysctlsForbidden) when using disallowed sysctls

This addresses the gap in documentation for configuring unsafe sysctls,
which is not available in spec.kubelet but can be configured through
UserData using the NodeConfig format.

Related issue: aws#2099

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@yk-mt12 yk-mt12 force-pushed the docs/add-allowed-unsafe-sysctls-example branch from a362dc4 to 2e8e74e Compare October 13, 2025 04:24
@yk-mt12
Copy link
Author

yk-mt12 commented Oct 21, 2025

Hi @ryan-mist 👋

I hope you're doing well! I wanted to kindly follow up on this PR when you have a chance.

This is a documentation update that adds configuration examples for allowedUnsafeSysctls in EC2NodeClass for AL2023, which addresses issue #2099.

The change is relatively small (41 lines added to the docs) and includes:

  • Security warnings
  • Use case examples
  • EC2NodeClass configuration example

Would you be able to take a look when you have some time? No rush at all!

Thank you! 🙏

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.

1 participant