Skip to content

docs(skill): discover Kubernetes gateway workload - #2262

Open
elezar wants to merge 2 commits into
mainfrom
codex/debug-kube-workload
Open

docs(skill): discover Kubernetes gateway workload#2262
elezar wants to merge 2 commits into
mainfrom
codex/debug-kube-workload

Conversation

@elezar

@elezar elezar commented Jul 14, 2026

Copy link
Copy Markdown
Member

Summary

Update Kubernetes troubleshooting guidance so commands target the gateway controller actually installed by Helm. Each standalone diagnostic block now discovers deployment/openshell or statefulset/openshell and errors clearly if neither exists.

Related Issue

Related to #1868. This extracts a generally applicable skill cleanup into its own PR.

Changes

  • Resolve the installed gateway controller into GATEWAY_WORKLOAD.
  • Use that workload for gateway logs, rollout status, and image inspection.
  • Replace troubleshooting guidance that told users to try both controller kinds.
  • Keep HA peer troubleshooting and unrelated documentation out of scope.

Testing

  • mise run pre-commit passes (partial: Markdown, Helm lint/docs, license, and formatting checks passed; the run then failed because grpc_tools was unavailable to the proto task and z3.h was missing for Rust tests)
  • Focused markdownlint passes for the changed skill
  • Updated shell snippets pass bash -n
  • git diff --check passes
  • Unit tests added/updated (not applicable: documentation-only change)
  • E2E tests added/updated (not applicable: documentation-only change)

The sync-agent-infra audit found the skill inventory and workflow chains consistent. It also found pre-existing, unrelated architecture-table drift: AGENTS.md omits six current crates (openshell-driver-podman, openshell-prover, openshell-server-macros, openshell-supervisor-network, openshell-supervisor-process, and openshell-vfio). This PR intentionally does not widen scope to fix that drift.

Checklist

  • Follows Conventional Commits
  • Commits are signed off (DCO)
  • Architecture docs updated (not applicable)

@copy-pr-bot

copy-pr-bot Bot commented Jul 14, 2026

Copy link
Copy Markdown

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

Signed-off-by: Evan Lezar <elezar@nvidia.com>
@elezar
elezar force-pushed the codex/debug-kube-workload branch from 8857e14 to bd364bd Compare July 27, 2026 13:28
@elezar
elezar marked this pull request as ready for review July 27, 2026 13:38
Signed-off-by: Evan Lezar <elezar@nvidia.com>
@elezar

elezar commented Jul 29, 2026

Copy link
Copy Markdown
Member Author

gator-agent

Blocked

Head SHA: 190dfead2e0e5d4a62ee1baaf713eb1ef762da05

Gator is blocked because GitHub currently reports this PR as mergeable_state: dirty, which indicates merge conflicts against main.

Next action: @elezar, please update the PR branch against main and resolve the merge conflicts. Gator will resume review once GitHub reports the branch as mergeable.

@elezar elezar added the gator:blocked Gator is blocked by process or repository gates label Jul 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

gator:blocked Gator is blocked by process or repository gates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant