{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-leader-election",
  "id": "leader-election",
  "kind": "mechanism",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-execution-core",
    "json": "https://banes-lab.com/json/records/layer/execution-core",
    "label": "Execution Core",
    "markdown": "https://banes-lab.com/records/layer/execution-core.md",
    "ref": "layer:execution-core"
  },
  "name": "Leader Election",
  "ref": "architecture:leader-election",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-consensus",
          "json": "https://banes-lab.com/json/records/architecture/consensus",
          "label": "Consensus",
          "markdown": "https://banes-lab.com/records/architecture/consensus.md",
          "ref": "architecture:consensus"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-control-plane",
          "json": "https://banes-lab.com/json/records/architecture/control-plane",
          "label": "Control Plane",
          "markdown": "https://banes-lab.com/records/architecture/control-plane.md",
          "ref": "architecture:control-plane"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-fault-tolerance",
          "json": "https://banes-lab.com/json/records/architecture/fault-tolerance",
          "label": "Fault Tolerance",
          "markdown": "https://banes-lab.com/records/architecture/fault-tolerance.md",
          "ref": "architecture:fault-tolerance"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-single-writer-coordination",
          "json": "https://banes-lab.com/json/records/lexicon/single-writer-coordination",
          "label": "Single-Writer Coordination",
          "markdown": "https://banes-lab.com/records/lexicon/single-writer-coordination.md",
          "ref": "lexicon:single-writer-coordination"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-automatic-failover-of-leadership",
          "json": "https://banes-lab.com/json/records/lexicon/automatic-failover-of-leadership",
          "label": "Automatic Failover of Leadership",
          "markdown": "https://banes-lab.com/records/lexicon/automatic-failover-of-leadership.md",
          "ref": "lexicon:automatic-failover-of-leadership"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-split-brain-coordination",
          "json": "https://banes-lab.com/json/records/lexicon/split-brain-coordination",
          "label": "Split-Brain Coordination",
          "markdown": "https://banes-lab.com/records/lexicon/split-brain-coordination.md",
          "ref": "lexicon:split-brain-coordination"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-availability",
          "json": "https://banes-lab.com/json/records/lexicon/availability",
          "label": "Availability",
          "markdown": "https://banes-lab.com/records/lexicon/availability.md",
          "ref": "lexicon:availability"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-availability-leader-election",
          "json": "https://banes-lab.com/json/records/tension/availability-leader-election",
          "label": "Leader Election / Availability",
          "markdown": "https://banes-lab.com/records/tension/availability-leader-election.md",
          "ref": "tension:availability-leader-election"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-split-brain-coordination",
          "json": "https://banes-lab.com/json/records/lexicon/split-brain-coordination",
          "label": "Split-Brain Coordination",
          "markdown": "https://banes-lab.com/records/lexicon/split-brain-coordination.md",
          "ref": "lexicon:split-brain-coordination"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-contextual",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-contextual",
          "label": "contextual",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-contextual.md",
          "ref": "vocabulary:severity-contextual"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-control-coordination-centralization",
          "json": "https://banes-lab.com/json/records/architecture-category/control-coordination-centralization",
          "label": "Control / Coordination / Centralization",
          "markdown": "https://banes-lab.com/records/architecture-category/control-coordination-centralization.md",
          "ref": "architecture-category:control-coordination-centralization"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-control-coordination-centralization",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-control-coordination-centralization",
          "label": "Control / Coordination / Centralization",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-control-coordination-centralization.md",
          "ref": "chapter:/ontology#architecture-category-control-coordination-centralization"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-error-handling-resilience",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-error-handling-resilience",
          "label": "Error Handling / Resilience",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-error-handling-resilience.md",
          "ref": "chapter:/ontology#architecture-category-error-handling-resilience"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-control-coordination-centralization",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-control-coordination-centralization",
          "label": "Control / Coordination / Centralization",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-control-coordination-centralization.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-control-coordination-centralization"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-quality-attributes",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-quality-attributes",
          "label": "Quality Attributes",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-quality-attributes.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-quality-attributes"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-vocabulary-severity",
          "json": "https://banes-lab.com/json/ontology/schema/the-vocabulary-severity",
          "label": "Severity levels",
          "markdown": "https://banes-lab.com/ontology/schema/the-vocabulary-severity.md",
          "ref": "chapter:/ontology/schema#the-vocabulary-severity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-resolutions",
          "json": "https://banes-lab.com/json/ontology/schema/the-resolutions",
          "label": "The resolutions",
          "markdown": "https://banes-lab.com/ontology/schema/the-resolutions.md",
          "ref": "chapter:/ontology/schema#the-resolutions"
        }
      ],
      "relation": "linked-from"
    }
  ],
  "summary": "A mechanism that lets a group of nodes agree on one coordinator and replace it when it fails.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-consensus",
      "json": "https://banes-lab.com/json/records/architecture/consensus",
      "label": "Consensus",
      "markdown": "https://banes-lab.com/records/architecture/consensus.md",
      "ref": "architecture:consensus"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-decentralization",
      "json": "https://banes-lab.com/json/records/architecture/decentralization",
      "label": "Decentralization",
      "markdown": "https://banes-lab.com/records/architecture/decentralization.md",
      "ref": "architecture:decentralization"
    }
  },
  "up": {
    "href": null,
    "json": "https://banes-lab.com/json/api/records/architecture",
    "label": "Architecture principles",
    "markdown": "https://banes-lab.com/api/records/architecture.md",
    "ref": "api:records/architecture"
  },
  "aliases": [],
  "exemplar": {
    "after": "const lease = await fooCoordinator.acquireLeadership(\"foo-scheduler\", { ttlMs: 10_000 });\nlease.onAcquired(() => runFooScheduler());\nlease.onLost(() => stopFooScheduler());",
    "before": "if (process.env.IS_LEADER === \"true\") runFooScheduler();",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "distributed system",
    "coordination",
    "availability"
  ],
  "severity": "contextual"
}
