Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Epic] Consolidated CLI for Troubleshoot #933

Closed
9 of 19 tasks
xavpaice opened this issue Dec 29, 2022 · 0 comments
Closed
9 of 19 tasks

[Epic] Consolidated CLI for Troubleshoot #933

xavpaice opened this issue Dec 29, 2022 · 0 comments
Labels

Comments

@xavpaice
Copy link
Member

xavpaice commented Dec 29, 2022

Goal

The current Troubleshoot project ships command line tools for support-bundle, preflight, analyze and collect. These have a large amount of common functionality with code duplication, plus inconsistent command line switches and syntax.

The proposal is to create a single CLI tool with subcommands for each function, which can be implemented using Krew, to simplify usage and maintenance of the project.

Additionally, the consolidate of sbctl in #882 adds the need for a CLI tool to initiate sbctl, which would end up as a subcommand.

An additional, but no less important, part of this is that the way other projects including KOTS and kURL import Troubleshoot is not using a stable public API, resulting in risk of breaking changes and additional complexity when working within the Troubleshoot code. A consolidated CLI would be a good starting point to arrange for a stable public API which other projects can use long term.

Design Proposal

Private: working backwards doc

Definition of done

  • One CLI entrypoint with subcommands for support-bundle, collect, analyze, redact, preflight and sbctl
  • All CLI subcommands call a stable public API which is also available for other projects to import
  • Documentation of the consolidated CLI in all necessary documentation pages #1251
  • Docs/examples in docs.replicated.com are updated with the new CLI
  • Ensure KOTS, Vendor Portal and any other project we discover uses the new API
  • Vendor portal provides instructions using the new CLI

Subtasks

Started

  • [ ]

Planned

  • [ ]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
Status: Done
Development

No branches or pull requests

1 participant