‫Cloudflare Workers برای توسعه‌دهندگان ASP.NET Core؛ بخش اول: مبانی و مفاهیم کلیدی

• مفهوم: Edge Computing یعنی اجرای کد شما نه در یک سرور مرکزی، بلکه در شبکه‌ای گسترده از سرورها که در سراسر جهان و نزدیک به کاربران نهایی توزیع شده‌اند. به این نقاط توزیع شده، PoP (Point of Presence) گفته می‌شود.
• یک مقایسه آشنا: شما احتمالاً با CDN (Content Delivery Network) برای سرو کردن فایل‌های استاتیک (مثل تصاویر، CSS و JavaScript) آشنا هستید. CDN این فایل‌ها را در نقاط مختلف دنیا کَش می‌کند تا سریع‌تر به دست کاربر برسند. Edge Computing را به عنوان یک CDN برای کدهای اجرایی خودتان در نظر بگیرید!

• چیزی که با آن آشنا هستید (کانتینرها): در دنیای .NET، ما از Docker برای پکیج کردن اپلیکیشن به همراه تمام نیازمندی‌هایش، حتی یک نسخه کوچک از سیستم‌عامل، استفاده می‌کنیم. راه‌اندازی یک کانتینر جدید چند صد میلی‌ثانیه تا چند ثانیه زمان می‌برد که به آن Cold Start می‌گویند.
• روش Cloudflare Workers (ایزوله‌ها): کلادفلر از تکنولوژی به نام V8 Isolates استفاده می‌کند که توسط موتور جاوااسکریپت V8 گوگل کروم قدرت گرفته است. هر ایزوله یک محیط اجرای کد بسیار سبک و ایزوله است، بدون سربار سیستم‌عامل.
• مزیت اصلی: راه‌اندازی یک ایزوله کمتر از ۵ میلی‌ثانیه طول می‌کشد! این یعنی عملاً Cold Start وجود ندارد. این معماری به کلادفلر اجازه می‌دهد تا روی یک سرور فیزیکی، هزاران Worker را با هزینه بسیار پایین اجرا کند.

• سرعت فوق‌العاده: کاهش چشمگیر Latency برای کاربران سراسر جهان.
• حفاظت از سرور اصلی: شما می‌توانید درخواست‌های مخرب، بات‌ها یا ترافیک اسپم را در Edge شناسایی و مسدود کنید، پیش از آنکه اصلاً به سرور ASP.NET Core شما برسند.
• کاهش هزینه و بار سرور: با مدیریت کردن کش، ریدایرکت‌ها و حتی بخشی از منطق برنامه در Edge، بار پردازشی سرور اصلی شما به شدت کاهش می‌یابد.
• مقیاس‌پذیری بی‌نهایت: کد شما به صورت خودکار و بدون نیاز به هیچ‌گونه تنظیماتی در سراسر جهان مقیاس‌پذیر می‌شود.

npm install -g wrangler

wrangler login

wrangler init my-first-worker

• src/index.ts (یا .js): این فایل اصلی کد شماست. معادل فایل Program.cs یا یک Controller در پروژه ASP.NET Core شما.
• wrangler.toml: این فایل تنظیمات پروژه شماست. معادل فایل appsettings.json یا .csproj. در اینجا نام Worker، دامنه و سایر تنظیمات را مشخص می‌کنید.

wrangler dev

wrangler deploy

// src/index.ts
export default {
  async fetch(request: Request): Promise<Response> {
    // این اولین Worker من است!
    return new Response('Hello from the Edge!');
  },
};

export default {
  async fetch(request: Request): Promise<Response> {
    const url = request.url; // آدرس کامل درخواست
    const method = request.method; // متد HTTP (GET, POST, etc.)
    const userAgent = request.headers.get('User-Agent'); // خواندن یک هدر خاص

    const responseBody = `You made a ${method} request to ${url}. Your User-Agent is: ${userAgent}`;
    return new Response(responseBody);
  },
};

• new Response(body, options)

export default {
  async fetch(request: Request): Promise<Response> {
    const jsonData = { id: 1, name: 'Sample Data' };

    return new Response(JSON.stringify(jsonData), {
      status: 200, // کد وضعیت OK
      headers: {
        'Content-Type': 'application/json', // تنظیم هدر
        'X-Powered-By': 'Cloudflare-Workers'
      },
    });
  },
};

export default {
  async fetch(request: Request): Promise<Response> {
    const url = new URL(request.url);

    if (url.pathname === '/api/user') {
      return new Response('User Profile Data');
    }

    if (url.pathname.startsWith('/admin')) {
      return new Response('Admin area access denied!', { status: 403 });
    }

    return new Response('Welcome to the homepage!');
  },
};