Skip to content

Missing self-contained JSON Schema for Tekton resource validation #8983

@anithapriyanatarajan

Description

@anithapriyanatarajan

Issue Summary

No reliable JSON to validate tekton resources.

Tekton currently includes a swagger.json in the pipeline repo, but it is not self-contained (depends on external Kubernetes schemas).

There is no JSON schema published to JSON Schema Store and existing IDE plugins (like vscode-tekton) only support a subset of CRDs
This makes it hard for users to get YAML validation for Tekton resources (Pipeline, Task, PipelineRun, TaskRun, StepAction, CustomRun, etc.) in editors like VS Code.

What needs to be done possibly

  • Generate a bundled JSON schema from Tekton CRDs (resolve all external references so it’s self-contained).
  • Publish the schema files per release in the Tekton repo (e.g. schema/v1/pipeline.json).
  • Provide a stable URL for each version (e.g. https://tekton.dev/schema/v1/pipeline.json).
  • (Optional) Contribute the Tekton schema to schemastore.org, so IDEs auto-detect Tekton YAML.

Acceptance Criteria

  • Users can configure VS Code with yaml.schemas pointing to Tekton’s published JSON schema.
  • Schema covers all supported CRDs in v1.
  • Schema is versioned alongside Tekton releases.

Why this helps

Gives Tekton users native IDE validation without runtime trial/error.
Improves developer experience and reduces YAML misconfiguration errors.
Creates a single authoritative schema for use in IDEs.

Metadata

Metadata

Assignees

Labels

good first issueDenotes an issue ready for a new contributor, according to the "help wanted" guidelines.

Type

No type

Projects

Status

Todo

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions