tektoncd/pipeline

Missing self-contained JSON Schema for Tekton resource validation

オープン

#8,983 opened on 2025/08/20

 (6 件のコメント) (0 件のリアクション) (1 人の担当者)Go (1,943 件のフォーク)auto 404
help wanted

Repository metrics

Stars
 (9,013 個のスター)
PR merge metrics
 (PR metrics pending)

説明

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.

コントリビューターガイド