Mengatasi Kesalahan Cloudflare Workers 404 Setelah Penerapan Berhasil

Memecahkan Masalah Lingkungan Staging dengan Cloudflare Workers

Tahap penting dalam proses pengembangan adalah menyiapkan lingkungan pementasan sehingga pembaruan dapat diuji dengan benar sebelum diluncurkan. Dalam hal ini, Cloudflare Workers menjaga situs web utama yang sedang dikembangkan agar tetap beroperasi dengan baik.

Setelah mengkloning repositori Git yang ada dan menghubungkannya ke lingkungan pementasan melalui Cloudflare Workers & Pages, semuanya tampak berfungsi dengan baik. Log menunjukkan bahwa penerapan berhasil, yang biasanya menandakan pembuatan instance langsung.

Namun ketika pengembang mencoba mengakses alamat Cloudflare yang diberikan, pesan kesalahan 404 muncul, membuatnya tidak yakin apa yang salah. Menangani masalah seperti ini bisa jadi menjengkelkan, terutama ketika ada keyakinan bahwa server harus langsung aktif setelah penerapan.

Tidak jelas apakah server kedua diperlukan atau ada hal lain yang perlu dilakukan untuk mengaktifkan repositori baru sepenuhnya. Kami akan melihat penyebab masalah 404 ini dan cara mengatur server Cloudflare Workers dengan benar untuk lingkungan pementasan di artikel ini.

Bagaimana Pekerja dan Skrip Cloudflare Menangani Kesalahan 404

Skrip pertama dalam contoh yang diberikan menunjukkan cara menggunakannya JavaScript untuk menangani kesalahan 404 di frontend. Skrip menggunakan jendela.onload acara untuk menunggu halaman dimuat sepenuhnya. Halaman tersebut membuat a mengambil meminta untuk melihat apakah sumber daya tersedia setelah dimuat. Pengguna diarahkan ke halaman kesalahan yang disesuaikan jika sumber daya mengembalikan kesalahan 404. Tanpa memerlukan keterlibatan backend, teknik ini sangat berguna untuk mengelola kegagalan langsung di browser pengguna dan menyediakan cadangan untuk halaman atau sumber daya yang hilang.

Pada contoh kedua, skrip mengelola permintaan menggunakan a Pekerja Cloudflare saat berpindah ke backend. Pekerja menggunakan tambahkanEventListener metode untuk mendengarkan kejadian dan mencegat permintaan pengambilan saat dibuat. Jika kesalahan 404 terjadi karena halaman yang diminta tidak ada, pekerja akan secara dinamis menyediakan halaman kesalahan yang disesuaikan. Strategi ini bekerja dengan baik untuk mengelola jawaban server dan menawarkan cara yang lebih mudah beradaptasi dan aman untuk menangani kesalahan, terutama ketika bekerja dengan berbagai konteks seperti produksi dan pementasan atau konten dinamis.

Untuk memastikan bahwa skrip frontend dan backend disebarkan dan beroperasi dengan benar, pengujian unit diperkenalkan pada contoh ketiga. Ia melakukan pengujian otomatis untuk melihat apakah penerapan Cloudflare Pages mengembalikan kode status HTTP yang benar Node.js dan kerangka pengujian seperti Mocha. Pengujian untuk halaman utama (yang mengasumsikan status 200) dan pengujian untuk halaman yang tidak ada (yang mengharapkan status 404) keduanya disertakan dalam rangkaian pengujian. Pengujian ini memastikan bahwa semuanya diterapkan sesuai rencana dan setiap halaman atau tautan yang rusak menghasilkan respons yang sesuai.

Selanjutnya, penggunaan tes menegaskan perintah menjamin bahwa setiap perbedaan dalam kode status respons terdeteksi segera. Dalam pipeline integrasi dan penerapan berkelanjutan (CI/CD), di mana memastikan perilaku penerapan sangat penting untuk mencegah downtime atau koneksi terputus, pengujian sangat diperlukan. Dengan mempertimbangkan semua hal, penggabungan pengalihan frontend, penanganan kesalahan backend, dan pengujian unit menawarkan pendekatan menyeluruh untuk menjamin kelancaran penerapan Cloudflare Workers Anda—bahkan saat tidak ada sumber daya atau kondisi yang disesuaikan seperti server pementasan.

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

Memahami Lingkungan Pementasan Pekerja Cloudflare

Untuk tujuan pengembangan, menginstal lingkungan pementasan bisa menjadi hal yang penting saat bekerja dengannya Pekerja Cloudflare. Pengembang dapat menguji aplikasi mereka di lingkungan pementasan sebelum menyebarkannya ke server produksi. Untuk mencegah masalah seperti yang ditunjukkan pada kesalahan 404, lingkungan ini harus dikonfigurasi dengan benar saat pertama kali dikonfigurasi. Pengembang sering kali percaya bahwa yang diperlukan untuk meluncurkan server langsung hanyalah mengkloning repositori GitHub dan menghubungkannya ke Halaman Cloudflare. Meskipun Cloudflare secara otomatis menyebarkan situs statis, jika konfigurasi perutean pekerja tidak diatur dengan benar, masalah mungkin terjadi.

Kesalahan 404 sering kali berarti permintaan tidak disadap dengan benar oleh Pekerja. Aturan perutean khusus diperlukan bagi Cloudflare Worker untuk menjamin bahwa permintaan dikirim ke tempat yang tepat. Bahkan setelah situs diluncurkan, permintaan untuk beberapa halaman mungkin menghasilkan kesalahan 404 jika rute ini tidak diatur. Memastikan skrip Pekerja terhubung ke domain pementasan juga penting. Kesalahan ini dapat dikurangi selama pengembangan dengan memanfaatkan Pekerja yang terorganisir dengan baik dan memvalidasi rute.

Menjadikan Pekerja tersebut masih terhubung dengan Anda domain pementasan adalah langkah penting lainnya. Pekerja terkadang gagal untuk secara otomatis mengikat dirinya ke lingkungan baru selama penerapan, terutama ketika ada beberapa lingkungan (seperti produksi dan staging). Untuk menghubungkan Pekerja secara manual ke lingkungan tertentu dan memastikannya memproses permintaan dengan tepat, pengembang dapat menggunakan dasbor Cloudflare. Agar lingkungan pementasan dan produksi berjalan lancar dan bebas kesalahan, langkah ini diperlukan.