Django, Python programlama dilinde oluşturulmuş, ücretsiz ve açık kaynaklı bir web uygulaması çerçevesidir. Django son derece hızlı, güvenli ve yüksek düzeyde ölçeklenebilirdir. Yetenekli bir geliştiricinin elinde Django, hızlı bir şekilde güçlü bir web sitesi kurabilir. Popüler web sunucuları (Apache, Nginx) ve veritabanları (MySQL, MariaDB, PostgreSQL, Oracle ve SQLite) vb. ile sorunsuz bir şekilde entegre olabilir. Django; Instagram, Mozilla ve NASA gibi dünyanın en büyük web sitelerinden bazılarına güç vermektedir. Bu kılavuz, PostgreSQL, Nginx ve Gunicorn yardımıyla Django ile bir web uygulamasının temelini Ubuntu 20.04 üzerinde kurmayı göstermektedir.
Gereksinimler
Bu kılavuz, temel bir güvenlik duvarı ve sudo yetkisine sahip root olmayan bir kullanıcı ile yapılandırılmış bir Ubuntu 20.04 sunucusu çalıştırmanızı gerektirir. Bir Ubuntu sunucusunun nasıl kurulacağına ilişkin bu ayrıntılı kılavuza göz atın. sudo yetkisine sahip root olmayan bir kullanıcıyı yapılandırmak için bu öğreticiyi takip edin. Ayrıca bu kılavuzdaki adımları izleyerek bir Iptables güvenlik duvarı yapılandırabilirsiniz.
. Django'yu sanal bir ortamda kuracağız. Projeye özel bir ortama sahip olmak, aynı sunucudan birden fazla projenin daha kolay yönetilmesini sağlar. Veritabanları ve uygulamalar hazır olduğunda, Gunicorn uygulama sunucusunu dağıtacağız. Gunicorn, istemci isteklerini HTTP'den uygulamamızın kullanabileceği Python çağrılarına dönüştüren uygulama arayüzü olacaktır. Ardından, hızlı performanslı bağlantı yönetimi ve uygulaması kolay güvenlik özellikleri için Gunicorn'un önüne Nginx'i dağıtacağız.
Gerekli Paketlerin Kurulması
İlk olarak, gerekli tüm paketleri kurarak işe başlayın. Neyse ki, tüm bu paketler resmi Ubuntu paket depolarından doğrudan temin edilebilir. Terminali açın ve APT paket önbelleğini güncelleyin:
|
1 |
sudo apt update |
Paket listesi, web uygulamasının Python 2 mi yoksa Python 3 mü kullanacağına bağlıdır. Django'yu Python 3 ile kurmak için aşağıdaki komutu çalıştırın:
|
1 |
sudo apt install python3-pip python3-dev libpq-dev postgresql postgresql-contrib nginx curl |
Django 1.11 LTS, Django'nun Python 2'yi destekleyecek son sürümüdür. Django'yu Python 2 ile kullanmak istiyorsanız, aşağıdaki paketleri kurun:
|
1 |
sudo apt install python-pip python-dev libpq-dev postgresql postgresql-contrib nginx curl |
PostgreSQL Veritabanı ve Kullanıcısı
Veritabanı çözümü olarak PostgreSQL kullanacağız. Güçlü, açık kaynaklı bir nesne-ilişkisel veritabanı sistemidir. PostgreSQL güvenilirlik, sağlamlık ve performans sunar. PostgreSQL kurulumuna ilişkin ayrıntılı adımlar için Ubuntu sunucusunda PostgreSQL kurulumu hakkındaki bu kılavuza göz atın. Bu kılavuz için, Django uygulamamız için özel bir veritabanı ve kullanıcı oluşturacağız.
Varsayılan olarak PostgreSQL, yerel bağlantılar için kimlik doğrulama şeması olarak “peer authentication” (eş kimlik doğrulaması) uygular. Kısacası, “peer authentication”, kullanıcının işletim sistemi kullanıcı adı geçerli bir PostgreSQL kullanıcı adı ile eşleşirse girişi doğrular. Kurulum sırasında PostgreSQL, postgres işletim sistemi kullanıcısını, postgres PostgreSQL yönetici kullanıcısına karşılık gelecek şekilde yapılandırdı. Aşağıdaki komutu kullanarak postgres olarak PostgreSQL etkileşimli kabuk oturumuna giriş yapın:
|
1 |
sudo -u postgres psql |
PostgreSQL komut satırına ulaşacaksınız. İlk adım, proje için özel bir veritabanı oluşturmaktır. Gösterim amacıyla veritabanı viktor_project:
|
1 |
CREATE DATABASE viktor_project; |
Bir sonraki adım, proje veritabanı için özel bir kullanıcı oluşturmaktır. Kullanıcının güçlü bir kullanıcı adı olmalıdır. Gösterim amacıyla kullanıcı adı viktor_project_user:
|
1 |
CREATE USER viktor_project_user WITH PASSWORD 'password123'; |
Şimdi bazı parametreleri değiştireceğiz:
- Belirli bağlantı parametreleri. Kısacası, her bağlantı kurulduğunda doğru değerleri sorgulamak ve ayarlamak gerekmeyecektir. Bu, veritabanı performansını büyük ölçüde artırır.
- Varsayılan kodlama:
UTF-8. Bu evrensel bir kodlamadır ve Django bunu bekler. - Varsayılan işlem yalıtım şeması “read committed” (işlenmişi oku) olarak ayarlanır. İşlenmemiş işlemlerden okuma yapılmasını engeller.
- Saat dilimi:
UTC.
Tüm bu parametre değişiklikleri Django projesinin kendisi tarafından önerilmektedir. Bu değişiklikleri uygulamak için aşağıdaki komutları çalıştırın. Veritabanı kullanıcı adını doğru olanla değiştirmeyi unutmayın:
|
1 2 3 |
ALTER ROLE viktor_project_user SET client_encoding TO 'utf8'; ALTER ROLE viktor_project_user SET default_transaction_isolation TO 'read committed'; ALTER ROLE viktor_project_user SET timezone TO 'UTC'; |
Veritabanı yöneticisini özel veritabanı kullanıcısı olarak değiştirin:
|
1 |
GRANT ALL PRIVILEGES ON DATABASE viktor_project TO viktor_project_user; |
PostgreSQL ile işimiz şimdilik bitti. PostgreSQL etkileşimli kabuğundan çıkın:
|
1 |
\q |
Python Sanal Ortamı
Veritabanı hazırlandıktan sonra, artık projenin diğer gereksinimlerini oluşturmaya odaklanabiliriz. Daha kolay yönetim için sanal bir ortam oluşturacağız ve tüm Python gereksinimlerini oraya yükleyeceğiz. Sanal bir ortam oluşturmak için virtualenv'e ihtiyacımız var. Pip ile kolayca kurulabilir.
Aşağıdaki komutlar pip'i yükseltecek ve virtualenv'i kuracaktır. Python 3 için aşağıdaki komutları çalıştırın:
|
1 2 |
sudo -H pip3 install --upgrade pip sudo -H pip3 install virtualenv |
Python 2 için bunun yerine aşağıdaki komutları çalıştırın:
|
1 2 |
sudo -H pip install --upgrade pip sudo -H pip install virtualenv |
Once virtualenv kurulduktan sonra, sanal bir ortam oluşturma zamanı gelmiştir. Ardından, sanal ortam için özel bir dizin oluşturun:
|
1 |
mkdir -v ~/viktor_project |
Bundan sonra, mevcut aktif dizini sanal ortam için ayrılmış dizine değiştirin:
|
1 |
cd ~/viktor_project |
Dizin içinde aşağıdaki komutu çalıştırın. virtualenv aracı, proje adıyla sanal bir ortam oluşturacaktır:
|
1 |
virtualenv viktor_project |
Proje adıyla bir alt dizin oluşturacaktır. Alt dizin, Python'ın yerel bir sürümünü ve pip. Proje için izole bir Python ortamı kurma ve yapılandırma esnekliği sunar.
Aşağıdaki komut sanal ortamı etkinleştirecektir:
|
1 |
source viktor_project/bin/activate |
Terminal istemi, bir Python sanal ortamı içinde çalıştığınızı gösterecek şekilde değişecektir. Artık sanal ortamda olduğumuza göre, gerekli Python gereksinimlerini kuracağız. Django, Gunicorn ve psycopg2 (PostgreSQL adaptörü) bileşenlerine ihtiyacımız var. Aşağıdaki komut, yerel pip'e bileşenleri kurmasını söyleyecektir:
|
1 |
pip install django gunicorn psycopg2-binary |
Python 3 kullanıyor olsanız bile doğru komut pip'tir. Çünkü sanal ortamda pip3, pip olarak yeniden adlandırılır.
Yeni Django Projesi
Python bileşenleri hazır olduğuna göre, gerçek Django proje dosyalarıyla çalışmaya başlayabiliriz.
-
Django projesi oluşturma
Proje dizini zaten oluşturuldu. Django'ya dosyalarını oraya kurmasını söyleyeceğiz. Bu işlem, gerçek kodları içeren ikinci düzey bir dizin oluşturacaktır. Dizin ayrıca bir yönetim betiği de içerecektir. Önemli olan, Django'nun mevcut dizine göre karar vermesine izin vermek yerine hedef dizini açıkça belirtmemizdir:
|
1 |
django-admin.py startproject viktor_project ~/viktor_project |
Django projeyi buna göre oluşturacaktır. İşte odaklanacağımız önemli dosya ve dizinlerden bazıları. Dizin ve dosya adları gösterime göre kullanılmıştır.
~/viktor_project/manage.py: Django tarafından sağlanan proje yönetim betiği.~/viktor_project/viktor_project/: Django projesini içeren pakettir. __init__.py, settings.py, urls.py, asgi.py ve wsgi.py dosyalarını içermelidir.
-
Proje ayarlarını düzenleme
Proje oluşturulduktan sonra yapılacak ilk şey yapılandırmasını düzenlemektir. Bir metin düzenleyicide settings.py dosyasını açın:
|
1 |
nano ~/viktor_project/viktor_project/settings.py |
Aradığımız ilk yönerge ALLOWED_HOSTS'tur. Django örneğine bağlanabilecek sunucuları veya alan adlarını tanımlar. Gelen herhangi bir istekte Host başlığı ALLOWED_HOSTS listesiyle eşleşmezse, bir istisna oluşturacaktır. Belirli güvenlik açıklarından kaçınmak için Django tarafından önerilir:
|
1 |
ALLOWED_HOSTS = ['<server_ip_or_domain_name_1>',' server_ip_or_domain_name_2','localhost'] |
Odaklanacağımız bir sonraki bölüm DATABASE'dir. Veritabanı erişimini yönetir. Varsayılan olarak, SQLite veritabanı motoru için yapılandırma içerir. Ancak proje için PostgreSQL veritabanını kullanacağız. Django, PostgreSQL ile iletişim kurmak için psycopg2 adaptörünü kullanacaktır:
|
1 2 3 4 5 6 7 8 9 10 |
DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql_psycopg2', 'NAME': 'viktor_project', 'USER': 'viktor_project_user', 'PASSWORD': 'password123', 'HOST': 'localhost', 'PORT': '', } } |
Şimdi dosyanın en altına gidin. Statik dosyaların konumunu belirtmek için aşağıdaki satırları ekleyin. Bu, Nginx'in bu öğeler için gelen istekleri işlemesine yardımcı olur:
|
1 2 |
import os STATIC_ROOT = os.path.join(BASE_DIR, 'static/') |
Şimdilik settings.py ile işimiz bitti. Dosyayı kaydedin ve düzenleyiciyi kapatın.
-
İlk proje kurulumunun tamamlanması
Artık ilk veritabanı şemasını ayrılmış PostgreSQL veritabanına taşıyabiliriz. Aşağıdaki komutu çalıştırın:
|
1 2 |
~/viktor_project/manage.py makemigrations ~/viktor_project/manage.py migrate |
Ardından, proje için bir süper kullanıcı oluşturmamız gerekiyor. Bir süper kullanıcı oluşturmak için aşağıdaki komutu çalıştırın:
|
1 |
~/viktor_project/manage.py createsuperuser |
Tüm statik dosyaları settings.py dosyasında belirttiğimiz konumda toplayın. Statik dosyalar, proje dizini altında “static” adında ayrı bir dizinde toplanacaktır:
|
1 |
~/viktor_project/manage.py collectstatic |
Şimdi sunucu güvenlik duvarı ile uğraşmamız gerekiyor. Sunucu yapılandırma kılavuzunu takip ettiyseniz, zaten UFW'yi yapılandırmış ve etkinleştirmişsinizdir. 8000 numaralı bağlantı noktası için bir istisna oluşturacağız. Bu, Django'nun kullandığı varsayılan bağlantı noktasıdır. Şunun hakkında daha fazla bilgi edinmek için bu kılavuza göz atın: UFW güvenlik duvarı temelleri ve kullanımı.
|
1 |
sudo ufw allow 8000 |
Ardından, işlemi doğrulayın:
|
1 |
sudo ufw status |
Son olarak, sunucuyu çalışırken test edebiliriz. Django geliştirme sunucusunu başlatın:
|
1 |
~/viktor_project/manage.py runserver 0.0.0.0:8000 |
Yapılandırma başarıyla tamamlandıysa, Django geliştirme sunucusu başlamalı ve gelen istekleri kabul etmelidir. Bir tarayıcı açın ve 8000 numaralı bağlantı noktasında sunucunuzun IP/alan adına gidin:
|
1 |
http://<server_or_domain>:8000 |
Django varsayılan dizin sayfasına ulaşmalısınız. Yönetici paneline erişmek için URL'nin sonuna /admin ekleyin. Yönetici paneline yalnızca önceden oluşturduğumuz süper kullanıcı erişebilir:
|
1 |
http://<server_or_domain>:8000/admin |
Giriş yaptıktan sonra, varsayılan Django yönetim arayüzüne yönlendirileceksiniz:
Şimdilik test etmeyi bitirdik. Sunucuyu durdurmak için terminal penceresinden “Ctrl + C” tuşlarına basın.
-
Gunicorn'u Test Etme
Sanal ortamdan çıkmadan önce, Gunicorn'un uygulamaları sunabildiğinden emin olmak istiyoruz. Bunu test etmenin yolu, projenin WSGI modülünü yüklemek için Gunicorn kullanmaktır.
Gunicorn komutu proje dizini içinde yer alır:
|
1 2 |
cd ~/viktor_project gunicorn --bind 0.0.0.0:8000 viktor_project.wsgi |
Bu, Gunicorn'u Django'nun çalıştığı aynı arayüzde başlatacaktır. Uygulamayı normal bir web tarayıcısından tekrar test edebiliriz. Gunicorn'un statik CSS içeriklerini nasıl bulacağını henüz bilmemesi nedeniyle yönetim arayüzüne herhangi bir stil uygulanmayacağını unutmayın:
|
1 |
http://<server_or_domain>:8000 |
İşiniz bittiğinde, Gunicorn sunucusunu durdurmak için terminal penceresinden “Ctrl + C” tuşlarına basın.
-
Sanal ortamdan çıkış
Django uygulama yapılandırması tamamlandı. Sanal ortamdan çıkmak için aşağıdaki komutu çalıştırın:
|
1 |
deactivate |
Gunicorn Soket ve Servis Dosyaları
Gunicorn'un Django uygulamasıyla etkileşime girebildiğini doğruladık. Ancak, uygulama sunucusunu yönetmek için daha sağlam bir yola ihtiyacımız var. İşte burada devreye systemd giriyor. Systemd, Linux'ta bulunan en popüler init sistemlerinden biridir. İşte hakkında derinlemesine bir rehber: systemd servisleri ve birimleri nasıl yönetilir.
Gunicorn için soket ve servis dosyaları oluşturarak systemd'nin onu bir servismiş gibi yönetmesini sağlayabiliriz. Önyükleme sırasında Gunicorn soketi oluşturulacaktır. Soket, gelen bağlantıları dinleyecektir. Bir bağlantı gerçekleştiğinde, systemd bağlantıyı işlemek için Gunicorn işlemlerini başlatacaktır.
-
Gunicorn soketi
Bir Gunicorn soketi oluşturarak başlayalım. Dosyanın sudo yetkisiyle oluşturulması gerekir:
|
1 |
sudo nano /etc/systemd/system/gunicorn.socket |
Dosyanın içine aşağıdaki kodu girin:
|
1 2 3 4 5 6 7 |
[Unit] Description=gunicorn socket [Socket] ListenStream=/run/gunicorn.sock [Install] WantedBy=sockets.target |
Gördüğünüz gibi, kodun üç bölümü vardır.
[Unit]:Bu bölüm soketi tanımlar.[Socket]:Soket konumunu tanımlar.[Install]:Bu kısım, systemd'nin soketi doğru zamanda oluşturmasını sağlar.
Dosyayı kaydedin ve düzenleyiciyi kapatın.
-
Gunicorn servisi
Sırada, Gunicorn için bir servis dosyası oluşturacağız. Soket dosyasına benzer şekilde, bunun da sudo yetkisiyle oluşturulması gerekir:
|
1 |
sudo nano /etc/systemd/system/gunicorn.service |
Aşağıdaki kodu girin:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
[Unit] Description=gunicorn daemon Requires=gunicorn.socket After=network.target [Service] User=cloudsigma Group=www-data WorkingDirectory=/home/cloudsigma/viktor_project ExecStart=/home/cloudsigma/viktor_project/viktor_project/bin/gunicorn \ --access-logfile - \ --workers 3 \ --bind unix:/run/gunicorn.sock \ viktor_project.wsgi:application [Install] WantedBy=multi-user.target |
Kod birden fazla bölüm içerir:
[Unit]:Bu bölüm meta verileri ve bağımlılıkları belirtir. Ayrıca yalnızca ağ hedefine ulaşıldıktan sonra başlatılacağını açıklar.[Service]:Bu bölüm, işlemin altında çalışacağı kullanıcıyı ve grubu belirtir. Grubun sahipliği, Nginx'in Gunicorn ile iletişim kurabilmesi için “www-data” olarak ayarlanmıştır. Ayrıca çalışma dizinlerini eşler ve başlangıç komutlarını belirtir.[Install]:Bu bölüm, sistem açılışında etkinleştirilirse systemd'ye bu hizmeti neye bağlayacağını söyler. Normal çok kullanıcılı sistem çalışmaya başladıktan sonra başlamalıdır.
Ardından, dosyayı kaydedin ve düzenleyiciyi kapatın.
-
Gunicorn soketini etkinleştirme
Gunicorn soketi kullanıma hazır. Bu nedenle, aşağıdaki komutları çalıştırabilirsiniz. Soketi başlatacak ve etkinleştirecektir. Soket dosyası şurada oluşturulacaktır: /run/gunicorn.sock açılışta. Sokete bir bağlantı yapıldığında, systemd bunu işlemek için Gunicorn hizmetini başlatacaktır:
|
1 2 |
sudo systemctl start gunicorn.socket sudo systemctl enable gunicorn.socket |
Gunicorn soketinin durumunu kontrol edin:
|
1 |
sudo systemctl status gunicorn.socket |
Şimdi, soket dosyasının varlığını kontrol edin:
|
1 |
file /run/gunicorn.sock |
Systemctl'den gelen durum bir hata gösteriyorsa veya gunicorn.sock dosyası bulunamadıysa, bu soketin doğru şekilde oluşturulmadığını gösterir. İpuçları için ayrıntılı günlüğe göz atın:
|
1 |
sudo journalctl -u gunicorn.socket |
Olası hatalar için gunicorn.socket dosyasına tekrar bakmayı unutmayın.
-
Soket aktivasyonu
Şimdiye kadar gunicorn.socket başlattık. Ancak, herhangi bir bağlantı isteği olmadan, gunicorn.service etkinleşmeyecektir. Ardından, Gunicorn'un durumunu doğrulayın:
|
1 |
sudo systemctl status gunicorn |
Soket aktivasyon mekanizmasını, curl kullanarak bir bağlantı isteği göndererek test edebiliriz:
|
1 |
curl --unix-socket /run/gunicorn.sock localhost |
Uygulamadan bir HTML çıktısı almalısınız. Bu, Gunicorn'un başarıyla başladığını ve Django uygulamasını sunabildiğini gösterir. Gunicorn hizmetinin mevcut durumunu doğrulayın:
|
1 |
sudo systemctl status gunicorn |
Beklenmeyen bir davranış veya çıktı (bir hata gösteren) varsa, ipuçları için ayrıntılı günlüklere göz atın:
|
1 |
sudo journalctl -u gunicorn |
gunicorn.service dosyasında değişiklik yapıldıysa, hizmet tanımını yeniden okumak için arka plan programını (daemon) yeniden yüklemeniz gerekir. Bu ayrıca Gunicorn hizmetinin yeniden başlatılmasını gerektirir:
|
1 2 |
sudo systemctl daemon-reload sudo systemctl restart gunicorn |
Nginx'i Yapılandırma
Şimdi, gelen trafiği işleme aktarmak için Nginx'i yapılandıracağız. İlk olarak, Nginx'te yeni bir sunucu bloğu oluşturun:
|
1 |
sudo nano /etc/nginx/sites-available/viktor_project |
Ardından, aşağıdaki kodu girin:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
server { listen 80; server_name 31.171.250.71; location = /favicon.ico { access_log off; log_not_found off; } location /static/ { root /home/cloudsigma/viktor_project; } location / { include proxy_params; proxy_pass http://unix:/run/gunicorn.sock; } } |
Yapılandırmada birden fazla blok bulunmaktadır:
service:Bu blok, sunucunun normal olarak 80 numaralı bağlantı noktasını dinlemesi gerektiğini ve sunucunun alan adına veya IP adresine yanıt vermesi gerektiğini tanımlar.location:Bu ilk location girişidir. Statik varlıkların nerede bulunacağını tanımlar.location:Bu ikinci location girişidir. Bu blok, standart proxy parametrelerini ve trafiğin Gunicorn soketine nasıl aktarılacağını tanımlar.
Dosyayı kaydedin ve düzenleyiciyi kapatın. Etkinleştirmek için dosyayı “sites-enabled” dizinine bağlayın:
|
1 |
sudo ln -s /etc/nginx/sites-available/viktor_project /etc/nginx/sites-enabled |
Bundan sonra, Nginx yapılandırmasında herhangi bir sözdizimi hatası olup olmadığını test edin:
|
1 |
sudo nginx -t |
Bir hata bulamadıysanız, değişikliği uygulamak için Nginx'i yeniden başlatın:
|
1 |
sudo systemctl restart nginx |
UFW kurallarını tekrar değiştirmemiz gerekiyor. Artık geliştirme sunucusuna erişime ihtiyacımız yok, bu nedenle 8000 portu için olan istisnayı kaldırabiliriz. Ek olarak, normal trafik için 80 portunu açmak istiyoruz:
|
1 2 |
sudo ufw delete allow 8000 sudo ufw allow 'Nginx Full' |
Bu güvenlik duvarı kuralı değişikliklerini doğrulayın:
|
1 |
sudo ufw status |
Sunucuya artık normal bir web tarayıcısından erişilebilmelidir.
Sorun Giderme Prosedürleri
Tüm adımlar düzgün bir şekilde takip edildiyse, Django uygulamasına internet üzerinden erişilebilmelidir. Erişilemiyorsa, bu durum kurulumun planlandığı gibi gitmediğini gösterir. Sorunun kaynağını bulmak için sorun giderme yapmamız gerekir.
-
Nginx varsayılan sayfayı gösteriyor
Nginx, uygulama proxy'si yerine varsayılan sayfayı görüntülüyorsa, bu genellikle server_name ifadesinin sunucu bloğunda yanlış yapılandırıldığı anlamına gelir.
Bu örnekte, sunucu bloğu aşağıdaki konumda saklanır:
|
1 |
/etc/nginx/sites-available/viktor_project |
The server_name girdisi, Nginx'in isteklere yanıt vermek için hangi sunucu bloğunu kullanacağını belirler. Varsayılan sayfa gösteriliyorsa, Nginx muhtemelen isteği açık bir sunucu bloğuyla eşleştirememiştir, bu nedenle bunun yerine varsayılan bloğa geri dönüyordur:
|
1 |
/etc/nginx/sites-available/default |
Şu değerin Django projenizin sunucu bloğunda düzgün şekilde yapılandırılıp yapılandırılmadığını kontrol edin: server_name.
-
502 Bad Gateway
502 Hatası, Nginx'in isteği başarıyla yönlendiremediğini (proxy) gösterir. 502 hatasına yol açabilecek çok çeşitli olası yapılandırma sorunları vardır, bu nedenle düzgün bir şekilde sorun gidermek için ipuçlarına ihtiyacımız var.
İpuçlarının birincil kaynağı Nginx hata günlükleridir. Genellikle, proxy işlemi sırasında sorunlara neden olan koşullara işaret eder. Aşağıdaki komutu kullanarak Nginx hata günlüğünü kontrol edin:
|
1 |
sudo tail -F /var/log/nginx/error.log |
Günlük açıldıktan sonra, sunucuya bir kez daha erişmeyi deneyin. Günlükte yeni bir hata mesajı oluşturmalıdır. Bu, sorunu daraltmaya yardımcı olabilir. İşte birkaç olası mesaj:
- connect() to unix:/run/gunicorn.sock failed (2: No such file or directory)
Bu, Nginx'in gunicorn.sock dosyasını yapılandırmada tanımlanan konumda bulamadığını gösterir. Konum, site bloğu altındaki proxy_pass yönergesi ile tanımlanır. proxy_pass ifadesinin, gunicorn.socket systemd birimi tarafından oluşturulan gunicorn.sock dosyasının doğru konumunu gösterip göstermediğini kontrol edin:
|
1 |
/etc/nginx/sites-available/viktor_project |
Eğer gunicorn.sock dosyası /run dizini altında bulunamadıysa, bu systemd'nin bunu oluşturamadığı anlamına gelir. Gunicorn soket dosyası yapılandırma adımlarını yeniden kontrol etmelisiniz.
- connect() to unix:/run/gunicorn.sock failed (13: Permission denied)
Bu, izin sorunları nedeniyle Nginx'in Gunicorn soketine bağlanamadığını gösterir. İşlem bir sudo kullanıcısı yerine root kullanıcısı olarak gerçekleştirildiyse bu durum yaşanabilir. systemd gunicorn.sock dosyasını başarıyla oluşturmuş olsa da, Nginx bunu kullanamaz.
Olası nedenlerden biri, kök dizin (/) ile gunicorn.sock dosyası arasındaki sınırlı izinler olabilir. Soket dosyasının ve üst dizinlerinin her birinin iznini ve sahipliğini kontrol edin:
|
1 |
namei -l /run/gunicorn.sock |
İlk sütun dosya iznini açıklar. İkinci sütun kullanıcı sahibini ve üçüncü sütun grup sahibini açıklar. gunicorn.sock dosyasına giden dizinlerden herhangi biri uygun okuma ve yürütme izinlerine sahip değilse, Nginx sokete erişemez.
-
Django'nun “could not connect to the server: Connection refused” hatası göstermesi
Bu, Django'nun PostgreSQL sunucusuna bağlanamadığını gösterir. PostgreSQL sunucusunun çalışır durumda olduğundan emin olun:
|
1 |
sudo systemctl status postgresql |
Eğer çalışmıyorsa, başlatmak ve etkinleştirmek için aşağıdaki komutları çalıştırın:
|
1 2 |
sudo systemctl start postgresql sudo systemctl enable postgresql |
Hâlâ bu hatayı alıyorsanız, veritabanı kimlik bilgilerinin şunun altında düzgün bir şekilde tanımlandığından emin olun: settings.py:
|
1 |
~/viktor_project/viktor_project/settings.py |
Daha fazla sorun giderme
Ek sorun giderme işlemleri için çeşitli günlükler (loglar) mevcuttur. Bu günlükler, sorunların kaynaklarını daraltmaya yardımcı olabilir.
Yardımcı olabilecek günlüklerin listesi aşağıdadır:
- Nginx günlükleri
|
1 |
sudo journalctl -u nginx |
- Erişim günlükleri-Nginx
|
1 |
sudo less /var/log/nginx/access.log |
- Hata günlükleri-Nginx
|
1 |
sudo less /var/log/nginx/error.log |
- Uygulama günlükleri-Gunicorn
|
1 |
sudo journalctl -u gunicorn |
- Soket günlükleri-Gunicorn
|
1 |
sudo journalctl -u gunicorn.socket |
|
1 |
sudo systemctl restart gunicorn |
|
1 2 |
sudo systemctl daemon-reload sudo systemctl restart gunicorn.socket gunicorn.service |
|
1 2 |
sudo nginx -t sudo systemctl restart nginx |
Son Düşünceler
Bu kılavuz, Django'nun temelinin nasıl atılacağını başarıyla göstermektedir. Django, bir web uygulamasının ortak bileşenlerinin çoğunu sağlayarak benzersiz unsurlara odaklanmanıza olanak tanır. Django projesi sanal ortam içinde çalışacaktır. Gunicorn, istemci istekleri ile Django arasındaki iletişimi yönetir. Son olarak, Nginx istemci bağlantılarını işlemek için bir ters proxy (reverse proxy) görevi görür.
Keyifli çalışmalar!
Yorumlar
Henüz yorum yapılmamış. İlk siz olun.