health.ready

Může tento proces obsluhovat provoz: registr a index, které sestavil při startu, už rezidentní, a jak se vrstva četla. Jen lokální inicializace — nikdy externí provider, databáze nebo jiná služba, protože kontrola připravenosti, která sonduje závislost, shodí nasazení kvůli něčemu, co není tento proces.

query
behaviorally_verified
module health
#health
#deployment

Zpřístupnění

Kde je tato jedna definice dosažitelná. Absence je explicitní: povrch, který není uveden, ji nenese.

povrch	jako
MCP	—
HTTP	GET /api/v1/ready operationId health.ready
příkazová řádka	—

Schémata

Kanonický vstup a výstup z typů Rustu; schéma nástroje MCP a parametry a odpovědi OpenAPI se odvozují z nich.

vstup · Prázdné

Žádný vstup.

Žádné vlastnosti: schopnost nebere žádný vstup.

JSON Schema

{
  "additionalProperties": false,
  "description": "No input.",
  "title": "Empty",
  "type": "object"
}

výstup · Readiness

Odpověď na otázku „může tento proces obsluhovat provoz“: lokální inicializace, kterou by požadavek potřeboval, a nic nad rámec tohoto procesu. Kontrola připravenosti, které narostla sonda závislostí, shodí nasazení kvůli tomu, že nefunguje nesouvisející služba.

vlastnost	typ	povinné	popis
capabilities	integer	ano	Kolik schopností registr drží; nula by znamenala, že není co servírovat.
commit	string	ano	Commit, z něhož byl tento spustitelný soubor sestaven, nebo `unknown`; tutéž hodnotu vrací `health.live`.
špinavé	boolean \| null	ne	Zda byl strom buildu špinavý; `null`, když to build nevěděl.
vrstva	reference	ano	Zda se vrstva četla čistě. Degradovaná vrstva se přesto obsluhuje — diagnostika je smyslem — takže toto hlásí, neodmítá.
objekty	integer	ano	Kolik objektů index drží. Čteno z indexu, který tento proces sestavil při startu: už je v paměti a jeho čtení nic neprochází.
připraveno	boolean	ano	Zda je každá část níže na místě.
důvody	array	ne	Každý důvod, proč tato odpověď není prosté ano, jako `code: words`. `lease_lost` a `stale` činí `ready` nepravdivým: jiný proces drží lease tohoto checkoutu, nebo tento obsluhuje kód, který už neexistuje. `layer_degraded` ho nepravdivým nečiní: vrstva se servíruje se svou diagnostikou a klient rozhodne, zda to stačí.
zastaralé	string \| null	ne	Proč tento proces obsluhuje kód, který už na disku není: spustitelný soubor, z něhož byl spuštěn, byl od té doby nahrazen nebo odstraněn. Je-li přítomno, `ready` je nepravda — server odpovídající včerejším kódem to říká na místě, kde říká, že je připraven, klientovi, který nedrží nic než tuto odpověď (I1502).
verze	string	ano	Verze tohoto spustitelného souboru.

JSON Schema

{
  "$defs": {
    "HealthStatus": {
      "description": "Where one dimension of the system stands. Ordered by severity, so the worst check\ndecides the whole.",
      "oneOf": [
        {
          "const": "ok",
          "description": "The engine that decides this dimension is satisfied.",
          "type": "string"
        },
        {
          "const": "warn",
          "description": "Nothing is broken and something is worth looking at.",
          "type": "string"
        },
        {
          "const": "fail",
          "description": "The engine that decides this dimension is not satisfied.",
          "type": "string"
        },
        {
          "const": "unknown",
          "description": "This process cannot decide it, and says so rather than reporting `ok`.",
          "type": "string"
        }
      ]
    }
  },
  "description": "The answer to \"can this process serve traffic\": the local initialisation a request\nwould need, and nothing beyond this process. A readiness check that grew a dependency\nprobe fails a deployment because an unrelated service is down.",
  "properties": {
    "capabilities": {
      "description": "How many capabilities the registry holds; zero would mean nothing to serve.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "commit": {
      "description": "The commit this executable was built from, or `unknown`; the same value `health.live`\nanswers.",
      "type": "string"
    },
    "dirty": {
      "description": "Whether the build's tree was dirty; `null` when the build did not know.",
      "type": [
        "boolean",
        "null"
      ]
    },
    "layer": {
      "$ref": "#/$defs/HealthStatus",
      "description": "Whether the layer read cleanly. A degraded layer is still served — the diagnostics\nare the point — so this reports rather than refuses."
    },
    "objects": {
      "description": "How many objects the index holds. Read from the index this process built at\nstart-up: it is already in memory, and reading it walks nothing.",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "ready": {
      "description": "Whether every part below is in place.",
      "type": "boolean"
    },
    "reasons": {
      "description": "Every reason this answer is not a plain yes, as `code: words`. `lease_lost` and\n`stale` make `ready` false: another process holds this checkout's lease, or this one\nserves code that is gone. `layer_degraded` does not: the layer is served with its\ndiagnostics, and a client decides whether that is enough.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "stale": {
      "description": "Why this process is serving code that is no longer on disk: the executable it was\nstarted from has been replaced or removed since. Present, `ready` is false — a server\nanswering with yesterday's code says so in the place it says it is ready, to a client\nholding nothing but this answer (I1502).",
      "type": [
        "string",
        "null"
      ]
    },
    "version": {
      "description": "This executable's version.",
      "type": "string"
    }
  },
  "required": [
    "ready",
    "version",
    "commit",
    "capabilities",
    "objects",
    "layer"
  ],
  "title": "Readiness",
  "type": "object"
}

Politiky

benchmark: povinné — cíl na každém transportu, který expozice deklaruje; případy jsou ty ze vstupního typu
cache: vypnuto — každé volání spustí handler

Cíle benchmarku

Odvozeno z registru pro tento repozitář: jeden požadavek na transport a případy, které poskytuje typ vstupu. Celá matice je na stránce měření výkonu.

transport	state	případy	targets
direct	pokryto	1	výchozí
http	pokryto	1	výchozí