Copy Files and Folders

The copy collector copies files and folders out of pods.

The ability to copy folders was introduced in Kots 1.19.0 and Troubleshoot 0.9.42.

The copy collector can be used to copy files or an entire folder from pods and include the contents in the collected data. This collector can be included multiple times to copy different files or folders from different pods.


In addition to the shared collector properties, the copy collector accepts the following parameters:

selector (Required)

The selector to use to locate the pod when copying files. If this selector matches more than 1 pod replica, the files will be copied out of each replica that matches the selector.

namespace (Optional)

The namespace to look for the selector in. This is optional, and if not provided will default to the current namespace from the context.

containerPath (Required)

The path in the container of the file(s) to copy. This supports glob syntax but can only support copying a single file. All glob patterns should match exactly one file.

containerName (Optional)

When specified, this will collect files from the requested container name. For single container pods, this is not required. If a pod has multiple containers and this parameter is not provided, the files will be copied from the first container in pod that matches the selector.

extractArchive (Optional)

By default the archive will not be extracted. Set to true to extract.

Example Collector Definition

apiVersion: troubleshoot.sh/v1beta2
kind: SupportBundle
  name: sample
  #Copies resolv.conf file
    - copy:
          - app=api
        namespace: default
        containerPath: /etc/resolv.conf
        containerName: api
  #Copies htdocs folder
    - copy:
          - app=myhttpd
        namespace: default
        containerPath: /usr/local/apache2/htdocs

Included resources

When this collector is executed, it will include the following files in a support bundle:


This will contain the pod's folder or file specified in the collector

Edit on GitHub