Skip to content

Commit

Permalink
Merge pull request #32 from replicatedhq/run
Browse files Browse the repository at this point in the history
Updated README and krew manifest
  • Loading branch information
marccampbell authored Jul 29, 2019
2 parents 58b05dc + 2a29451 commit 31e60ab
Show file tree
Hide file tree
Showing 2 changed files with 35 additions and 11 deletions.
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@
# Replicated Troubleshoot

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).
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).

## Preflight Checks
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.

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:
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:

```shell
kubectl preflight https://preflight.replicated.com
```

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

## Support Bundle
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.

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

```shell
kubectl troubleshoot https://troubleshoot.replicated.com
Expand Down
38 changes: 31 additions & 7 deletions deploy/krew/preflight.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@ spec:
sha256: "75f82c2b720b578cefe05afb50d2559a9f7eb2ed1860cb5c5cb30254878e161c"
files:
- from: "./preflight"
to: "kubectl-preflight"
bin: "kubectl-preflight"
to: "."
bin: "preflight"
- selector:
matchLabels:
os: darwin
Expand All @@ -23,8 +23,8 @@ spec:
sha256: "cc8ca71f31ec40796738a745794136b08fa3c224220040c8d413c76d70bc7bc5"
files:
- from: "./preflight"
to: "kubectl-preflight"
bin: "kubectl-preflight"
to: "."
bin: "preflight"
- selector:
matchLabels:
os: windows
Expand All @@ -33,7 +33,31 @@ spec:
sha256: "5d96a7b9abb3699fc495b8739519e7b608c1d42f8b22b1e6581b889de7376872"
files:
- from: "/preflight.exe"
to: "kubectl-preflight.exe"
bin: "kubectl-preflight.exe"
shortDescription: Executes preflight tests and application conformance verifications on a cluster before installing an application
to: "."
bin: "preflight.exe"
shortDescription: Executes application preflight tests in a cluster
homepage: https://github.com/replicaetdhq/troubleshoot
caveats: |
Usage:
$ kubectl preflight <URL>
Flags:
-h, --help help for preflight
--interactive interactive preflights (default true)
--kubecontext string the kubecontext to use when connecting (default "~/.kube/config")
--serviceaccount string name of the service account to use. if not provided, one will be created
--format string output format, one of human, json, yaml. only used when interactive is set to false (default "human")
Documentation:
https://help.replicated.com/docs/troubleshoot/kubernetes/preflight/overview/
description: |
This plugin executes application-specific preflight checks and conformance tests against a cluster, prior to installation of an application.
Application developers can create and host a Preflight manifest that defines the minimum and desired Kubernetes environment
for an application. Before installing the application, a cluster admin can use this plugin to execute the application preflight checks
to identify any missing components, configuration or incompatibilities between the cluster and the desired environment.
When executing Preflight tests, the test results will be displayed in a terminal-based UI on the workstation that executed the command.
For information on creating a Preflight manifest, view the documentation at https://help.replicated.com/docs/troubleshoot/kubernetes/analysis/

0 comments on commit 31e60ab

Please sign in to comment.