tektoncd / tektoncd/cli

Dry-run and validation for mutating operations

Open
#2,860 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

kind/feature
Dominant language
Go
Stars
461
Forks
277
Avg merge
16h 48m
Merged PRs (30d)
95

Description

Summary

Agents should be able to preview the effect of mutating operations before executing them. A --dry-run flag on all mutating commands enables agents to validate actions and present them to users for confirmation.

Proposal

  • Add --dry-run flag to all mutating operations (create, delete, start)
  • Perform local validation before Kubernetes API calls
  • Return would-be changes in structured JSON format
  • Enable agents to preview actions before execution

Acceptance Criteria

  • --dry-run flag available on all mutating commands
  • Dry-run performs local validation and reports errors
  • Output shows what would happen in structured JSON (when --output json is used)
  • No actual Kubernetes API mutations occur during dry-run

Context

Part of #2849 — making tkn agent-friendly.

Note: Kubernetes already supports server-side dry-run (--dry-run=server). This may leverage that mechanism where applicable, but should also cover tkn-specific validation (e.g., parameter completeness for tkn pipeline start).

/kind feature

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the implementations and tests for the create, delete, and start commands, then trace how they validate inputs and call the Kubernetes API. Define the shared dry-run behavior and verify that local validation, structured JSON output, and zero mutating API calls meet the acceptance criteria.

Written by the indexing model from the issue text.

Assessment

Tech stack
go, kubernetes
Domain
cli, devops
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.