Troubleshooting Renders

Start Narrow

drydock get apps --path .
drydock test apps --path .
drydock diag --path .

get apps checks discovery. test apps checks render health without manifest output. diag reports repository and settings diagnostics without rendering every Application; add --render when the diagnostic report needs render-backed diagnostics.

Isolate One Application

drydock test app argocd/my-app --path .
drydock build app argocd/my-app --path .

Use NAMESPACE/NAME when names are reused across namespaces.

Check Source Access

drydock test apps --path . --offline
drydock diag --path . --cache-events -o json

If offline mode fails, add repo maps or populate caches before expecting cache-only CI runs to pass.

Check Plugins

drydock test apps --path .
drydock test apps --path . --plugin-policy-ref main --enable-plugins

Run without plugin execution first. Add trusted plugin policy flags only when the failing source requires them.

Remove Diff Noise

drydock diff apps --repo . --ref HEAD --ref-orig main --show-ignored-fields
drydock diff apps --repo . --ref HEAD --ref-orig main --strip-attr checksum/config

Use --show-ignored-fields to inspect default ignored fields, and --strip-attr for extra label or annotation noise.

For symptom-based routing, see Troubleshooting . For full command behavior, see the usage guide .