synckit

synckit

Shared deploy/update spine for sync servers — Discord bot (/verify, /updateserver), a declarative deploy-agent, Discord OAuth, generic Postgres plumbing, and a stable HTTP contract. Consumed by EggLedger and EggIncognito sync servers.

Consume it (Go)

import (
	"log"
	"os"

	synckit "github.com/DavidArthurCole/synckit"
	"github.com/DavidArthurCole/synckit/contract"
)

func main() {
	err := synckit.Run(synckit.AppProfile{
		Name: "EggLedger",
		RepoURL: "https://github.com/DavidArthurCole/EggLedgerSyncServer",
		Discord: synckit.DiscordConfig{
			Token: os.Getenv("DISCORD_BOT_TOKEN"),
			AppID: os.Getenv("DISCORD_CLIENT_ID"),
			GuildID: os.Getenv("DISCORD_GUILD_ID"),
		},
		Build: contract.VerifyInfo{SHA256: BuildSHA256, Version: BuildVersion, Date: BuildDate},
		DeployAgent: synckit.AgentRef{
			URL: os.Getenv("DEPLOY_AGENT_URL"),
			Secret: os.Getenv("DEPLOY_AGENT_SECRET"),
		},
	})
	if err != nil {
		log.Fatal(err)
	}
}

Build-info vars (BuildSHA256/BuildVersion/BuildDate) are injected by the consumer via -ldflags "-X main.BuildVersion=...".

AppProfile fields: Name, RepoURL, Discord, Build, DeployAgent, DB (nil = run DB-free), Commands (app-specific slash commands), Events (inbound hooks), Mux (bring your own — app routes; nil = synckit creates one).

Deploy-agent

A host-side binary (needs docker + git) that runs a declarative pipeline on POST. Define deploy-agent.yaml:

repo: /home/david/repos/EggLedgerSyncServer
steps:
  - git-pull
  - docker-build: { tag: ledgersyncserver:latest }
  - container-recreate: { name: ledgersync }
  - webhook: { url_env: PORTAINER_WEBHOOK_URL }

Step types: git-pull, docker-build, container-recreate, webhook, shell. git-pull records from/to short hashes and short-circuits on "Already up to date." shell runs arbitrary commands — yaml is trusted operator input. A consumer parses this with agent.ParseConfig, builds an agent.Executor, and serves it via agent.NewHandler(secret, exec.Run).

Frame host setup

The sync server runs in a container; the deploy-agent runs on the host under systemd (it needs the docker socket + git). To register it:

cd deploy
cp install.sh.tmpl install.sh   # edit the vars at the top
bash install.sh

This writes /etc/synckit/<app>.env, installs synckit-agent-<app>.service, runs daemon-reload, and enables + starts it. The bot's /updateserver then POSTs to the agent, which pulls/builds/recreates and pings the Portainer webhook.

HTTP contract

The contract package holds frozen JSON types shared with non-Go consumers (the .NET app, the device farm): DeployResponse, VerifyInfo, NewVersionEvent. The device farm POSTs NewVersionEvent to /events/new-version (bearer-authed via EventHandlers.EventSecret) when it detects a new game version; the consumer's Events.NewVersion handler then drives generate-and-deploy.

Packages