Diagnostika a troubleshooting self-hosted

Řešení problémů v self-hosted režimu

Self-hosted přináší větší kontrolu, ale i větší odpovědnost. Tahle stránka je určená jako rychlý operativní playbook: co udělat, když se něco pokazí, a hlavně co udělat předtím, aby se problém opakoval méně často.

Účel a předpoklady

• Účel: stabilizovat provoz, najít příčinu, vrátit stav a zachovat audit stopu.
• Předpoklady: přístup k self-hosted instanci, práva adminu/workspace ownera, přístup do historie runů.
• Nástroje: provozní runbook, předchozí logy, aktuální playbook a stav targetu.

Postup krok za krokem při incidentu

1. Okamžitá stabilizace: zastavte další změny, omezte scope, potvrďte scope rollback.
2. Shromážděte fakta: ID runu, workspace, cílový server, typ změny, předchozí stav.
3. Ověřte preflight a logy: pročtěte výsledky preflightu a detaily log streamu.
4. Zhodnoťte dopad: provoz up/down, dostupnost, bezpečnostní dopad.
5. Volba nápravy: oprava konfigurace, zopakování runu, nebo rollback podle playbooku.
6. Komunikace: informujte team, aktualizujte komentář runu.
7. Preventivní akce: doplňte checklist a preflight pravidla.

Kontrolní checklist

• Máte identifikované správné run ID a cílový prostor?
• Máte k dispozici logy preflightu i runtime před i po zásahu?
• Byla ověřena závislost šablony a správnost proměnných?
• Proběhla kontrola workspace oprávnění (kdo mohl změnu spustit)?
• Je zřejmé, zda je problém jednorázový nebo drift konfigurace?

Běžné chyby

• Změna bez potvrzení preflight warningů.
• Retry bez fixu příčina opakovaného selhání.
• Neúplný audit záznam při incidentu, chybějící poznámka ve runu.
• Chybějící komunikační bod: tým řeší problém izolovaně.

Další kroky

• První nasazení a produkční checklist pro bezpečné opakování nasazení.
• Runbook a governance jako závazná reference pro každou větší změnu.
• Šablony a workflow pro úpravu guardrailů a opakovatelných kroků.
• Workspaces a přístupy při změně rolí.

Cross-track odkazy

Chcete-li změnit režim provozu, pokračujte na přechod mezi managed a self-hosted nebo si porovnejte managed vs self-hosted.

Další krok: Přesun do prvního nasazení nebo runbooku pro denní provoz.