Skip to content

docs: expand local debugging guidance in DEVELOPMENT.md - #929

Closed
amarkdotdev wants to merge 1 commit into
fluxcd:mainfrom
amarkdotdev:docs/245-local-debugging
Closed

amarkdotdev wants to merge 1 commit into
fluxcd:mainfrom
amarkdotdev:docs/245-local-debugging

Conversation

@amarkdotdev

Copy link
Copy Markdown

Summary

  • Expand DEVELOPMENT.md with a practical local-debugging guide: scale down the in-cluster Deployment, suspend unrelated ImageRepository/ImagePolicy objects, raise log verbosity (keeping --storage-path=./data), exercise a minimal object pair, document cross-controller interaction with image-automation-controller, and attach VS Code.
  • Document the local listen addresses used by make run.
  • Explicitly avoid the incorrect RUNTIME_NAMESPACE / --concurrent=1 advice from closed docs: add debugging tips to DEVELOPMENT.md #881; explain why keeping --watch-all-namespaces (default) is preferred when reproducing cross-namespace behaviour.

Fixes #245

Test plan

  • Read the new section for accuracy against main.go flags and make run
  • Confirm flux suspend image-repository|image-policy --all command names
  • DCO Signed-off-by present on the commit

Document practical local debugging for image-reflector-controller without
the incorrect RUNTIME_NAMESPACE / --concurrent tips from closed fluxcd#881.

Signed-off-by: amarkdotdev <amarkdotdev@users.noreply.github.com>
@amarkdotdev
amarkdotdev force-pushed the docs/245-local-debugging branch from 563bda4 to e26fa81 Compare September 4, 2026 08:37
@amarkdotdev

Copy link
Copy Markdown
Author

Friendly reminder for a review when bandwidth allows.

@amarkdotdev amarkdotdev closed this Sep 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improve documentation on debugging the controller locally

1 participant