Get started with Preflight Checks and Support Bundles
Welcome. The easiest way to get started with the Troubleshoot project is to see it in action through a couple examples.
Executing Preflight Checks and Support Bundles relies on a client-side utility, packaged as a
kubectl plugin and distributed through the krew package manager.
If you don't already have krew installed, head over to the krew installation guide, follow the steps there and then come back here.
Install the Preflight and Support Bundle plugin using:
kubectl krew install preflight kubectl krew install support-bundle
Note: This will not install anything to your cluster, it only places a single binary per plugin in your path.
Now that you have the plugins installed lets look at a simple example of a Preflight Check and a Support Bundle to get a sense for how they are structured and how to run them.
Example Preflight check
Preflight Checks can be executed before installing an application into a Kubernetes cluster. The checks are defined in a YAML file. Run the following command on your cluster to see an example Preflight Check.
kubectl preflight https://preflight.replicated.com
Example Support Bundle
A Support Bundle needs to know what to collect and optionally, what to analyze. This is defined in a YAML file. There's a lot already included in the default collectors. Run the following command on your cluster to see an example Support Bundle.
kubectl support-bundle https://support-bundle.replicated.com
Create your own
Learn how to add custom preflight checks and support bundles to your application.
Looking for something specific or a place to start? Browse through some examples.
Read the docs
Ready to dig to the reference docs?