{"id":29596,"date":"2025-09-16T12:30:27","date_gmt":"2025-09-16T09:30:27","guid":{"rendered":"https:\/\/fatihsoysal.com\/blog\/fastapi-uygulamasini-digital-ocean-dropletta-nginx-ve-ci-cd-ile-dagitma\/"},"modified":"2025-09-16T12:30:27","modified_gmt":"2025-09-16T09:30:27","slug":"fastapi-uygulamasini-digital-ocean-dropletta-nginx-ve-ci-cd-ile-dagitma","status":"publish","type":"post","link":"https:\/\/fatihsoysal.com\/blog\/fastapi-uygulamasini-digital-ocean-dropletta-nginx-ve-ci-cd-ile-dagitma\/","title":{"rendered":"FastAPI Uygulamas\u0131n\u0131 Digital Ocean Droplet’ta Nginx ve CI\/CD ile Da\u011f\u0131tma"},"content":{"rendered":"

FastAPI Uygulamas\u0131n\u0131 Digital Ocean Droplet’ta Nginx ve CI\/CD ile Da\u011f\u0131tma<\/p>\n

H\u0131zl\u0131, \u00f6l\u00e7eklenebilir ve g\u00fcvenilir bir web uygulamas\u0131 geli\u015ftirmek ve da\u011f\u0131tmak her zaman zorlu bir s\u00fcre\u00e7tir. Bu makalede, pop\u00fcler Python web framework’\u00fc FastAPI’yi kullanarak bir uygulamay\u0131 Digital Ocean Droplet \u00fczerinde Nginx reverse proxy ile nas\u0131l da\u011f\u0131taca\u011f\u0131n\u0131z\u0131 ve s\u00fcrekli entegrasyon\/s\u00fcrekli da\u011f\u0131t\u0131m (CI\/CD) pipeline’\u0131n\u0131 nas\u0131l kuraca\u011f\u0131n\u0131z\u0131 ad\u0131m ad\u0131m ele alaca\u011f\u0131z. Bu, uygulaman\u0131z\u0131n g\u00fcncellemelerini otomatik hale getirecek ve sunucu y\u00f6netimini kolayla\u015ft\u0131racakt\u0131r. Haz\u0131rsan\u0131z, ba\u015flayal\u0131m!<\/p>\n

FastAPI, Nginx ve Digital Ocean: Temel Kavramlar<\/h2>\n

\u00d6ncelikle, projemizin temel bile\u015fenlerini anlamam\u0131z gerekiyor. FastAPI, modern ve performans odakl\u0131 bir Python web framework’\u00fcd\u00fcr. Asenkron yap\u0131s\u0131 sayesinde y\u00fcksek performans sunar ve API geli\u015ftirmeyi olduk\u00e7a kolayla\u015ft\u0131r\u0131r. Nginx, y\u00fcksek performansl\u0131 bir web sunucusu ve reverse proxy’dir. Trafi\u011fi y\u00f6netir, statik dosyalar\u0131 sunar ve FastAPI uygulaman\u0131z\u0131n \u00f6n\u00fcne ge\u00e7erek g\u00fcvenlik ve performans katman\u0131 ekler. Digital Ocean, \u00f6l\u00e7eklenebilir bulut sunucular\u0131 sunan bir platformdur. Droplet’lerimiz, uygulamalar\u0131m\u0131z\u0131 bar\u0131nd\u0131raca\u011f\u0131m\u0131z sanal sunuculard\u0131r.<\/p>\n

Bu \u00fc\u00e7 bile\u015feni birle\u015ftirerek, g\u00fcvenli, h\u0131zl\u0131 ve \u00f6l\u00e7eklenebilir bir uygulama mimarisi kuraca\u011f\u0131z. FastAPI, uygulaman\u0131n \u00e7ekirde\u011fini olu\u015fturacak, Nginx trafi\u011fi y\u00f6netecek ve Digital Ocean altyap\u0131s\u0131n\u0131 sa\u011flayacakt\u0131r. CI\/CD s\u00fcreci ise uygulaman\u0131n g\u00fcncellemelerini otomatikle\u015ftirecek ve manuel m\u00fcdahaleyi en aza indirecektir. Daha fazla bilgi i\u00e7in (https:\/\/fatihsoysal.com) inceleyebilirsiniz.<\/p>\n

Digital Ocean Droplet’\u0131 Haz\u0131rlama: Ad\u0131m Ad\u0131m Kurulum<\/h2>\n

\u0130lk ad\u0131m\u0131m\u0131z, Digital Ocean’da bir Droplet olu\u015fturmakt\u0131r. Bu s\u00fcre\u00e7, Digital Ocean kontrol panelinden birka\u00e7 t\u0131klamayla tamamlanabilir. Ubuntu veya Debian gibi bir Linux da\u011f\u0131t\u0131m\u0131 se\u00e7meniz \u00f6nerilir. Droplet’\u0131n\u0131z\u0131 olu\u015fturduktan sonra SSH ile ba\u011flanarak gerekli yaz\u0131l\u0131mlar\u0131 kuraca\u011f\u0131z. Bu ad\u0131mda, Python, pip, Nginx ve gerekli di\u011fer paketleri kuraca\u011f\u0131z. \u00d6zellikle g\u00fcvenlik duvar\u0131 ayarlar\u0131n\u0131 do\u011fru yapman\u0131z kritiktir. Sadece gerekli portlar\u0131n (\u00f6rne\u011fin, 80 ve 443 i\u00e7in HTTP ve HTTPS, ayr\u0131ca FastAPI uygulaman\u0131z\u0131n dinledi\u011fi port) a\u00e7\u0131k oldu\u011fundan emin olun.<\/p>\n

\u0130\u015fte \u00f6rnek bir kurulum komut dizisi:<\/p>\n

sudo apt update\nsudo apt upgrade -y\nsudo apt install python3 python3-pip nginx -y<\/pre>\n
<\/code><\/p>\n
Daha sonra, sisteminizin g\u00fcncel oldu\u011fundan ve g\u00fcvenlik a\u00e7\u0131klar\u0131n\u0131n kapat\u0131ld\u0131\u011f\u0131ndan emin olmal\u0131s\u0131n\u0131z.  Bunun i\u00e7in d\u00fczenli g\u00fcvenlik g\u00fcncellemelerini takip etmeniz ve g\u00fcvenlik duvar\u0131 kurallar\u0131n\u0131z\u0131 d\u00fczenli olarak g\u00f6zden ge\u00e7irmeniz \u00e7ok \u00f6nemlidir. G\u00fcvenlik duvar\u0131 hatalar\u0131, s\u0131zmalara ve verilerin \u00e7al\u0131nmas\u0131na neden olabilir.<\/p>\n
FastAPI Uygulamas\u0131n\u0131n Kurulumu ve Yap\u0131land\u0131rmas\u0131<\/h2>\n
Digital Ocean Droplet'\u0131n\u0131za SSH ile ba\u011fland\u0131ktan sonra, FastAPI projenizi klonlayabilir veya yeni bir proje olu\u015fturabilirsiniz.  Projenizi sanal bir ortamda \u00e7al\u0131\u015ft\u0131rmak (virtualenv) iyi bir uygulamad\u0131r.  Bu, proje ba\u011f\u0131ml\u0131l\u0131klar\u0131n\u0131z\u0131n sisteminizin genel Python kurulumunu etkilememesini sa\u011flar.  Projenizi olu\u015fturduktan sonra, gerekli paketleri requirements.txt<\/code> dosyas\u0131na ekleyip pip install -r requirements.txt<\/code> komutu ile y\u00fckleyebilirsiniz.<\/p>\n
\u0130\u015fte basit bir FastAPI uygulamas\u0131 \u00f6rne\u011fi:<\/p>\n
from fastapi import FastAPI\n\napp = FastAPI()\n\n@app.get(\"\/\")\nasync def root():\n    return {\"message\": \"Hello World\"}<\/pre>\n
<\/code><\/p>\n
Bu uygulamay\u0131 \u00e7al\u0131\u015ft\u0131rmak i\u00e7in uvicorn main:app --reload<\/code> komutunu kullanabilirsiniz (main.py dosyan\u0131zda \u00e7al\u0131\u015ft\u0131r\u0131yorsan\u0131z).  Uygulaman\u0131n \u00e7al\u0131\u015ft\u0131\u011f\u0131ndan emin olduktan sonra, Nginx ile entegre etmemiz gerekir.<\/p>\n
Nginx Reverse Proxy'sinin Yap\u0131land\u0131rmas\u0131<\/h2>\n
Nginx, FastAPI uygulaman\u0131z\u0131n \u00f6n\u00fcnde bir reverse proxy olarak \u00e7al\u0131\u015farak performans\u0131 art\u0131r\u0131r ve g\u00fcvenlik katman\u0131 ekler.  Nginx'in yap\u0131land\u0131rma dosyas\u0131 genellikle \/etc\/nginx\/sites-available\/default<\/code>  konumunda bulunur.  Bu dosyay\u0131 d\u00fczenleyerek FastAPI uygulaman\u0131z\u0131n dinledi\u011fi porta y\u00f6nlendirme yapabilirsiniz.  HTTPS kullanmak i\u00e7in bir SSL sertifikas\u0131 (Let's Encrypt gibi) olu\u015fturman\u0131z ve yap\u0131land\u0131rman\u0131z gerekecektir.  Bu ad\u0131m, g\u00fcvenli\u011finiz i\u00e7in hayati \u00f6nem ta\u015f\u0131r.<\/p>\n
\u00d6rnek bir Nginx yap\u0131land\u0131rma dosyas\u0131:<\/p>\n
server {\n    listen 80;\n    listen [::]:80;\n    server_name your_domain.com;\n\n    location \/ {\n        proxy_pass http:\/\/127.0.0.1:8000; # FastAPI uygulaman\u0131z\u0131n portu\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n    }\n}<\/pre>\n
<\/code><\/p>\n
Yap\u0131land\u0131rmay\u0131 kaydettikten sonra sudo nginx -t<\/code> komutu ile yap\u0131land\u0131rman\u0131n do\u011fru olup olmad\u0131\u011f\u0131n\u0131 kontrol edin ve ard\u0131ndan sudo systemctl restart nginx<\/code> komutu ile Nginx'i yeniden ba\u015flat\u0131n.<\/p>\n
CI\/CD Pipeline'\u0131n\u0131n Kurulumu<\/h2>\n
Uygulaman\u0131z\u0131n s\u00fcrekli entegrasyon ve s\u00fcrekli da\u011f\u0131t\u0131m s\u00fcre\u00e7lerini otomatikle\u015ftirmek i\u00e7in bir CI\/CD pipeline'\u0131 kurman\u0131z \u00f6nerilir.  GitHub Actions, GitLab CI\/CD veya benzeri hizmetler kullanarak, kod de\u011fi\u015fikliklerinizi otomatik olarak Digital Ocean Droplet'\u0131n\u0131za da\u011f\u0131tabilirsiniz.  Bu, g\u00fcncellemeleri manuel olarak yapmak zorunda kalman\u0131z\u0131 \u00f6nler ve daha h\u0131zl\u0131 ve g\u00fcvenilir bir da\u011f\u0131t\u0131m sa\u011flar.  Bu s\u00fcre\u00e7, kodunuzu bir depoya (\u00f6rne\u011fin, GitHub) y\u00fcklemeniz, bir CI\/CD hizmetiyle entegre etmeniz ve da\u011f\u0131t\u0131m komutlar\u0131n\u0131z\u0131 bu hizmette tan\u0131mlaman\u0131z anlam\u0131na gelir.<\/p>\n
Performans Optimizasyonu ve \u00d6l\u00e7eklendirme<\/h2>\n
Uygulaman\u0131z\u0131n performans\u0131n\u0131 optimize etmek i\u00e7in \u00e7e\u015fitli teknikler kullanabilirsiniz.  Bunlar aras\u0131nda FastAPI'nin asenkron yap\u0131s\u0131ndan tam olarak faydalanmak, veritaban\u0131 optimizasyonu, \u00f6nbellekleme ve Nginx'in performans ayarlar\u0131n\u0131 d\u00fczenlemek bulunur.  Uygulaman\u0131z\u0131n \u00f6l\u00e7eklenebilirli\u011fini art\u0131rmak i\u00e7in, Digital Ocean'da daha g\u00fc\u00e7l\u00fc Droplet'ler kullanabilir veya y\u00fck dengeleme (load balancing) kullanabilirsiniz.  Y\u00fck dengeleme, trafi\u011fi birden fazla sunucu aras\u0131nda da\u011f\u0131tarak tek bir sunucunun a\u015f\u0131r\u0131 y\u00fcklenmesini \u00f6nler.<\/p>\n
Ger\u00e7ek D\u00fcnya Senaryolar\u0131 ve Vaka Analizleri<\/h2>\n
\u00d6rne\u011fin, e-ticaret uygulamas\u0131 geli\u015ftiren bir \u015firket, \u00fcr\u00fcn kataloglar\u0131n\u0131 ve sipari\u015f bilgilerini veritaban\u0131ndan h\u0131zl\u0131 bir \u015fekilde \u00e7ekmesi gereken bir API'ye ihtiya\u00e7 duyar.  FastAPI, bu y\u00fcksek performansl\u0131 API'yi geli\u015ftirmek i\u00e7in ideal bir se\u00e7imdir.  Nginx, trafi\u011fi y\u00f6netir ve statik dosyalar (resimler, CSS, JavaScript) sunarak sunucu y\u00fck\u00fcn\u00fc azalt\u0131r.  Digital Ocean, \u00f6l\u00e7eklenebilir altyap\u0131 sa\u011flar ve gerekti\u011finde daha fazla sunucu ekleme olana\u011f\u0131 sunar.  CI\/CD, g\u00fcncellemeleri otomatikle\u015ftirerek h\u0131zl\u0131 ve g\u00fcvenilir bir da\u011f\u0131t\u0131m sa\u011flar.  Bu \u015fekilde, e-ticaret \u015firketi, m\u00fc\u015fterilerine kesintisiz ve h\u0131zl\u0131 bir al\u0131\u015fveri\u015f deneyimi sunabilir.<\/p>\n
\u0130leri D\u00fczey Teknikler ve \u0130pu\u00e7lar\u0131<\/h2>\n
Deneyimli geli\u015ftiriciler i\u00e7in baz\u0131 ileri d\u00fczey teknikler \u015funlard\u0131r:  Gunicorn'\u0131 FastAPI uygulaman\u0131z\u0131n \u00f6n\u00fcnde bir WSGI sunucusu olarak kullanmak, Nginx'i HTTPS ile yap\u0131land\u0131rmak ve Let's Encrypt kullanarak SSL sertifikalar\u0131 olu\u015fturmak, performans monit\u00f6rleme ara\u00e7lar\u0131 kullanmak ve loglar\u0131 analiz etmek, uygulama g\u00fcvenli\u011fini g\u00fc\u00e7lendirmek i\u00e7in g\u00fcvenlik duvar\u0131 kurallar\u0131 ve di\u011fer g\u00fcvenlik \u00f6nlemlerini yap\u0131land\u0131rmak.  Ayr\u0131ca, Docker ve Kubernetes gibi konteynerle\u015fme ve orkestrasyon teknolojilerini kullanarak uygulaman\u0131n da\u011f\u0131t\u0131m\u0131n\u0131 ve y\u00f6netimini daha da basitle\u015ftirebilirsiniz.<\/p>\n
Sonu\u00e7 ve S\u0131k\u00e7a Sorulan Sorular<\/h2>\n
Bu makalede, FastAPI uygulamalar\u0131n\u0131 Digital Ocean Droplet'larda Nginx ve CI\/CD ile da\u011f\u0131tman\u0131n temel ad\u0131mlar\u0131n\u0131 inceledik.  Bu s\u00fcre\u00e7, uygulamalar\u0131n\u0131z\u0131n g\u00fcvenli\u011fini, performans\u0131n\u0131 ve \u00f6l\u00e7eklenebilirli\u011fini art\u0131r\u0131r.  Ancak unutmay\u0131n ki g\u00fcvenlik her zaman en \u00f6nemli husustur.  D\u00fczenli g\u00fcvenlik g\u00fcncellemelerini takip etmek ve g\u00fcvenlik a\u00e7\u0131klar\u0131n\u0131 kapatmak i\u00e7in proaktif ad\u0131mlar atman\u0131z kritiktir. Daha fazla bilgi i\u00e7in (https:\/\/fatihsoysal.com) inceleyebilirsiniz.<\/p>\n
S\u0131k\u00e7a Sorulan Sorular:<\/h3>\n
    \n
  • Soru:<\/strong>  FastAPI'yi Nginx olmadan \u00e7al\u0131\u015ft\u0131rabilir miyim?  Cevap:<\/strong> Evet, ancak Nginx, performans, g\u00fcvenlik ve \u00f6l\u00e7eklenebilirlik avantajlar\u0131 sa\u011flar.\n    <\/li>\n
  • Soru:<\/strong> Hangi CI\/CD platformunu kullanmal\u0131y\u0131m?  Cevap:<\/strong> GitHub Actions, GitLab CI\/CD, Jenkins gibi bir\u00e7ok se\u00e7enek mevcuttur.  \u0130htiya\u00e7lar\u0131n\u0131za ve tercihlerinize en uygun olan\u0131 se\u00e7in.\n    <\/li>\n
  • Soru:<\/strong> SSL sertifikas\u0131 nas\u0131l olu\u015fturulur?  Cevap:<\/strong> Let's Encrypt gibi \u00fccretsiz SSL sertifika sa\u011flay\u0131c\u0131lar\u0131 kullanabilirsiniz.\n    <\/li>\n
  • Soru:<\/strong> Uygulamam \u00e7ok yava\u015f \u00e7al\u0131\u015f\u0131yor.  Ne yapabilirim?  Cevap:<\/strong> Performans sorunlar\u0131n\u0131 gidermek i\u00e7in veritaban\u0131 optimizasyonu, \u00f6nbellekleme ve kod optimizasyonu tekniklerini uygulay\u0131n.\n    <\/li>\n
  • Soru:<\/strong> Uygulaman\u0131n g\u00fcvenli\u011fini nas\u0131l art\u0131rabilirim?  Cevap:<\/strong> G\u00fc\u00e7l\u00fc parolalar kullan\u0131n, d\u00fczenli g\u00fcvenlik g\u00fcncellemelerini yap\u0131n, g\u00fcvenlik duvar\u0131 kurallar\u0131n\u0131z\u0131 do\u011fru yap\u0131land\u0131r\u0131n ve g\u00fcvenlik a\u00e7\u0131klar\u0131n\u0131 d\u00fczenli olarak taray\u0131n.\n    <\/li>\n<\/ul>\n
    Yazar: Fatih Soysal<\/p>\n