Základní nastavení reverzní proxy vyžaduje pouze tři rozhodnutí a tento průvodce nabízí pomoc s každým z nich: název hostitele, cesta a backend. Vyhledávání HTTP proxy může znamenat forward nebo reverzní proxy, a zde plánujete a kontrolujete server, který provozujete sami. Agent za vás nikdy nerozhodne, který hostitel nebo cesta je správná. Zapíše, co požadujete, zobrazí každou změnu jako diff a nahlásí skutečný výsledek každého příkazu, takže můžete vidět dopad každého rozhodnutí před tím, než provedete další. Projděte si čtyři kroky níže v pořadí a považujte plán směrování za dokument, kterému vy i agent následujete od prvního příkazu až po poslední požadavek.
Spusťte Segment Route a otevřete pracovní složku, která obsahuje vaši konfiguraci a soubory tras. Nástroje pro práci se soubory fungují v této složce, takže čistá složka obsahující pouze soubory důležité pro tuto doménu udržuje diffy stručné a výsledky vyhledávání čitelné. Pokud jsou vaše živé soubory na serveru, který vlastníte, zkopírujte je nejprve do složky, nebo zvolte prostředí SSH pro příkazy a ponechte plán ve složce.
Požádejte agenta, aby napsal routing-plan.txt s vašimi trasami, přesměrováními a stavovým kódem, který pro každý očekáváte. Plán je prostý text, můžete jej upravovat a je to seznam, se kterým na konci porovnáváte skutečné výsledky. Pojmenujte jedno očekávání pro každou trasu i každé přesměrování, aby nebylo žádné pravidlo bez kontroly. Udržujte soubor krátký a čitelný.
Schvalujte diff pro každé pravidlo, poté nechte Shell spustit příkaz na test konfigurace před jakýmkoli restartem. V režimu Ask first agent před každou změnou pozastaví akci a karta pro test zobrazuje skutečný návratový kód a celý výstup. Nikdy nespouštějte restart, dokud test neprojde, a ponechte zálohu předchozího souboru, dokud není potvrzeno nové chování.
Pošlete požadavek na každou adresu pomocí příkazu request, přečtěte si stavový kód a hlavičku Location a porovnejte je s plánem. Pokud se jedna hodnota liší, obnovte zálohu, restartujte a změňte jedno pravidlo znovu. Opakujte, dokud každé očekávání v plánu neodpovídá výsledku, a poté ponechte finální plán jako záznam toho, co konfigurace má dělat.
.3 souboryroutes.confnačtenorouting-plan.txtuloženoyour request commandzaznamenáno# routing plan for my own domain
# one line per rule, written before any change
route 1: host app, path /api, goes to service api
route 2: host app, path /, goes to service web
route 3: host admin, path /, goes to service admin
redirect 1: old page to new page, code 301
redirect 2: www host to bare host, code 301
redirect 3: http to https, code 301
# status to expect after the change
expect 1: app path /api answers with a success code
expect 2: old page answers 301 and gives the new address
# keep the old configuration file as a backup
# end of routing planKaždý řádek je jedno pravidlo nebo jedno očekání. Napsaný jako první dává plán něco, s čím můžete porovnat skutečné stavové kódy po každé změně, a změna, která naruší očekávání, je snadno zjistitelná. Hostitelé, cesty a služby jsou pouze příklady; nahraďte je těmi svými a ponechte plán vedle konfigurace, kterou popisuje. Slovo redirect s kódem stačí agentovi k tomu, aby věděl, co napsat.
Tento průvodce pro vlastní hosting s reverzní proxy serverem před vašimi službami začíná hledáním toho, kde pravidla žijí. list_dir zobrazí pracovní složku, glob vylistuje soubory, které vypadají jako seznamy tras, a grep je prohledá pro slova route a redirect. Výsledkem je krátký seznam s názvy souborů a čísly řádků. Zatím se nic nemění. Vyberte soubor, který obsahuje pravidla pro vaši vlastní doménu, otevřete jej pomocí read_file a pošlete požadavek na každou adresu pomocí příkazu request a zapište si aktuální stavový kód. Prohledejte seznam v režimu Plan only, pokud chcete, aby agent nejprve navrhl pořadí práce, a uložte poznámky vedle svého plánu směrování, aby byly první stavové kódy zaznamenány.
Změňte jedno pravidlo najednou, protože malý diff je snadné posoudit. edit_file přečte soubor, navrhne nový řádek a zobrazí diff s přidanými a odebranými řádky. Když vyvstane otázka ohledně pravidla přesměrování subdomény, agent zobrazí pravidlo vedle kódu, který by měl vrátit, a vy rozhodnete. V režimu Ask first se nic neuloží, dokud ho nepřijmete. Auto-run by uložil okamžitě, takže jej používejte pouze u souborů, které lze obnovit. Ponechte starý soubor jako zálohu, přijměte diff a přejděte k dalšímu kroku. Zamítněte diff, pokud vás jeden řádek překvapí, a požádejte o menší změnu.
Restart s poškozeným souborem může vzít fungující web offline, takže nejprve otestujte. Shell spustí váš příkaz na test konfigurace a úspěch se posuzuje podle skutečného návratového kódu: úspěšný kód znamená, že soubor byl parsován, cokoli jiného znamená, že zůstanete na staré konfiguraci. Karta se rozbalí na celý výstup, včetně čísla řádku chyby. Opravte ji dalším malým diffem. Po úspěšném testu restartujte, znovu pošlete požadavek na adresu a porovnejte HTTP stavové kódy starého a nového běhu. Zkontrolujte výstup sami, protože úspěšný test říká pouze, že syntaxe je platná, a ne to, že trasa je správná.
Stavové kódy jsou seskupeny podle jejich první číslice: 2xx úspěch, 3xx přesměrování, 4xx chyba klienta, 5xx chyba serveru. Pro proxy znamená 502 neplatnou odpověď od backendu, 503 znamená, že služba není k dispozici, 504 znamená, že backend odpověděl příliš pomalu, a 404 znamená nenalezeno. http_get stáhne jednu stránku vaší vlastní služby a váš příkaz request zobrazí novou adresu přesměrování. Pokud se kód liší od vašeho plánu, obnovte záložní soubor, restartujte a znovu otestujte. Poté změňte plán nebo pravidlo a opakujte, jedno pravidlo za kolo. Krátký plán směrování a záložní soubor jsou vše, co potřebujete pro návrat.
