Spracovanie chýb

Neúspešné požiadavky vyhodia RoundlyConsulting\KubernetesApi\Exceptions\KubernetesException. Rozširuje RequestException z Laravelu — catch (RequestException), $e->response aj $e->getCode() (HTTP stav) naďalej fungujú — a pridáva metódy, ktoré Status apiservera prečítajú z tela až na požiadanie:

use RoundlyConsulting\KubernetesApi\Exceptions\KubernetesException;

try {
    $cluster->secrets()->setNamespace('shop')->setName('db')->create();
} catch (KubernetesException $e) {
    $e->status();       // 409 (also $e->getCode())
    $e->reason();       // 'AlreadyExists' — only a well-formed reason token, else null
    $e->apiMessage();   // 'secrets "db" already exists', or null
    $e->details();      // the Status details array (name, kind, causes…), or []
    $e->getMessage();   // 'secrets "db" already exists' — never the raw body
    $e->response;       // the full Laravel Response, body included
}

Správy nikdy nenesú telo odpovede

Správy výnimiek končia v logoch a vo failed_jobs, preto nikdy neobsahujú surové telo odpovede — HTML stránka z edge servera alebo proxy, ktorá vracia hlavičku Authorization, by tam inak zanechala bearer token. Súhrn tela od Laravelu, ktorý jeho handler pri report() zapisuje do správy, sa nepoužije nikdy:

• Všeobecná správa pridá reason zo Status, ak ho telo obsahuje v platnom tvare.
• Nenasledované presmerovanie znie Kubernetes API request was redirected (HTTP 302 to https://login.example:8443) and the redirect was not followed — len pôvod cieľa, nikdy jeho cesta či dotaz.
• Úspešná odpoveď, ktorú volanie nevie použiť, vyhodí KubernetesException::malformedResponse(): Malformed TokenRequest response from the Kubernetes API (HTTP 201).
• new KubernetesException($response, ?string $message = null, bool $redacted = false) použije vlastnú správu presne tak, ako ju zadáte.

Skrátené chyby

withRedactedErrors() — alebo redact_errors v konfigurácii klastra — skráti správy na stav a dôvod, bez správy zo Status. Metódy výnimky aj $e->response telo naďalej prečítajú, pretože si oň výslovne poviete, a applyConfig() nastavenie zachová:

$cluster = Kubernetes::cluster('production')->withRedactedErrors();
// or 'redact_errors' => true on the cluster's config entry (KUBERNETES_REDACT_ERRORS)

try {
    $cluster->secrets()->setNamespace('shop')->setName('db')->create();
} catch (KubernetesException $e) {
    $e->getMessage();   // 'HTTP 409 AlreadyExists'
    $e->apiMessage();   // still 'secrets "db" already exists' — reading it is a choice
}

Žiadosti o token service accountu sú skrátené vždy, bez ohľadu na nastavenie klastra — ide o endpoint s prihlasovacími údajmi. Odmietnutý upgrade pri exec vyhodí WebSocketException so stavovým riadkom a správou zo Status apiservera (pri skracovaní len so stavovým riadkom), napríklad WebSocket upgrade failed: HTTP/1.1 403 Forbidden: pods "api" is forbidden; hlavičky ani telo odpovede v nej nikdy nie sú.

Všetky výnimky

404 z find() je zvyčajne signál na vytvorenie — existsOnCluster() a updateOrCreate() to riešia za vás. 409 z update() alebo updateOrCreate() znamená, že sa objekt od načítania zmenil: načítajte ho znova a pokus zopakujte.