Support Bundle for Appian on Kubernetes

Overview

Copy link to clipboard

The page details how to generate a support bundle for both the Appian operator and any sites managed by the operator. When possible, the decision to generate a support bundle should be made in consultation with Appian Support.

What is a support bundle?

Copy link to clipboard

A support bundle is an archive containing information gathered from a self-managed customer's Kubernetes cluster that can be analyzed to troubleshoot issues with either the Appian operator or sites in that cluster. The information collected and analyzed includes but is not limited to:

• Operator logs
• Site container logs that went to stdout
• ConfigMaps created and/or managed by the operator
• The existence of certain Secrets that are required by either the operator or sites
• Various cluster-level resources such as CustomResourceDefinitions, Namespaces, and ClusterRoles

Installing the support bundle plugin for kubectl

Copy link to clipboard

Generation of a support bundle is handled by a kubectl plugin. The plugin runs entirely on the client side, meaning nothing is installed to the Kubernetes cluster. This means the plugin must be installed by the user generating the support bundle.

Installing with Krew

Copy link to clipboard

The easiest way to install the plugin is via Krew. Start by installing Krew.

Once Krew has been installed you can install the support-bundle plugin:

1
kubectl krew install support-bundle
Copy

Installing the plugin directly

Copy link to clipboard

1. Download the plugin. Make sure you download the collect executable (not the preflight executable).

2. Unarchive the downloaded file and move it to somewhere on your PATH. The file must be named kubectl-support_bundle after being moved as well as being executable. For example, assuming $HOME/bin is on your PATH:

   1
   2
   3
   tar -xzvf collect_linux_arm64.tar.gz collect
   mv collect $HOME/bin/kubectl-support_bundle
   chmod 700 $HOME/bin/kubectl-support_bundle
   Copy

Generating a support bundle

Copy link to clipboard

Generating a support bundle for either the Appian operator or a site simply involves running the plugin.

Generating a support bundle for the Appian operator

Copy link to clipboard

Assuming you installed the operator to the appian-operator namespace:

1
kubectl support-bundle --namespace appian-operator --load-cluster-specs --output appian-operator-$(date +%Y%m%d%H%M%S)
Copy

This will generate a file named something similar to appian-operator-20230725120000.tar.gz.

Generating a support bundle for a site

Copy link to clipboard

The following example assumes your site is running in the namespace my-site-namespace. Adjust the --namespace flag to use your actual site namespace.

1
kubectl support-bundle --namespace my-site-namespace --load-cluster-specs --output my-site-$(date +%Y%m%d%H%M%S)
Copy

This will generate a file named something similar to my-site-20230725120000.tar.gz.

Data redaction for a support bundle

Copy link to clipboard

Some of the data collected by the support-bundle plugin is automatically redacted. Sensitive information like passwords will be redacted during generation of the support bundle.

Support bundle self-help

Copy link to clipboard

When a support bundle is generated some checks for common problems are run and the results are displayed. Depending on the issue you might be able to resolve it.

• Webhooks certificate issues: Refer to the documentation on certificates
• NetworkPolicy issues: Refer to the documentation on restricting traffic
• Issues with secrets: Ensure the secret exists and the configuration for the operator or the site is set to use the correct secret

Feedback

Copy link to clipboard