‫Cloudflare Workers برای توسعه‌دهندگان ASP.NET Core؛ بخش چهارم: مباحث پیشرفته و آینده .NET در Cloudflare Workers

• یادآوری دستور:

wrangler secret put MY_API_KEY

[vars]
API_BASE_URL = "https://my-aspnet-api.com"

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    // آدرس API مقصد را از متغیرها میخوانیم
    const apiUrl = `${env.API_BASE_URL}/api/products`;

    // هدرهای لازم برای ارسال به API مقصد را آماده میکنیم
    const apiHeaders = new Headers({
      'Content-Type': 'application/json',
      // کلید محرمانه را از env.secrets میخوانیم
      'X-API-Key': env.MY_API_KEY 
    });

    // درخواست را به سمت API خودمان ارسال میکنیم
    const apiResponse = await fetch(apiUrl, {
      method: 'GET',
      headers: apiHeaders
    });

    // پاسخ دریافتی از API را مستقیما به کاربر برمیگردانیم
    return new Response(apiResponse.body, {
      status: apiResponse.status,
      headers: apiResponse.headers
    });
  },
};

interface Env {
  API_BASE_URL: string;
  MY_API_KEY: string; // Wrangler به صورت خودکار Secrets را اینجا قرار میدهد
}

dotnet workload install wasi-experimental

dotnet new wasiconsole -o WasiDemo
cd WasiDemo

• فایل Program.cs را باز کنید. این یک اپلیکیشن کنسول ساده است.

// Program.cs
Console.WriteLine("Hello from C# on Cloudflare Workers!");

• پروژه را با تنظیمات مخصوص WASI منتشر کنید.

dotnet publish -c Release -r wasi-wasm

• در پوشه bin/Release/netX.0/wasi-wasm/native یک فایل به نام WasiDemo.wasm ایجاد می‌شود.

• یک پروژه Worker جدید بسازید و فایل WasiDemo.wasm را در آن کپی کنید.

[[wasm_modules]]
name = "csharp_module"
path = "./WasiDemo.wasm"

interface Env {
  // این ماژول Wasm توسط Wrangler به ما تزریق میشود
  csharp_module: WebAssembly.Module;
}

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    // در حال حاضر راه ارتباطی استاندارد با Wasi از طریق stdout است
    // که در آینده قطعا بهتر خواهد شد.

    // این یک کد boilerplate برای اجرای ماژول WASI و خواندن خروجی آن است
    // فعلا نیازی به درک عمیق آن نیست.

    // در آینده نزدیک این بخش بسیار ساده‌تر خواهد شد.

    return new Response("Check your Worker logs for the message from C#!");
  }
};

# تنظیمات پیش‌فرض
name = "my-awesome-worker-staging"
# ... سایر تنظیمات

[env.production]
name = "my-awesome-worker-production" # override name for production
vars = { API_BASE_URL = "https://production-api.com" }

[env.staging]
vars = { API_BASE_URL = "https://staging-api.com" }

• wrangler deploy: به محیط پیش‌فرض (staging) دیپلوی می‌کند.
• wrangler deploy --env production: به محیط production دیپلوی می‌کند.

# مشاهده لاگ‌های محیط پیش‌فرض
wrangler tail

# مشاهده لاگ‌های محیط production
wrangler tail --env production

• Cloudflare Workers چیست و چرا معماری آن (V8 Isolates) انقدر کارآمد است.
• چگونه منطق Middleware را به Edge منتقل کنید تا سرور اصلی خود را محافظت و بهینه کنید.
• چگونه از سرویس‌های ذخیره‌سازی جهانی (KV, R2) و کش پیشرفته برای ساخت اپلیکیشن‌های stateful در Edge بهره ببرید.
• و در نهایت، نگاهی به آینده هیجان‌انگیز اجرای مستقیم کدهای .NET در این پلتفرم داشتید.