Rayno DocsRayno Cloud v2.2.0
docsready-apps

اپ‌های آماده و وردپرس

کاتالوگ اپ‌های آماده، نسخه‌ها، پلن‌های وردپرس اکو و توربو و تغییر قالب.

اپ‌های آماده سرویس‌هایی هستند که با یک کلیک مستقر می‌شوند: فقط قالب و نسخه را انتخاب می‌کنید و پلتفرم ایمیج، پورت و منابع پیش‌فرض را خودش می‌داند. در کنسول، این گزینه در صفحه استقرار سرویس جدید با برچسب «اپ آماده» است.

چه چیزی از کاتالوگ می‌آید

فهرست زنده از GET /api/v1/catalog/apps خوانده می‌شود. برای هر قالب:

فیلدمعنا
slugشناسه یکتا (مثلاً n8n، ghost)
name_faنام نمایشی
categoryدسته: AUTOMATION، DEVTOOLS، AI، CMS، ANALYTICS، OBSERVABILITY، PRODUCTIVITY
versionsنسخه‌های منتشرشده؛ هر نسخه ایمیج و تعداد پورت خودش را دارد
default_versionنسخه‌ای که وقتی چیزی انتخاب نکنید استفاده می‌شود
verifiedنتیجه بررسی ایمیج و سرویس‌های جانبی در مخزن
statusACTIVE یا DISABLED

قالب‌های DISABLED در کنسول نمایش داده نمی‌شوند، حتی اگر شناسه‌شان را بدانید؛ API با TEMPLATE_UNAVAILABLE رد می‌کند.

قالب‌های پیش‌فرض

قالبکاربردپورت داخلی
n8nاتوماسیون گردش‌کار بدون کد5678
vscode-webVS Code در مرورگر (code-server)8080
hermes-agentعامل هوش مصنوعی8080
giteaمیزبان گیت سبک3000
directusمدیریت محتوا و API8055
umamiتحلیل بازدید بدون کوکی3000
ghostوبلاگ و خبرنامه2368
grafanaداشبورد پایش3000
nextcloudفضای ابری شخصی80
uptime-kumaپایش دسترس‌پذیری3001
9routerدرگاه مدل‌های زبانی8080
sentryردیابی خطا (نیازمند دیتابیس و Redis جدا)9000
madmailسرور ایمیل8080

قالب‌هایی که وابستگی بیرونی دارند (مثل Sentry و Umami) با تنظیمات پیش‌فرض بالا می‌آیند اما برای کارکرد کامل به یک دیتابیس مدیریت‌شده نیاز دارند. آن‌ها را از دیتابیس‌ها بسازید و رشته اتصال را در تب متغیرها قرار دهید.

استقرار

از کنسول:

  1. برنامه‌ها → استقرار سرویس جدید.
  2. گزینه اپ آماده را انتخاب کنید.
  3. قالب و نسخه را انتخاب کنید. منابع پیش‌فرض پر می‌شوند و می‌توانید فقط رو به بالا تغییرشان دهید.
  4. هزینه ساعتی و ماهانه را ببینید و تایید کنید.

از 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 خوانده می‌شوند:

پلنمنابعبرای چه کسی
EchoCPU و RAM اقتصادی، دیسک کوچکسایت شخصی، وبلاگ، ترافیک کم
Turboمنابع بیشتر، پشتیبان‌گیری خودکار و پشتیبانی اولویت‌دارفروشگاه و سایت پرترافیک
Ultra (نمونه)بالاترین منابع و SLA کوتاه‌ترسازمانی

هر پلن در کنسول CPU، RAM، دیسک و سقف پهنای باند خودش را نشان می‌دهد؛ عددها از کاتالوگ می‌آیند و در متن مستندات تکرار نمی‌شوند تا کهنه نشوند.

ساخت سایت:

  1. برنامه‌ها → استقرار سرویس جدید → وردپرس.
  2. پلن را انتخاب کنید.
  3. نام سایت، عنوان و اطلاعات مدیر را وارد کنید.
  4. تایید کنید. پلتفرم دیتابیس، ایمیج و 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موجودی کمتر از هزینه ۷ روز است؛ کیف پول را شارژ کنید
آخرین به‌روزرسانی: مستندات نسخه پلتفرم (Rayno Cloud v2.2.0)مشکلی در مستندات پیدا کردید؟ تیکت بزنید