النشر على DigitalOcean#

سيرشدك هذا الدليل خطوة بخطوة خلال نشر تطبيق Vapor بسيط من نوع “مرحباً بالعالم” على Droplet. ولاتّباع هذا الدليل، يجب أن يكون لديك حساب DigitalOcean مع إعداد الفوترة.

إنشاء الخادم#

لنبدأ بتثبيت Swift على خادم Linux. استخدم قائمة الإنشاء لإنشاء Droplet جديد.

ضمن التوزيعات، اختر Ubuntu 22.04 LTS. سيستخدم الدليل التالي هذا الإصدار كمثال.

بعد اختيار التوزيعة، اختر أي خطة ومنطقة مركز بيانات تفضّلها. ثم أعِدّ مفتاح SSH للوصول إلى الخادم بعد إنشائه. وأخيراً، انقر على إنشاء Droplet وانتظر حتى يبدأ الخادم الجديد بالعمل.

بمجرد أن يصبح الخادم الجديد جاهزاً، مرّر المؤشر فوق عنوان IP الخاص بـ Droplet وانقر على نسخ.

الإعداد الأولي#

افتح الطرفية واتصل بالخادم بوصفك المستخدم root باستخدام SSH.

ssh root@your_server_ip

يوفّر DigitalOcean دليلاً مفصّلاً حول الإعداد الأولي للخادم على Ubuntu 22.04. سيغطي هذا الدليل الأساسيات بسرعة.

إعداد الجدار الناري#

اسمح بمرور OpenSSH عبر الجدار الناري وفعّله.

ufw allow OpenSSH
ufw enable

إضافة مستخدم#

أنشئ مستخدماً جديداً بخلاف root. يُسمّي هذا الدليل المستخدم الجديد vapor.

adduser vapor

اسمح للمستخدم المُنشأ حديثاً باستخدام sudo.

usermod -aG sudo vapor

انسخ مفاتيح SSH المُصرّح بها للمستخدم root إلى المستخدم المُنشأ حديثاً. سيسمح لك هذا بالاتصال عبر SSH بوصفك المستخدم الجديد.

rsync --archive --chown=vapor:vapor ~/.ssh /home/vapor

وأخيراً، اخرج من جلسة SSH الحالية وسجّل الدخول بوصفك المستخدم المُنشأ حديثاً.

exit
ssh vapor@your_server_ip

تثبيت Swift#

الآن وبعد أن أنشأت خادم Ubuntu جديداً وسجّلت الدخول بمستخدم غير root، يمكنك تثبيت Swift.

التثبيت المؤتمت باستخدام أداة Swiftly CLI (موصى به)#

زُر موقع Swiftly للاطّلاع على تعليمات تثبيت Swiftly و Swift على Linux. بعد ذلك، ثبّت Swift بالأمر التالي:

الاستخدام الأساسي#

$ swiftly install latest

Fetching the latest stable Swift release...
Installing Swift 5.9.1
Downloaded 488.5 MiB of 488.5 MiB
Extracting toolchain...
Swift 5.9.1 installed successfully!

$ swift --version

Swift version 5.9.1 (swift-5.9.1-RELEASE)
Target: x86_64-unknown-linux-gnu

تثبيت Vapor باستخدام Vapor Toolbox#

الآن وبعد تثبيت Swift، لنثبّت Vapor باستخدام Vapor Toolbox. ستحتاج إلى بناء الـ toolbox من المصدر. اطّلع على إصدارات الـ toolbox على GitHub للعثور على أحدث إصدار. في هذا المثال، نستخدم الإصدار 18.6.0.

استنساخ وبناء Vapor#

استنسخ مستودع Vapor Toolbox.

git clone https://github.com/vapor/toolbox.git

تحقّق من أحدث إصدار.

cd toolbox
git checkout 18.6.0

ابنِ Vapor وانقل الملف التنفيذي إلى مسارك.

swift build -c release --disable-sandbox --enable-test-discovery
sudo mv .build/release/vapor /usr/local/bin

إنشاء مشروع Vapor#

استخدم أمر المشروع الجديد الخاص بالـ Toolbox لإنشاء مشروع.

vapor new HelloWorld -n

بمجرد انتهاء الأمر، انتقل إلى المجلد المُنشأ حديثاً:

cd HelloWorld

فتح منفذ HTTP#

للوصول إلى Vapor على خادمك، افتح منفذ HTTP.

sudo ufw allow 8080

التشغيل#

الآن وبعد أن أُعِدّ Vapor ولدينا منفذ مفتوح، لنشغّله.

swift run App serve --hostname 0.0.0.0 --port 8080

زُر عنوان IP الخاص بخادمك عبر المتصفح أو الطرفية المحلية، ومن المفترض أن ترى “It works!”. عنوان IP في هذا المثال هو 134.122.126.139.

$ curl http://134.122.126.139:8080
It works!

بالعودة إلى خادمك، من المفترض أن ترى سجلات لطلب الاختبار.

[ NOTICE ] Server starting on http://0.0.0.0:8080
[ INFO ] GET /

استخدم CTRL+C لإنهاء الخادم. قد يستغرق الأمر ثانية لإيقاف التشغيل.

تهانينا على تشغيل تطبيق Vapor الخاص بك على DigitalOcean Droplet!

الخطوات التالية#

يشير باقي هذا الدليل إلى موارد إضافية لتحسين نشرك.

Supervisor#

إن Supervisor هو نظام للتحكم في العمليات يمكنه تشغيل ملفك التنفيذي لـ Vapor ومراقبته. مع إعداد Supervisor، يمكن لتطبيقك أن يبدأ تلقائياً عند إقلاع الخادم وأن يُعاد تشغيله في حال تعطّله. تعرّف على المزيد حول Supervisor.

Nginx#

إن Nginx هو خادم HTTP ووكيل سريع للغاية ومُختبَر بشدة وسهل الإعداد. وبينما يدعم Vapor خدمة طلبات HTTP مباشرة، فإن الوكالة خلف Nginx يمكن أن توفر أداءً وأماناً وسهولة استخدام أعلى. تعرّف على المزيد حول Nginx.