إدارة بنية السحابة يدوياً عبر لوحات الويب بطيئة وعرضة للأخطاء ولا يمكن توسيعها. بينما تعتمد أدوات البنية التحتية ككود (IaC) التقليدية مثل Terraform على لغات إعداد خاصة بالمجال (HCL)، يتيح لك Pulumi تعريف ونشر وإدارة بنية السحابة باستخدام لغات برمجة حقيقية تشمل TypeScript/JavaScript وPython وGo وJava وC#.
في هذا الدليل، ستتعلم كيفية تثبيت Pulumi على VPS بنظام Ubuntu أو Debian، وإعداد تبعياته، ونشر موارد السحابة الأولى خطوة بخطوة.
جهّز خادم VPSie الخاص بك
- أنشئ حساباً: سجّل في بوابة عملاء VPSie.
- أضف رصيداً لحسابك: انتقل إلى الفوترة في البوابة لإضافة الرصيد أو إعداد طرق الدفع.
- انشر خادمًا: أنشئ جهاز افتراضي (VM) بنظام Linux يعمل بإصدار Ubuntu 24.04 / 26.04 LTS أو Debian 12 / 13 مع 2 vCPUs و2 GB RAM على الأقل.
حدّث النظام وثبّت الاعتماديات
يضمن أن مدير الحزم وتحديثات الأمان لديك محدّثة. سجّل الدخول إلى خادمك عبر SSH وحدّث قاعدة بيانات حزم النظام:
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git build-essential
تثبيت بيئات التشغيل اللغوية (Node.js وnpm)
يتطلب Pulumi بيئة تشغيل اللغة التي تختارها لكود البنية التحتية ككود (IaC). سنقوم بتثبيت Node.js (إصدار v20 LTS):
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
تحقق من التثبيت:
node -v
npm -v
تثبيت Pulumi CLI عبر السكربت الرسمي
شغّل سكربت التثبيت الآلي الخاص ب Pulumi:
curl -fsSL https://get.pulumi.com | sh
بعد الانتهاء، حدّث بيئة shell الحالية حتى يتمكن الطرفية النظامية من العثور على أمر pulumi:
export PATH=$PATH:$HOME/.pulumi/bin
echo 'export PATH=$PATH:$HOME/.pulumi/bin' >> ~/.bashrc
تحقق من التثبيت:
pulumi version
تهيئة حالة الخلفية الخلفية (Backend State) ل Pulumi
يحتاج Pulumi إلى تتبع حالة بنيتك التحتية. يمكنك تسجيل الدخول إلى الخدمة المدارة المجانية (Pulumi Cloud) أو تخزين الحالة محلياً على قرص خادمك:
الخلفية المحلية (إدارة ذاتية على خادمك):
pulumi login --local
عند تسجيل الدخول إلى واجهة خلفية محلية دون وجود مكدس نشط، سيطالبك Pulumi بإنشاء مشروع. طبّق واختر الخيارات المطلوبة عند الطلب:
- ماذا تريد أن تفعل؟ اختر إنشاء مشروع Pulumi جديد.
- أدخل أو أنشئ مجلدًا فارغًا: أدخل اسم المجلد (مثل: my-pulumi-app).
- ما المزوّد الذي تريد استخدامه؟ اختر برنامج Pulumi الأساسي (أو اختر مزوّد سحابة محددًا مثل AWS/DigitalOcean).
- ما اللغة التي تريد استخدامها؟ اختر لغتك المفضلة (مثل: Python أو TypeScript).
- تفاصيل المشروع (الاسم، الوصف، اسم المكدس): اضغط Enter لقبول القيم الافتراضية (مثل: اسم المكدس dev).
- هل تبدو هذه التفاصيل صحيحة؟ اختر نعم، أنشئ المشروع.
- العبارة السرية: أدخل كلمة مرور قوية لتشفير الأسرار المحلية وأعد إدخالها للتأكيد.
أنشئ مشروع Pulumi الأول
أنشئ مجلدًا جديدًا لأكواد البنية التحتية وابدأ تهيئة المشروع:
mkdir my-first-pulumi && cd my-first-pulumi
pulumi new aws-typescript
اتبع إشارات الطرف التفاعلي:
- اسم المشروع: اقبل القيمة الافتراضية (my-first-pulumi).
- وصف المشروع: اقبل القيمة الافتراضية أو اكتب ملخصًا موجزًا.
- اسم المكدس: اقبل القيمة الافتراضية (dev).
- منطقة AWS: اختر أقرب منطقة إليك (مثل us-east-1 أو eu-central-1).
تكوين بيانات اعتماد مزوّد السحابة
قبل النشر، قدّم مفاتيح الوصول الخاصة بمزوّد السحابة. على سبيل المثال، لإعداد AWS:
export AWS_ACCESS_KEY_ID="your-access-key-here"
export AWS_SECRET_ACCESS_KEY="your-secret-key-here"
نشر بنيتك التحتية
نفّذ أمر النشر داخل مجلد مشروعك:
pulumi up
ما يحدث خلال هذه الخطوة:
- يترجم Pulumi كود TypeScript الخاص بك إلى خطط تنفيذ.
- يقارن الكود الخاص بك مع ملف الحالة الحالي ويعرض معاينة تفصيلية (Diff Preview) للموارد التي سيتم إنشاؤها أو تعديلها أو حذفها.
- يُطلب منك: هل تريد تنفيذ هذا التحديث؟
- اضغط Enter على yes لتطبيق التغييرات على مزوّد السحابة.