How talyguryn/konta works
Konta is a single-server GitOps tool for Docker Compose. A user bootstraps a repository and configuration, then runs or enables Konta; its runtime fetches repository changes, reconciles Compose projects, and records deployment state. Reconciliation also supports managed-service labels, rolling deployments, health checks, drift recovery, and lifecycle hooks. The README documents these capabilities, but the supplied excerpts do not expose every implementation detail, so uncertain connections are omitted.
Main entry points: cmd.go CLI commands · cmd_fetch.go Fetch workflow · reconcile.go Compose reconciliation · state.go Deployment state
Components 20
CLI and setup
- CLI entrypoint
cmd/konta/main.go - Command router
internal/app/app.go - CLI commands
internal/cmd/cmd.go - Bootstrap
internal/cmd/cmd_bootstrap.go - Daemon control
internal/cmd/daemon.go
Repository and config
- Configuration
internal/config/config.go - Git fetch and diff
internal/git/git.go - Native Git fallback
internal/git/git_native.go - Fetch workflow
internal/cmd/cmd_fetch.go
Deployment runtime
- Compose reconciliation
internal/reconcile/reconcile.go - Docker command helper
internal/dockerutil/dockerutil.go - Deployment state
internal/state/state.go - Lifecycle hooks
internal/hooks/hooks.go
Operations and integrations
- GitHub deployment status
internal/githubdeploy/githubdeploy.go - Container garbage collection
internal/cmd/cmd_gc.go - Status and projects
internal/cmd/cmd_status.go - Konta updates
internal/cmd/cmd_update.go - Platform service manager
internal/platform/service/manager.go
Other components
- Server operator
- Docker Compose runtime
Connections 24
- Server operator → CLI entrypoint: runs
README.md - CLI entrypoint → Command router: starts
cmd/konta/main.go - Command router → CLI commands: dispatches
internal/app/app.go - CLI commands → Bootstrap: invokes
internal/cmd/cmd.go - CLI commands → Fetch workflow: runs
- CLI commands → Daemon control: manages
- Bootstrap → Configuration: saves
internal/cmd/cmd_bootstrap.go - Bootstrap → Deployment state: initializes
internal/cmd/cmd_bootstrap.go - Fetch workflow → Git fetch and diff: fetches
internal/cmd/cmd_fetch.go - Fetch workflow → Compose reconciliation: creates reconciler
internal/cmd/cmd_fetch.go - Fetch workflow → Deployment state: loads state
internal/cmd/cmd_fetch.go - Compose reconciliation → Docker command helper: creates client
internal/reconcile/reconcile.go - Docker command helper → Docker Compose runtime: runs commands
- Compose reconciliation → Deployment state: persists networks
internal/reconcile/reconcile.go - Compose reconciliation → Lifecycle hooks: runs drift hooks
internal/reconcile/reconcile.go - Git fetch and diff → Native Git fallback: fallback diff
internal/git/git.go - CLI commands → GitHub deployment status: reports deployment
- CLI commands → Lifecycle hooks: runs deploy hooks
internal/cmd/cmd.go - CLI commands → Container garbage collection: dispatches
- CLI commands → Status and projects: dispatches
- CLI commands → Konta updates: checks updates
internal/cmd/cmd.go - Daemon control → Platform service manager: controls service
internal/cmd/daemon.go - Status and projects → Deployment state: reads state
internal/cmd/cmd_status.go - Konta updates → Lifecycle hooks: runs post-update
internal/cmd/cmd_update.go