Skip to content

docs: align cronjob nodepool docs with required affinity behavior#116

Open
Guimove wants to merge 1 commit intomainfrom
docs/cronjob-required-affinity
Open

docs: align cronjob nodepool docs with required affinity behavior#116
Guimove wants to merge 1 commit intomainfrom
docs/cronjob-required-affinity

Conversation

@Guimove
Copy link
Copy Markdown
Contributor

@Guimove Guimove commented May 7, 2026

Summary

Cron job pod affinity for the dedicated cronjob Karpenter nodepool was recently switched from preferred (soft) to required (hard) so cron pods actually land on that nodepool instead of silently scheduling on default whenever it has spare capacity. This PR aligns the docs with the new behavior.

Files updated

  • docs/configuration/cronjob.mdx
  • docs/configuration/integrations/kubernetes/eks/managed.mdx

What changed

  • "preferred node affinity" replaced by "required node affinity".
  • "they are steered there when available" replaced by "they always run there".
  • "we strongly recommend redeploying" replaced by "you must redeploy".
  • Removed the now-incorrect statement that cron jobs fall back to the default nodepool if the cronjob nodepool is removed. With hard affinity they stay in Pending until redeployed.
  • Added an explicit warning on both pages that whenever the cronjob nodepool is toggled on or off, every cron job must be redeployed for the change to take effect.

Why

The previous wording described soft (preferred) affinity behavior, including a fallback that no longer exists. Without this update, anyone toggling the setting without redeploying could be surprised by cron jobs stuck in Pending.

@Guimove Guimove requested a review from a team May 7, 2026 10:14
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented May 7, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
✅ Deployment successful!
View logs
qovery-doc-mintlify-proxy ff086fa May 07 2026, 10:17 AM

@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 7, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
qovery 🟢 Ready View Preview May 7, 2026, 10:16 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Cron job pod affinity for the dedicated cronjob Karpenter nodepool was
recently switched from preferred (soft) to required (hard) so cron pods
actually land on that nodepool instead of silently scheduling on the
default nodepool whenever it has spare capacity. The docs still
described the previous soft behavior.

Both the cronjob page and the EKS managed cluster resources page now:

* describe a required (hard) node affinity instead of preferred
* state that redeploying cron jobs is mandatory after enabling or
  disabling the cronjob nodepool, not just recommended
* remove the false claim that jobs fall back to the default nodepool
  when the cronjob nodepool is removed; with hard affinity they stay
  in Pending until redeployed

Pairs with the corresponding engine code change.
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.

2 participants