openshift-must-gather is a tool for collecting cluster data.
It dumps clusteroperator data, and associated namespace data, into a specified --base-dir location.
The directory structure, as well as specific details behind this tool can be found in this enhancement.
Data collection scripts are kept in ./collection-scripts. The content of that folder is placed in /usr/bin in the image.
The data collection scripts should only include collection logic for components that are included as part of the OpenShift
CVO payload. Outside components are encouraged to produce a similar "must-gather" image, but this is not the spot to be
included.
You can run must-gather on a cluster with oc adm must-gather.
Use -h flag to see available options.
Build a new must-gather image with your changes using the Makefile. There are two options in the Makefile, make will use imagebuilder to build the image while make BUILDER=podman will use podman to build the image.
If using make BUILDER=podman, please set the AUTH_FILE parameter pointing to an authentication file that has credentials for the registry.ci.openshift.org registry. Ensure that you are connected to the VPN before building the image.
make BUILDER=podman AUTH_FILE=/path/to/authfile
Once the image is built, push it to a registry where it can be accessed from.
podman push [built-image] [registry/username/your-built-image]
To test your new changes with a cluster, run the following:
oc adm must-gather --image=registry/username/your-built-image
There is a dedicated effort to obfuscate and omit confidential information. Head over to openshift/must-gather-clean for more information.