Python venv, pipx oder uv auf Servern nutzen
Ubuntu 24.04 blockiert pip install mit dem Fehler externally-managed-environment. Erfahren Sie, wann venv, pipx oder uv die richtige Wahl für Ihre Server-Anwendung ist.
Warum pip install auf einem neuen Ubuntu-Server fehlschlägt
Die Entscheidung zwischen einer Python-venv, pipx und uv hängt auf einem Server von einer Frage ab: Was installieren Sie? Anwendungsabhängigkeiten gehören in eine virtuelle Umgebung im eigenen Verzeichnis der Anwendung. Kommandozeilenwerkzeuge, die Sie per Namen aufrufen möchten, gehören in pipx. uv erledigt beide Aufgaben und ergänzt eine Lockdatei. Das wird wichtig, sobald eine zweite Maschine dieselbe Umgebung erstellen muss. Keines dieser Werkzeuge installiert jedoch in das System-Python, weil ein aktueller Ubuntu-Server dies ausdrücklich verweigert.
Führen Sie sudo pip install requests unter Ubuntu 24.04 aus, beendet sich pip, bevor eine einzige Datei heruntergeladen wurde.
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.Hier greift PEP 668 (Python enhancement proposal 668, „externally managed environments“). Debian und Ubuntu legen neben dem Interpreter unter /usr/lib/python3.12/EXTERNALLY-MANAGED eine Markierungsdatei ab. pip verweigert das Schreiben in jeden Interpreter, der diese Datei enthält.
Die Regel besteht wegen der Reihenfolge in sys.path. apt installiert Bibliotheken nach /usr/lib/python3/dist-packages. Wenn Sie pip als root gegen den System-Interpreter ausführen, schreibt pip nach /usr/local/lib/python3.12/dist-packages. Debian trägt dieses Verzeichnis in den Suchpfad weiter vorne ein. Geben Sie python3 -c 'import sys; print(sys.path)' selbst aus und prüfen Sie die Reihenfolge. Dadurch überschreibt die von pip geschriebene Kopie die von apt installierte Kopie. Das betrifft jedes Programm auf dem System, das unter /usr/bin/python3 ausgeführt wird, einschließlich der eigenen Werkzeuge der Distribution. cloud-init importiert requests, jinja2 und PyYAML aus diesem Interpreter. Aktualisieren Sie eines davon mit pip und erhalten Sie eine inkompatible Version, schlägt beim nächsten Boot möglicherweise etwas fehl, das Sie nie geändert haben. Der Traceback nennt dann ein Paket, von dessen Beteiligung Sie nichts wussten. apt führt seine eigene Version weiterhin als installiert. Daher erhalten Sie keine Warnung. Zur Reparatur entfernen Sie die von pip installierte Kopie mit sudo pip uninstall --break-system-packages requests. sudo apt reinstall python3-requests allein schreibt lediglich die bereits überschattete apt-Kopie neu.
Die daraus folgende Regel ist kurz. Das System-Python gehört zur Distribution. Installieren Sie nichts darin, aktualisieren Sie seine Bibliotheken nicht mit pip und löschen Sie nicht die Datei EXTERNALLY-MANAGED, nur damit die Meldung verschwindet. Die einzige Aufgabe für /usr/bin/python3 ist das Erstellen virtueller Umgebungen.
venv vs pipx vs uv: die Entscheidungsregel
Wählen Sie anhand dessen, was Sie installieren, nicht anhand des Tools, über das Sie zuletzt gelesen haben.
- Eine Anwendung, die Sie bereitstellen und als Dienst ausführen, beispielsweise ein Django- oder Flask-Projekt: eine virtuelle Umgebung (venv) im Verzeichnis dieser Anwendung.
- Ein Kommandozeilentool, das Sie auf Ihrem
PATHbenötigen, beispielsweiseansibleoderhttpie: pipx. pipx gibt jedem Tool eine eigene private Umgebung und einen Link inPATH. - Ein Projekt, das eine Lockdatei, schnellere Installationen oder eine Python-Version benötigt, die von der Distribution nicht bereitgestellt wird: uv. uv erstellt zusätzlich zu einer normalen venv eine Datei
uv.lock. - Eine Bibliothek, die ein Distributionstool und nicht Ihr Code benötigt:
sudo apt install python3-<name>. Dies ist die einzige unterstützte Möglichkeit, etwas zum Systeminterpreter hinzuzufügen.
pipx und uv tool install erfüllen dieselbe Aufgabe. Auf einem System, auf dem uv bereits installiert ist, benötigen Sie daher nicht zusätzlich pipx. Welches Webframework Sie gewählt haben, ändert daran nichts: Django und Flask auf einem VPS unterscheiden sich darin, was in requirements.txt landet, nicht darin, wie die umgebende Umgebung erstellt wird. Alle folgenden Beispiele verwenden Ubuntu 24.04 und dessen Python 3.12. Passen Sie die Versionsnummer in den Pfaden an, falls Ihre Version abweicht.
Die anwendungsspezifische venv erstellen
Ubuntu lagert das Modul venv aus dem Python-Basispaket aus. Daher schlägt der erste Versuch auf einem Minimal-Image mit einer Meldung fehl, die genau angibt, was fehlt.
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-venvInstallieren Sie das Modul. Erstellen Sie anschließend die Umgebung als der Benutzer, dem der Code gehören wird.
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.txtAchten Sie darauf, was nicht vorhanden ist: kein source und kein activate. /srv/myapp/.venv/bin/pip wird aufgrund des Speicherorts der Binärdatei in dieser Umgebung installiert, nicht aufgrund einer in der Shell gesetzten Variable. Bestätigen Sie dies, bevor Sie fortfahren.
/srv/myapp/.venv/bin/python -c 'import sys; print(sys.prefix)'Der Befehl gibt /srv/myapp/.venv aus. Wenn /usr ausgegeben wird, verwenden Sie den Systeminterpreter und Ihre Pakete wurden an einem nicht beabsichtigten Ort installiert.
Zwei Eigenschaften einer venv bestimmen, was Sie anschließend damit tun können. Eine venv ist nicht verschiebbar, weil jedes Entry-Point-Skript in bin/ eine absolute Shebang-Zeile enthält: head -1 /srv/myapp/.venv/bin/pip liest #!/srv/myapp/.venv/bin/python. Wenn Sie das übergeordnete Verzeichnis umbenennen, schlagen diese Skripte mit bad interpreter: No such file or directory fehl. Eine venv bindet außerdem den Interpreter, mit dem sie erstellt wurde. Dieser ist als Zeile home in /srv/myapp/.venv/pyvenv.cfg eingetragen, und bin/python3 ist ein Symlink auf /usr/bin/python3. Aktualisieren Sie das Release, sodass dieser Pfad nun auf eine neuere Python-Version zeigt, sucht der neue Interpreter nach Paketen in einem lib/python3.13-Verzeichnis, das die venv nicht besitzt. Daher beendet sich der Dienst beim Start mit ModuleNotFoundError. Auf Arch Linux genügt dafür bereits ein gewöhnliches pacman -Syu, sobald Python auf eine neue Minor-Version springt; muss der Dienst sofort wieder laufen, können Sie das vorherige Python-Paket zurückholen und vorübergehend festhalten, bis die venv neu erstellt ist. In beiden Fällen ist die Lösung identisch: Löschen Sie die venv und erstellen Sie sie aus requirements.txt neu. Das erneute Erstellen dauert nur wenige Sekunden. Kopieren Sie eine venv niemals zwischen Rechnern.
Wo sich die venv befindet und wem sie gehört
Legen Sie sie neben dem Code unter /srv/myapp/.venv an, und verwenden Sie pro Anwendung eine eigene venv. Das Deployment besteht dann aus einem einzigen Verzeichnis, die systemd-Unit erhält einen unveränderlichen Pfad, und zwei Anwendungen können sich niemals durch ein gemeinsames Upgrade einer Abhängigkeit gegenseitig beeinträchtigen. Platzieren Sie eine venv nicht in einem Verzeichnis, aus dem Ihr Webserver Dateien direkt veröffentlicht. Sie enthält Ihre Abhängigkeiten und häufig auch Ihre Konfiguration.
Die Besitzverhältnisse sollten Sie kurz festlegen. Lassen Sie einen Benutzer deploy den Code und die Umgebung besitzen, und geben Sie dem Dienstkonto ausschließlich Lese- und Ausführungsrechte.
sudo adduser --system --group --no-create-home myapp
sudo chown -R deploy:myapp /srv/myapp
sudo chmod -R o-rwx /srv/myappDer Dienst kann seine Abhängigkeiten jetzt importieren, sie aber nicht überschreiben. Dadurch kann ein Fehler mit Codeausführung in der Webanwendung nicht unbemerkt eine Bibliothek auf dem Datenträger ersetzen und einen Neustart überdauern. Dieselbe Vorgehensweise für den Rest des Systems wird unter Dienste mit Benutzern mit den geringsten Rechten ausführen beschrieben.
pipx für Befehlszeilenwerkzeuge
pipx installiert Anwendungen, keine Bibliotheken. Jedes Werkzeug erhält eine eigene Umgebung unter ~/.local/share/pipx/venvs/<name>. Die ausführbaren Dateien dieses Werkzeugs werden nach ~/.local/bin verlinkt. Deshalb kommen sich zwei Werkzeuge mit unterschiedlichen Versionen derselben Bibliothek nicht in die Quere.
sudo apt update
sudo apt install -y pipx
pipx ensurepath
pipx install httpiepipx ensurepath fügt ~/.local/bin durch eine Änderung Ihrer Shell-Startdatei zu PATH hinzu. Die bereits geöffnete Shell kann das Programm nicht ändern. Wenn http: command not found direkt nach der Installation ausgeführt wird, haben Sie sich daher normalerweise noch nicht ab- und wieder angemeldet. Die standardmäßige Ubuntu-~/.profile fügt ~/.local/bin beim Anmelden nur hinzu, wenn dieses Verzeichnis bereits existiert. Deshalb tritt dieses Problem bei einem neuen Konto einmalig auf und danach nicht mehr.
Wenn Sie pipx auf eine Bibliothek ansetzen, wird der Vorgang mit einer Meldung abgelehnt, die mit Folgendem beginnt:
No apps associated with package requests.Damit weist das Werkzeug darauf hin, dass es dafür nicht geeignet ist. Bibliotheken gehören in die venv einer Anwendung.
Auf einem Server ist der Speicherort entscheidend. Ein einfaches pipx install legt alles im Home-Verzeichnis eines Benutzers ab. Eine als myapp ausgeführte systemd-Unit kann darauf nicht zugreifen. Ein root-Cronjob kann ebenfalls nicht darauf zugreifen. Auch sudo findet es nicht, weil secure_path in /etc/sudoers PATH durch eine feste Liste ersetzt. Wenn ein Werkzeug auf dem gesamten Rechner verfügbar sein soll, installieren Sie es global.
sudo pipx install --global ansible
sudo pipx ensurepath --globalDas Flag --global legt Umgebungen in /opt/pipx ab und verlinkt ausführbare Dateien nach /usr/local/bin. Dieses Verzeichnis befindet sich im standardmäßigen PATH und innerhalb von secure_path. Prüfen Sie zunächst Ihre Version mit pipx --version. Ubuntu 24.04 enthält pipx 1.4.3 als Paket. Diese Version ist älter als --global. Ein älteres pipx antwortet mit unrecognized arguments: --global. Legen Sie bei dieser Version die beiden dokumentierten Verzeichnisse selbst fest:
sudo env PIPX_HOME=/opt/pipx PIPX_BIN_DIR=/usr/local/bin pipx install ansible
command -v ansiblecommand -v ansible sollte /usr/local/bin/ansible ausgeben. Wenn ein Pfad unter /home ausgegeben wird, wurde das Werkzeug im Konto eines einzelnen Benutzers installiert. Kein Dienst wird es dort finden.
uv, wenn Sie eine Lockfile benötigen
uv ist eine einzelne Binärdatei von Astral, die die Funktionen von pip, venv und pip-tools abdeckt und zudem Interpreter herunterladen kann. Sie ist so schnell, dass der Unterschied selbst auf einem kleinen VPS spürbar ist, und sie erstellt eine echte Lockfile.
Der offizielle Installer legt uv und uvx in ~/.local/bin ab:
curl -LsSf https://astral.sh/uv/install.sh | sh
uv --versionEin Skript per Pipe direkt in eine Shell auf einem Server zu leiten, erfordert einen Moment der Aufmerksamkeit. Fixieren Sie die Version in der URL und lesen Sie die Datei, bevor Sie sie ausführen:
curl -LsSf https://astral.sh/uv/0.12.3/install.sh -o uv-install.sh
less uv-install.sh
sh uv-install.shpipx install uv funktioniert ebenfalls, wenn pipx bereits vorhanden ist. uv ist eine in sich geschlossene Binärdatei ohne eigene Python-Abhängigkeiten; daher ist das Kopieren nach /usr/local/bin ein valider Weg, um sie für alle Benutzer auf dem System bereitzustellen.
Für ein Projekt mit einer pyproject.toml besteht der Workflow aus vier Befehlen, von denen nur der letzte auf dem Server ausgeführt wird.
uv init myapp
uv add flask gunicorn
uv lock
uv sync --frozen --no-devuv lock schreibt uv.lock, eine plattformübergreifende Lockfile, die exakt aufgelöste Versionen enthält; diese checken Sie zusammen mit Ihrem Code ein. uv sync erstellt .venv im Projekt-Root passend dazu. Auf dem Server ist --frozen das entscheidende Flag: Die Dokumentation definiert es so, dass die Versionen in der Lockfile als einzige Quelle der Wahrheit verwendet werden, anstatt zu prüfen, ob die Lockfile aktuell ist – ein Verhalten, das für Deployments bevorzugt wird. --no-dev lässt die Entwicklungsgruppe der Abhängigkeiten weg.
Ein bestehendes requirements.txt-Projekt benötigt keine Konvertierung, da uv die Sprache von pip spricht:
uv venv /srv/myapp/.venv
uv pip install --python /srv/myapp/.venv/bin/python -r /srv/myapp/requirements.txtDas Ergebnis ist eine gewöhnliche virtuelle Umgebung mit einem Unterschied: uv installiert kein pip darin, daher funktionieren .venv/bin/pip und .venv/bin/python -m pip nicht, es sei denn, Sie erstellen die Umgebung mit uv venv --seed. Installieren Sie stattdessen mit uv pip. Nichts im weiteren Verlauf dieses Leitfadens führt pip innerhalb der Umgebung aus, daher ändert sich nichts.
Eine Standardeinstellung von uv ist wichtig zu kennen, bevor Sie es auf einem Server einsetzen. Die Einstellung python-preference ist standardmäßig auf managed gesetzt, was laut Dokumentation bedeutet, dass „diejenigen gewählt werden, die von uv heruntergeladen und installiert werden“, anstatt bereits auf dem System vorhandene Interpreter zu nutzen. Daher lädt uv venv --python 3.13 auf einem System, das nur 3.12 bereitstellt, im Hintergrund 3.13 nach ~/.local/share/uv/python herunter, anstatt fehlzuschlagen. Das ist auf einem Laptop praktisch, auf einem Server jedoch überraschend, da Ihr Dienst nun von einem Interpreter abhängt, der in einem Home-Verzeichnis liegt und den apt upgrade niemals patchen wird. Setzen Sie python-preference auf only-system in uv.toml, wenn Sie den Interpreter der Distribution verwenden möchten. Wenn Sie die Umgebung an einem anderen Ort als dem Projekt-Root wünschen, legt UV_PROJECT_ENVIRONMENT das Verzeichnis für eine virtuelle Projektumgebung fest.
Verweisen Sie in systemd auf den venv-Interpreter, nicht auf activate
Hier schlagen die meisten Python-Deployments fehl. Ursache ist ein Missverständnis darüber, was activate macht.
bin/activate ist ein Shell-Skript. Es stellt das bin-Verzeichnis des venv an den Anfang von PATH, setzt VIRTUAL_ENV, speichert die alten Werte, damit deactivate sie wiederherstellen kann, und ändert den Prompt. Es enthält nichts, was der Interpreter selbst liest. Die Aktivierung ist nur eine Erleichterung für eine Person, die python an einer Eingabeaufforderung eingibt.
Welche Umgebung verwendet wird, bestimmt tatsächlich die Interpreterdatei, die Sie ausführen. Beim Start von /srv/myapp/.venv/bin/python sucht das Python-Modul site im Verzeichnis der ausführbaren Datei und eine Ebene darüber nach einer Datei namens pyvenv.cfg. Wenn /srv/myapp/.venv/pyvenv.cfg gefunden wird, setzt Python sys.prefix auf das venv. Dadurch gelangt dessen site-packages an den Anfang von sys.path. Das ist der gesamte Mechanismus. Dafür sind weder eine Umgebungsvariable noch eine Shell erforderlich.
Diese Unit startet daher nie:
[Service]
ExecStart=source /srv/myapp/.venv/bin/activate && gunicorn app:appmyapp.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/EXECExecStart ist keine Shell-Befehlszeile. systemd führt ein Programm direkt aus. Daher gibt es kein source-Builtin, && wird als wörtliches Argument übergeben, und über die wenigen Erweiterungen hinaus, die systemd selbst dokumentiert, findet keine Shell-Ersetzung statt.
Diese Unit startet und beendet sich anschließend:
[Service]
ExecStart=/usr/bin/python3 /srv/myapp/app.pyModuleNotFoundError: No module named 'flask'/usr/bin/python3 ist der Systeminterpreter. Sein sys.path hat Ihr venv nie enthalten. Derselbe Befehl funktioniert in Ihrer SSH-Sitzung nur deshalb, weil Sie dort das venv aktiviert hatten. Dadurch löste die Shell python3 über PATH stattdessen zu .venv/bin/python3 auf.
Wenn Sie den Befehl in /bin/bash -c 'source ... && gunicorn ...' einschließen, funktioniert er. Damit liegt jedoch ohne Nutzen eine Shell zwischen systemd und Ihrem Prozess. Ein absoluter Pfad reicht aus:
[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.targetsudo systemctl daemon-reload
sudo systemctl enable --now myapp
systemctl status myapp
journalctl -u myapp -n 50 --no-pagersystemctl status myapp sollte active (running) mit einem Main PID ausgeben, das zu Ihrem gunicorn-Prozess gehört. Andernfalls prüfen Sie das Journal.
Die Zeile Environment=PATH= ist nicht für ExecStart erforderlich, da dieses bereits einen vollständigen Pfad enthält. Sie ist für die Prozesse bestimmt, die Ihre Anwendung startet. Ein Dienst erbt von systemd ein kurzes Standard-PATH. Daher findet Python-Code, der subprocess.run(["ffmpeg", ...]) aufruft, oder ein Verwaltungsbefehl, der ein Console-Skript aus dem venv als externen Prozess startet, die benötigten Programme nicht. Das venv-bin-Verzeichnis an die erste Stelle zu setzen, ist der Teil von activate, den ein Dienst tatsächlich verwendet. Prüfen Sie mit systemctl show -p Environment myapp, was die Unit tatsächlich erhalten hat.
Dieselbe Regel gilt für geplante Aufgaben. Unter Ubuntu übergibt cron einem Job nicht das PATH aus Ihrer Shell oder aus dem Daemon. Wenn die Crontab PATH nicht selbst setzt, erhält jeder Job das einkompilierte Standard-/usr/bin:/bin. /etc/environment überschreibt dieses nicht. Es enthält Ihr venv nie. Eine Crontab-Zeile mit python3 /srv/myapp/cleanup.py führt daher den Systeminterpreter aus und schlägt um drei Uhr morgens mit ModuleNotFoundError fehl. cron sendet den Fehler per E-Mail an den Eigentümer der Crontab oder an die Adresse MAILTO, falls Sie eine festlegen. Auf den meisten Servern bedeutet das ein lokales Postfach, das niemand liest. Wenn kein Mailprogramm installiert ist, verwirft cron die Ausgabe und schreibt nur No MTA installed, discarding output in das Systemprotokoll. Tragen Sie auch dort den absoluten Pfad zum venv ein. Wenn die Ausgabe stattdessen im Journal erscheinen und ein Protokoll des letzten Laufs erhalten bleiben soll, verwendet ein systemd-Service mit zugehörigem Timer dieselbe ExecStart-Zeile.
Ersetzt Docker diese Entscheidung?
Ein Container verfügt über ein eigenes Dateisystem. Die Frage ändert daher ihre Form, verschwindet aber nicht. In einem offiziellen Image wie python:3.12-slim ist Python in /usr/local integriert und enthält keine EXTERNALLY-MANAGED-Markierung. Daher ist pip install als root der vorgesehene Weg, Pakete hinzuzufügen. Eine virtuelle Umgebung bringt hier wenig. Bauen Sie stattdessen FROM ubuntu:24.04, stoßen Sie innerhalb des Images aus demselben Grund wie auf dem Host erneut auf externally-managed-environment: Es handelt sich um den Interpreter der Distribution, der die Markierungsdatei der Distribution enthält.
Viele Images verwenden trotzdem eine virtuelle Umgebung, weil sie einen mehrstufigen Build vereinfacht. Die Builder-Stage installiert nach /opt/venv. Die Runtime-Stage kopiert anschließend nur dieses Verzeichnis und lässt die Compiler zurück. Das Problem mit der Aktivierung wird dabei übernommen. Eine Zeile mit RUN source /opt/venv/bin/activate wirkt nur auf die Shell dieser Build-Schicht. Zur Laufzeit startet der Container daher mit dem System-Interpreter und meldet ModuleNotFoundError. Setzen Sie ENV PATH="/opt/venv/bin:$PATH" oder übergeben Sie CMD den absoluten Pfad /opt/venv/bin/gunicorn. Es handelt sich um denselben Fehler wie bei systemd, nur in einer anderen Datei.
Ein Container ersetzt also die Frage nach dem Interpreter, weil das Image den Interpreter und alles darunter festlegt. Die Frage nach der Versionierung ersetzt er nicht. Ein Image, das aus einem nicht versionierten requirements.txt erstellt wird, löst im nächsten Monat möglicherweise andere Versionen auf. Damit ist zwar der Image-Tag reproduzierbar, nicht aber der Build, der ihn erzeugt hat. Eine Lockdatei wie uv.lock oder eine vollständig versionierte Requirements-Datei schließt diese Lücke, unabhängig davon, ob Container verwendet werden. Wenn eine Anwendung auf einem einzelnen VPS unter systemd läuft, verlagert ein Container diese Entscheidung meist nur in ein Dockerfile, da systemd einen fehlgeschlagenen Prozess bereits neu startet und seine Ausgabe im Journal erfasst. Docker auf einem VPS betreiben lohnt sich, wenn das erstellte Image selbst das Deployment-Artefakt sein soll.
FAQ
Kann ich einfach pip install mit --break-system-packages verwenden?
Nicht auf einem Server, der dauerhaft laufen muss. Das Flag tut, was sein Name sagt: Es entfernt die Schutzfunktion, und pip schreibt nach /usr/local/lib/python3.12/dist-packages, das vor dem apt-Verzeichnis in sys.path liegt. Ihre Version überschattet dann die Distributionsversion für jedes unter /usr/bin/python3 laufende Systemskript. apt geht weiterhin davon aus, dass seine eigene Version installiert ist. Daher erkennt nichts den Konflikt, bis etwas ausfällt. In einem Container-Image, das Sie jedes Mal von Grund auf neu erstellen, bleibt der Schaden auf dieses Image begrenzt. Dort ist die Verwendung vertretbar. Auf einem von Ihnen verwalteten Rechner erstellen Sie eine venv. Das ist ein einziger Befehl.
Wo sollte die virtuelle Umgebung auf einem Server liegen?
Im eigenen Verzeichnis der Anwendung, als /srv/myapp/.venv, im Besitz eines Deploy-Benutzers. Das Dienstkonto darf nur Lese- und Ausführungszugriff haben. Verwenden Sie pro Anwendung eine eigene venv. Bei einer gemeinsam genutzten venv kann ein Upgrade für die erste Anwendung die zweite Anwendung unbrauchbar machen. Verschieben oder kopieren Sie eine venv nach ihrer Erstellung nicht. Jedes Entry-Point-Skript in ihrem Verzeichnis bin/ enthält diesen absoluten Pfad in seiner Shebang-Zeile. Eine verschobene venv schlägt daher mit bad interpreter: No such file or directory fehl. Löschen Sie sie stattdessen und erstellen Sie sie aus requirements.txt neu.
Warum schlägt mein systemd-Dienst mit ModuleNotFoundError fehl?
Weil die Unit einen Interpreter ausführt, der nicht zur venv gehört. Führen Sie systemctl cat myapp aus und lesen Sie ExecStart. Der Pfad muss /srv/myapp/.venv/bin/python oder ein Console-Skript aus demselben Verzeichnis bin/ als absoluten Pfad angeben. activate direkt in ExecStart zu laden, kann nicht funktionieren, weil ExecStart keine Shell ist. systemd meldet dann Failed to locate executable source mit status=203/EXEC. Fügen Sie Environment=PATH=/srv/myapp/.venv/bin:/usr/local/bin:/usr/bin:/bin hinzu, damit auch jeder von Ihrem Code gestartete Unterprozess die Werkzeuge der venv findet.
Sollte ich uv anstelle von venv und pip verwenden?
Verwenden Sie uv, wenn Sie eine Lockdatei benötigen, die Installationszeit so lang ist, dass sie Sie beeinträchtigt, oder wenn Sie eine Python-Version benötigen, die Ihre Distribution nicht bereitstellt. uv erstellt eine gewöhnliche venv. Daher ändern sich weder die systemd-Unit noch das Dateilayout, und uv sync --frozen installiert genau das, was die Lockdatei vorgibt. Wenn eine einzelne Anwendung aus git mit einem festgelegten requirements.txt bereitgestellt wird und die Installation in wenigen Sekunden abgeschlossen ist, reicht python3 -m venv bereits aus. Außerdem müssen Sie dann ein Binary weniger auf dem Server aktuell halten.