SSD Nodes Learn Hosting plans →
מדריכים Matt Connorמאת Matt Connor · עודכן 2026-10-25

venv, pipx או uv בשרת Ubuntu: מה לבחור?

נתקלתם בשגיאת externally-managed-environment ב-Ubuntu? המדריך מסביר מתי להשתמש ב-venv, pipx או uv כדי לנהל חבילות Python מבלי לשבור את תלויות המערכת שלכם בשרת.

מדוע pip install נכשל בשרת Ubuntu חדש

הבחירה בין Python venv, pipx ו-uv בשרת מסתכמת בשאלה אחת: מה אתם מתקינים? תלויות של יישום שייכות לסביבה וירטואלית בתוך ספריית היישום עצמו. כלי שורת פקודה שברצונכם להפעיל לפי שם שייכים ל-pipx. הכלי uv מבצע את שתי המשימות ומוסיף קובץ lockfile, דבר שהופך למשמעותי ברגע שמכונה שנייה צריכה לבנות את אותה סביבה. אף אחד מהם לא מתקין חבילות לתוך ה-Python של המערכת, כיוון ששרת Ubuntu מודרני מסרב לכך באופן מוחלט.

הריצו את sudo pip install requests ב-Ubuntu 24.04, ו-pip יעצור לפני שיוריד אפילו קובץ אחד.

error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.

    If you wish to install a non-Debian-packaged Python package,
    create a virtual environment using python3 -m venv path/to/venv.
    Then use path/to/venv/bin/python and path/to/venv/bin/pip.

    If you wish to install a non-Debian packaged Python application,
    it may be easiest to use pipx install xyz, which will manage a
    virtual environment for you.

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this behaviour by passing --break-system-packages.

זהו PEP 668 (הצעה לשיפור Python מספר 668, "סביבות מנוהלות חיצונית") שמבצע את תפקידו. Debian ו-Ubuntu מציבות קובץ סימון לצד המפרש ב-/usr/lib/python3.12/EXTERNALLY-MANAGED, ו-pip מסרב לכתוב לתוך כל מפרש שנושא קובץ כזה.

הכלל קיים בגלל סדר ה-sys.path. הפקודה apt מתקינה ספריות לתוך /usr/lib/python3/dist-packages. הפקודה pip, כאשר היא מורצת כ-root מול מפרש המערכת, כותבת לתוך /usr/local/lib/python3.12/dist-packages, והאריזה של Debian מציבה ספרייה זו מוקדם יותר בנתיב החיפוש. הציגו זאת בעצמכם עם python3 -c 'import sys; print(sys.path)' וקראו את הסדר. לכן, העותק ש-pip כתב מסתיר את העותק ש-apt התקין, עבור כל תוכנית במכונה שרצה תחת /usr/bin/python3, כולל הכלים של ההפצה עצמה. התהליך cloud-init מייבא את requests, jinja2 ו-PyYAML מאותו מפרש. שדרגו אחד מהם עם pip, הגיעו לגרסה לא תואמת, ומשהו שמעולם לא נגעתם בו ייכשל באתחול הבא עם traceback שמציין חבילה שלא ידעתם שהיא בשרשרת. הפקודה apt עדיין רושמת את הגרסה שלה כמותקנת, לכן שום דבר לא יזהיר אתכם. התיקון הוא הסרת העותק של pip עם sudo pip uninstall --break-system-packages requests, כיוון ש-sudo apt reinstall python3-requests לבדו רק כותב מחדש את העותק של apt שכבר הוסתר.

הכלל הנובע מכך הוא קצר. ה-Python של המערכת שייך להפצה. אל תתקינו לתוכו, אל תשדרגו את הספריות שלו עם pip, ואל תמחקו את הקובץ EXTERNALLY-MANAGED כדי להעלים את ההודעה. המשימה היחידה שיש להטיל על /usr/bin/python3 היא בניית סביבות וירטואליות.

venv לעומת pipx לעומת uv: כללי ההחלטה

בחרו את הכלי לפי מה שאתם מתקינים, ולא לפי הכלי שקראתם עליו לאחרונה.

  • יישום שאתם פורסים ומריצים כשירות, כגון פרויקט Django או Flask: סביבה וירטואלית אחת (venv) בתוך תיקיית היישום.
  • כלי שורת פקודה שאתם רוצים ב-PATH שלכם, כגון ansible או httpie: השתמשו ב-pipx, שמעניק לכל כלי סביבה פרטית וקישור אחד ב-PATH.
  • פרויקט שזקוק לקובץ נעילה (lockfile), התקנות מהירות יותר, או גרסת Python שההפצה אינה מספקת: השתמשו ב-uv, שמייצר venv רגיל בתוספת קובץ uv.lock.
  • ספרייה שכלי של ההפצה זקוק לה, ולא הקוד שלכם: השתמשו ב-sudo apt install python3-<name>, הדרך הנתמכת היחידה להוסיף רכיבים למפרש המערכת.

pipx ו-uv tool install מבצעים את אותה עבודה, לכן שרת שכבר מותקן בו uv אינו זקוק גם ל-pipx. בחירת ה-web framework אינה משנה דבר כאן: Django ו-Flask על גבי VPS נבדלים במה שמגיע ל-requirements.txt, לא בדרך שבה נבנית הסביבה סביבם. כל מה שמתואר להלן משתמש ב-Ubuntu 24.04 וב-Python 3.12 שלה, לכן התאימו את הגרסה בתוך הנתיבים אם הגרסה שלכם שונה.

בניית venv לכל יישום

Ubuntu מפרידה את המודול venv מחבילת ה-Python הבסיסית, לכן בתמונה מינימלית הניסיון הראשון ייכשל עם הודעה המציינת במדויק מה חסר.

The virtual environment was not created successfully because ensurepip is not
available.  On Debian/Ubuntu systems, you need to install the python3-venv
package using the following command.

    apt install python3.12-venv

התקינו אותו, ולאחר מכן צרו את הסביבה כמשתמש שיהיה הבעלים של הקוד.

sudo apt update
sudo apt install -y python3-venv
sudo install -d -o deploy -g deploy -m 755 /srv/myapp
sudo -u deploy python3 -m venv /srv/myapp/.venv
sudo -u deploy /srv/myapp/.venv/bin/pip install -r /srv/myapp/requirements.txt

שימו לב למה שאינו קיים: אין source, אין activate. הפקודה /srv/myapp/.venv/bin/pip מתקינה לתוך אותה סביבה בזכות המיקום של הקובץ הבינארי, ולא בגלל משהו שייצאתם ל-shell. ודאו זאת לפני שתמשיכו.

/srv/myapp/.venv/bin/python -c 'import sys; print(sys.prefix)'

פעולה זו מדפיסה /srv/myapp/.venv. אם היא מדפיסה /usr, אתם מריצים את ה-interpreter של המערכת והחבילות שלכם הגיעו למקום שלא התכוונתם אליו.

שתי תכונות של venv קובעות מה תוכלו לעשות איתו לאחר מכן. venv אינו ניתן להעברה (relocatable), כיוון שכל סקריפט נקודת כניסה ב-bin/ נושא שורת shebang מוחלטת: head -1 /srv/myapp/.venv/bin/pip קורא את #!/srv/myapp/.venv/bin/python. שנו את שם תיקיית האב והסקריפטים הללו ייכשלו עם bad interpreter: No such file or directory. כמו כן, venv מקבע את ה-interpreter שיצר אותו, המתועד כשורת home ב-/srv/myapp/.venv/pyvenv.cfg, ו-bin/python3 הוא קישור סימבולי ל-/usr/bin/python3. שדרגו את גרסת המערכת כך שהנתיב יוביל כעת ל-Python חדש יותר, וה-interpreter החדש יחפש חבילות בתיקיית lib/python3.13 שאינה קיימת ב-venv, לכן השירות יקרוס בעת ההפעלה עם ModuleNotFoundError. בשני המקרים הפתרון זהה: מחקו את ה-venv ובנו אחד חדש מ-requirements.txt. בנייה מחדש אורכת שניות. לעולם אל תעתיקו venv בין מכונות.

מיקום ה-venv והבעלות עליו

מקמו את ה-venv לצד הקוד ב-/srv/myapp/.venv, והקפידו על venv אחד לכל יישום. כך הפריסה הופכת לספריה אחת, יחידת ה-systemd מקבלת נתיב קבוע שאינו משתנה, ושני יישומים לעולם לא ישבשו זה את זה עקב שדרוג תלויות משותף. אל תמקמו venv במקום שבו שרת האינטרנט מפרסם קבצים ישירות, כיוון שהוא מכיל את התלויות שלכם ולעיתים קרובות גם את הגדרות התצורה.

הבעלות דורשת תשומת לב קצרה. תנו למשתמש deploy להיות הבעלים של הקוד ושל הסביבה, והעניקו לחשבון השירות הרשאות קריאה והרצה בלבד.

sudo adduser --system --group --no-create-home myapp
sudo chown -R deploy:myapp /srv/myapp
sudo chmod -R o-rwx /srv/myapp

השירות יכול כעת לייבא את התלויות שלו אך לא לשכתב אותן. המשמעות היא שבאג של הרצת קוד ביישום האינטרנט לא יוכל להחליף בשקט ספרייה על הדיסק ולשרוד אתחול. אותו היגיון המיושם על שאר המכונה מוסבר ב-הרצת שירותים כמשתמשים בעלי הרשאות מינימליות.

pipx עבור כלי שורת פקודה

pipx מתקין יישומים, לא ספריות. כל כלי מקבל סביבה משלו תחת ~/.local/share/pipx/venvs/<name>, והקבצים הניתנים להרצה של אותו כלי מקושרים לתוך ~/.local/bin, כך ששני כלים הזקוקים לגרסאות שונות של אותה ספרייה לעולם לא יתנגשו.

sudo apt update
sudo apt install -y pipx
pipx ensurepath
pipx install httpie

pipx ensurepath מוסיף את ~/.local/bin לתוך PATH על ידי עריכת קובץ האתחול של ה-shell שלכם. הוא אינו יכול לשנות את ה-shell שבו אתם נמצאים כרגע, לכן http: command not found מיד לאחר ההתקנה בדרך כלל אומר שטרם התנתקתם ונכנסתם מחדש למערכת. ה-~/.profile המוגדר כברירת מחדל ב-Ubuntu מוסיף את ~/.local/bin רק כאשר התיקייה הזו כבר קיימת בעת הכניסה למערכת, וזו הסיבה שהבעיה הזו מופיעה פעם אחת בחשבון חדש ולאחר מכן לא חוזרת על עצמה.

אם תפנו את pipx לספרייה, הוא יסרב ויציג הודעה שמתחילה ב:

No apps associated with package requests.

זהו הכלי המציין בפניכם שזהו אינו הכלי המתאים למשימה. ספריות שייכות ל-venv של יישום.

הפרט שחשוב בשרת הוא המיקום. פקודת pipx install פשוטה מציבה את הכל תחת תיקיית הבית של משתמש יחיד. יחידת systemd שרצה כ-myapp לא יכולה לראות זאת, משימת cron של root לא יכולה לראות זאת, וגם sudo לא ימצא זאת, כיוון ש-secure_path בתוך /etc/sudoers מחליף את PATH ברשימה קבועה. עבור כלי שכל המכונה צריכה, יש להתקין אותו באופן גלובלי.

sudo pipx install --global ansible
sudo pipx ensurepath --global

הדגל --global מציב סביבות בתוך /opt/pipx ומקשר קבצים הניתנים להרצה לתוך /usr/local/bin, שנמצא ב-PATH המוגדר כברירת מחדל ובתוך secure_path. בדקו תחילה את הגרסה שלכם באמצעות pipx --version, כיוון ש-Ubuntu 24.04 כוללת את pipx 1.4.3, שהיא גרסה ישנה יותר מ---global, וגרסת pipx ישנה תשיב עם unrecognized arguments: --global. בגרסה זו, הגדירו את שתי התיקיות המתועדות בעצמכם:

sudo env PIPX_HOME=/opt/pipx PIPX_BIN_DIR=/usr/local/bin pipx install ansible
command -v ansible

command -v ansible אמור להדפיס /usr/local/bin/ansible. אם הוא מדפיס נתיב תחת /home, הכלי הותקן בחשבון של משתמש יחיד ואף שירות לא ימצא אותו.

uv כשרוצים קובץ lockfile

uv הוא קובץ בינארי יחיד מבית Astral המאחד את הפונקציונליות של pip,‏ venv ו-pip-tools, ויכול גם להוריד מפרשי Python. הוא מהיר מספיק כדי שההבדל יורגש ב-VPS קטן, והוא יוצר קובץ lockfile אמיתי.

מתקין התוכנה הרשמי מציב את uv ואת uvx ב-~/.local/bin:

curl -LsSf https://astral.sh/uv/install.sh | sh
uv --version

הזרמת סקריפט ישירות ל-shell בשרת דורשת רגע של תשומת לב. קבעו גרסה ב-URL וקראו את הקובץ לפני ההרצה:

curl -LsSf https://astral.sh/uv/0.12.3/install.sh -o uv-install.sh
less uv-install.sh
sh uv-install.sh

pipx install uv עובד גם הוא, אם pipx כבר מותקן. uv הוא קובץ בינארי עצמאי ללא תלות ב-Python, לכן העתקתו ל-/usr/local/bin היא דרך תקינה לשתף אותו עם כל המשתמשים במערכת.

עבור פרויקט עם pyproject.toml, תהליך העבודה מורכב מארבע פקודות, ורק האחרונה שבהן מורצת על השרת.

uv init myapp
uv add flask gunicorn
uv lock
uv sync --frozen --no-dev

uv lock כותב את uv.lock, קובץ lockfile חוצה-פלטפורמות המכיל גרסאות מדויקות שנפתרו, ואותו יש להוסיף ל-commit לצד הקוד. uv sync בונה את .venv בשורש הפרויקט בהתאם לקובץ זה. בשרת, --frozen הוא הדגל הקריטי: התיעוד מגדיר אותו כשימוש בגרסאות שבקובץ ה-lockfile כמקור האמת, במקום בדיקה אם הקובץ מעודכן – התנהגות רצויה בפריסה (deployment). --no-dev משמיט את קבוצת התלויות של הפיתוח.

פרויקט requirements.txt קיים אינו דורש המרה, כיוון ש-uv דובר את השפה של pip:

uv venv /srv/myapp/.venv
uv pip install --python /srv/myapp/.venv/bin/python -r /srv/myapp/requirements.txt

התוצאה היא סביבה וירטואלית רגילה עם הבדל אחד: uv לא מתקין לתוכה את pip, לכן .venv/bin/pip ו-.venv/bin/python -m pip לא יעבדו אלא אם יצרתם את הסביבה עם uv venv --seed. השתמשו ב-uv pip להתקנה במקום. שום דבר בהמשך המדריך הזה לא מריץ pip בתוך הסביבה, כך ששום דבר לא ישתנה.

יש הגדרת ברירת מחדל אחת ב-uv שכדאי להכיר לפני השימוש בשרת. הגדרת ה-python-preference שלו היא כברירת מחדל managed, שמתועדת כבחירה ב"אלו שהורדו והותקנו על ידי uv" על פני מפרשים שכבר קיימים במערכת. לכן, uv venv --python 3.13 על שרת שמספק רק 3.12 יוריד בשקט את 3.13 לתוך ~/.local/share/uv/python במקום להיכשל. זה נוח במחשב נייד ומפתיע בשרת, כיוון שהשירות שלכם תלוי כעת במפרש שנמצא בתיקיית הבית ושה-apt upgrade לעולם לא יעדכן. הגדירו את python-preference ל-only-system ב-uv.toml אם אתם מעדיפים את המפרש של ההפצה. אם אתם רוצים שהסביבה תהיה במקום אחר מאשר שורש הפרויקט, UV_PROJECT_ENVIRONMENT מציין את התיקייה שבה יש להשתמש עבור סביבה וירטואלית של פרויקט.

הפנו את systemd למפרש ה-venv, לא ל-activate

זהו המקום שבו רוב פריסות ה-Python נכשלות, והסיבה לכך היא אי-הבנה של מה ש-activate עושה.

bin/activate הוא סקריפט shell. הוא מוסיף את ספריית ה-bin של ה-venv לתחילת ה-PATH, מגדיר את VIRTUAL_ENV, שומר את הערכים הישנים כדי ש-deactivate יוכל לשחזר אותם, ומשנה את ה-prompt שלכם. הוא אינו מכיל דבר שהמפרש עצמו קורא. הפעלה (activation) היא נוחות עבור אדם המקליד python בשורת הפקודה.

מה שבוחר בפועל את הסביבה הוא קובץ המפרש שאתם מריצים. כאשר /srv/myapp/.venv/bin/python מתחיל, מודול ה-site של Python מחפש קובץ pyvenv.cfg בספרייה שמכילה את קובץ ההרצה וברמה אחת מעליה. מציאת /srv/myapp/.venv/pyvenv.cfg מגדירה את sys.prefix ל-venv, מה שמציב את ה-site-packages של אותו venv ב-sys.path. זהו כל המנגנון. הוא אינו זקוק למשתנה סביבה ואינו זקוק ל-shell.

לכן, יחידה זו לעולם לא תתחיל:

[Service]
ExecStart=source /srv/myapp/.venv/bin/activate && gunicorn app:app
myapp.service: Failed to locate executable source: No such file or directory
myapp.service: Failed at step EXEC spawning source: No such file or directory
myapp.service: Main process exited, code=exited, status=203/EXEC

ExecStart אינה שורת פקודה של shell. ‏systemd מריץ תוכנית ישירות, לכן אין פקודה מובנית של source, ‏&& מועבר כארגומנט מילולי, ואף אחת מהרחבות ה-shell לא מתרחשת מעבר לאלו ש-systemd מתעד בעצמו.

ויחידה זו מתחילה, ואז קורסת:

[Service]
ExecStart=/usr/bin/python3 /srv/myapp/app.py
ModuleNotFoundError: No module named 'flask'

/usr/bin/python3 הוא מפרש המערכת, וה-sys.path שלו מעולם לא הכיל את ה-venv שלכם. אותה פקודה עובדת בסשן ה-SSH שלכם רק משום שהפעלתם שם את ה-venv, כך שה-shell פתר את python3 דרך PATH ל-.venv/bin/python3 במקום זאת.

עטיפת הפקודה ב-/bin/bash -c 'source ... && gunicorn ...' אכן עובדת. היא גם מציבה shell בין systemd לבין התהליך שלכם ללא תועלת, בעוד שנתיב מוחלט אחד פותר את העניין:

[Unit]
Description=myapp web service
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=myapp
Group=myapp
WorkingDirectory=/srv/myapp
Environment=PYTHONUNBUFFERED=1
Environment=PATH=/srv/myapp/.venv/bin:/usr/local/bin:/usr/bin:/bin
ExecStart=/srv/myapp/.venv/bin/gunicorn --workers 3 --bind 127.0.0.1:8000 app:app
Restart=on-failure
RestartSec=5
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=full

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now myapp
systemctl status myapp
journalctl -u myapp -n 50 --no-pager

systemctl status myapp אמור לדווח על active (running) עם Main PID שהוא תהליך ה-gunicorn שלכם. לכל דבר אחר, קראו את ה-journal.

שורת ה-Environment=PATH= אינה שם עבור ExecStart, שכבר נושא נתיב מלא. היא שם עבור התהליכים שהיישום שלכם מפעיל. שירות יורש PATH ברירת מחדל קצר מ-systemd, לכן קוד Python שקורא ל-subprocess.run(["ffmpeg", ...]), או פקודת ניהול שמפעילה סקריפט קונסולה מתוך ה-venv, לא ימצאו את מה שהם צריכים. הצבת ספריית ה-bin של ה-venv בראש הרשימה היא החלק היחיד ב-activate ששירות באמת משתמש בו. בדקו מה היחידה קיבלה בפועל באמצעות systemctl show -p Environment myapp.

אותו כלל חל על עבודה מתוזמנת. ב-Ubuntu, ‏cron לא מעביר לעבודה את ה-PATH מה-shell שלכם או מה-daemon: אלא אם ה-crontab מגדיר את PATH בעצמו, כל עבודה מקבלת את ה-/usr/bin:/bin המהודר כברירת מחדל, ו-/etc/environment אינו דורס אותו. זה לעולם לא מכיל את ה-venv שלכם, לכן שורת crontab שקוראת python3 /srv/myapp/cleanup.py מריצה את מפרש המערכת ונכשלת עם ModuleNotFoundError בשלוש לפנות בוקר. ‏cron שולח את השגיאה בדוא"ל לבעלי ה-crontab, או לכתובת MAILTO אם הגדרתם כזו, מה שברוב השרתים אומר תיבת דואר מקומית שאף אחד לא קורא. ללא תוכנת דואר מותקנת, cron משליך את הפלט וכותב רק No MTA installed, discarding output ליומן המערכת. כתבו גם שם את הנתיב המוחלט ל-venv. כדי לקבל את הפלט הזה ב-journal ותיעוד של ההרצה האחרונה במקום זאת, זוג שירות וטיימר של systemd משתמש באותה שורת ExecStart.

האם Docker מחליף את ההחלטה הזו?

למכולה יש מערכת קבצים משלה, לכן השאלה משנה צורה במקום להיעלם. בתמונה רשמית כמו python:3.12-slim, ‏Python מובנה בתוך /usr/local ואינו נושא סימון EXTERNALLY-MANAGED, לכן pip install כ-root היא הדרך המיועדת להוספת חבילות, ושימוש ב-venv מוסיף מעט מאוד. אם תבנו FROM ubuntu:24.04 במקום זאת, תיתקלו ב-externally-managed-environment שוב בתוך התמונה, מאותה סיבה כמו במארח: זהו המפרש של ההפצה הנושא את קובץ הסימון של ההפצה.

תמונות רבות עדיין משתמשות ב-venv, כיוון שהוא מפשט בנייה רב-שלבית (multi-stage build). שלב הבנייה מתקין לתוך /opt/venv, ושלב ההרצה מעתיק את אותה תיקייה ומשאיר את המהדרים מאחור. בעיית ה-activate עוברת איתו. שורת RUN source /opt/venv/bin/activate משפיעה רק על ה-shell של שכבת הבנייה הזו, לכן בזמן ההרצה המכולה מתחילה עם מפרש המערכת ומעלה שגיאת ModuleNotFoundError. הגדירו ENV PATH="/opt/venv/bin:$PATH", או ספקו ל-CMD את הנתיב המוחלט /opt/venv/bin/gunicorn. זהו אותו באג כמו ב-systemd, רק בקובץ אחר.

לפיכך, מכולה מחליפה את שאלת המפרש, כיוון שהתמונה מקבעת את המפרש ואת כל מה שתחתיו. היא אינה מחליפה את שאלת הקיבוע (pinning). תמונה שנבנתה מ-requirements.txt לא מקובע תפתור גרסאות שונות בחודש הבא, מה שאומר שתג התמונה ניתן לשחזור בעוד שהבנייה שיצרה אותו אינה כזו. קובץ נעילה (lockfile) כמו uv.lock, או קובץ requirements מקובע לחלוטין, הוא מה שסוגר את הפער הזה, עם מכולה או בלעדיה. וכאשר יישום אחד רץ על VPS יחיד תחת systemd, מכולה לרוב מעבירה את אותה החלטה לתוך Dockerfile, שכן systemd ממילא מאתחל תהליך שנכשל ולוכד את הפלט שלו ב-journal. הרצת Docker על VPS מצדיקה את עצמה כאשר רוצים שהתמונה הבנויה עצמה תהיה האובייקט שאותו פורסים.

FAQ

האם אני יכול פשוט להשתמש ב-pip install עם הדגל --break-system-packages?

לא בשרת שצריך להישאר פעיל. הדגל עושה בדיוק את מה ששמו מרמז: הוא מסיר את מנגנון ההגנה, ו-pip כותב לתוך /usr/local/lib/python3.12/dist-packages, שמופיע לפני ספריית ה-apt ב-sys.path. הגרסה שלך תדרוס את גרסת ההפצה עבור כל סקריפט מערכת שרץ תחת /usr/bin/python3, ו-apt עדיין יחשוב שהגרסה שלו מותקנת, כך ששום דבר לא יזהה את ההתנגשות עד שמשהו יישבר. בתוך image של container שאתה בונה מחדש מאפס בכל פעם, הנזק נעצר באותו image, ולכן זה קביל שם. במכונה שאתה מתחזק, צור venv. זו פקודה אחת בלבד.

היכן סביבה וירטואלית צריכה לשכון בשרת?

בתוך ספריית היישום עצמו, כ-/srv/myapp/.venv, בבעלות משתמש deploy, כאשר חשבון השירות מחזיק בהרשאות קריאה והרצה בלבד. החזק venv אחד לכל יישום, כיוון שסביבה משותפת משמעה ששדרוג עבור היישום הראשון עלול לשבור את השני. אל תעביר או תעתיק venv לאחר יצירתו: כל סקריפט entry-point בספריית ה-bin/ שלו מכיל את הנתיב המוחלט הזה בתוך שורת ה-shebang שלו, ולכן venv שהועבר ייכשל עם bad interpreter: No such file or directory. מחק אותו ובנה מחדש מתוך requirements.txt במקום זאת.

מדוע שירות ה-systemd שלי נכשל עם ModuleNotFoundError?

מכיוון שה-unit מריץ מפרש (interpreter) שאינו זה של ה-venv. הרץ את systemctl cat myapp וקרא את ExecStart. עליו לציין את /srv/myapp/.venv/bin/python, או סקריפט קונסולה מאותה ספריית bin/, באמצעות נתיב מוחלט. הרצת activate ישירות בתוך ExecStart לא יכולה לעבוד, כיוון ש-ExecStart אינו shell, ו-systemd מדווח על Failed to locate executable source עם status=203/EXEC. הוסף את Environment=PATH=/srv/myapp/.venv/bin:/usr/local/bin:/usr/bin:/bin כדי שכל תהליך משנה שהקוד שלך מפעיל ימצא גם הוא את הכלים של ה-venv.

האם כדאי להשתמש ב-uv במקום ב-venv וב-pip?

השתמש ב-uv כאשר אתה זקוק ל-lockfile, כאשר זמן ההתקנה איטי מספיק כדי להפריע לך, או כאשר אתה זקוק לגרסת Python שההפצה שלך לא מספקת. הוא יוצר venv רגיל, כך שה-unit של systemd ומבנה הקבצים אינם משתנים, ו-uv sync --frozen מתקין בדיוק את מה שה-lockfile מתעד. אם יישום בודד נפרס מ-git עם requirements.txt נעול וההתקנה מסתיימת בשניות, python3 -m venv כבר מספיק, וזה קובץ בינארי אחד פחות שצריך לעדכן בשרת.

האם המאמר הזה היה מועיל?

#python#venv#pipx#uv#deployment