Python Uygulamalarını Okteto ile Kubernetes’e Dağıtma Rehberi
Kubernetes, konteynerleştirilmiş uygulamaları otomatik olarak dağıtmak, ölçeklendirmek ve yönetmek için güçlü bir platformdur. Modern yazılım geliştirme dünyasında, uygulamaların hızlı bir şekilde geliştirilip dağıtılması, yüksek erişilebilirlik ve ölçeklenebilirlik sağlaması büyük önem taşımaktadır. Python, esnekliği ve geniş kütüphane ekosistemi sayesinde web uygulamalarından makine öğrenimine kadar birçok alanda tercih edilen bir dildir. Ancak Python uygulamalarını Kubernetes gibi karmaşık bir orkestrasyon platformuna entegre etmek ve bu ortamda verimli bir şekilde geliştirmek, kendine özgü zorlukları beraberinde getirebilir. İşte tam bu noktada Okteto devreye girer. Okteto, geliştiricilerin Kubernetes üzerinde doğrudan, hızlı ve verimli bir şekilde kod yazmasını, test etmesini ve hata ayıklamasını sağlayan bir geliştirme platformudur. Bu makalede, Python uygulamalarını Kubernetes’e Okteto ile nasıl dağıtacağımızı, geliştirme sürecini nasıl optimize edeceğimizi ve bu güçlü araç kombinasyonunun sunduğu avantajları detaylı bir şekilde inceleyeceğiz.
Kubernetes ve Konteynerleşme Temelleri
Modern uygulamaların dağıtım ve yönetim süreçlerini anlamak için konteynerleşme ve Kubernetes’in temel prensiplerini kavramak kritik öneme sahiptir.
Konteyner Nedir?
Konteynerler, bir uygulamanın kodunu, çalışma zamanını, sistem araçlarını, sistem kütüphanelerini ve ayarlarını içeren hafif, taşınabilir ve bağımsız yürütülebilir paketlerdir. Docker, konteyner teknolojisinin en popüler uygulayıcısıdır. Bir Docker konteyneri, uygulamanızın farklı ortamlarda (geliştirme, test, üretim) tutarlı bir şekilde çalışmasını sağlar. Bu, “benim makinemde çalışıyor” sorununu ortadan kaldırır.
Kubernetes Nedir?
Kubernetes (genellikle K8s olarak kısaltılır), Google tarafından geliştirilen ve açık kaynak olarak sunulan bir konteyner orkestrasyon platformudur. Amacı, konteynerleştirilmiş iş yüklerini ve hizmetleri yönetmek için bir platform sağlamaktır. Kubernetes, uygulamalarınızı otomatik olarak dağıtır, ölçekler, yönetir ve iyileştirir. Temel Kubernetes kavramları şunlardır:
* Pod: Kubernetes’teki en küçük dağıtılabilir birimdir. Bir veya daha fazla konteyneri (genellikle tek bir uygulamayı veya uygulamanın bir bileşenini) barındırır. Pod’lar, depolama ve ağ kaynaklarını paylaşır.
* Deployment: Pod’ların ve bunların yaşam döngüsünün yönetimini sağlar. Bir uygulamanın belirli bir sürümünü dağıtmak, güncellemek ve geri almak için kullanılır.
* Service: Pod’lara erişim sağlayan soyut bir yapıdır. Pod’lar geçici olduğu için, Service’ler sabit bir IP adresi ve DNS adı sağlayarak uygulamaların birbirleriyle ve dış dünya ile iletişim kurmasını kolaylaştırır.
* Ingress: Küme içindeki hizmetlere dışarıdan HTTP/HTTPS erişimi sağlamak için bir yol tanımlar. Genellikle bir Ingress Controller tarafından yönetilir.
Neden Kubernetes?
Kubernetes kullanmanın başlıca nedenleri şunlardır:
* Ölçeklenebilirlik: Uygulamaların trafik yüküne göre otomatik olarak ölçeklenmesini sağlar.
* Yüksek Erişilebilirlik: Uygulamaların sürekli çalışır durumda kalmasını garanti eder, hata durumunda otomatik olarak iyileşme sağlar.
* Kaynak Yönetimi: Küme kaynaklarını (CPU, bellek) verimli bir şekilde kullanır.
* Taşınabilirlik: Uygulamaların farklı bulut sağlayıcıları veya şirket içi veri merkezleri arasında kolayca taşınmasını sağlar.
* Geliştirici Verimliliği: Dağıtım ve yönetim süreçlerini otomatikleştirerek geliştiricilerin ana işlerine odaklanmasını sağlar.
Python Uygulamaları ve Konteynerleşme
Bir Python uygulamasını Kubernetes’e dağıtmadan önce, onu bir konteyner imajına dönüştürmemiz gerekir. Bu süreç genellikle Docker kullanılarak yapılır.
Dockerfile Yazma
Dockerfile, Docker’ın bir imajı nasıl oluşturacağını anlatan talimatları içeren metin tabanlı bir dosyadır. Basit bir Python uygulaması için tipik bir Dockerfile aşağıdaki gibi görünebilir:
# Temel Python imajını kullan
FROM python:3.9-slim-buster
Çalışma dizinini ayarla
WORKDIR /app
Bağımlılıkları kopyala ve kur
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
Uygulama kodunu kopyala
COPY . .
Uygulamanın dinleyeceği portu belirt
EXPOSE 8000
Uygulamayı başlat
CMD ["python", "app.py"]Bu Dockerfile şu adımları gerçekleştirir:
1. python:3.9-slim-buster temel imajını kullanır. slim-buster varyantı, daha küçük imaj boyutları için gereksiz paketleri içermez.
2. Konteyner içinde /app dizinini çalışma dizini olarak ayarlar.
3. requirements.txt dosyasını kopyalar ve içindeki bağımlılıkları yükler. --no-cache-dir seçeneği, pip’in indirme önbelleğini kullanmamasını sağlayarak imaj boyutunu küçültür.
4. Mevcut dizindeki tüm uygulama kodunu /app dizinine kopyalar.
5. Uygulamanın 8000 numaralı portu dinleyeceğini belirtir.
6. Konteyner başlatıldığında python app.py komutunu çalıştırarak uygulamayı başlatır.
Okteto Nedir ve Neden Kullanılır?
Okteto, geliştiricilerin Kubernetes üzerinde doğrudan ve verimli bir şekilde kod yazmasını sağlayan bir Geliştirme Platformudur. Geleneksel olarak, Kubernetes’te uygulama geliştirme süreci oldukça yorucu olabilir:
* Uzun Geri Bildirim Döngüleri: Kodu değiştirdikten sonra, Docker imajını yeniden oluşturmanız, Kubernetes kümesine göndermeniz ve dağıtımı güncellemeniz gerekir. Bu, her küçük değişiklik için zaman alan bir süreçtir.
* Yerel Ortamda Kubernetes Simülasyonu: Geliştiriciler, uygulamalarını yerel makinelerinde Kubernetes ortamını taklit etmeye çalışarak (Minikube, Kind vb.) geliştirirler. Bu, üretim ortamıyla tutarsızlıklar yaratabilir ve kaynak tüketimi açısından zorlayıcı olabilir.
* Bağımlılık Yönetimi: Uygulamanızın bağımlı olduğu diğer servisleri (veritabanları, mesaj kuyrukları vb.) yerel ortamda çalıştırmak veya taklit etmek karmaşıktır.
Okteto bu sorunları şu şekilde çözer:
* Anında Kod Senkronizasyonu: Yerel makinenizdeki kod değişiklikleri, anında Kubernetes kümesindeki geliştirme konteynerinize senkronize edilir. Bu, “kaydet ve gör” deneyimi sunar.
* Gerçek Kubernetes Ortamı: Geliştirme ortamınız doğrudan Kubernetes kümesi üzerinde çalışır. Bu, uygulamanızın üretim ortamında nasıl davranacağını daha doğru bir şekilde yansıtmasını sağlar.
* Tamamen Entegre Bağımlılıklar: Uygulamanızın bağımlı olduğu diğer servisler de Kubernetes üzerinde çalışabilir ve geliştirme ortamınız onlarla kolayca etkileşim kurabilir.
* Geliştirme Konteynerleri: Okteto, uygulamanızın normal üretim konteynerini bir “geliştirme konteynerine” dönüştürür. Bu konteyner, geliştirme araçlarını (hata ayıklayıcılar, kod düzenleyiciler) ve kod senkronizasyonu için gerekli altyapıyı içerir.
Okteto’nun temel özellikleri şunlardır:
* Okteto CLI: Uygulamanızı Kubernetes’e dağıtmak, geliştirme ortamını başlatmak ve yönetmek için kullanılan komut satırı aracı.
* Okteto Manifest (okteto.yaml): Uygulamanızın geliştirme ortamını tanımlayan bir YAML dosyasıdır. Hangi imajın kullanılacağı, hangi portların yönlendirileceği, hangi dizinlerin senkronize edileceği gibi bilgileri içerir.
* Geliştirme Konteynerleri: Kubernetes kümesinde çalışan ve kodunuzu barındıran özel konteynerler.
Ön Koşullar ve Kurulum
Okteto ile bir Python uygulaması dağıtmaya başlamadan önce bazı araçların yüklü olması gerekir.
Gerekenler:
* Docker Desktop: Konteyner imajları oluşturmak ve yönetmek için.
* kubectl: Kubernetes kümeleriyle etkileşim kurmak için.
* Okteto CLI: Okteto platformunu kullanmak için.
* Kubernetes Kümesi: Uygulamanızı dağıtacağınız bir Kubernetes kümesi (Minikube, Kind, Google Kubernetes Engine (GKE), Amazon EKS, Azure AKS veya Okteto Cloud).
* Okteto Cloud Hesabı (Önerilir): Eğer kendi Kubernetes kümenizi kurmak istemiyorsanız, Okteto Cloud ücretsiz bir geliştirme ortamı sağlar.
Okteto CLI Kurulumu:
Okteto CLI’yi işletim sisteminize göre kurabilirsiniz:
* macOS (Homebrew ile):
brew install okteto* Linux (curl ile):
curl https://get.okteto.com -sSfL | sh* Windows (Chocolatey ile):
choco install okteto-cli Kurulumdan sonra okteto version komutunu çalıştırarak kurulumu doğrulayabilirsiniz.
Kubernetes Kümesine Erişim:
* Eğer Minikube veya Kind kullanıyorsanız, başlatıldığından emin olun (minikube start).
* Eğer bir bulut kümesi kullanıyorsanız, kubectl‘in doğru bağlamı işaret ettiğinden emin olun (kubectl config get-contexts).
* Eğer Okteto Cloud kullanıyorsanız, okteto context use https://cloud.okteto.com komutuyla bağlanabilir ve okteto login ile giriş yapabilirsiniz.
Adım Adım Python Uygulamasını Okteto ile Kubernetes’e Dağıtma
Şimdi, basit bir Python Flask uygulamasını Okteto ile Kubernetes’e dağıtma sürecini adım adım inceleyelim.
1. Örnek Python Uygulaması Oluşturma
Öncelikle, basit bir Flask uygulaması oluşturalım. Proje dizini python-app olsun.
python-app/app.py:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
return "Merhaba, Okteto ile Kubernetes'te Python!"
if __name__ == '__main__':
app.run(host='0.0.0.0', port=8000)python-app/requirements.txt:
Flask==2.2.22. Dockerfile Hazırlama
Uygulamamızı konteynerleştirmek için python-app/Dockerfile dosyasını oluşturalım:
# Temel Python imajını kullan
FROM python:3.9-slim-buster
Çalışma dizinini ayarla
WORKDIR /app
Bağımlılıkları kopyala ve kur
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
Uygulama kodunu kopyala
COPY . .
Uygulamanın dinleyeceği portu belirt
EXPOSE 8000
Uygulamayı başlat
CMD ["python", "app.py"]3. Kubernetes Manifest Dosyaları Oluşturma
Uygulamamızı Kubernetes’e dağıtmak için deployment.yaml ve service.yaml dosyalarına ihtiyacımız var. python-app/kubernetes adında bir dizin oluşturalım ve bu dosyaları içine koyalım.
python-app/kubernetes/deployment.yaml:
apiVersion: apps/v1
kind: Deployment
metadata:
name: python-app
spec:
replicas: 1
selector:
matchLabels:
app: python-app
template:
metadata:
labels:
app: python-app
spec:
containers:
- name: python-app
image: okteto/python-app:latest # İlk dağıtım için placeholder imajı, Okteto bunu değiştirecek
ports:
- containerPort: 8000
resources:
requests:
cpu: "100m"
memory: "128Mi"
limits:
cpu: "200m"
memory: "256Mi"python-app/kubernetes/service.yaml:
apiVersion: v1
kind: Service
metadata:
name: python-app
spec:
selector:
app: python-app
ports:
- protocol: TCP
port: 80
targetPort: 8000
type: LoadBalancer # Eğer bulut kümesi kullanıyorsanız LoadBalancer, Minikube/Kind için NodePort veya ClusterIPNot: image: okteto/python-app:latest kısmı başlangıçta bir yer tutucudur. Okteto, geliştirme ortamını başlattığında kendi özel geliştirme imajını kullanacaktır. Service tipi olarak LoadBalancer yerine NodePort veya ClusterIP kullanabilirsiniz, kümenizin yapısına ve dışarıdan erişim beklentinize göre değişir. Okteto Cloud kullanıyorsanız, LoadBalancer genellikle otomatik olarak bir dış URL sağlar.
4. Okteto Manifest Dosyası Oluşturma
Şimdi Okteto’nun geliştirme ortamını tanımlayan okteto.yaml dosyasını python-app dizininin köküne oluşturalım.
python-app/okteto.yaml:
name: python-app
namespace: default # Uygulamanızın dağıtılacağı Kubernetes namespace'i
image: python:3.9-slim-buster # Geliştirme konteyneri için temel imaj
command: ["bash"] # Okteto terminali açıldığında çalışacak komut
sync:
- .:/app # Yerel dizini /app'ye senkronize et
forward:
- 8000:8000 # Yerel 8000 portunu konteynerdeki 8000 portuna yönlendir
volumes:
- /root/.cache/pip # pip önbelleğini kalıcı hale getirBu okteto.yaml dosyası Okteto’ya şunları söyler:
* name: Geliştirme ortamınızın adı (Kubernetes’teki deployment adıyla eşleşmesi önerilir).
* namespace: Uygulamanızın dağıtılacağı Kubernetes namespace’i.
* image: Okteto’nun geliştirme konteyneri için kullanacağı temel imaj. Python geliştirme için uygun bir imaj seçmelisiniz.
* command: Okteto terminali açıldığında çalıştırılacak komut. bash genellikle iyi bir başlangıçtır.
* sync: Yerel dosya sisteminizdeki hangi dizinlerin geliştirme konteyneri ile senkronize edileceğini belirtir. Burada . (mevcut dizin) /app dizinine senkronize edilecek.
* forward: Yerel makinenizdeki hangi portların geliştirme konteynerindeki portlara yönlendirileceğini belirtir. 8000:8000 yerel 8000 portunu konteynerdeki 8000 portuna yönlendirir, böylece uygulamaya yerelden erişebilirsiniz.
* volumes: Geliştirme konteyneri yeniden başlatıldığında bile kalıcı olmasını istediğiniz dizinleri belirtir. pip önbelleğini kalıcı hale getirmek, bağımlılıkların her seferinde yeniden indirilmesini önler.
5. Uygulamayı Kubernetes’e Dağıtma (İlk Kez)
Şimdi uygulama dosyalarınızın bulunduğu python-app dizinine gidin ve Kubernetes manifest dosyalarını uygulayın.
cd python-app
kubectl apply -f kubernetes/Bu komut, python-app deployment’ını ve python-app service’ini Kubernetes kümenize dağıtacaktır. deployment.yaml içindeki image etiketi henüz gerçek uygulamanızı içermediği için, bu deployment sadece bir yer tutucu olarak işlev görür. Okteto, okteto up komutuyla bu deployment’ı ele geçirecektir.
6. Okteto Geliştirme Ortamını Başlatma
Uygulamanızın kök dizininde (okteto.yaml dosyasının bulunduğu yerde) aşağıdaki komutu çalıştırın:
okteto upBu komut şunları yapacaktır:
1. Kubernetes kümesinde python-app deployment’ını bulur.
2. Bu deployment’ın pod’unu, okteto.yaml dosyasında belirtilen geliştirme imajını kullanan ve gerekli geliştirme araçlarını içeren bir geliştirme konteynerine dönüştürür.
3. Yerel dosya sisteminizdeki kodu (. dizini) geliştirme konteynerindeki /app dizinine senkronize etmeye başlar.
4. Belirtilen portları (8000:8000) yerel makinenize yönlendirir.
5. Size geliştirme konteynerinin içinde bir terminal oturumu açar.
Terminal açıldığında, artık Kubernetes kümesi üzerinde çalışan geliştirme konteynerinizin içindesiniz demektir. Uygulamanızı buradan başlatabilirsiniz:
python app.pyUygulama başlatıldığında, yerel tarayıcınızdan http://localhost:8000 adresine giderek uygulamanıza erişebilirsiniz.
7. Uygulama Üzerinde Geliştirme Yapma
Okteto’nun en büyük avantajı buradadır. Geliştirme konteyneriniz çalışırken, yerel makinenizdeki app.py dosyasında değişiklikler yapın. Örneğin:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
return "Merhaba, Okteto ile Kubernetes'te Python! (v2)" # Mesajı değiştirdik
if __name__ == '__main__':
app.run(host='0.0.0.0', port=8000)Değişikliği kaydedin. Okteto, bu değişikliği anında geliştirme konteynerine senkronize edecektir. Eğer uygulamanız bir hot-reload mekanizmasına sahipse (örneğin Flask’ın debug modu veya uvicorn’un reload seçeneği), değişiklikler otomatik olarak yansır. Aksi takdirde, geliştirme konteyneri terminalinde Ctrl+C ile uygulamayı durdurup tekrar python app.py komutuyla başlatmanız gerekebilir.
Değişikliği kaydettikten ve uygulamayı yeniden başlattıktan sonra, http://localhost:8000 adresini yenilediğinizde “Merhaba, Okteto ile Kubernetes’te Python! (v2)” mesajını görmelisiniz. Bu, geliştirme döngünüzün ne kadar hızlandığını gösterir. Artık Docker imajı oluşturma, gönderme ve Kubernetes dağıtımını güncelleme gibi adımlara gerek kalmadan, doğrudan Kubernetes üzerinde geliştirme yapabiliyorsunuz.
Hata ayıklama yapmak için, okteto exec -- python -m pdb app.py gibi komutlarla veya geliştirme konteynerinize yüklediğiniz IDE uzantılarıyla hata ayıklama oturumları başlatabilirsiniz.
8. Değişiklikleri Dağıtma
Geliştirme süreciniz bittiğinde ve uygulamanızın son halini üretim ortamına dağıtmaya hazır olduğunuzda, Okteto geliştirme ortamından çıkmanız gerekir.
Terminalde Ctrl+D tuşuna basarak veya exit yazarak Okteto geliştirme oturumundan çıkın. Bu, okteto down komutunu çalıştırır ve geliştirme konteynerini orijinal python-app deployment’ına geri döndürür.
Şimdi uygulamanızın yeni bir Docker imajını oluşturmanız ve Kubernetes deployment’ınızı güncellemeniz gerekiyor.
# Docker imajını oluştur
docker build -t your-docker-username/python-app:v1.0 .
Docker imajını Docker Hub'a (veya başka bir registry'ye) gönder
docker push your-docker-username/python-app:v1.0
Kubernetes deployment dosyasını güncelle
python-app/kubernetes/deployment.yaml dosyasındaki image etiketini güncelle
image: your-docker-username/python-app:v1.0
Güncellenmiş deployment'ı uygula
kubectl apply -f kubernetes/Bu adımlar, uygulamanızın son halini içeren yeni bir Docker imajını Kubernetes kümenize dağıtır. CI/CD boru hatları, bu adımları otomatikleştirerek her kod değişikliğinde otomatik dağıtım yapabilir.
Okteto’nun Gelişmiş Özellikleri
Okteto, geliştirme deneyimini daha da zenginleştiren bir dizi gelişmiş özellik sunar.
Preview Environments (Önizleme Ortamları)
Okteto Preview Environments, her pull request veya feature branch için otomatik olarak geçici, izole edilmiş Kubernetes ortamları oluşturmanıza olanak tanır. Bu sayede ekip üyeleri, QA ve paydaşlar, değişiklikleri ana kod tabanına birleştirmeden önce gerçek bir ortamda test edebilir ve önizleyebilir. Bu, geri bildirim döngülerini kısaltır ve hataları erken yakalamayı sağlar.
Remote Development (Uzak Geliştirme)
Okteto, VS Code veya JetBrains IDE’leri gibi popüler IDE’ler için uzantılar sunar. Bu uzantılar sayesinde, yerel IDE’nizi Kubernetes üzerindeki geliştirme konteynerinize bağlayabilir, kodunuzu uzaktan düzenleyebilir, hata ayıklayabilir ve terminal komutlarını çalıştırabilirsiniz. Bu, güçlü bir geliştirme makinesine ihtiyaç duymadan, bulutun tüm kaynaklarından faydalanarak geliştirme yapmanızı sağlar.
Volumes ve Persistence
okteto.yaml dosyasındaki volumes bölümü, geliştirme konteyneriniz yeniden başlatıldığında bile belirli dizinlerin kalıcı olmasını sağlar. Bu, özellikle bağımlılık önbellekleri (pip önbelleği gibi) veya geliştirme sırasında oluşturulan veriler için kullanışlıdır, böylece her okteto up komutunda her şeyin yeniden indirilmesi veya oluşturulması gerekmez.
Private Registries
Eğer Docker imajlarınızı özel bir kayıt defterinde (private registry) tutuyorsanız, Okteto bu kayıt defterlerinden imaj çekmek için gerekli kimlik doğrulama yapılandırmasını destekler. Bu, okteto.yaml dosyasında veya okteto context komutlarıyla yapılandırılabilir.
Performans ve Güvenlik İpuçları
Kubernetes üzerinde Python uygulamaları geliştirirken ve dağıtırken performans ve güvenlik her zaman göz önünde bulundurulması gereken önemli faktörlerdir.
Performans İpuçları:
* Optimal Dockerfile:
* Çok Aşamalı Yapılar (Multi-stage Builds): Üretim imajınızın boyutunu küçültmek için çok aşamalı Dockerfile’lar kullanın. Geliştirme aşamasında tüm bağımlılıkları yükleyip testleri çalıştırabilir, son aşamada ise sadece uygulamanın çalışması için gereken minimum dosyaları içeren daha küçük bir imaj oluşturabilirsiniz.
* .dockerignore Kullanımı: git, .vscode, __pycache__ gibi gereksiz dosyaların imajınıza kopyalanmasını engellemek için .dockerignore dosyası oluşturun.
* Bağımlılık Katmanlaması: requirements.txt dosyasını COPY edip pip install komutunu çalıştırmadan önce COPY . . komutunu çalıştırmayın. Bu, bağımlılıklar değişmediğinde Docker’ın katman önbelleğini kullanmasını sağlar.
* Kaynak Limitleri ve İstekleri (Requests/Limits): Kubernetes deployment’larınızda CPU ve bellek için requests ve limits tanımlayın. Bu, uygulamanızın kümede ne kadar kaynak talep ettiğini ve ne kadarını kullanabileceğini belirler. Doğru ayarlar, kümenin stabil çalışmasını ve uygulamalarınızın yeterli kaynağa sahip olmasını sağlar.
resources:
requests:
cpu: "100m" # 0.1 CPU çekirdeği
memory: "128Mi" # 128 Megabayt bellek
limits:
cpu: "200m"
memory: "256Mi"* Veritabanı Bağlantıları: Veritabanı bağlantı havuzları (connection pooling) kullanarak her istek için yeni bir bağlantı açma maliyetinden kaçının. Uygulamanızın veritabanı ile verimli bir şekilde iletişim kurduğundan emin olun.
Güvenlik İpuçları:
* Minimalist İmajlar: python:3.9-slim-buster veya python:3.9-alpine gibi küçük, minimalist temel imajlar kullanın. Bu imajlar, saldırı yüzeyini azaltan daha az paket ve bağımlılık içerir.
* Root Olmayan Kullanıcı: Konteynerlerinizi root kullanıcısı olarak çalıştırmaktan kaçının. Dockerfile içinde özel bir kullanıcı oluşturup uygulamanızı bu kullanıcıyla çalıştırın:
# ...
RUN adduser --disabled-password --gecos "" appuser
USER appuser
# ...* Bağımlılık Taraması: Uygulamanızın bağımlılıklarını güvenlik açıkları için düzenli olarak tarayın (örneğin pip-audit, Snyk, Trivy gibi araçlarla).
* Ortam Değişkenleri ve Secret’lar: Hassas bilgileri (API anahtarları, veritabanı şifreleri) doğrudan kodunuza veya Docker imajınıza gömmeyin. Kubernetes Secret’larını veya bir sır yönetim sistemini kullanarak bu bilgileri güvenli bir şekilde yönetin ve uygulama konteynerlerine ortam değişkenleri olarak enjekte edin.
* Ağ Politikaları (Network Policies): Kubernetes Ağ Politikaları ile Pod’lar arasındaki ağ trafiğini kısıtlayın. Bu, uygulamalarınızın yalnızca belirli servislerle iletişim kurmasına izin vererek yanal hareket (lateral movement) riskini azaltır.
* Güncel Tutun: Python yorumlayıcınızı, kütüphanelerinizi ve temel Docker imajlarınızı düzenli olarak güncelleyin. Bu, bilinen güvenlik açıklarının kapatılmasını sağlar.
Sık Karşılaşılan Sorunlar ve Çözümleri
Okteto ve Kubernetes ile çalışırken bazı yaygın sorunlarla karşılaşabilirsiniz. İşte bunlardan bazıları ve olası çözümleri:
* okteto up Çalışmıyor veya Hata Veriyor:
* Kubernetes Küme Bağlantısı: kubectl get pods komutunu çalıştırarak Kubernetes kümenize erişiminiz olduğundan ve doğru bağlamda olduğunuzdan emin olun.
* Okteto CLI Sürümü: Okteto CLI’nızın güncel olduğundan emin olun (okteto update).
* Manifest Hataları: okteto.yaml veya Kubernetes manifest dosyalarınızda (deployment.yaml, service.yaml) YAML sözdizimi hataları olup olmadığını kontrol edin.
* Kaynak Kısıtlamaları: Kubernetes kümenizde yeterli kaynak (CPU, bellek) olmayabilir. Okteto Cloud kullanıyorsanız, ücretsiz katman limitlerine dikkat edin. Kendi kümenizde kubectl describe pod ile kaynak kullanımını kontrol edebilirsiniz.
* Deployment Mevcut Değil: okteto up komutunu çalıştırmadan önce kubectl apply -f kubernetes/ ile deployment’ın kümede olduğundan emin olun.
* Port Yönlendirme Sorunları:
* Port Çakışması: Yerel makinenizde okteto.yaml içinde belirtilen portun başka bir uygulama tarafından kullanılıp kullanılmadığını kontrol edin.
* Güvenlik Duvarı: İşletim sisteminizin güvenlik duvarının, Okteto’nun yerel port yönlendirmesini engellemediğinden emin olun.
* Yanlış Port Numarası: okteto.yaml içindeki forward ayarlarının ve uygulamanızın dinlediği portun doğru olduğundan emin olun.
* Kod Senkronizasyonu Gecikmeleri veya Sorunları:
* Büyük Dosya Sayısı: Çok sayıda dosya veya çok büyük dosyalar, senkronizasyon sürecini yavaşlatabilir. .stignore dosyası kullanarak senkronize edilmesini istemediğiniz dizinleri veya dosyaları dışarıda bırakabilirsiniz (örneğin node_modules, venv, target gibi).
* Ağ Gecikmesi: Kubernetes kümeniz ile yerel makineniz arasındaki ağ gecikmesi, senkronizasyonu etkileyebilir.
* Diskteki Değişiklikler: Bazen dosya sistemi olayları düzgün tetiklenmeyebilir. Okteto terminalinde okteto status komutuyla senkronizasyon durumunu kontrol edebilirsiniz.
* Uygulama Geliştirme Konteynerinde Başlamıyor:
* Bağımlılıklar Eksik: okteto.yaml içinde belirtilen geliştirme imajının, uygulamanızın çalışması için gereken tüm bağımlılıklara sahip olduğundan emin olun. Eğer pip install komutunu çalıştırmanız gerekiyorsa, bunu okteto up ile açılan terminalde yapın.
* CMD veya ENTRYPOINT: okteto.yaml dosyasındaki command veya Dockerfile içindeki CMD/ENTRYPOINT ayarlarınızın doğru olduğundan emin olun. Uygulamanızı okteto up ile açılan terminalde manuel olarak başlatmayı deneyin.
* Uygulama Hataları: Uygulamanızın kendisinde bir hata olabilir. Geliştirme konteyneri terminalindeki logları kontrol edin.
Sonuç
Python uygulamalarını Kubernetes üzerinde Okteto ile dağıtmak ve geliştirmek, modern yazılım geliştirme süreçlerinde önemli bir verimlilik artışı sağlar. Kubernetes’in sunduğu ölçeklenebilirlik, yüksek erişilebilirlik ve kaynak yönetimi avantajlarını, Okteto’nun sağladığı hızlı geri bildirim döngüsü ve doğrudan Kubernetes üzerinde geliştirme yapabilme yeteneği ile birleştirmek, geliştiricilerin daha hızlı kod yazmasına, daha az hata yapmasına ve daha tutarlı bir geliştirme deneyimi yaşamasına olanak tanır.
Bu makalede, bir Python uygulamasını Docker ile konteynerleştirmeden, Kubernetes manifest dosyalarını hazırlamaya ve Okteto’nun okteto.yaml dosyasıyla geliştirme ortamını yapılandırmaya kadar tüm süreci adım adım inceledik. Ayrıca, Okteto’nun gelişmiş özelliklerini, performans ve güvenlik ipuçlarını ve sık karşılaşılan sorunlara yönelik çözümleri ele aldık.
Okteto, karmaşık Kubernetes ortamlarında geliştirme yapmanın zorluklarını ortadan kaldırarak geliştiricilere bulut yerel uygulamaları geliştirme gücünü verir. Bu entegrasyon sayesinde, Python geliştiricileri, üretim ortamına daha yakın bir ortamda çalışarak, dağıtım sorunlarını erken tespit edebilir ve genel olarak daha sağlam uygulamalar oluşturabilirler. Gelecekte, Okteto gibi araçların, bulut yerel geliştirme süreçlerini daha da basitleştirerek, geliştiricilerin sadece kod yazmaya odaklanmasını sağlayacağı açıktır.