BuilderIO/agent-native / packages/core/docs
agent-native-docs
UnverifiedHow to look up version-matched Agent-Native framework docs and source in node_modules. Use before coding against @agent-native/core APIs or advanced features.
content/locales/ar-SA/deploy-an-app.mdx
View on GitHub---
title: "نشر تطبيق"
description: "الخطوات التي يتبعها كل نشر لتطبيق Agent-Native مستقل، وأين تجد الدليل الخاص بموفر الاستضافة لديك."
---
# نشر تطبيق
يضع نشر تطبيق Agent-Native مستقل التطبيقَ على الإنترنت مع قاعدة بيانات حقيقية،
حتى يتمكن أشخاص آخرون من التسجيل واستخدامه. يتبع كل دليل استضافة الخطوات الخمس
نفسها. تشرح هذه الصفحة ما تفعله كل خطوة وتساعدك على اختيار موفر استضافة. ثم يقدّم
دليل كل موفر الأوامر الدقيقة.
<Callout tone="info">
يلزم Node.js `22.22+`.
</Callout>
## اختيار موفر استضافة {#choose-a-host}
| موفر الاستضافة | أين يعمل التطبيق |
| --------------------------------------------------------- | ------------------------------------------------- |
| [Node.js](/docs/node-js) | خادم تديره بنفسك، مثل جهاز افتراضي |
| [Docker](/docs/docker) | حاوية على خادم أو موفر استضافة حاويات تديره بنفسك |
| [Vercel](/docs/vercel) | استضافة Vercel، بدون خادم تحتاج إلى إدارته |
| [Netlify](/docs/netlify) | استضافة Netlify، بدون خادم تحتاج إلى إدارته |
| [Cloudflare Workers](/docs/cloudflare#cloudflare-workers) | شبكة Cloudflare، بدون خادم تحتاج إلى إدارته |
اختر Node.js أو Docker عندما تريد تحكمًا كاملًا في الجهاز الذي يعمل عليه التطبيق.
اختر Vercel أو Netlify أو Cloudflare Workers عندما تريد أن يشغّل موفر الاستضافة
التطبيق نيابةً عنك ويمنحه عنوانًا عامًا مع HTTPS.
## الخطوات التي يتبعها كل نشر {#the-steps-every-deployment-follows}
### الخطوة 1: إنشاء التطبيق {#step-1-create-the-app}
أنشئ تطبيقًا مستقلًا وثبّت تبعياته. تستخدم الأدلة قالب Chat كمثال، لكن يمكنك
البدء من أي قالب أو استخدام تطبيق لديك بالفعل. يشرح [البدء](/docs/getting-started)
كيفية إنشاء تطبيق وتشغيله محليًا.
### الخطوة 2: ضبط أسرار البيئة {#step-2-configure-environment-secrets}
يقرأ التطبيق إعدادات الإنتاج من متغيرات البيئة:
| المتغير | مطلوب | الغرض |
| -------------------- | ----- | ------------------------------------------------------- |
| `DATABASE_URL` | نعم | يربط التطبيق بقاعدة بيانات PostgreSQL الخاصة به |
| `BETTER_AUTH_SECRET` | نعم | يوقّع جلسات المستخدمين |
| `BETTER_AUTH_URL` | لا | يحدد العنوان العام الذي يستخدمه الناس للوصول إلى تطبيقك |
احفظ هذه المتغيرات في إعدادات البيئة لدى موفر الاستضافة، وليس فقط في ملف `.env`
المحلي الخاص بالتطبيق. يوضح كل دليل كيفية فعل ذلك لدى موفر الاستضافة الخاص به.
يجب أن يشير `DATABASE_URL` إلى قاعدة بيانات PostgreSQL دائمة، مثل Neon أو
Supabase أو Amazon RDS. توضح [أدلة موفري قواعد البيانات](/docs/neon) مكان العثور
على سلسلة الاتصال. يجب أن يبقى `BETTER_AUTH_SECRET` ثابتًا عبر عمليات النشر، لأن
تغييره يؤدي إلى تسجيل خروج كل مستخدم. اضبط `BETTER_AUTH_URL` عند استخدام نطاق
مخصص أو وكيل عكسي.
يسرد [مرجع بيئة النشر](/docs/deployment-environment-variables) كل إعدادات الإنتاج
الأخرى.
### الخطوة 3: الترحيل {#step-3-migrate}
تنشئ عمليات الترحيل الجداول التي يحتاجها التطبيق في قاعدة البيانات وتحدّثها.
شغّلها مقابل قاعدة بيانات الإنتاج قبل أول زيارة، ومرة أخرى بعد كل ترقية:
```bash
pnpm migrate:production
```
لا تتخطَّ هذه الخطوة. في الإنتاج، وخاصةً لدى موفري الاستضافة بدون خوادم، لا ينشئ
التطبيق دائمًا الجداول الناقصة بنفسه. عندها يؤدي الجدول الناقص إلى فشل أول استعلام
حقيقي.
### الخطوة 4: البناء {#step-4-build}
ابنِ التطبيق لموفر الاستضافة لديك. يضبط كل دليل `NITRO_PRESET` حتى ينتج البناء
التنسيق الذي يتوقعه موفر الاستضافة، مثل `node` أو `vercel` أو `netlify` أو
`cloudflare_module`.
### الخطوة 5: النشر {#step-5-deploy}
شغّل البناء أو ارفعه. على Node.js وDocker، تشغّل الخادم أو الحاوية بنفسك. على
Vercel وNetlify وCloudflare Workers، ترفع أداة سطر أوامر البناء وتطبع العنوان العام
للتطبيق.
<Callout tone="warning">
لا تستخدم قاعدة بيانات التطوير المحلية في الإنتاج. فهي تخزّن البيانات على الجهاز
الذي يشغّل التطبيق، لذلك تُفقد لدى معظم موفري الاستضافة. ويعمل اختصار **Continue as local
dev** أيضًا أثناء التطوير المحلي فقط. يستخدم التطبيق المنشور تدفق التسجيل وتسجيل
الدخول المدعوم بقاعدة بيانات الإنتاج وسر المصادقة الخاصين بك.
</Callout>
## التحقق من النشر {#check-the-deployment}
بعد أول عملية نشر، افتح العنوان العام للتطبيق وتحقق مما يلي:
- يمكنك إنشاء حساب وتسجيل الدخول.
- تبقى البيانات التي تنشئها موجودة بعد إعادة تحميل الصفحة.
- يشير أي تسجيل دخول عبر OAuth أو webhook يستخدمه تطبيقك إلى العنوان العام.
## ما هي الخطوة التالية {#whats-next}
- [**متغيرات بيئة النشر**](/docs/deployment-environment-variables) - القائمة الكاملة لإعدادات الإنتاج
- [**قاعدة البيانات**](/docs/server-database#production) - اتصالات قاعدة بيانات الإنتاج
- [**الأمان**](/docs/security) - قائمة التحقق الخاصة بأمان الإنتاج
- [**النشر**](/docs/deployment) - قارن بين أهداف الاستضافة ومتطلباتها الأساسية
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |