Skip to content

feat: add new commands for completion and migration in pipectl#6751

Open
vedantlavale wants to merge 1 commit intopipe-cd:masterfrom
vedantlavale:fix-pipectl-cli-docs
Open

feat: add new commands for completion and migration in pipectl#6751
vedantlavale wants to merge 1 commit intopipe-cd:masterfrom
vedantlavale:fix-pipectl-cli-docs

Conversation

@vedantlavale
Copy link
Copy Markdown

Summary

Updates the pipectl CLI documentation in docs-dev and docs-v1.0.x to match the current source code.

Changes

  • Removes pipectl init from the "Available Commands" help output (command was removed in Remove pipectl init command #5958)
  • Adds completion, migrate, and plugin to the "Available Commands" help output
  • Removes the "Generating an application config" section documenting the removed pipectl init command
  • Adds a new "Migrating application configs and database" section documenting:
    • pipectl migrate application-config
    • pipectl migrate database
  • Adds a new "Pushing a plugin" section documenting pipectl plugin push

Why we need it

pipectl init was removed from the codebase but is still documented as an available command. Users following the official documentation currently hit a dead end.

At the same time, pipectl migrate (the replacement workflow) and pipectl plugin push already exist in the source code but are undocumented, making them difficult for users and plugin authors to discover.

Which issue(s) this PR fixes

Closes: #6750

Does this PR introduce a user-facing change?

How are users affected by this change

CLI documentation now accurately reflects the currently available commands. Users can discover and use pipectl migrate and pipectl plugin push through the official docs.

Is this a breaking change?

No

How to migrate (if breaking change)

N/A

Signed-off-by: vedantlavale <vedantlavale@gmail.com>
Copilot AI review requested due to automatic review settings May 8, 2026 10:51
@vedantlavale vedantlavale requested review from a team as code owners May 8, 2026 10:51
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Updates the pipectl CLI user guide docs to reflect current commands, removing references to the deprecated init workflow and documenting newer migrate and plugin functionality.

Changes:

  • Updates “Available Commands” to remove init and add completion, migrate, and plugin
  • Replaces the removed pipectl init documentation with pipectl migrate documentation (application-config + database)
  • Adds documentation for pipectl plugin push

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.

File Description
docs/content/en/docs-v1.0.x/user-guide/command-line-tool.md Updates the documented CLI help output to match current commands
docs/content/en/docs-dev/user-guide/command-line-tool.md Updates command list and replaces init docs with migrate and plugin push documentation


Available Commands:
application Manage application resources.
completion Generate the autocompletion script for the specified shell

Available Commands:
application Manage application resources.
completion Generate the autocompletion script for the specified shell
@@ -357,37 +359,54 @@ You can encrypt it the same way you do [from the web](../managing-application/se

Note: The docs for pipectl available command is maybe outdated, we suggest users use the `help` command for the updated usage while using pipectl.
### Generating an application config (app.pipecd.yaml)
### Migrating application configs and database

Migrate v0 application configs and database records to be compatible with the plugin-based pipedv1.

#### Migrating database

Migrate database records to be compatible with plugin-architectured piped:
@vedantlavale
Copy link
Copy Markdown
Author

@khanhtc1202 , @rahulshendre , @Ayushmore1214 hey, could someone take a look at this when free?
fixed some outdated pipectl docs and added docs for a couple missing commands

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Command-line tool: pipectl CLI docs reference removed pipectl init command, missing migrate and plugin

2 participants