Skip to content

Document KHI job mode#709

Open
Haihan-Jiang wants to merge 1 commit into
GoogleCloudPlatform:mainfrom
Haihan-Jiang:codex/khi-document-job-mode
Open

Document KHI job mode#709
Haihan-Jiang wants to merge 1 commit into
GoogleCloudPlatform:mainfrom
Haihan-Jiang:codex/khi-document-job-mode

Conversation

@Haihan-Jiang

Copy link
Copy Markdown
Contributor

Summary

  • add a setup guide for running KHI in job mode
  • document the required job mode flags, supported inspection type IDs, and a basic GKE example
  • link the new guide from the README user guide section

Fixes #196

Tests

  • go test ./pkg/parameters
  • git diff --check

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request introduces documentation for running KHI in job mode. It adds a new guide, docs/en/setup-guide/job-mode.md, which details the required flags, command format, inspection values, and feature selection, and updates README.md to link to this new guide. There are no review comments, and I have no feedback to provide.

@Haihan-Jiang

Copy link
Copy Markdown
Contributor Author

This is ready for review from my side. The remaining github-deploy-ondemand check appears to require project-side approval/run permissions; could someone take a look or trigger it when convenient?

--job-mode \
--job-inspection-type gcp-gke \
--job-inspection-features ALL \
--job-inspection-values '{

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I think the most difficult part of this feature is building the --job-inspection-values parameter.
The current easiest way is using dev tool on browser to see what is sent from the frontend. It's a little hacky way but worth to be documented.

Comment thread docs/en/setup-guide/job-mode.md Outdated
"cloud.google.com/common/input-location": "us-central1",
"cloud.google.com/common/input-end-time": "2026-01-15T10:00:00Z",
"cloud.google.com/common/input-duration": "2h",
"<inspection-specific-field-id>": "<value>"

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

It would be better if we can show the example workable job command with the full parameter.
The current example lacks of many parameters and user need to find what are missing. It'll be nicer if we can list keys required for actually running the job mode. Values for the parameters can be placeholder then.

@kyasbal kyasbal added the documentation Improvements or additions to documentation label Jun 1, 2026
@Haihan-Jiang Haihan-Jiang force-pushed the codex/khi-document-job-mode branch from 41a81bf to 0c9b9a5 Compare June 3, 2026 00:34
@Haihan-Jiang

Copy link
Copy Markdown
Contributor Author

Thanks, I updated the job mode doc in two places:

  • added a practical way to build --job-inspection-values from the browser dev tools request payload for /run or /dryrun
  • expanded the GKE example to include concrete common field IDs such as project, location, cluster name, namespaces, and kinds

I kept the wording scoped because the exact required fields still depend on the selected inspection type and enabled features.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document KHI Job Mode

2 participants