KOTS: How can i generate a support bundle if i cannot access the admin console?

#1

On an embedded KURL cluster installing the KOTS admin console or uploading the app may fail. In this case it may not be possible to access the admin console to generate a support bundle.

It is possible to generate a support bundle using the default kots.io spec by running the following command:

kubectl support-bundle https://kots.io

On an airgapped/airgap server it is possible to copy the default kots.io spec using this command:

curl -o spec.yaml https://kots.io -H 'User-agent:Replicated_Troubleshoot/v1beta1'

The spec can then be uploaded to the server and the local spec can be used by running:

kubectl support-bundle /path/to/spec.yaml

If the admin console is running and the app is installed you can use:

kubectl support-bundle http://<server-address>:8800/api/v1/troubleshoot/<app-slug>

If the app is not installed but the admin console is running:

kubectl support-bundle http://<server-address>:8800/api/v1/troubleshoot

If you do not already have the support-bundle kubectl plugin installed, it can be installed by running:

curl https://krew.sh/support-bundle | bash

Or by installing krew and running:

kubectl krew install support-bundle
#2

When running the support-bundle command kubectl support-bundle in a KURL cluster, it is possible to receive the error unknown command ""support-bundle" for "kubectl".

The support bundle binary is located at /usr/local/bin/kubectl-support_bundle and can be substituted in all of the above commands for kubectl support-bundle.

For example:

/usr/local/bin/kubectl-support_bundle /path/to/spec.yaml