Усунення помилки Cloudflare Workers 404 після успішного розгортання

Усунення проблем із проміжним середовищем із Cloudflare Workers

Важливим етапом у процесі розробки є налаштування проміжного середовища, щоб оновлення можна було належним чином протестувати перед запуском. У цьому випадку працівники Cloudflare підтримували належну роботу основного веб-сайту, що розроблявся.

Після клонування існуючого репозиторію Git і підключення його до проміжного середовища через Cloudflare Workers & Pages все, здавалося, працює нормально. У журналах зазначено, що розгортання було успішним, що зазвичай сигналізує про створення живого екземпляра.

Але коли розробник спробував отримати доступ до вказаної адреси Cloudflare, з’явилося повідомлення про помилку 404, через що він не знав, що пішло не так. Вирішувати проблеми такого характеру може дратувати, особливо коли існує переконання, що сервер має бути активним одразу після розгортання.

Незрозуміло, чи потрібен другий сервер, чи потрібно ще щось зробити, щоб повністю активувати нове сховище. У цій статті ми розглянемо причини цієї проблеми 404 і як правильно налаштувати сервер Cloudflare Workers для проміжного середовища.

Як Cloudflare Workers і скрипти обробляють помилки 404

Перший скрипт у наведеному прикладі показує, як використовувати JavaScript для обробки помилки 404 на інтерфейсі. Сценарій використовує window.onload подія очікування повного завантаження сторінки. Сторінка робить a принести запитати, чи доступний ресурс після його завантаження. Якщо ресурс повертає помилку 404, користувач переходить на спеціальну сторінку помилки. Не потребуючи залучення серверної частини, ця техніка особливо корисна для керування збоями безпосередньо у веб-переглядачі користувача та надання резервного варіанту для будь-яких відсутніх сторінок або ресурсів.

У другому прикладі сценарій керує запитами за допомогою a Cloudflare Worker під час переходу до серверної частини. Робітник користується addEventListener метод для прослуховування подій і перехоплення запитів на вибірку, коли вони зроблені. У випадку, якщо виникає помилка 404 через те, що запитана сторінка не існує, працівник динамічно надасть налаштовану сторінку помилки. Ця стратегія добре працює для керування відповідями сервера та пропонує більш адаптивний і безпечний спосіб обробки помилок, особливо під час роботи з різноманітними контекстами, такими як виробництво, інсценування чи динамічний вміст.

Для того, щоб переконатися, що сценарії інтерфейсу та серверної частини розгортаються та працюють правильно, модульне тестування представлено в третьому прикладі. Він виконує автоматичні тести, щоб перевірити, чи повертає розгортання Cloudflare Pages правильні коди статусу HTTP за допомогою Node.js і платформа тестування, така як Mocha. Тести для головної сторінки (які передбачають статус 200) і тести для неіснуючої сторінки (які очікують статус 404) обидва включені в набір тестів. Ці тести гарантують, що все розгортається згідно з планом і що будь-які пошкоджені сторінки чи посилання призводять до відповідної відповіді.

Крім того, використання тестів стверджувати Команди гарантують, що будь-які відмінності в кодах статусу відповіді будуть виявлені негайно. У конвеєрах безперервної інтеграції та розгортання (CI/CD), де забезпечення поведінки розгортання має вирішальне значення для запобігання простою або розриву з’єднань, тести є незамінними. З огляду на все, поєднання переспрямування зовнішнього інтерфейсу, обробки внутрішніх помилок і модульного тестування пропонує ретельний підхід до гарантування безперебійної роботи вашого розгортання Cloudflare Workers — навіть за відсутності ресурсів або налаштованих умов, таких як проміжний сервер.

// 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);
  });
});

Розуміння проміжного середовища Cloudflare Workers

Для цілей розробки встановлення проміжного середовища може мати вирішальне значення під час роботи Працівники Cloudflare. Розробники можуть тестувати свої програми в проміжному середовищі перед розгортанням їх на робочому сервері. Щоб запобігти таким проблемам, як зазначена помилка 404, це середовище має бути належним чином налаштовано під час його першого налаштування. Розробники часто вважають, що для запуску живого сервера потрібно лише клонувати репозиторій GitHub і підключити його до сторінок Cloudflare. Хоча Cloudflare автоматично розгортає статичні сайти, можуть виникнути проблеми, якщо конфігурація маршрутизації робочого налаштована неправильно.

Помилка 404 часто означає, що запит не перехоплюється належним чином робітник. Користувальницькі правила маршрутизації необхідні Cloudflare Workers, щоб гарантувати надсилання запитів у потрібне місце. Навіть після запуску сайту запити на деякі сторінки можуть повертати помилку 404, якщо ці маршрути не налаштовано. Важливо також переконатися, що робочий сценарій підключений до проміжного домену. Ці помилки можна зменшити під час розробки, використовуючи добре організований Worker і перевіряючи маршрути.

Переконайтеся, що Worker все ще підключений до вашого проміжний домен це ще один важливий крок. Час від часу Worker може не прив’язуватися до нового середовища під час розгортання, особливо коли існує кілька середовищ (наприклад, виробництво та проміжне). Щоб вручну зв’язати Worker із певним середовищем і переконатися, що він належним чином обробляє запити, розробники можуть використовувати інформаційну панель Cloudflare. Цей крок необхідний для того, щоб робоче та робоче середовища працювали безперебійно та без помилок.