Skip to content

docs: document migration, installerChecker, and namespaceDestroyAll jobs - #1307

Open
rberrelleza wants to merge 3 commits into
mainfrom
docs/513-okteto-jobs-admin-docs
Open

docs: document migration, installerChecker, and namespaceDestroyAll jobs#1307
rberrelleza wants to merge 3 commits into
mainfrom
docs/513-okteto-jobs-admin-docs

Conversation

@rberrelleza

@rberrelleza rberrelleza commented Jul 21, 2026

Copy link
Copy Markdown
Member

Closes #513

Documents the three Kubernetes jobs Okteto runs in the okteto namespace (migration, installerChecker, namespaceDestroyAll) in the Helm configuration reference.

What changed

  • helm-configuration.mdx: adds installerChecker, migration, and namespaceDestroyAll config sections under Okteto Components, giving priorityClassName and the other values a documented home (the gap raised in the Document priorityClassName #511 review). Each section describes the job and its configurable values.
  • troubleshooting.mdx: notes that the installerChecker CronJob clears pipelines stuck in "progressing", linking to its Helm configuration section.

Self-contained; no dependency on other PRs.

🤖 Generated with Claude Code

Add an admin-focused reference and troubleshooting page for the three
Kubernetes jobs Okteto runs in the okteto namespace, plus Helm config
value sections for each so priorityClassName and related settings have a
documented home.

- New page self-hosted/manage/okteto-jobs.mdx: what each job is, when it
  runs, the resources it acts on, and how to inspect it (component label
  selectors, kubectl commands, logs).
- helm-configuration.mdx: add installerChecker, migration, and
  namespaceDestroyAll sections under Okteto Components.
- troubleshooting.mdx: cross-link the installerChecker from the
  "progressing forever" section.
- sidebars.js: add the new page to Operating Okteto.

Closes #513

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Ramiro Berrelleza <ramiro@okteto.com>
@netlify

netlify Bot commented Jul 21, 2026

Copy link
Copy Markdown

Deploy Preview for okteto-docs ready!

Name Link
🔨 Latest commit 33ca876
🔍 Latest deploy log https://app.netlify.com/projects/okteto-docs/deploys/6a6010e2666b8600081e3c5c
😎 Deploy Preview https://deploy-preview-1307--okteto-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Remove the new okteto-jobs.mdx page and its sidebar entry from this PR; they
now live in a dedicated PR (#1310). This PR keeps the helm-configuration.mdx
config sections and the troubleshooting.mdx cross-link, which reference that
page. Merge #1310 first.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@rberrelleza
rberrelleza marked this pull request as ready for review July 22, 2026 00:33
Drop the "See Okteto Jobs" cross-links from the installerChecker, migration,
and namespaceDestroyAll config sections, and point the troubleshooting
installerChecker link at its Helm configuration section instead. This PR is
now self-contained and no longer depends on the separate Okteto Jobs page PR.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.

Document installerChecker, migration and namespaceDestroyAll

1 participant