3.0 KiB
بسم الله الرحمن الرحيم
إليك كيفية إعداد ملف pip.conf لجعل سجل "غيمة" هو المصدر الافتراضي:
📝 إعداد ملف pip.conf
يعتمد مسار هذا الملف على نظام التشغيل الخاص بك. اختر النظام المناسب أدناه:
1. على أنظمة Linux و macOS
يتم وضع الملف عادةً في المسار ~/.config/pip/pip.conf. إذا لم يكن المجلد موجودًا، يمكنك إنشاؤه.
أو يمكنك وضعه في المجلد الرئيسي ~/.pip/pip.conf (للإصدارات القديمة).
2. على نظام Windows
يتم وضع الملف في المسار %APPDATA%\pip\pip.ini.
⚙️ محتوى الملف
بما أن سجل "غيمة" هو سجل خاص (Private Registry)، يفضل إضافة trusted-host لتجنب مشاكل شهادات SSL ولتعريف الجهاز بأن هذا المستضيف موثوق.
افتح الملف pip.conf (أو pip.ini) وأضف الأسطر التالية:
[global]
index-url = https://pypi.ghaymah.systems/simple/
trusted-host = pypi.ghaymah.systems
توضيح الإعدادات:
index-url: يحدد أن أي أمرpip installسيبحث تلقائيًا في سجل غيمة بدلاً من PyPI العالمي.trusted-host: يخبرpipبالوثوق في هذا النطاق، وهو ضروري إذا كان السجل يستخدم شهادات داخلية أو HTTP (رغم أن الرابط يستخدم HTTPS، فهذا الإعداد يمنع بعض التحذيرات).
🔐 إضافة بيانات الاعتماد تلقائيًا
إذا كنت لا تريد إدخال اسم المستخدم وكلمة المرور في كل مرة تطلب فيها حزمة، يمكنك تضمينها داخل الرابط في ملف الإعداد (مع مراعاة الحيطة من كشف كلمة المرور في الأجهزة المشتركة):
[global]
index-url = https://myuser:mypassword@pypi.ghaymah.systems/simple/
trusted-host = pypi.ghaymah.systems
(استبدل myuser و mypassword بالبيانات التي حصلت عليها من فريق الدعم).
🔄 السيناريو المختلط: الاستخدام مع PyPI العالمي
إذا كنت تريد استخدام سجل "غيمة" للحزم الخاصة بك، مع الحفاظ على القدرة على تحميل الحزم العامة من PyPI، يفضل استخدام extra-index-url بدلاً من index-url ليبحث في كلا السجلين:
[global]
# يبحث هنا أولاً (غيمة)
index-url = https://myuser:mypassword@pypi.ghaymah.systems/simple/
# إذا لم يجد الحزمة، يبحث هنا (PyPI الرسمي)
extra-index-url = https://pypi.org/simple
trusted-host = pypi.ghaymah.systems
بعد حفظ هذا الملف، يمكنك ببساطة تشغيل:
pip install my-package
وسيقوم pip بالبحث في سجل غيمة تلقائيًا.