Řešení chyby Cloudflare Workers 404 po úspěšném nasazení

Odstraňování problémů s testovacím prostředím s pracovníky Cloudflare

Nezbytnou fází procesu vývoje je nastavení pracovního prostředí, aby bylo možné aktualizace před spuštěním řádně otestovat. V tomto případě Cloudflare Workers udržovali primární web ve vývoji dobře fungující.

Po naklonování stávajícího úložiště Git a jeho připojení k pracovnímu prostředí prostřednictvím Cloudflare Workers & Pages se zdálo, že vše funguje dobře. Protokoly naznačovaly, že nasazení bylo úspěšné, což by obvykle signalizovalo vytvoření živé instance.

Když se však vývojář pokusil získat přístup k dané adrese Cloudflare, objevila se chybová zpráva 404, takže si nebyl jistý, co se stalo. Může být nepříjemné řešit problémy tohoto druhu, zvláště když existuje přesvědčení, že server by měl být v provozu ihned po nasazení.

Není jasné, zda je potřeba druhý server, nebo jestli je potřeba udělat něco jiného, ​​aby se nové úložiště úplně aktivovalo. V tomto článku se podíváme na příčiny tohoto problému 404 a na to, jak správně nastavit server Cloudflare Workers pro pracovní prostředí.

Jak pracovníci Cloudflare a skripty zvládají chyby 404

První skript v uvedeném příkladu ukazuje, jak používat JavaScript ke zpracování chyby 404 na frontendu. Skript používá okno.načtení událost čekání na úplné načtení stránky. Stránka vytváří a vynést požádat o zjištění, zda je zdroj po načtení dostupný. Pokud zdroj vrátí chybu 404, je uživatel odeslán na přizpůsobenou chybovou stránku. Bez nutnosti zapojení backendu je tato technika zvláště užitečná pro správu selhání přímo v prohlížeči uživatele a poskytuje záložní řešení pro jakékoli chybějící stránky nebo zdroje.

Ve druhém příkladu skript spravuje požadavky pomocí a Cloudflare Worker jak se přesune do backendu. Pracovník používá addEventListener metoda, která naslouchá událostem a zachycuje požadavky na načtení, když jsou provedeny. V případě, že dojde k chybě 404 kvůli tomu, že požadovaná stránka neexistuje, pracovník dynamicky poskytne přizpůsobenou chybovou stránku. Tato strategie funguje dobře pro správu odpovědí serveru a nabízí adaptabilnější a bezpečnější způsob řešení chyb, zejména při práci s různými kontexty, jako je produkce a příprava nebo dynamický obsah.

Aby bylo zajištěno, že frontendové a backendové skripty jsou nasazeny a fungují správně, je ve třetím příkladu zavedeno testování jednotek. Provádí automatické testy, aby zjistil, zda nasazení Cloudflare Pages vrací správné stavové kódy HTTP pomocí Node.js a testovací rámec, jako je Mocha. Testy pro hlavní stránku (které předpokládají stav 200) a testy neexistující stránky (které očekávají stav 404) jsou součástí testovací sady. Tyto testy zajišťují, že je vše nasazeno podle plánu a že jakékoli nefunkční stránky nebo odkazy vedou k odpovídající reakci.

Dále použití testů tvrdit commands zaručuje, že jakékoli rozdíly v kódech stavu odezvy jsou okamžitě detekovány. V kanálech průběžné integrace a nasazení (CI/CD), kde je zajištění chování při nasazení zásadní pro zamezení prostojů nebo přerušení připojení, jsou testy nepostradatelné. Sloučení přesměrování frontendu, zpracování chyb backendu a testování jednotek nabízí důkladný přístup k zaručení bezproblémového provozu vašeho nasazení Cloudflare Workers – dokonce i v případě chybějících zdrojů nebo přizpůsobených podmínek, jako je například pracovní server.

// Frontend JavaScript for handling redirection
// This script checks if a resource is available on the Cloudflare page
// If not, it redirects to a fallback page
window.onload = function () {
  fetch(window.location.href)
    .then(response => {
      if (response.status === 404) {
        window.location.href = '/404.html';  // Redirect to custom 404 page
      }
    })
    .catch(error => {
      console.error('Error fetching the page:', error);
      window.location.href = '/error.html';  // Redirect to error page
    });
};

// Cloudflare Worker script for managing 404 errors
// The script checks if the requested path exists, and if not, returns a custom 404 page
addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request));
});
async function handleRequest(request) {
  try {
    const response = await fetch(request);
    if (response.status === 404) {
      return new Response('Custom 404 Page', { status: 404 });
    }
    return response;
  } catch (error) {
    return new Response('Error occurred: ' + error.message, { status: 500 });
  }
}

// Example unit test for deployment verification
// Using JavaScript to ensure that Cloudflare Pages return the correct response
const assert = require('assert');
const fetch = require('node-fetch');
describe('Cloudflare Deployment Test', function() {
  it('should return 200 for the main page', async function() {
    const response = await fetch('https://your-domain.pages.dev');
    assert.equal(response.status, 200);
  });
  it('should return 404 for non-existent page', async function() {
    const response = await fetch('https://your-domain.pages.dev/unknown');
    assert.equal(response.status, 404);
  });
});

Porozumění pracovnímu prostředí Cloudflare Workers

Pro účely vývoje může být při práci zásadní instalace pracovního prostředí Pracovníci Cloudflare. Vývojáři mohou své aplikace otestovat ve zkušebním prostředí před jejich nasazením na produkční server. Aby se předešlo problémům, jako je indikovaná chyba 404, musí být toto prostředí při prvním nastavení správně nakonfigurováno. Vývojáři se často domnívají, že ke spuštění živého serveru stačí naklonovat úložiště GitHub a připojit ho ke stránkám Cloudflare. Přestože Cloudflare automaticky nasazuje statické weby, pokud není konfigurace směrování pracovníka správně nastavena, mohou nastat problémy.

Chyba 404 často znamená, že požadavek není správně zachycen Pracovník. Vlastní pravidla směrování jsou nezbytná pro pracovníky Cloudflare, aby bylo zaručeno, že požadavky budou odeslány na správné místo. I po spuštění webu mohou požadavky na některé stránky vrátit chybu 404, pokud tyto trasy nejsou nastaveny. Zásadní je také zajištění toho, aby byl skript Worker připojen ke stagingové doméně. Tyto chyby lze během vývoje omezit využitím dobře organizovaného pracovníka a ověřením tras.

Díky tomu je Pracovník stále připojen k vašemu inscenační doména je dalším zásadním krokem. Pracovník může příležitostně selhat při automatickém navázání na nové prostředí během nasazení, zejména pokud existuje několik prostředí (jako je produkční a pracovní prostředí). K ručnímu propojení pracovníka s konkrétním prostředím a zajištění řádného zpracování požadavků mohou vývojáři využít řídicí panel Cloudflare. Tento krok je nezbytný, aby pracovní a produkční prostředí fungovalo hladce a bez chyb.