میتوانید چند سرویس وب را با یک فایل Compose در یک پروژه اجرا کنید و برای هرکدام دامنه یا زیردامنهٔ جداگانه داشته باشید. برای مثال سایت، API و پنل مدیریت یک پروژه هستند، اما هر آدرس به سرویس خودش میرود.
پیشنیازها و سقف پلن
دامنهای با دسترسی به تنظیمات DNS، یک پلن دارای ظرفیت کافی کانتینر و CPU و RAM کافی لازم است. دامنهٔ پیشفرض پروژه به سرویس وب اصلی متصل است. اتصال دامنهٔ شخصی به سرویسهای دیگر اختیاری است.
سقف اولیهٔ پلنهای نانو، پایه، استاندارد، حرفهای و حرفهای پلاس بهترتیب ۳، ۵، ۸، ۱۲ و ۱۶ کانتینر است. مدیر میتواند این اعداد را در «کاتالوگ محصولات ← پلن سرویسها ← حداکثر کانتینر در پروژه» تغییر دهد؛ مقدار نمایشدادهشده در فرم ساخت ملاک است. سقف فنی کل فایل Compose همچنان ۱۶ سرویس است.
همهٔ سرویسهای برنامه، worker و کارهای یکبارهٔ کامپوز شمرده میشوند. دیتابیسهایی که به سرویس مدیریتشده تبدیل میشوند، منابع و قیمت جدا دارند و از سقف کانتینر برنامه کم نمیکنند. تعداد نمونههای مقیاسپذیری و کانتینرهای کمکی پلتفرم هم در این شمارش نیستند. منابع پلن بین سرویسهای برنامه تقسیم میشوند؛ سقف تعداد کانتینر بهتنهایی تضمین کافیبودن حافظه نیست.
سقف هنگام ساخت روی پروژه ثبت میشود. ویرایش پلن در ادمین، سقف پروژههای موجود را عوض نمیکند. پروژههای ساختهشده پیش از این قابلیت از سقف تعداد کانتینر معافاند، حتی هنگام استقرار مجدد و تغییر پلن. پروژههای جدید در استقرارهای بعدی هم سقف ثبتشده را رعایت میکنند؛ تغییر پلن خود پروژه، سقف آن را به مقدار پلن مقصد بهروز میکند و اگر تعداد سرویسهای فعلی بیشتر باشد، کاهش پلن پذیرفته نمیشود.
نمونهٔ کامل: پنج سرویس وب در یک پروژه
این نمونه برای آزمایش مسیریابی است. هر سرویس نام خودش را در پاسخ نمایش میدهد. فایل زیر را با نام compose.yaml ذخیره کنید یا در روش ساخت «Compose» بچسبانید.
services:
frontend:
image: nginx:1.28-alpine
expose:
- "80"
command: ["/bin/sh", "-c", "printf 'frontend' > /usr/share/nginx/html/index.html; exec nginx -g 'daemon off;'"]
api:
image: nginx:1.28-alpine
expose:
- "80"
command: ["/bin/sh", "-c", "printf 'api' > /usr/share/nginx/html/index.html; exec nginx -g 'daemon off;'"]
admin:
image: nginx:1.28-alpine
expose:
- "80"
command: ["/bin/sh", "-c", "printf 'admin' > /usr/share/nginx/html/index.html; exec nginx -g 'daemon off;'"]
docs:
image: nginx:1.28-alpine
expose:
- "80"
command: ["/bin/sh", "-c", "printf 'docs' > /usr/share/nginx/html/index.html; exec nginx -g 'daemon off;'"]
assets:
image: nginx:1.28-alpine
expose:
- "80"
command: ["/bin/sh", "-c", "printf 'assets' > /usr/share/nginx/html/index.html; exec nginx -g 'daemon off;'"]
همهٔ سرویسها میتوانند پورت داخلی ۸۰ داشته باشند. نیازی به پورت متفاوت میزبان یا پراکسی جدا در Compose نیست. سرویس اصلی پیشنهادی را در پیشنمایش بررسی کنید.
ساخت و استقرار پروژه
- در «اپلیکیشنها»، «ساخت پروژه» و سپس «Compose» را انتخاب کنید. نامی مانند
multi-web-demoوارد کنید و فایل بالا را بچسبانید؛ همین فایل از ZIP و مخزن Git هم قابل دریافت است. - ناحیه و پلنی با سقف حداقل پنج کانتینر و حافظهٔ کافی انتخاب کنید. اگر پلن بهعلت کمبود حافظه یا تعداد کانتینر غیرفعال است، پلن بزرگتری انتخاب کنید.
- «بررسی پروژه» را بزنید. فهرست سرویسها، سرویس اصلی، منابع و هزینه را مرور کنید. این مرحله پروژه نمیسازد و هزینهای کم نمیکند.
- پس از تأیید هزینه، پروژه را مستقر کنید و تا آمادهشدن استقرار منتظر بمانید. سپس صفحهٔ پروژه و بخش «دامنه» را باز کنید.
اتصال دامنه یا زیردامنه به هر سرویس
برای هر ردیف زیر، «سرویس مقصد» و «پورت داخلی» را انتخاب کنید، نام دامنه را وارد کنید و «افزودن دامنه» یا «اتصال دامنه» را بزنید. example.com را با دامنهٔ خودتان جایگزین کنید.
| دامنه | سرویس مقصد | پورت داخلی | پاسخ نمونه |
|---|---|---|---|
example.com | frontend | ۸۰ | frontend |
api.example.com | api | ۸۰ | api |
admin.example.com | admin | ۸۰ | admin |
docs.example.com | docs | ۸۰ | docs |
assets.example.com | assets | ۸۰ | assets |
گزینهٔ «سرویس اصلی پروژه» همان مقصد پیشفرض را نگه میدارد. برای اتصال ثابت به یک سرویس مشخص، نام خود سرویس را انتخاب کنید. فهرست مقصدها از نسخهٔ فعال همین پروژه ساخته میشود؛ سرویس بدون پورت و کار یکباره، مقصد دامنه نیست. پورت انتخابی باید HTTP برنامه را پاسخ دهد؛ HTTPS عمومی را پاستا مدیریت میکند. افزودن دامنه راه انتشار عمومی پورت دیتابیس یا پروتکل خام TCP نیست. یک سرویس میتواند چند دامنه داشته باشد، ولی هر نام دامنه فقط یک اتصال دارد.
تنظیم DNS و فعالشدن HTTPS
اگر DNS در پاستا مدیریت میشود، «اتصال دامنه» رکوردهای لازم را آماده میکند. برای دامنهای که تازه به DNS پاستا میآید، Nameserverهای نمایشدادهشده را در پنل ثبتکننده تنظیم کنید. اگر دامنه از قبل رکورد وب دارد، پیام تداخل و اثر جایگزینی را پیش از تأیید بخوانید.
اگر DNS جای دیگری است، «DNS را جای دیگری مدیریت میکنم» و سپس «اتصال بدون تغییر DNS» را انتخاب کنید. رکورد A و رکورد TXT مالکیت را دقیقاً با نام و مقدار نمایشدادهشده بسازید. مقدار TXT هر اتصال اختصاصی است؛ آن را از مثال دیگری کپی نکنید. رکوردهای ایمیل یا سرویسهای دیگر را حذف نکنید.
پس از انتشار DNS، «بررسی همین حالا» را بزنید. وضعیت ابتدا «در انتظار DNS»، سپس «در حال صدور گواهی» و پس از آمادهشدن HTTPS، «فعال» میشود. برای دامنههای متصل از مسیر CDN، HTTPS در همان مسیر مدیریت میشود. روشنکردن انتقال خودکار HTTP به HTTPS را پس از فعالشدن گواهی انجام دهید. برای وایلدکارد مانند *.example.com، رکورد تأیید گواهی نیز مطابق راهنمای همان ردیف لازم است؛ دامنهٔ اصلی جداگانه متصل میشود و زیردامنهٔ صریح را میتوانید به سرویس دیگری بدهید.
آزمایش نتیجه
پس از فعالشدن هر پنج اتصال، آدرسها را در مرورگر باز کنید یا دستورهای زیر را اجرا کنید. هر آدرس باید نام سرویس متناظر جدول را برگرداند.
curl --fail https://example.com
curl --fail https://api.example.com
curl --fail https://admin.example.com
curl --fail https://docs.example.com
curl --fail https://assets.example.comاتصال از API
توکن باید به همین پروژه دسترسی و مجوز environment:write داشته باشد. نام پروژه، دامنه و پورت را متناسب با نسخهٔ فعال تغییر دهید. نمونهٔ زیر فقط اتصال را ثبت میکند؛ DNS را با اطلاعات پاسخ بسازید و پس از انتشار، درخواست تأیید را بفرستید.
curl --fail-with-body -X POST \
https://paasta.cloud/api/projects/multi-web-demo/domains \
-H "Authorization: Bearer $PAASTA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"hostname":"api.example.com","serviceName":"api","targetPort":80,"setupDns":false}'
# Use the id returned by the previous request.
curl --fail-with-body -X PUT \
https://paasta.cloud/api/projects/multi-web-demo/domains \
-H "Authorization: Bearer $PAASTA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id":"DOMAIN_ID"}' سرویس داخلی، استقرار مجدد و تغییر مقصد
سرویس وب اصلی آدرس پیشفرض عمومی دارد. سرویسهای دیگر تا وقتی برایشان دامنه نگذارید، از مسیر دامنههای پروژه عمومی نمیشوند و در شبکهٔ خصوصی پروژه با نام سرویس به هم وصل میشوند. برای worker بدون ورودی وب، پورت و دامنه تعریف نکنید.
دامنه به نام سرویس متصل است و با تعویض کانتینر در استقرار مجدد، راهاندازی مجدد یا انتقال پروژه حفظ میشود. اگر سرویسی با دامنهٔ متصل را حذف یا پورتش را تغییر دهید، استقرار رد میشود تا دامنه به سرویس دیگری نرود. برای تغییر مقصد، ابتدا اتصال آن دامنه را حذف کنید، نسخهٔ جدید را مستقر کنید و سپس دامنه را با سرویس و پورت جدید اضافه کنید. این جابهجایی ممکن است وقفه داشته باشد و حذف اتصال، دادهٔ برنامه را حذف نمیکند. پیش از بازگشت به نسخهٔ قدیمی هم وجود سرویسها و پورتهای متصل بررسی میشود.
رفع خطا
- «سرویس یا پورت مقصد معتبر نیست»: پایان استقرار را بررسی کنید و سرویس و پورت را از نسخهٔ فعال همین پروژه انتخاب کنید. دسترسی به پروژهٔ دیگر از این مسیر پذیرفته نیست.
- «استقرار پروژه در حال انجام است»: پس از پایان ساخت یا استقرار، اتصال دامنه را تغییر دهید.
- خطای سقف کانتینر: تعداد سرویسهای برنامه را کم کنید یا از مدیریت پروژه پلن بزرگتری انتخاب کنید؛ پروژهها و دادههای قبلی بهخاطر این خطا حذف نمیشوند.
- DNS یا گواهی آماده نیست: نام و مقدار رکوردهای همان دامنه، Nameserver و تداخل A، AAAA یا CNAME را بررسی کنید. پس از انتشار دوباره بررسی کنید و پیام وضعیت همان ردیف را بخوانید.
- پاسخ سرویس اشتباه است: مقصد نوشتهشده زیر دامنه و آدرس درخواست را کنترل کنید. در نمونهٔ بالا، هر سرویس پاسخ متفاوتی دارد.