الدليل
طرق النشر
كل طريقة مع فيديو قصير ومثال «Hello, world» يمكنك نسخه. جميعها تعمل داخل المملكة.
01استيراد مستودع (تطبيق GitHub)
wadiup-hello-app ↗- الإعدادات ← GitHub ← إدارة المستودعات على GitHub؛ اختر المستودع واحفظ.
- جديد ← استيراد مستودع ← نشر.
- سمِّ المشروع واضغط تطبيق. ملف wadiup.yaml (أو render.yaml) في المستودع يحدد ما يُنشأ.

02النشر عند الدفع
wadiup-hello-app ↗- ادفع تعديلاً إلى الفرع المنشور (main).
- يُبلغ GitHub منصة وادي أب، فيُبنى نفس الإيداع ويُطلق دون أي نقرة.
- تعرض صفحة النشرات الإصدار الجديد «مباشر» والسابق «مستبدل».

03لصق ملف مخطط
- افتح مشروعاً وانزل إلى «المخطط».
- الصق wadiup.yaml أو render.yaml كما هو، ثم طبّق. العناصر الموجودة لا تتكرر.
services:
- type: web
name: hello
image: nginxdemos/hello:plain-text
port: 80
04عنوان Git عام
wadiup-hello-node ↗- المشروع ← إضافة ← خدمة ويب.
- افتح «أو ابنِ من Git» والصق عنوان المستودع العام. لا حاجة إلى Dockerfile: يُكتشف Node.js تلقائياً.

05Git خاص برمز شخصي
wadiup-hello-private ↗- أنشئ الخدمة من عنوان المستودع الخاص.
- في صفحة الخدمة، رمز GitHub للمستودعات الخاصة: الصق رمزاً محدود الصلاحية (Contents: read)، احفظ ثم انشر الآن.
لبيئات الاختبار فقط. النشر الإنتاجي يتطلب تطبيق GitHub.

06صورة جاهزة
- المشروع ← إضافة ← خدمة ويب.
- أدخل الصورة (مثل nginxdemos/hello) ومنفذها، اختر الخطة، ثم أنشئ.

07صورة من سجل خاص
wadiup-hello-image ↗- أنشئ خدمة ويب من الصورة الخاصة (مثل ghcr.io/<owner>/<image>:1) ومنفذها.
- في صفحة الخدمة، بيانات دخول السجل الخاص: المستخدم ورمز قراءة (GHCR: read:packages)، احفظ ثم انشر الآن.

08إعادة النشر والتراجع
wadiup-hello-app ↗- الخدمة ← إعادة النشر تبني الفرع نفسه من جديد.
- النشرات ← تراجع على أي إصدار سابق يعيد الصورة نفسها تماماً.

09رمز وصول لـ Claude وأدوات الذكاء الاصطناعي
- الإعدادات ← الأمان ورموز الوصول ← قراءة ونشر.
- تستطيع الأداة العرض والنشر والتراجع وتطبيق المخططات عبر /v1/mcp، ولا تستطيع الحذف أو الفوترة أو إدارة الأعضاء.

10موقع ثابت
wadiup-hello-static ↗- المشروع ← إضافة ← موقع ثابت، من Git.
- يكفي ملف index.html؛ يخدمه nginx عبر HTTPS.

11عامل في الخلفية
wadiup-hello-worker ↗- المشروع ← إضافة ← عامل خلفية، من Git.
- بلا منفذ ولا عنوان: تابعه في السجلات.

12مهمة مجدولة
wadiup-hello-cron ↗- المشروع ← إضافة ← مهمة مجدولة، من Git.
- حدد الجدول بتوقيت الرياض (مثل */5 * * * *). كل تشغيل يكتب في السجلات ثم ينتهي.

13PostgreSQL
- المشروع ← إضافة ← PostgreSQL؛ اختر الإصدار والخطة.
- اربطها بخدمة لتحصل على DATABASE_URL. النسخ الاحتياطي داخل المملكة.

14MongoDB
- المشروع ← إضافة ← MongoDB؛ التوفر العالي اختياري.
- اربطها بخدمة لتحصل على رابط الاتصال.

15تخزين الملفات (متوافق مع S3)
- المشروع ← إضافة ← تخزين ملفات؛ خاص افتراضياً.
- اربطه بخدمة لتحصل على متغيرات S3_*.

البدء السريع حسب اللغة (بدون Dockerfile)
إذا وُجد Dockerfile في المستودع فهو المعتمد. وإلا تتعرّف المنصة على نوع المشروع وتبنيه داخل المملكة.
| Node.js (Express, Nest) | package.json | npm ci → npm run build (if present) → npm start. PORT is set for you. | wadiup-hello-node ↗ |
| Next.js | package.json with next | Built and served with next start; choose a Web service. | |
| Static sites (Vite, React, Astro, plain HTML) | index.html or package.json | Choose Static site; output from dist, build, out or public is served by nginx with SPA fallback. | |
| Python (Django, Flask, FastAPI) | requirements.txt or pyproject.toml | pip install; the Procfile web: line is the start command, else main.py, app.py, or gunicorn for Django. | wadiup-hello-python ↗ |
| Go | go.mod | go build; the binary must listen on $PORT. | wadiup-hello-go ↗ |
| Java (Maven, Gradle, Spring Boot) | pom.xml or build.gradle | Maven or Gradle build; the jar is started with -Dserver.port=$PORT. | wadiup-hello-java ↗ |
| .NET | *.csproj | dotnet publish; ASPNETCORE_URLS set from $PORT. | wadiup-hello-dotnet ↗ |
| PHP (Laravel, WordPress) | composer.json or index.php | Apache with Composer install, listening on $PORT. | wadiup-hello-php ↗ |
| Ruby (Rack, Sinatra, Rails) | Gemfile | bundle install → bundle exec rackup on $PORT. | wadiup-hello-ruby ↗ |
الانتقال من Render
- Create a project on a KSA data plane.
- Paste your render.yaml as a blueprint, or add each service from the same repo and branch.
- Create PostgreSQL, restore your pg_dump, link it (DATABASE_URL).
- Add your custom domain, verify the TXT record, switch DNS.
الانتقال من Vercel
- Next.js apps: Web service, build and start detected.
- Pure static exports: Static site, publish directory out.
- Serverless functions run inside the Next.js server.
- Connect the GitHub App for push to deploy.
الانتقال من Heroku
- Your Procfile web: line is used as-is.
- Worker dynos: Background worker with a start command.
- Scheduler jobs: Cron job (Riyadh time).
- heroku pg:backups → restore into managed PostgreSQL.