این صفحه قرارداد قوانین آپاستریم را توضیح میدهد. هر قانون، برای درخواستهای منطبق، آپاستریمی از همان CDN را انتخاب میکند. تفاوت این قوانین با قانون مسیر در قوانین آپاستریم آمده است. برای تنظیم در پنل، مسیریابی ترافیک بینالملل با قوانین آپاستریم را دنبال میکنیم.
ساختار قانون
قوانین در فهرست spec.routingRules منبع CDN قرار دارند.
| گزینه | فیلد | قرارداد |
|---|---|---|
| نام قانون | name | در پنل الزامی، حداکثر ۶۴ کاراکتر و در همان CDN یکتا |
| وضعیت | enabled | فقط قوانین فعال در ارزیابی شرکت میکنند |
| شرطها | constraints | آرایه دوبعدی؛ شرطهای هر گروه با «و» و گروهها با «یا» ترکیب میشوند |
| عملیات | actions | عملیات پشتیبانیشده setUpstream است؛ پنل برای هر قانون یک آپاستریم انتخاب میکند |
| آپاستریم مقصد | actions[].setUpstream.upstreamName | نام یک آپاستریم موجود در spec.upstreams همان CDN؛ مقدار خالی یا نام ناموجود معتبر نیست |
شرطهای قابل استفاده
فرم قانون آپاستریم شرطهای زیر را دارد. نام فیلدها، عملگرها و معکوس کردن شرط با negate در مرجع شروط DNF آمده است.
| پارامتر | type | مقدار مورد مقایسه |
|---|---|---|
| ربات شناختهشده | known_bots | شناختهشده بودن درخواست بهعنوان ربات |
| TLS | tls | استفاده از TLS |
| میزبان | host | میزبان درخواست |
| مسیر | path | مسیر بدون Query String |
| URI | uri | مسیر همراه Query String |
| پارامتر Query | args | نام و مقدار پارامتر |
| کشور | country | کد کشور، مانند IR |
| آدرس IP | ip | آدرس یا محدوده CIDR |
| ASN | asn | شماره ASN |
| کوکی | cookie | نام و مقدار کوکی |
| هدر | header | نام و مقدار هدر درخواست |
| متد | method | متد درخواست، مانند GET |
IP Set در قانون آپاستریم
فرم پنل گزینه انتخاب IP Set را نیز نمایش میدهد، اما در پیادهسازی فعلی، اعضای IP Set فقط برای قوانین فایروال آماده میشوند. برای تطبیق IP در قانون آپاستریم، مقادیر CIDR مستقیما وارد میشوند؛ انتخاب IP Set در این بخش روش پشتیبانیشدهای برای مسیریابی نیست.
ترتیب و تطبیق
| وضعیت | نتیجه |
|---|---|
| قانون غیرفعال | در ارزیابی شرکت نمیکند |
| هیچ قانون منطبق نیست | آپاستریم پیشفرض قانون مسیر تغییر نمیکند |
| چند قانون منطبق هستند | قوانین به ترتیب فهرست اعمال میشوند؛ آخرین عملیات setUpstream منطبق، مقصد را تعیین میکند |
constraints: [] | هیچ گروهی برای تطبیق وجود ندارد؛ قانون منطبق نمیشود |
constraints: [[]] | گروه خالی برقرار محسوب میشود؛ قانون با همه درخواستها منطبق است |
قانون آپاستریم، انتخاب آپاستریم را تغییر میدهد. تنظیمات کش، بازنویسی مسیر و سایر گزینههای قانون مسیر، با این عملیات تغییر نمیکنند. ترتیب این قوانین با قوانین مسیر و دیواره آتش که اولین قانون منطبق را انتخاب میکنند، یکسان نیست. جزییات را در مرجع قوانین مسیر و مرجع دیواره آتش (Firewall) مطالعه میکنیم.
نمونه ساختار یک قانون
این نمونه یک عضو از spec.routingRules است، نه بدنه کامل درخواست بهروزرسانی CDN. آپاستریم foreign-origin باید در همان CDN تعریف شده باشد.
{
"name": "outside-ir",
"enabled": true,
"constraints": [
[
{
"type": "country",
"negate": true,
"country": { "operator": "equals", "expected": ["IR"] }
}
]
],
"actions": [
{
"type": "setUpstream",
"setUpstream": { "upstreamName": "foreign-origin" }
}
]
}