Skip to content

GB-068: the goatnet is not in its declared end state

Generated from ops/errors/catalog.yaml by ops/ci/check-error-catalog.py --write; do not edit here. GB-068 is printed by goatbuilder. The same text offline: goat explain GB-068 or goatbuilder explain GB-068.

What it means

endstate graded every service the site declares: present or absent, deployed (its ledger names the declared ref), active (every container running), healthy (its healthcheck or isitup probe), functional (the acceptance rows that exercise it), and its zero-trust edges (its served name resolves and its certificate verifies, its OIDC client is registered in Hydra, its SPIRE entry exists). At least one grade failed or could not be read, or something runs that the end state does not declare (an orphan).

Why it happens

  • a declared service is not running, or its ledger is pending, rolled back or at another ref
  • an edge is broken, such as an OIDC client never registered or a name that does not resolve
  • an orphan, such as a container left behind by a retired service, or a Hydra client or SPIRE entry no service declares
  • a grade could not be read, most often because a host was unreachable or the assay did not run

What to do

One line per step or alternative:

goatbuilder endstate <site> (each failing grade with its reason)
goatbuilder deploy --component <c> --env <goatnet> (restore a declared service)
goatbuilder endstate <site> --json (the grades as data)

Read more

Exit code

goatbuilder exits with 3.