Directories
¶
| Path | Synopsis |
|---|---|
|
Package appconfig parses the per-app zattera.toml (spec §4) into the proto shapes ApplyAppConfig consumes, and computes the deterministic config hash that identifies a release's effective configuration.
|
Package appconfig parses the per-app zattera.toml (spec §4) into the proto shapes ApplyAppConfig consumes, and computes the deterministic config hash that identifies a release's effective configuration. |
|
Package cli implements every user-facing command.
|
Package cli implements every user-facing command. |
|
cliconfig
Package cliconfig manages the CLI-side configuration (~/.config/zattera/config.toml): named contexts pointing at clusters, with tokens.
|
Package cliconfig manages the CLI-side configuration (~/.config/zattera/config.toml): named contexts pointing at clusters, with tokens. |
|
ui
Package ui centralizes CLI output: lipgloss styles, success/error lines in the Vercel-style format, tables, and a --json mode that suppresses all decoration.
|
Package ui centralizes CLI output: lipgloss styles, success/error lines in the Vercel-style format, tables, and a --json mode that suppresses all decoration. |
|
Package commands assembles the cobra command tree.
|
Package commands assembles the cobra command tree. |
|
Package config loads and validates the zatterad server configuration.
|
Package config loads and validates the zatterad server configuration. |
|
Package daemon is the node runtime: control plane and/or worker, selected by config roles.
|
Package daemon is the node runtime: control plane and/or worker, selected by config roles. |
|
agent
Package agent is the node-side runtime that keeps a node in sync with the control plane.
|
Package agent is the node-side runtime that keeps a node in sync with the control plane. |
|
api
Package api hosts the public control-plane API.
|
Package api hosts the public control-plane API. |
|
builder
Package builder builds container images from source using a managed buildkitd (spec §3.4).
|
Package builder builds container images from source using a managed buildkitd (spec §3.4). |
|
ca
Package ca implements the embedded cluster certificate authority.
|
Package ca implements the embedded cluster certificate authority. |
|
github
Package github implements push-to-deploy: a webhook endpoint that turns GitHub push events into builds, and GitHub App authentication for cloning private repos and posting commit statuses (spec F9, T-37).
|
Package github implements push-to-deploy: a webhook endpoint that turns GitHub push events into builds, and GitHub App authentication for cloning private repos and posting commit statuses (spec F9, T-37). |
|
intdns
Package intdns is the per-node internal DNS resolver (F26).
|
Package intdns is the per-node internal DNS resolver (F26). |
|
livestate
Package livestate holds the leader's in-memory view of connected nodes: presence, last heartbeat time and the most recent live sample.
|
Package livestate holds the leader's in-memory view of connected nodes: presence, last heartbeat time and the most recent live sample. |
|
logstore
Package logstore defines the per-node log storage contract (spec §3.10).
|
Package logstore defines the per-node log storage contract (spec §3.10). |
|
mesh
Package mesh owns the WireGuard overlay (ADR-0003).
|
Package mesh owns the WireGuard overlay (ADR-0003). |
|
nodeinfo
Package nodeinfo detects a node's static capacity (CPU / memory / disk) for registration in state.
|
Package nodeinfo detects a node's static capacity (CPU / memory / disk) for registration in state. |
|
proxy
Package proxy hosts the embedded L7/L4 proxy (tasks T-41..T-48).
|
Package proxy hosts the embedded L7/L4 proxy (tasks T-41..T-48). |
|
raftstore
Package raftstore wires hashicorp/raft to the in-memory state store (ADR-0004).
|
Package raftstore wires hashicorp/raft to the in-memory state store (ADR-0004). |
|
registry
Package registry implements Zattera's embedded OCI image registry (spec §3.5).
|
Package registry implements Zattera's embedded OCI image registry (spec §3.5). |
|
runtime
docker.go is the ONLY file permitted to import the Docker SDK (spec rule 3).
|
docker.go is the ONLY file permitted to import the Docker SDK (spec rule 3). |
|
scheduler
Package scheduler runs on the leader and reconciles desired replica counts into Assignments: it decides WHAT should run WHERE, writing only desired state (agents converge it, T-15).
|
Package scheduler runs on the leader and reconciles desired replica counts into Assignments: it decides WHAT should run WHERE, writing only desired state (agents converge it, T-15). |
|
secrets
Package secrets implements envelope encryption for cluster secrets (spec §3.13, design §2.10):
|
Package secrets implements envelope encryption for cluster secrets (spec §3.13, design §2.10): |
|
tlsmgr
Package tlsmgr manages TLS certificates for the ingress: ACME issuance via certmagic backed by the raft KV (cluster-wide, one issuer serialized by a distributed lock), and a dev mode that mints self-signed certs from the cluster CA on demand (T-44).
|
Package tlsmgr manages TLS certificates for the ingress: ACME issuance via certmagic backed by the raft KV (cluster-wide, one issuer serialized by a distributed lock), and a dev mode that mints self-signed certs from the cluster CA on demand (T-44). |
|
tsdb
Package tsdb defines the embedded time-series store contract (spec §3.10): per-series ring buffers, 15s raw resolution for 24h + 5m downsampled for 30d.
|
Package tsdb defines the embedded time-series store contract (spec §3.10): per-series ring buffers, 15s raw resolution for 24h + 5m downsampled for 30d. |
|
pkgutil
|
|
|
clock
Package clock abstracts time for testability.
|
Package clock abstracts time for testability. |
|
ids
Package ids generates the ULID identifiers used for every first-class object.
|
Package ids generates the ULID identifiers used for every first-class object. |
|
version
Package version carries the build version, stamped via -ldflags.
|
Package version carries the build version, stamped via -ldflags. |
|
Package state holds the full replicated cluster state in memory (ADR-0004).
|
Package state holds the full replicated cluster state in memory (ADR-0004). |
|
testutil
|
|
|
fakeruntime
Package fakeruntime is an in-memory ContainerRuntime for unit and simcluster tests.
|
Package fakeruntime is an in-memory ContainerRuntime for unit and simcluster tests. |
|
freeport
Package freeport hands out free TCP ports for tests.
|
Package freeport hands out free TCP ports for tests. |
|
simcluster
Package simcluster runs an in-process multi-node Zattera control plane for unit and chaos tests: real hashicorp/raft with in-memory transports, real FSM/state, fake container runtime, fake clock.
|
Package simcluster runs an in-process multi-node Zattera control plane for unit and chaos tests: real hashicorp/raft with in-memory transports, real FSM/state, fake container runtime, fake clock. |
Click to show internal directories.
Click to hide internal directories.