Skip to content

Commit 31e60ab

Browse files
authored
Merge pull request #32 from replicatedhq/run
Updated README and krew manifest
2 parents 58b05dc + 2a29451 commit 31e60ab

File tree

2 files changed

+35
-11
lines changed

2 files changed

+35
-11
lines changed

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,22 @@
11
# Replicated Troubleshoot
22

3-
Replicated Troubleshoot is a CLI tool and a Kubernetes Operator that provides pre-installation cluster conformance testing and validation (preflight checks) and post-installation troubleshooting and diagnostics (support bundles).
3+
Replicated Troubleshoot is a CLI tool that provides pre-installation cluster conformance testing and validation (preflight checks) and post-installation troubleshooting and diagnostics (support bundles).
44

55
## Preflight Checks
66
Preflight checks are an easy-to-run set of conformance tests that can be written to verify that specific requirements in a cluster are met.
77

8-
To run a sample preflight check from a sample application, [install the preflight kubectl plugin](https://help.replicated.com/docs/troubleshoot/kubernetes/preflight/running-as-kubectl-plugin/) and run:
8+
To run a sample preflight check from a sample application, [install the preflight kubectl plugin](https://help.replicated.com/docs/troubleshoot/kubernetes/preflight/executing/) and run:
99

1010
```shell
1111
kubectl preflight https://preflight.replicated.com
1212
```
1313

14-
For a full description of the supported preflight checks, visit the [docs](https://help.replicated.com/docs/troubleshoot/kubernetes/analysis/analysis-phase/).
14+
For a full description of the supported preflight checks, visit the [docs](https://help.replicated.com/docs/troubleshoot/kubernetes/analysis/).
1515

1616
## Support Bundle
1717
A support bundle is an archive that's created in-cluster, by collecting logs, cluster information and executing various commands. After creating a support bundle, the cluster operator will normally deliver it to the application vendor for analysis and remote debugging.
1818

19-
To collect a sample support bundle, [install the troubleshoot kubectl plugin](/docs/troubleshoot/kubernetes/troubleshoot/running-as-kubectl-plugin/) and run:
19+
To collect a sample support bundle, [install the troubleshoot kubectl plugin](https://help.replicated.com/docs/troubleshoot/kubernetes/support-bundle/collecting/) and run:
2020

2121
```shell
2222
kubectl troubleshoot https://troubleshoot.replicated.com

deploy/krew/preflight.yaml

Lines changed: 31 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,8 @@ spec:
1313
sha256: "75f82c2b720b578cefe05afb50d2559a9f7eb2ed1860cb5c5cb30254878e161c"
1414
files:
1515
- from: "./preflight"
16-
to: "kubectl-preflight"
17-
bin: "kubectl-preflight"
16+
to: "."
17+
bin: "preflight"
1818
- selector:
1919
matchLabels:
2020
os: darwin
@@ -23,8 +23,8 @@ spec:
2323
sha256: "cc8ca71f31ec40796738a745794136b08fa3c224220040c8d413c76d70bc7bc5"
2424
files:
2525
- from: "./preflight"
26-
to: "kubectl-preflight"
27-
bin: "kubectl-preflight"
26+
to: "."
27+
bin: "preflight"
2828
- selector:
2929
matchLabels:
3030
os: windows
@@ -33,7 +33,31 @@ spec:
3333
sha256: "5d96a7b9abb3699fc495b8739519e7b608c1d42f8b22b1e6581b889de7376872"
3434
files:
3535
- from: "/preflight.exe"
36-
to: "kubectl-preflight.exe"
37-
bin: "kubectl-preflight.exe"
38-
shortDescription: Executes preflight tests and application conformance verifications on a cluster before installing an application
36+
to: "."
37+
bin: "preflight.exe"
38+
shortDescription: Executes application preflight tests in a cluster
3939
homepage: https://github.com/replicaetdhq/troubleshoot
40+
caveats: |
41+
Usage:
42+
$ kubectl preflight <URL>
43+
44+
Flags:
45+
-h, --help help for preflight
46+
--interactive interactive preflights (default true)
47+
--kubecontext string the kubecontext to use when connecting (default "~/.kube/config")
48+
--serviceaccount string name of the service account to use. if not provided, one will be created
49+
--format string output format, one of human, json, yaml. only used when interactive is set to false (default "human")
50+
51+
Documentation:
52+
https://help.replicated.com/docs/troubleshoot/kubernetes/preflight/overview/
53+
54+
description: |
55+
This plugin executes application-specific preflight checks and conformance tests against a cluster, prior to installation of an application.
56+
57+
Application developers can create and host a Preflight manifest that defines the minimum and desired Kubernetes environment
58+
for an application. Before installing the application, a cluster admin can use this plugin to execute the application preflight checks
59+
to identify any missing components, configuration or incompatibilities between the cluster and the desired environment.
60+
61+
When executing Preflight tests, the test results will be displayed in a terminal-based UI on the workstation that executed the command.
62+
63+
For information on creating a Preflight manifest, view the documentation at https://help.replicated.com/docs/troubleshoot/kubernetes/analysis/

0 commit comments

Comments
 (0)