Python Uygulamaları

Güncellendi 18 Kas 2026 Markdown

/admin/python-apps tüm hesaplardaki her Python uygulamasını listeler (uygulama başına bir satır). Hesaba, runtime sürümüne, duruma (running / stopped / errored) göre filtre. Uygulama bazlı detay:

Genel BakışSahip hesap, uygulama slug'ı, dinleme portu, runtime, process durumu, son hata, requirements.txt yolu, virtualenv yolu, gunicorn worker'ları
AyarlarRuntime sürümü (3.10 / 3.11 / 3.12), giriş noktası modülü, ortam değişkenleri (KEY=VALUE), worker sayısı (paket python_workers_limit ile sınırlı), maksimum bellek (paket python_max_memory_mb ile sınırlı)
Loglargunicorn'un kendi error ve access logları (<uygulama>-error.log, <uygulama>-access.log, son N satır); web sunucusunun uygulamanın alan adı için yazdığı satırlar Loglar sayfasında o alan adının altındadır
AksiyonlarBaşlat / durdur / yeniden başlat, requirements kur (uzun süren, SSE stream), durumu sıfırla (yeniden başlatmadan "errored" bayrağını temizler)

Agent aktivasyon sırasında uygulama başına systemd unit + nginx reverse-proxy snippet sağlar. Paketin max_python_apps değeri bir hesabın açabileceği uygulama sayısını sınırlar — 0 sınır yok demektir; sınırın bir fazlası 403 PYTHON_APP_LIMIT ile reddedilir.

Domain bağlama. Uygulamanın domain'i, oluşturulduğu hesaba zaten ait olmalıdır — birincil domain, addon domain ya da alt alan adı. Başka bir ad (başka bir hesabın domain'i ve sunucunun kendi hostname'i dahil) hem oluşturmada hem güncellemede 404 DOMAIN_NOT_FOUND ile reddedilir; önce domain hesaba eklenir. Kural admin ve API çağrıları için de geçerlidir: uygulamanın yazdığı vhost o adı kimin sunacağını belirler.

Ortam değişkenleri. Uygulamanın değişkenleri tek bir küme olarak kaydedilir. Okunamadıklarında sekme Yeniden dene düğmeli bir hata görünümü gösterir ve Kaydet kapalı kalır — aksi hâlde kayıt, saklı her değişkenin yerine ekrandakileri koyardı. Node.js uygulamaları sayfası da aynı davranır.

Ajanın hesap evine yazdığı dosyalar. Uygulamanın .env ve gunicorn.conf.py dosyaları, yeni uygulamanın iskelet dosyaları, uygulama günlük dosyaları (hesabın ev dışındaki log klasöründe, /var/log/whost-accounts/<hesap>/) ve .gunicorn durum klasörü dizin tutamaçlarıyla yazılır, okunur ve silinir; hesabın bu adlardan birine koyduğu bağlantı hiçbir zaman izlenmez: adı bir bağlantı, klasör ya da ikinci sert bağlantılı dosya üzerinde duran kayıt ya da oluşturma 422 VALIDATION_ERROR ile reddedilir (details.field girdiyi adlandırır; panel kaydı başarısız bildirir), günlük görünümü böyle bir adı boş okur, uygulama klasörünün adı bağlantı olan dağıtım "The application folder is missing or is not a plain folder under the account home directory." ile durur. Dağıtımın medya klasörü (media_dir, göreli yol) her zaman uygulama klasörünün altına açılır. Node.js uygulamaları için de aynı kural geçerlidir. Sunucu yolunun analizi projeyi aynı yolla okur: adı hesabın evinin dışına çıkan dosya ya da klasör (dışarı giden bağlantı olan requirements.txt, package.json, kaynak dosyası ya da media klasörü) yok sayılır — içeriği, boyutu ve içindeki adlar kullanılmaz, evin içinde kalan bağlantı ise çalışmaya devam eder; package.json'ı böyle bir bağlantı olan Node.js projesi "package.json could not be read: it is not a plain file inside the account home." uyarısını gösterir, sunucudaki arşiv bağlantı izlenmeden açılan bir tanıtıcıdan açılır (bağlantıyla değiştirilen ad 422 VALIDATION_ERROR, details.field: server_path alır); taşıma dağıtımının hesap evindeki SQL dökümü de böyle bir tanıtıcıdan içe aktarılır (o ana kadar bağlantıya dönmüş ad, dağıtım günlüğünde "SQL dump is not a plain file inside the account home" satırıyla atlanır); hesabın evindeki medya arşivi de öyle okunur ("Media archive is not a plain file inside the account home") ve girdileri medya klasörüne onun tutamacından yazılır. Sunucu yolundan dağıtım kaynak klasörünü (ve medya klasörünü) yol denetiminin gördüğü klasörün tutamacından, her seviyeyi bağlantı izlemeden açarak kopyalar: denetimden sonra o yoldaki bir klasör bağlantıyla değiştirilmişse dağıtım "The source folder is not a plain folder (a link stands on its path)." ile durur (details.field: source_path). Yolun kendisi denetlenirken o yoldaki bir ad değiştirilirse istek dağıtım başlamadan reddedilir: 422 VALIDATION_ERROR, aynı alan, "The source path changed while it was being checked …" — dağıtımı yeniden başlatın. Hesap günlükleri evlerin dışında. Her web sunucusunun alan adı başına erişim ve hata günlükleri, php-error.log ve uygulama günlükleri (Node.js uygulamasının çıktısı, Python uygulamasında gunicorn'un erişim / hata günlükleri) hesabın log klasörüne yazılır: /var/log/whost-accounts/<kullanıcı>/ (root:<hesap grubu> 0750; taban /var/log/whost-accounts root:root 0711), adları her zamanki gibi. Bu dosyaları yolla açan her root süreci — web sunucularının ana süreçleri (nginx, Apache, OpenLiteSpeed), bir uygulamanın çıktısı için systemd, logrotate (/etc/logrotate.d/whost-accounts, kalıp /var/log/whost-accounts/*/*.log) ve fail2ban — böylece hiçbir hesabın adını değiştiremeyeceği bir yolu açar; PHP-FPM ve gunicorn yine hesabın kimliğiyle yazar (hesabın grubu klasörden geçebilir). Hesap klasörü evindeki logs bağlantısından (ajanın açılışında, hesap ve uygulama oluşturulurken ve geri yüklemeden sonra, ad boşsa kurulur; hesabın oraya koyduğu bir ad olduğu gibi bırakılır ve izlenmez) ve panelden görür: Loglar sayfaları, uygulama günlük sekmeleri ve logs'u o klasör olarak salt okunur açan Dosya Yöneticisi. Yedek klasörün dosyalarını eskisi gibi logs/ olarak taşır; hesap silinince log klasörü de silinir; gösterilen disk kullanımı ev + log klasörünü sayar. Var olan kurulum bir kez taşınır, bu sürümün ilk ajan açılışında: ajanın ürettiği ve <ev>/logs adını taşıyan dosyalar (her web sunucusunun vhost'ları, PHP-FPM havuzları, Node.js / Python birimleri, gunicorn yapılandırmaları, logrotate kuralları — /home/*/logs/ adını taşıyan elle yazılmış kural da — ve web jail dosyası) yalnız bu yolu değiştirerek yeni yolu alır, asılları /var/lib/whost/account-logs-move-<zaman>-separate/files/ altında saklanır; her hesabın <ev>/logs'u dosyaları yeniden adlandırılarak klasörüne boşaltılır (aynı dosya sisteminde açık dosyalar aynı kalır, satır kaybolmaz, hiçbir uygulama yeniden başlatılmaz; ayrı dosya sistemlerinde dosyalar kopyalanır, eski klasör <ev>/.logs-moved-<zaman> olarak kalır) ve yerini bağlantıya bırakır; kurulu her web sunucusu sınanır, sonra çalışanlar, havuzu değişen PHP-FPM sürümleri ve systemd yeniden yüklenir; önce geçen ve sonra düşen bir sınama her dosyayı ve günlüğü geri koyar. Ajan günlüğü taşımayı adlandırır (account logs moved out of the homes …) ve /var/lib/whost/agent_state.json kaydeder (account_logs_layout: separate). Günlükleri evlere yazan bir sürüme geri dönmek için: ajanı durdurun, root olarak cd /opt/whost/agent && /opt/whost/venv/bin/python3 -m whost_agent.services.account_logs_move --to home çalıştırın (günlükler ve yollar aynı yolla geri döner), sonra önceki sürümü kurun; bu sürüm yeniden başlatılırsa günlükleri yeniden dışarı taşır. Bu günlükleri okuyan kendi aracınız (bir günlük izleyici, bir istatistik işi) onları yeni yolda okur. Yeni hesabın panel klasörleri (public_html, tmp, ssl, backups, mail) ve varsayılan sayfası da ev tutamacıyla oluşturulur; adında zaten bağlantı duran klasör oluşturmayı 422 VALIDATION_ERROR ile durdurur ("'public_html' in the account home is not a plain folder.", details.field klasörü adlandırır) ve hesap geri alınır — yöneticinin ve bayinin Hesap Oluştur formu bu iletiyi gösterir.

Kullanılan endpoint'ler: GET /accounts/{u}/python-apps, POST /accounts/{u}/python-apps, GET/PUT/DELETE /accounts/{u}/python-apps/{app}, POST /accounts/{u}/python-apps/{app}/{start,stop,restart}, POST /accounts/{u}/python-apps/{app}/install-requirements, GET /accounts/{u}/python-apps/{app}/logs.

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.