Ubuntu sunucuda Python venv, pipx ve uv kullanımı
Ubuntu sunucularda pip install komutunun externally-managed-environment hatası vermesinin nedenini öğrenin. Uygulama ve araç kurulumu için doğru yöntemi seçin.
Yeni bir Ubuntu sunucusunda pip install neden başarısız olur
Bir sunucuda Python venv, pipx ve uv arasında seçim yapmak tek bir soruya dayanır: ne yüklüyorsunuz? Uygulama bağımlılıkları, uygulamanın kendi dizini içindeki bir sanal ortamda bulunmalıdır. İsmiyle çağırmak istediğiniz komut satırı araçları pipx içinde yer almalıdır. uv her iki işi de yapar ve ikinci bir makinenin aynı ortamı oluşturması gerektiğinde önem kazanan bir lockfile ekler. Bunların hiçbiri sistem Python'ına kurulum yapmaz, çünkü güncel bir Ubuntu sunucusu bunu doğrudan reddeder.
Ubuntu 24.04 üzerinde sudo pip install requests komutunu çalıştırın; pip, tek bir dosya bile indirmeden duracaktır.
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.Bu, PEP 668'in (Python geliştirme önerisi 668, "harici olarak yönetilen ortamlar") görevini yapmasıdır. Debian ve Ubuntu, /usr/lib/python3.12/EXTERNALLY-MANAGED konumundaki yorumlayıcının yanına bir işaretçi dosyası bırakır ve pip, bu dosyayı taşıyan hiçbir yorumlayıcıya yazma yapmayı kabul etmez.
Bu kural, sys.path düzeni nedeniyle mevcuttur. apt, kütüphaneleri /usr/lib/python3/dist-packages dizinine kurar. root yetkisiyle sistem yorumlayıcısına karşı çalıştırılan pip, /usr/local/lib/python3.12/dist-packages dizinine yazar ve Debian'ın paketleme sistemi bu dizini arama yolunda daha ön sıraya koyar. Bunu python3 -c 'import sys; print(sys.path)' ile kendiniz yazdırın ve sırayı inceleyin. Dolayısıyla, pip tarafından yazılan kopya, sistemdeki /usr/bin/python3 altında çalışan her program için apt tarafından kurulan kopyayı gölgeler; buna dağıtımın kendi araçları da dahildir. cloud-init, requests, jinja2 ve PyYAML kütüphanelerini bu yorumlayıcıdan içe aktarır. Bunlardan birini pip ile yükseltir ve uyumsuz bir sürüme geçerseniz, hiç dokunmadığınız bir şey bir sonraki açılışta, zincirde olduğunu bilmediğiniz bir paketi işaret eden bir traceback ile başarısız olur. apt, kendi sürümünü kurulu olarak kaydetmeye devam ettiği için sizi hiçbir şey uyarmaz. Onarım, pip'in kopyasını sudo pip uninstall --break-system-packages requests ile kaldırmaktır; çünkü sudo apt reinstall python3-requests tek başına yalnızca zaten gölgelenmiş olan apt kopyasının üzerine yazar.
Bunu takip eden kural kısadır. Sistem Python'ı dağıtıma aittir. Ona kurulum yapmayın, kütüphanelerini pip ile yükseltmeyin ve hata mesajını ortadan kaldırmak için EXTERNALLY-MANAGED dosyasını silmeyin. /usr/bin/python3 aracına verilecek tek görev, sanal ortamlar oluşturmaktır.
venv, pipx ve uv: karar mekanizması
En son okuduğunuz araca göre değil, ne kurduğunuza göre seçim yapın.
- Django veya Flask projesi gibi bir servis olarak dağıtıp çalıştırdığınız bir uygulama: Uygulamanın dizini içinde bir adet sanal ortam (venv).
PATHüzerinde bulunmasını istediğinizansibleveyahttpiegibi bir komut satırı aracı: Her araca özel bir ortam vePATHüzerinde tek bir bağlantı sağlayan pipx.- Lockfile gerektiren, daha hızlı kurulum isteyen veya dağıtımın sunmadığı bir Python sürümüne ihtiyaç duyan bir proje: Standart bir venv ve bir
uv.lockdosyası oluşturan uv. - Kodunuzdan ziyade bir dağıtım aracının ihtiyaç duyduğu bir kütüphane: Sistem yorumlayıcısına herhangi bir şey eklemenin tek desteklenen yolu olan
sudo apt install python3-<name>.
pipx ve uv tool install aynı işi yapar, bu nedenle uv kurulu olan bir sistemde ayrıca pipx kullanılmasına gerek yoktur. Seçtiğiniz web framework'ü burada bir şeyi değiştirmez: VPS üzerinde Django ve Flask kurulumları, requirements.txt içine neyin yerleştiği konusunda farklılık gösterir, ancak çevresindeki ortamın nasıl oluşturulduğu konusunda değil. Aşağıdaki her şey Ubuntu 24.04 ve onun Python 3.12 sürümünü kullanır, bu nedenle sürümünüz farklıysa yolların içindeki sürüm numaralarını düzenleyin.
Uygulama bazlı venv oluşturma
Ubuntu, venv modülünü temel Python paketinden ayırır; bu nedenle minimal bir imaj üzerinde yapılan ilk deneme, eksik olanı belirten bir hata mesajıyla başarısız olur.
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-venvGerekli paketi kurun ve ardından ortamı, kodun sahibi olacak kullanıcı ile oluşturun.
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.txtNelerin orada olmadığına dikkat edin: source yok, activate yok. /srv/myapp/.venv/bin/pip, shell ortamına herhangi bir şey aktardığınız için değil, ikili dosyanın bulunduğu konum nedeniyle o ortama kurulur. Devam etmeden önce bunu doğrulayın.
/srv/myapp/.venv/bin/python -c 'import sys; print(sys.prefix)'Bu komut /srv/myapp/.venv çıktısını verir. Eğer /usr çıktısını alıyorsanız, sistem yorumlayıcısını çalıştırıyorsunuz demektir ve paketleriniz hedeflemediğiniz bir yere kurulmuştur.
Bir venv'nin iki özelliği, sonrasında onunla neler yapabileceğinizi belirler. Bir venv taşınabilir değildir; çünkü bin/ içindeki her giriş noktası betiği mutlak bir shebang satırı taşır: head -1 /srv/myapp/.venv/bin/pip, #!/srv/myapp/.venv/bin/python dosyasını okur. Üst dizini yeniden adlandırdığınızda bu betikler bad interpreter: No such file or directory hatasıyla başarısız olur. Bir venv ayrıca onu oluşturan yorumlayıcıyı sabitler; bu durum /srv/myapp/.venv/pyvenv.cfg içindeki home satırında kayıtlıdır ve bin/python3, /usr/bin/python3 dosyasına bir sembolik bağdır. İşletim sistemi sürümünü yükseltip bu yolun daha yeni bir Python sürümüne çıkmasını sağlarsanız, yeni yorumlayıcı paketleri venv içinde bulunmayan bir lib/python3.13 dizininde arar ve servis başlangıçta ModuleNotFoundError hatasıyla durur. Her iki durumun da çözümü aynıdır: venv'yi silin ve requirements.txt dosyasından yenisini oluşturun. Yeniden oluşturma işlemi saniyeler sürer. Bir venv'yi asla makineler arasında kopyalamayın.
venv dizininin konumu ve sahipliği
venv dizinini /srv/myapp/.venv yolundaki kodun yanına yerleştirin ve her uygulama için ayrı bir venv kullanın. Bu sayede dağıtım tek bir dizinden ibaret olur, systemd birimi asla değişmeyen bir yola sahip olur ve iki uygulama, paylaşılan bir bağımlılık güncellemesi nedeniyle birbirini bozamaz. venv dizinini, web sunucunuzun dosyaları doğrudan yayınladığı bir yere koymayın; çünkü bu dizin bağımlılıklarınızı ve genellikle yapılandırma dosyalarınızı barındırır.
Sahiplik konusu kısa bir incelemeyi hak eder. Kodun ve ortamın sahipliğini bir deploy kullanıcısına verin ve servis hesabına yalnızca okuma ve çalıştırma yetkisi tanıyın.
sudo adduser --system --group --no-create-home myapp
sudo chown -R deploy:myapp /srv/myapp
sudo chmod -R o-rwx /srv/myappServis artık bağımlılıklarını içe aktarabilir ancak bunları değiştiremez. Bu durum, web uygulamasındaki bir kod yürütme açığının disk üzerindeki bir kütüphaneyi sessizce değiştirmesini ve yeniden başlatma sonrasında varlığını sürdürmesini engeller. Makinenin geri kalanı için de geçerli olan aynı mantık, servisleri en düşük yetkili kullanıcılarla çalıştırma bölümünde ele alınmıştır.
Komut satırı araçları için pipx
pipx, kütüphaneleri değil uygulamaları kurar. Her araç ~/.local/share/pipx/venvs/<name> altında kendi ortamına sahip olur ve aracın çalıştırılabilir dosyaları ~/.local/bin dizinine bağlanır; böylece aynı kütüphanenin farklı sürümlerine ihtiyaç duyan iki araç asla çakışmaz.
sudo apt update
sudo apt install -y pipx
pipx ensurepath
pipx install httpiepipx ensurepath, kabuk başlangıç dosyanızı düzenleyerek ~/.local/bin dizinini PATH değişkenine ekler. Hâlihazırda kullanmakta olduğunuz kabuğu değiştiremeyeceği için, kurulumdan hemen sonra alınan http: command not found hatası genellikle oturumu kapatıp tekrar açmadığınız anlamına gelir. Ubuntu'nun varsayılan ~/.profile dosyası, ~/.local/bin dizinini yalnızca oturum açma sırasında mevcutsa ekler; bu durum, yeni bir hesapta bir kez yaşanır ve bir daha tekrarlanmaz.
pipx'i bir kütüphaneye yönlendirirseniz, şu ifadeyle başlayan bir mesajla reddeder:
No apps associated with package requests.Bu, aracın size yanlış bir yöntem kullandığınızı söyleme biçimidir. Kütüphaneler, bir uygulamanın venv dizininde bulunmalıdır.
Sunucuda önemli olan detay konumdur. Standart bir pipx install komutu, her şeyi tek bir kullanıcının ev dizini altına yerleştirir. myapp kullanıcısı olarak çalışan bir systemd birimi bunu göremez, root yetkisiyle çalışan bir cron işi bunu göremez ve sudo de bulamaz; çünkü /etc/sudoers içindeki secure_path, PATH değişkenini sabit bir listeyle değiştirir. Tüm makinenin erişmesi gereken bir araç için kurulumu global olarak yapın.
sudo pipx install --global ansible
sudo pipx ensurepath --global--global bayrağı, ortamları /opt/pipx dizinine yerleştirir ve çalıştırılabilir dosyaları, varsayılan PATH değişkeninde bulunan ve secure_path içinde yer alan /usr/local/bin dizinine bağlar. Öncelikle pipx --version ile sürümünüzü kontrol edin; çünkü Ubuntu 24.04, --global sürümünden daha eski olan pipx 1.4.3 paketini içerir ve eski bir pipx, unrecognized arguments: --global hatasıyla yanıt verir. Bu sürümde, belgelenen iki dizini kendiniz ayarlayın:
sudo env PIPX_HOME=/opt/pipx PIPX_BIN_DIR=/usr/local/bin pipx install ansible
command -v ansiblecommand -v ansible komutu /usr/local/bin/ansible çıktısını vermelidir. Eğer /home altında bir yol veriyorsa, araç tek bir kullanıcının hesabına kurulmuştur ve hiçbir servis onu bulamayacaktır.
uv, kilit dosyası (lockfile) istediğinizde
uv, pip, venv ve pip-tools'un yaptığı işleri kapsayan ve ayrıca Python yorumlayıcılarını indirebilen, Astral tarafından geliştirilmiş tek bir binary dosyasıdır. Küçük bir VPS üzerinde aradaki farkı hissettirecek kadar hızlıdır ve gerçek bir kilit dosyası oluşturur.
Resmi yükleyici, uv ve uvx dosyalarını ~/.local/bin dizinine yerleştirir:
curl -LsSf https://astral.sh/uv/install.sh | sh
uv --versionBir sunucuda script'i doğrudan shell'e yönlendirmek (pipe) kısa bir dikkat gerektirir. URL içindeki sürümü sabitleyin ve çalıştırmadan önce dosyayı okuyun:
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, pipx zaten yüklüyse işe yarar. uv, kendi Python bağımlılığı olmayan, kendi kendine yeten bir binary dosyasıdır; bu nedenle onu /usr/local/bin dizinine kopyalamak, sunucudaki tüm kullanıcılarla paylaşmak için geçerli bir yöntemdir.
pyproject.toml içeren bir proje için iş akışı dört komuttan oluşur ve sadece sonuncusu sunucuda çalıştırılır.
uv init myapp
uv add flask gunicorn
uv lock
uv sync --frozen --no-devuv lock, tam çözümlenmiş sürümleri içeren platformlar arası bir kilit dosyası olan uv.lock dosyasını yazar; bu dosyayı kodunuzla birlikte commit etmelisiniz. uv sync, proje kök dizininde bu dosyayla eşleşen .venv ortamını oluşturur. Sunucuda önemli olan bayrak --frozen bayrağıdır: dokümantasyon bunu, kilit dosyasının güncel olup olmadığını kontrol etmek yerine kilit dosyasındaki sürümleri tek gerçek kaynak olarak kullanmak şeklinde tanımlar; bu, dağıtım (deployment) için gereken davranıştır. --no-dev, geliştirme bağımlılıkları grubunu dışarıda bırakır.
Mevcut bir requirements.txt projesinin dönüştürülmesine gerek yoktur, çünkü uv, pip'in dilinden anlar:
uv venv /srv/myapp/.venv
uv pip install --python /srv/myapp/.venv/bin/python -r /srv/myapp/requirements.txtSonuçta ortaya çıkan yapı, tek bir fark dışında sıradan bir sanal ortamdır: uv, içine pip yüklemez; bu nedenle ortamı uv venv --seed ile oluşturmadığınız sürece .venv/bin/pip ve .venv/bin/python -m pip çalışmaz. Bunun yerine uv pip ile yükleme yapın. Bu kılavuzun ilerleyen kısımlarında sanal ortam içinde pip çalıştırılmadığı için hiçbir şey değişmeyecektir.
Sunucuda kullanmadan önce uv'nin bir varsayılan ayarını bilmekte fayda vardır. python-preference ayarı varsayılan olarak managed değerindedir ve dokümantasyonda, sistemde halihazırda bulunan yorumlayıcılar yerine "uv tarafından indirilen ve kurulanların" seçilmesi olarak tanımlanmıştır. Bu nedenle, sadece 3.12 sürümü yüklü olan bir sunucuda uv venv --python 3.13 komutu, hata vermek yerine sessizce 3.13 sürümünü ~/.local/share/uv/python dizinine indirir. Bu durum dizüstü bilgisayarda kullanışlı olsa da sunucuda şaşırtıcı olabilir; çünkü servisiniz artık home dizininde yaşayan ve apt upgrade tarafından asla yamalanmayacak bir yorumlayıcıya bağımlı hale gelir. Dağıtımın kendi yorumlayıcısını kullanmak istiyorsanız uv.toml dosyasında python-preference ayarını only-system olarak belirleyin. Tersine, kurmak istediğiniz paket dağıtımın Python sürümünü henüz desteklemiyorsa uv'nin indirdiği yorumlayıcı bilinçli bir tercihe dönüşür; yalnızca Python 3.11 ile 3.13 arasını destekleyen bir model için EMA Lightning Türkçe TTS modelini VPS'te çevrimdışı kurma rehberi yorumlayıcıyı bu yolla seçer. Sanal ortamın proje kök dizini dışında bir yerde olmasını istiyorsanız, UV_PROJECT_ENVIRONMENT proje sanal ortamı için kullanılacak dizini belirtir.
systemd'yi activate betiğine değil, venv yorumlayıcısına yönlendirin
Python dağıtımlarının büyük çoğunluğu burada hata verir; bunun nedeni activate komutunun işlevinin yanlış anlaşılmasıdır.
bin/activate bir kabuk betiğidir. venv'in bin dizinini PATH değişkeninin başına ekler, VIRTUAL_ENV değerini ayarlar, eski değerleri deactivate komutuyla geri yüklenebilecek şekilde kaydeder ve komut satırı isteminizi değiştirir. Bu betik, Python yorumlayıcısının okuduğu hiçbir şey içermez. Aktivasyon işlemi, yalnızca komut satırında python yazan kullanıcılar için sağlanan bir kolaylıktır.
Ortamı asıl belirleyen şey, çalıştırdığınız yorumlayıcı dosyasıdır. /srv/myapp/.venv/bin/python başladığında, Python'ın site modülü, çalıştırılabilir dosyanın bulunduğu dizinde veya bir üst dizinde bir pyvenv.cfg dosyası arar. /srv/myapp/.venv/pyvenv.cfg dosyasının bulunması, sys.prefix değerini venv olarak ayarlar ve bu da venv'in site-packages dizinini sys.path değişkenine ekler. Tüm mekanizma bundan ibarettir; herhangi bir ortam değişkenine veya kabuğa ihtiyaç duymaz.
Bu nedenle, aşağıdaki birim asla çalışmaz:
[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 bir kabuk komut satırı değildir. systemd bir programı doğrudan çalıştırır; bu nedenle source gibi bir yerleşik komut yoktur, && doğrudan bir argüman olarak iletilir ve systemd'nin kendi dokümantasyonunda belirttiği birkaç istisna dışında hiçbir kabuk genişletmesi gerçekleşmez.
Aşağıdaki birim ise çalışır ancak hemen ardından sonlanır:
[Service]
ExecStart=/usr/bin/python3 /srv/myapp/app.pyModuleNotFoundError: No module named 'flask'/usr/bin/python3 sistem yorumlayıcısıdır ve sys.path değişkeni hiçbir zaman venv'inizi içermemiştir. Aynı komutun SSH oturumunuzda çalışmasının tek nedeni, orada venv'i aktive etmiş olmanız ve kabuğun python3 ifadesini PATH üzerinden .venv/bin/python3 yoluna çözümlemesidir.
Komutu /bin/bash -c 'source ... && gunicorn ...' ile sarmalamak işe yarar. Ancak bu, systemd ile süreciniz arasına gereksiz bir kabuk katmanı ekler. Oysa mutlak bir yol (absolute path) kullanmak sorunu kökten çözer:
[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 komutu, Main PID değeri gunicorn süreciniz olan bir active (running) çıktısı vermelidir. Başka bir sonuç alırsanız günlük kayıtlarını inceleyin.
Environment=PATH= satırı, zaten tam yolu içeren ExecStart için orada değildir. Bu satır, uygulamanızın başlattığı süreçler içindir. Bir servis, systemd'den kısa ve varsayılan bir PATH değeri devralır. Bu nedenle, subprocess.run(["ffmpeg", ...]) çağıran Python kodu veya venv içindeki bir konsol betiğini çalıştıran yönetim komutları, ihtiyaç duydukları dosyaları bulamaz. venv'in bin dizinini başa eklemek, activate betiğinin bir servis tarafından gerçekten kullanılan tek kısmıdır. Birimin ne aldığını systemctl show -p Environment myapp ile kontrol edin.
Aynı kural zamanlanmış görevler için de geçerlidir. Ubuntu'da cron, bir işe kabuğunuzdan veya arka plan sürecinden PATH değerini aktarmaz. Crontab dosyası PATH değerini kendisi ayarlamadığı sürece, her iş derleme sırasında belirlenen varsayılan /usr/bin:/bin değerini alır ve /etc/environment bunu geçersiz kılmaz. Bu değer venv'inizi içermediği için, crontab içindeki python3 /srv/myapp/cleanup.py satırı sistem yorumlayıcısını çalıştırır ve sabahın üçünde ModuleNotFoundError hatasıyla başarısız olur. cron, hatayı crontab sahibine veya ayarladıysanız MAILTO adresine postalar; çoğu sunucuda bu, kimsenin okumadığı yerel bir posta kutusu demektir. Posta programı yüklü değilse, cron çıktıyı atar ve sistem günlüğüne yalnızca No MTA installed, discarding output yazar. Oraya da mutlak venv yolunu yazın. Çıktıyı günlükte görmek ve son çalıştırma kaydını tutmak için, aynı ExecStart satırını kullanan bir systemd servis ve zamanlayıcı çifti kullanın.
Docker bu kararın yerini tutar mı?
Bir container kendi dosya sistemine sahiptir, bu nedenle soru ortadan kalkmak yerine şekil değiştirir. python:3.12-slim gibi resmi bir imajda Python, /usr/local içine gömülüdür ve herhangi bir EXTERNALLY-MANAGED işareti taşımaz; bu nedenle paket eklemek için hedeflenen yöntem pip install olarak root kullanmaktır ve venv kullanımı çok az katkı sağlar. Bunun yerine FROM ubuntu:24.04 oluşturduğunuzda, ana makinedekiyle aynı nedenden dolayı imajın içinde tekrar externally-managed-environment ile karşılaşırsınız: bu, dağıtımın işaretçi dosyasını taşıyan dağıtım yorumlayıcısıdır.
Birçok imaj hala venv kullanır çünkü bu, çok aşamalı (multi-stage) derlemeyi basitleştirir. Derleyici aşaması kurulumu /opt/venv içine yapar ve çalışma zamanı aşaması sadece o dizini kopyalayarak derleyicileri geride bırakır. "Activate" sorunu da bununla birlikte gelir. Bir RUN source /opt/venv/bin/activate satırı yalnızca o derleme katmanının kabuğunu etkiler, bu nedenle çalışma zamanında container sistem yorumlayıcısı üzerinde başlar ve ModuleNotFoundError hatasını verir. ENV PATH="/opt/venv/bin:$PATH" ayarını yapın veya CMD için /opt/venv/bin/gunicorn mutlak yolunu belirtin. Bu, farklı bir dosyadaki systemd hatasıyla aynı hatadır.
Sonuç olarak container, imaj yorumlayıcıyı ve altındaki her şeyi sabitlediği için yorumlayıcı sorununun yerini tutar. Ancak sabitleme (pinning) sorununun yerini tutmaz. Sabitlenmemiş bir requirements.txt dosyasından oluşturulan bir imaj, gelecek ay farklı sürümleri çözümleyebilir; bu da imaj etiketinin yeniden üretilebilir olduğu, ancak onu oluşturan derleme işleminin öyle olmadığı anlamına gelir. uv.lock gibi bir kilit dosyası veya tamamen sabitlenmiş bir gereksinim dosyası, container olsun ya da olmasın bu açığı kapatan şeydir. Bir uygulama systemd altında tek bir VPS üzerinde çalıştığında, container bu kararın çoğunu bir Dockerfile dosyasına taşır; çünkü systemd zaten başarısız olan bir süreci yeniden başlatır ve çıktısını journal içinde yakalar. VPS üzerinde Docker çalıştırmak, oluşturulan imajın bizzat kendisini dağıtmak istediğinizde değerini kanıtlar.
FAQ
--break-system-packages bayrağı ile pip install kullanabilir miyim?
Sürekli çalışır durumda tutmanız gereken bir sunucuda bunu yapmamalısınız. Bu bayrak, isminin ifade ettiği işi yapar: korumayı kaldırır ve pip, /usr/local/lib/python3.12/dist-packages dizinine yazma yapar; bu dizin sys.path üzerinde apt dizininden önce gelir. Bu durumda sizin sürümünüz, /usr/bin/python3 altında çalışan tüm sistem betikleri için dağıtımın sağladığı sürümü gölgeler. apt ise kendi sürümünün yüklü olduğunu sanmaya devam eder; dolayısıyla bir şeyler bozulana kadar çakışma tespit edilemez. Her seferinde sıfırdan oluşturduğunuz bir container imajı içinde, hasar yalnızca o imajla sınırlı kalacağı için bu yöntem savunulabilir. Bakımını yaptığınız bir makinede ise bir venv oluşturun. Bu sadece tek bir komuttur.
Bir sunucuda sanal ortam (virtual environment) nerede bulunmalıdır?
Uygulamanın kendi dizini içinde, /srv/myapp/.venv adıyla, bir deploy kullanıcısının sahipliğinde ve servis hesabının yalnızca okuma ve çalıştırma erişimine sahip olduğu bir konumda bulunmalıdır. Uygulama başına bir venv tutun; çünkü paylaşılan bir venv, ilk uygulama için yapılan bir yükseltmenin ikinci uygulamayı bozmasına neden olabilir. Bir venv'yi oluşturduktan sonra taşımayın veya kopyalamayın: bin/ dizinindeki her giriş noktası (entry-point) betiği, shebang satırında o mutlak yolu barındırır; bu nedenle taşınan bir venv, bad interpreter: No such file or directory hatasıyla başarısız olur. Bunun yerine onu silin ve requirements.txt dosyasından yeniden oluşturun.
systemd servisim neden ModuleNotFoundError hatasıyla başarısız oluyor?
Çünkü unit dosyası, venv'ye ait olmayan bir yorumlayıcıyı çalıştırıyor. systemctl cat myapp komutunu çalıştırın ve ExecStart dosyasını okuyun. Bu dosya, /srv/myapp/.venv/bin/python yolunu veya aynı bin/ dizinindeki bir konsol betiğini mutlak yol ile belirtmelidir. activate dosyasını doğrudan ExecStart içinde kaynak (source) olarak kullanmak işe yaramaz; çünkü ExecStart bir kabuk (shell) değildir ve systemd, status=203/EXEC ile Failed to locate executable source hatasını bildirir. Kodunuzun başlattığı tüm alt süreçlerin de venv araçlarını bulabilmesi için Environment=PATH=/srv/myapp/.venv/bin:/usr/local/bin:/usr/bin:/bin ekleyin.
venv ve pip yerine uv kullanmalı mıyım?
Bir lockfile dosyasına ihtiyaç duyduğunuzda, kurulum süresi sizi rahatsız edecek kadar uzun olduğunda veya dağıtımınızın sunmadığı bir Python sürümüne ihtiyaç duyduğunuzda uv kullanın. uv, standart bir venv oluşturur; bu nedenle systemd unit dosyası ve dosya düzeni değişmez; uv sync --frozen ise lockfile dosyasında kayıtlı olanı tam olarak kurar. Eğer tek bir uygulama, sabitlenmiş bir requirements.txt ile git üzerinden dağıtılıyorsa ve kurulum saniyeler içinde tamamlanıyorsa, python3 -m venv zaten yeterlidir ve sunucuda güncel tutulması gereken bir ikili dosyadan daha kurtulmuş olursunuz.