التثبيت السريع

التثبيت بأمر واحد

curl -fsSL https://f5-sales-demo.github.io/devcontainer/scripts/install.sh | bash

يتولى هذا الأمر الواحد عملية الإعداد الكاملة عند التشغيل لأول مرة:

1. تثبيت حزم Homebrew (podman, podman-compose, gh, iterm2, nerd fonts)
2. تكوين iTerm2 (الخط، التنبيه الصوتي، سجل التمرير، السمة الداكنة، اختصار Shift+Enter)
3. تهيئة وضبط آلة Podman (ذاكرة 16 جيجابايت، 4 وحدات معالجة، قرص 220 جيجابايت، zram، swappiness)
4. تنزيل docker-compose.yml و devcontainer.sh وقالب .env إلى المجلد الحالي

يتطلب Homebrew

إذا لم يكن Homebrew مثبتاً، يتوقف السكريبت مع عرض التعليمات. قد يوفر قسم تقنية المعلومات لديكم Homebrew كبرنامج مُدار — تحقق معهم أولاً.

بعد التثبيت

عدّل .env بإضافة بيانات الاعتماد الخاصة بك:

vi .env

ثم ابدأ تشغيل الحاوية:

./devcontainer.sh

يكتشف السكريبت منطقتك الزمنية تلقائياً ويجلب رمز GitHub حديثاً من gh auth token عند كل تشغيل.

ما يتم إنشاؤه

بعد تشغيل أداة التثبيت، سيحتوي مجلدك على:

الملف	الغرض
devcontainer.sh	سكريبت التشغيل (شغّل هذا لبدء الحاوية)
docker-compose.yml	تعريف خدمة الحاوية
.env	بيانات الاعتماد الخاصة بك (من القالب، عدّله قبل أول تشغيل)

عمليات التشغيل اللاحقة

./devcontainer.sh

الاتصال

podman exec -it devcontainer zsh

التحديث

اسحب أحدث صورة وأعد التشغيل:

podman compose pull
./devcontainer.sh

البناء المحلي

ابنِ الصورة محلياً من المصدر (arm64 فقط):

./devcontainer.sh build