How release-argus/argus works
Argus monitors configured software sources for version changes, tracks latest and deployed versions, and can notify recipients or invoke webhooks and commands. Its main user-facing workflow is configuring services, reviewing approvals in the web UI, and responding to detected changes. The Go runtime also provides authentication/RBAC, persistence, WebSockets, and Prometheus metrics. The graph combines documented capabilities with relationships visible in the supplied excerpts and SOURCE INDEX; unsampled implementation details are omitted or shown only where documented.
Main entry points: status.go Service tracking · main.go Application runtime · servicemap.go Latest version lookup · http-api-service.go HTTP API
Components 26
Runtime and configuration
- Application runtime
cmd/argus/main.go - Configuration
config/settings.go - SQLite persistence
db/handlers.go - Logging
internal/logx/log.go
Release monitoring
- Service tracking
service/status/status.go - Latest version lookup
service/latest_version/servicemap.go - GitHub releases
service/latest_version/types/github/query.go - Forgejo releases
service/latest_version/types/forgejo/query.go - Custom URL lookup
service/latest_version/types/web/query.go - Deployed version lookup
service/deployed_version/servicemap.go - Manual version
service/deployed_version/types/manual/query.go - URL version
service/deployed_version/types/web/query.go
Change actions
- Change handling
service/handlers.go - Notifications
notify/shoutrrr/verify.go - Webhooks
webhook/send.go - Commands
command/init.go
Web application
- Web server
web/web.go - HTTP API
web/api/v1/http-api-service.go - React interface
web/ui/react-app/src/App.tsx - WebSocket updates
web/api/v1/websocket-client.go - Prometheus metrics
web/metric/prometheus.go
Identity and access
- Authentication and RBAC
auth/auth.go - Session management
auth/session/session.go
Other components
- Operator
- Release sources
- Notification recipients
Connections 30
- Operator → React interface: configures and reviews
README.md - Application runtime → Configuration: loads
cmd/argus/main.go - Application runtime → SQLite persistence: initializes
cmd/argus/main.go - Application runtime → Web server: starts
cmd/argus/main.go - Application runtime → Service tracking: starts tracking
cmd/argus/main.go - Service tracking → Latest version lookup: queries
- Latest version lookup → GitHub releases: dispatches
service/latest_version/servicemap.go - Latest version lookup → Forgejo releases: dispatches
service/latest_version/servicemap.go - Latest version lookup → Custom URL lookup: dispatches
service/latest_version/servicemap.go - GitHub releases → Release sources: requests releases
service/latest_version/types/github/query.go - Forgejo releases → Release sources: requests releases
service/latest_version/types/forgejo/query.go - Custom URL lookup → Release sources: requests URL
service/latest_version/types/web/query.go - Service tracking → Deployed version lookup: tracks deployed version
- Deployed version lookup → Manual version: dispatches
service/deployed_version/servicemap.go - Deployed version lookup → URL version: dispatches
service/deployed_version/servicemap.go - Manual version → SQLite persistence: persists changes
- Service tracking → SQLite persistence: records status
service/status/status.go - Service tracking → Prometheus metrics: provides status
service/status/status.go - Change handling → Notifications: sends
service/handlers.go - Change handling → Webhooks: sends
service/handlers.go - Change handling → Commands: executes
service/handlers.go - Notifications → Notification recipients: notifies
README.md - Webhooks → Notification recipients: posts changes
README.md - Web server → HTTP API: routes requests
web/web.go - HTTP API → React interface: serves interface
- HTTP API → Authentication and RBAC: authorizes
- Authentication and RBAC → Session management: manages sessions
auth/auth.go - React interface → HTTP API: calls
- WebSocket updates → React interface: pushes updates
- Prometheus metrics → Operator: exposes metrics