وبلاگ نت‌آرامآموزش، تجربه و راهکارهای زیرساخت

رفع externally-managed-environment پایتون بدون دست‌کاری بسته‌های سیستم

آموزش تشخیص externally-managed-environment، ساخت محیط مجازی و نصب امن پکیج‌های Python در هاست یا سرور لینوکسی.

انتشار:
توسط تیم فنی نت‌آرام
۶ دقیقه زمان مطالعه
۰ دیدگاه
محتوای تخصصی، ساده و کاربردی
هماهنگ با هویت حرفه‌ای نت‌آرام
بازگشت به لیست مقالات
تصویر شاخص مقاله رفع externally-managed-environment پایتون بدون دست‌کاری بسته‌های سیستم در وبلاگ نت‌آرام
محتوای آموزشی وبلاگ نت‌آرام
می‌خواهید با pip یک بسته پایتون نصب کنید، اما پیام externally-managed-environment می‌بینید. این پیام معمولاً یعنی پایتونی که انتخاب کرده‌اید به‌وسیله مدیر بسته سیستم‌عامل یا یک مدیر محیط دیگر نگهداری می‌شود و نصب مستقیم با pip در همان محیط محدود شده است. هدف این محدودیت جلوگیری از ناسازگارشدن ابزارهای سیستم و بسته‌های نصب‌شده پروژه است.
برای بیشتر پروژه‌ها راه‌حل، ساخت یا انتخاب یک محیط مجازی اختصاصی و نصب بسته‌ها در همان محیط است. در این راهنما اول مشخص می‌کنیم کدام مفسر در حال استفاده است، سپس برای سرور مستقل و هاست دارای پنل، مسیر مناسب را جدا توضیح می‌دهیم. اضافه‌کردن گزینه دورزدن حفاظت یا اجرای pip با دسترسی ریشه، نخستین راه‌حل نیست.

۱. ببینید خطا برای کدام Python است

در ترمینال، متن کامل خطا و فرمانی را که اجرا کرده‌اید بخوانید. سپس این دستورها را بزنید:
کد / دستورcommand -v python3 python3 --version python3 -m pip --version python3 -c 'import sys; print("executable:", sys.executable); print("prefix:", sys.prefix); print("base:", sys.base_prefix)'
مسیر مفسر و نسخه pip وابسته به همان مفسر نمایش داده می‌شوند. در یک محیط مجازی معمولی، sys.prefix اغلب با sys.base_prefix فرق دارد. اگر هر دو یکسان باشند، احتمالاً در محیط پایه هستید. این آزمایش را با همان فرمانی انجام دهید که خطا داده؛ pip تنها ممکن است به Python دیگری اشاره کند.
اگر از هاست اشتراکی با Python App استفاده می‌کنید، پیش از ساخت دستی محیط مرحله پنل را بخوانید. مسیر و نسخه‌ای که پنل برای برنامه انتخاب می‌کند می‌تواند با python3 عمومی ترمینال فرق داشته باشد.

۲. روی سرور مستقل یک محیط تازه برای پروژه بسازید

ابتدا به نسخه آزمایشی پروژه بروید. مسیر نمونه را با پوشه واقعی خود عوض کنید:
کد / دستورcd ~/myproject pwd ls -la
نسخه Python باید با کد و وابستگی‌های پروژه سازگار باشد. سپس با نامی که از قبل وجود ندارد محیط تازه بسازید:
کد / دستورpython3 -m venv .venv-test .venv-test/bin/python --version .venv-test/bin/python -m pip --version
فرمان اول پوشه محیط را ایجاد می‌کند و دو فرمان بعد مفسر و pip همان محیط را نشان می‌دهند. اگر .venv-test قبلاً وجود دارد، نام تازه‌ای انتخاب کنید تا محیط سالم دیگری را رونویسی نکنید. اگر ساخت محیط به دلیل نبودن پشتیبانی venv یا ensurepip شکست خورد، متن خطا و نسخه سیستم‌عامل را ببینید:
کد / دستورcat /etc/os-release
در سرور مستقل Debian یا Ubuntu، مدیر سیستم ممکن است نیاز داشته باشد بسته پشتیبانی محیط مجازی را با مدیر بسته همان سیستم نصب کند؛ نام دقیق و نسخه را با راهنمای توزیع تطبیق دهید. این کار به دسترسی مدیریتی و بررسی مخازن نیاز دارد. در هاست اشتراکی از دستورهای سیستمی یا sudo استفاده نکنید و مسیر پنل را دنبال کنید.

۳. وابستگی تأییدشده را در همان محیط نصب کنید

اگر فایل requirements.txt متعلق به همین نسخه برنامه و از منبع مورد اعتماد است، ابتدا وجودش را ببینید:
کد / دستورls -la requirements.txt
سپس در نسخه آزمایشی:
کد / دستور.venv-test/bin/python -m pip install -r requirements.txt .venv-test/bin/python -m pip check
فرمان اول بسته‌ها را در محیط جدید نصب می‌کند و ممکن است اسکریپت‌های نصب آن‌ها را اجرا کند؛ فایل نیازمندی و منبع بسته‌ها باید قابل اعتماد باشند. فرمان دوم ناسازگاری‌های شناخته‌شده وابستگی‌ها را گزارش می‌کند، اما آزمون کامل برنامه نیست. اگر فایل نیازمندی ندارید، نام و نسخه مورد تأیید پروژه را از توسعه‌دهنده یا مخزن پروژه بگیرید؛ نصب تصادفی آخرین نسخه همه بسته‌ها می‌تواند برنامه را بشکند.
برای واردشدن به محیط در یک پوسته لینوکسی می‌توانید بنویسید:
کد / دستورsource .venv-test/bin/activate python -c 'import sys; print(sys.executable)' deactivate
فرمان دوم باید مفسر محیط آزمایشی را نشان دهد و deactivate فقط همان پوسته را از حالت فعال خارج می‌کند. فعال‌سازی ضروری نیست اگر همواره مسیر کامل .venv-test/bin/python را به کار ببرید. نتیجه ترمینال به‌تنهایی نشان نمی‌دهد وب‌سرور یا کار زمان‌بندی‌شده هم از همان محیط استفاده می‌کند.

۴. روی هاست دارای پنل از محیط خود برنامه استفاده کنید

در cPanel بخش Setup Python App یا ابزار معادل را باز کنید. برنامه درست، نسخه پایتون، مسیر Application root و فرمان فعال‌سازی محیطی را که پنل نمایش می‌دهد پیدا کنید. فرمان اختصاصی را در Terminal یا SSH حساب اجرا کنید و سپس نسخه و مسیر python -m pip را دوباره ببینید. وابستگی‌های تأییدشده باید در محیط همان برنامه نصب شوند.
اگر پس از ورود به محیط پنل باز هم خطای externally-managed دریافت می‌کنید، خروجی مسیر مفسر و متن خطا را بدون رمز برای پشتیبانی بفرستید؛ ممکن است محیط اشتباه انتخاب شده یا ساخت محیط برنامه ناموفق بوده باشد. حذف و ساخت دوباره برنامه فعال از پنل می‌تواند تنظیمات و دسترسی سایت را قطع کند؛ ابتدا از یک برنامه آزمایشی مستقل و روش پشتیبانی‌شده سرویس استفاده کنید.

۵. مسیر اجرای برنامه را آزمایش کنید

در نسخه آزمایشی، import کتابخانه‌های اصلی و آزمون‌های پروژه را با مفسر جدید اجرا کنید. برای برنامه Django، در پوشه دارای manage.py یک بررسی اولیه می‌تواند چنین باشد:
کد / دستور.venv-test/bin/python manage.py check
این فرمان فقط در پروژه Django با همان نام محیط مثال معنا دارد و موفقیت آن سلامت تمام مسیرهای سایت را ثابت نمی‌کند. اگر سرویس از cron یا فایل شروع وب‌سرور استفاده می‌کند، مسیر مفسر آن‌ها باید با محیط تأییدشده هماهنگ باشد. مسیرهای مربوط به برنامه زنده را فقط پس از آزمون و با امکان بازگشت تغییر دهید.

چرا نباید فوراً حفاظت را دور زد؟

گزینه‌ای مانند --break-system-packages برای دورزدن محدودیت وجود دارد، اما نصب بسته پروژه در محیط مدیریت‌شده سیستم می‌تواند وابستگی ابزارهای سیستم‌عامل را تغییر دهد. همین‌طور نصب --user در برخی محیط‌های مدیریت‌شده همچنان می‌تواند محدود شود. اگر مدیر سیستم برای یک کاربرد خاص واقعاً نیاز به تغییر محیط پایه دارد، باید اثر آن را بر بسته‌های توزیع و پشتیبانی آینده بداند؛ برای برنامه معمولی، محیط مجازی روش مناسب‌تری است.
در پایان، برنامه را با روش پنل یا سرویس خودش Restart و قابلیت واقعی آن را آزمایش کنید. اگر محیط پس از انتقال مسیر قبلی را نشان می‌دهد، راهنمای bad interpreter پس از انتقال را بخوانید. امکانات سرویس را در هاست پایتون نت‌آرام و تعریف این محدودیت را در راهنمای رسمی بسته‌بندی Python ببینید.
اشتراک‌گذاری:
لینکدینتلگرامایکس
مقاله قبلی
مقاله قبلی وجود ندارد.

دیدگاه‌ها (۰)

دیدگاه‌های تاییدشده و پاسخ‌های تیم نت‌آرام