تثبيت Oracle 26ai وAPEX 26.2 عبر Docker

شغّل منظومة أوراكل كاملة — Oracle AI Database 26ai Free وORDS 26.3 وAPEX 26.2 — محليًا عبر Docker. هذه هي الأساس الذي تبني عليه بقية الأدلة.

يستخدم هذا الدليل القالب المرافق المجاني oracle-26ai-apex-docker. فهو يثبّت إصدارات الصور، ويتحقق من تنزيل APEX مقابل البصمة التي تنشرها أوراكل، ويترك حاوية ORDS الرسمية تثبّت APEX نيابةً عنك.

اختر نظام التشغيل — كل كتلة أوامر في هذه الصفحة تتبدّل معه:

المتطلبات

تحتاج إلى Docker وGit ونحو 15 جيجابايت من المساحة وما لا يقل عن 4 جيجابايت ذاكرة لـ Docker. على ويندوز يعمل Docker Desktop فوق WSL2.

# Install WSL2 (admin PowerShell; reboot if prompted), then Docker Desktop and Git
wsl --install
winget install -e --id Docker.DockerDesktop
winget install -e --id Git.Git

تأكد أن Docker يعمل قبل المتابعة:

docker run hello-world

الوصول إلى صور أوراكل

أنشئ حسابًا مجانيًا على container-registry.oracle.com. افتح Database → free وDatabase → ords واقبل الترخيص في كل صفحة مرة واحدة. ثم سجّل دخول Docker:

docker login container-registry.oracle.com

يجب أن ترى Login Succeeded.

احصل على القالب واضبط كلمات المرور

cd $HOME
git clone https://github.com/Mohamedhrby/oracle-26ai-apex-docker.git
cd oracle-26ai-apex-docker
copy .env.example .env
notepad .env

اضبط أربع كلمات مرور في .env: ORACLE_PWD (لـ SYS/SYSTEM)، وORDS_PUBLIC_PWD وAPEX_PUBLIC_PWD (الحسابان اللذان يتصل بهما ORDS)، وAPEX_ADMIN_PWD (دخولك كمسؤول APEX). وإذا كان المنفذ 1521 أو 8080 مستخدمًا، فغيّر DB_PORT أو ORDS_PORT.

نزّل APEX 26.2

لا يأتي APEX مع Docker. يُنزّل هذا السكربت APEX من oracle.com، ويتحقق منه مقابل بصمة SHA256 التي تنشرها أوراكل، ثم يفكّ ضغطه إلى ./apex:

.\scripts\get-apex.ps1

حجم التنزيل الكامل نحو 340 ميجابايت ويشمل كل اللغات، وهو ما تحتاجه لواجهة APEX Builder مترجمة (العربية مثلًا). وللإنجليزية فقط اضبط APEX_EDITION=en في .env قبل تشغيله.

شغّل المنظومة

docker compose up -d
docker compose logs -f ords

في التشغيل الأول تُنزَّل نحو 10 جيجابايت من الصور، ثم تبدأ القاعدة، ثم يثبّت ORDS نفسه وAPEX في FREEPDB1. خصّص 15 إلى 25 دقيقة بعد انتهاء التنزيل. اضغط تشغيل لترى السجل الحقيقي لتشغيل أول سليم:

عندما ترى Starting the Oracle REST Data Services instance اضغط Ctrl+C لإيقاف متابعة السجل؛ وتبقى المنظومة تعمل.

اضبط كلمة مرور مسؤول APEX

يمنح المثبّت الصامت الذي تشغّله حاوية ORDS مسؤولَ نسخة APEX كلمة مرور ثابتة مكتوبة في سكربت الصورة الرسمي من أوراكل — أي أنها معروفة للجميع عمليًا. استبدلها بقيمة APEX_ADMIN_PWD:

.\scripts\set-admin-password.ps1

التحقق وأول دخول

docker compose ps

يجب أن تظهر الحاويتان بحالة healthy. افتح http://localhost:8080/ords/apex وادخل إلى مساحة العمل INTERNAL باسم ADMIN وكلمة المرور APEX_ADMIN_PWD. ستصل إلى صفحة *Welcome to Oracle APEX*. اختر Create Workspace لإنشاء أول مساحة عمل ومخطط.

اتصل من SQLcl أو أي عميل SQL:

sql system@//localhost:1521/FREEPDB1

دورة الحياة اليومية

docker compose stop      # pause (keeps data)
docker compose start     # resume
docker compose down      # remove containers (volumes and data persist)
docker compose down -v   # full reset: DELETES the database

جرّب بعض الأوامر الآمنة بنفسك:

ترقية APEX لاحقًا

عندما تصدر أوراكل إصدار APEX التالي، حدّث الإصدار والبصمات في أعلى scripts/get-apex.* وشغّله مجددًا، ثم docker compose restart ords. يكتشف ORDS الإصدار الأحدث في ./apex ويرقّي APEX في مكانه. تحقّق أولًا من إصدار ORDS المطلوب لذلك الإصدار وحدّث وسم صورة ORDS عند الحاجة.

اختبر فهمك

أصبحت لديك بيئة Oracle وAPEX 26.2 محلية كاملة ومُتحقَّق منها. التالي: ابنِ أول تطبيق بالمحادثة مع وكيل ذكاء اصطناعي.