Troubleshooting Gofer
This page provides various tips on how to troubleshoot and find issues/errors within Gofer.
Debugging extensions
Extensions are simply long running containers that internally wait for an event to happen and then communicate with Gofer it's API.
There are two main avenues to debug extensions:
gofer extension logs <id>
will stream an extension's logs.- Each extension has a
/api/debug
endpoint that dumps debug information about that extension.
Debugging Tasks
When tasks aren't working quite right, it helps to have some simple tasks that you can use to debug. Gofer provides a few of these to aid in debugging.
Name | Image | Description |
---|---|---|
envs | ghcr.io/clintjedwards/gofer/debug/envs | Simply prints out all environment variables found |
fail | ghcr.io/clintjedwards/gofer/debug/fail | Purposely exist with a non-zero exit code. Useful for testing that pipeline failures or alerting works correctly. |
log | ghcr.io/clintjedwards/gofer/debug/log | Prints a couple paragraphs of log lines with 1 second in-between, useful as a container that takes a while to finish and testing that log following is working correctly |
wait | ghcr.io/clintjedwards/gofer/debug/wait | Wait a specified amount of time and then successfully exits. |