اپهای آماده و وردپرس
کاتالوگ اپهای آماده، نسخهها، پلنهای وردپرس اکو و توربو و تغییر قالب.
اپهای آماده سرویسهایی هستند که با یک کلیک مستقر میشوند: فقط قالب و نسخه را انتخاب میکنید و پلتفرم ایمیج، پورت و منابع پیشفرض را خودش میداند. در کنسول، این گزینه در صفحه استقرار سرویس جدید با برچسب «اپ آماده» است.
چه چیزی از کاتالوگ میآید
فهرست زنده از GET /api/v1/catalog/apps خوانده میشود. برای هر قالب:
| فیلد | معنا |
|---|---|
slug | شناسه یکتا (مثلاً n8n، ghost) |
name_fa | نام نمایشی |
category | دسته: AUTOMATION، DEVTOOLS، AI، CMS، ANALYTICS، OBSERVABILITY، PRODUCTIVITY |
versions | نسخههای منتشرشده؛ هر نسخه ایمیج و تعداد پورت خودش را دارد |
default_version | نسخهای که وقتی چیزی انتخاب نکنید استفاده میشود |
verified | نتیجه بررسی ایمیج و سرویسهای جانبی در مخزن |
status | ACTIVE یا DISABLED |
قالبهای DISABLED در کنسول نمایش داده نمیشوند، حتی اگر شناسهشان را بدانید؛ API با TEMPLATE_UNAVAILABLE رد میکند.
قالبهای پیشفرض
| قالب | کاربرد | پورت داخلی |
|---|---|---|
n8n | اتوماسیون گردشکار بدون کد | 5678 |
vscode-web | VS Code در مرورگر (code-server) | 8080 |
hermes-agent | عامل هوش مصنوعی | 8080 |
gitea | میزبان گیت سبک | 3000 |
directus | مدیریت محتوا و API | 8055 |
umami | تحلیل بازدید بدون کوکی | 3000 |
ghost | وبلاگ و خبرنامه | 2368 |
grafana | داشبورد پایش | 3000 |
nextcloud | فضای ابری شخصی | 80 |
uptime-kuma | پایش دسترسپذیری | 3001 |
9router | درگاه مدلهای زبانی | 8080 |
sentry | ردیابی خطا (نیازمند دیتابیس و Redis جدا) | 9000 |
madmail | سرور ایمیل | 8080 |
قالبهایی که وابستگی بیرونی دارند (مثل Sentry و Umami) با تنظیمات پیشفرض بالا میآیند اما برای کارکرد کامل به یک دیتابیس مدیریتشده نیاز دارند. آنها را از دیتابیسها بسازید و رشته اتصال را در تب متغیرها قرار دهید.
استقرار
از کنسول:
- برنامهها → استقرار سرویس جدید.
- گزینه اپ آماده را انتخاب کنید.
- قالب و نسخه را انتخاب کنید. منابع پیشفرض پر میشوند و میتوانید فقط رو به بالا تغییرشان دهید.
- هزینه ساعتی و ماهانه را ببینید و تایید کنید.
از CLI، معادل آن استفاده از ایمیج قالب است:
rayno up --image n8nio/n8n:latest --name n8n --port 5678 --cpu 500 --ram 1024 --disk 2
استقرار از CLI ایمیج را مستقیم میدهد و از کاتالوگ استفاده نمیکند. اگر میخواهید نسخههای قالب و منابع پیشفرض بهصورت خودکار اعمال شوند، از کنسول استفاده کنید.
WordPress: پلن اکو و توربو
WordPress مسیر جداگانهای دارد چون منابع و قابلیتهایش ثابت و از پیش تعریفشده است. پلنها از GET /api/v1/catalog/wordpress خوانده میشوند:
| پلن | منابع | برای چه کسی |
|---|---|---|
| Echo | CPU و RAM اقتصادی، دیسک کوچک | سایت شخصی، وبلاگ، ترافیک کم |
| Turbo | منابع بیشتر، پشتیبانگیری خودکار و پشتیبانی اولویتدار | فروشگاه و سایت پرترافیک |
| Ultra (نمونه) | بالاترین منابع و SLA کوتاهتر | سازمانی |
هر پلن در کنسول CPU، RAM، دیسک و سقف پهنای باند خودش را نشان میدهد؛ عددها از کاتالوگ میآیند و در متن مستندات تکرار نمیشوند تا کهنه نشوند.
ساخت سایت:
- برنامهها → استقرار سرویس جدید → وردپرس.
- پلن را انتخاب کنید.
- نام سایت، عنوان و اطلاعات مدیر را وارد کنید.
- تایید کنید. پلتفرم دیتابیس، ایمیج و volume را خودش میسازد.
curl -s -X POST $BASE/wordpress/sites \
-H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
-d '{"plan":"TURBO","name":"shop","title":"فروشگاه من",
"admin_email":"me@example.com","admin_password":"..."}' | jq
سایتهای ساختهشده در GET /wordpress/sites فهرست میشوند و با DELETE /wordpress/sites/{id} حذف میگردند.
تغییر قالب و نسخه
قالب یک برنامه پس از ساخت قابل تغییر نیست. برای ارتقای نسخه، برنامه جدیدی با همان قالب و نسخه جدید بسازید و پس از اطمینان، قدیمی را حذف کنید. دلیل این محدودیت این است که نسخههای مختلف قالب ممکن است پورت داخلی یا متغیرهای محیطی متفاوت داشته باشند و جابهجایی درجا میتواند داده را ناسازگار کند.
عیبیابی
| خطا | معنا |
|---|---|
TEMPLATE_REQUIRED | روش استقرار SAAS_APP است اما قالبی انتخاب نشده |
TEMPLATE_UNAVAILABLE | قالب یا نسخه غیرفعال شده است |
NO_SERVERS_AVAILABLE | گره آنلاینی با ظرفیت کافی نیست |
RESOURCE_TOO_SMALL | منابع کمتر از حداقل قالب است |
INSUFFICIENT_BALANCE | موجودی کمتر از هزینه ۷ روز است؛ کیف پول را شارژ کنید |