Üretim ortamına geçiş, bir uygulamanın gerçek kullanıcılarla buluştuğu kritik bir adımdır. Bu aşamada loglama, sağlık kontrolleri, yapılandırma yönetimi ve gizli anahtarların (secret) güvenli bir şekilde ele alınması, sistemin sürdürülebilirliği ve güvenliği için vazgeçilmezdir. Bu derste, Python tabanlı bir proje için üretim kontrol listesini nasıl oluşturacağınızı, her bir bileşeni nasıl yapılandıracağınızı ve basit bir örnekle nasıl uygulayacağınızı adım adım göstereceğiz.
Temel Kavramlar
Üretim ortamında dikkate almanız gereken dört temel unsur şunlardır:
- Loglama (Logging): Hata takibi, performans izleme ve denetim amaçlı kayıtların doğru seviyede tutulması.
- Sağlık Kontrolleri (Health Checks): Servisin çalışır durumda olup olmadığını dış sistemlere bildiren endpointler.
- Yapılandırma (Configuration): Çevreye özgü ayarların (veritabanı URL, API anahtarları vb.) yönetimi.
- Gizli Anahtarlar (Secrets): API anahtarları, şifreler ve sertifikalar gibi hassas bilgilerin güvenli saklanması.
Adım Adım Üretim Kontrol Listesi
Aşağıdaki adımları izleyerek projenizi üretime hazır hâle getirebilirsiniz.
- Log seviyesini
DEBUGdışına ayarlayın: Üretimde ayrıntılı debug logları performansı düşürür ve güvenlik riski oluşturur.logging.INFOveyalogging.WARNINGseviyeleri tercih edilmelidir. - Sağlık endpointi oluşturun:
/healthzgibi bir URL, servisinizin “up” olduğunu gösteren basit bir JSON yanıt döndürür. - Yapılandırma dosyasını dışa taşıyın:
.envveyaconfig.yamlgibi dosyalar, kod içinde sabit değerler tutmaktan kaçınmanızı sağlar. - Gizli anahtarları güvenli bir vault'tan çekin: AWS Secrets Manager, HashiCorp Vault veya Docker secret'ları gibi çözümler kullanılabilir.
- Test ortamında tüm kontrolleri çalıştırın: CI/CD pipeline'ınıza health ve log testlerini ekleyin.
Python’da Uygulama Örneği
Aşağıdaki kod, yukarıdaki adımları birleştirerek basit bir Flask uygulaması oluşturur. Bu örnek, sadece konsepti göstermek içindir; gerçek projelerde daha kapsamlı yapılandırma ve güvenlik önlemleri eklenmelidir.
import os
import logging
from flask import Flask, jsonify
from dotenv import load_dotenv
# .env dosyasını yükle
load_dotenv()
app = Flask(__name__)
# 1. Log seviyesini ayarla (DEBUG kapalı)
log_level = os.getenv('LOG_LEVEL', 'INFO').upper()
logging.basicConfig(level=getattr(logging, log_level))
logger = logging.getLogger(__name__)
# 2. Health endpointi
@app.route('/healthz')
def health():
return jsonify(status='UP'), 200
# 3. Config örneği (veritabanı URL)
DB_URL = os.getenv('DATABASE_URL')
logger.info(f'Database URL loaded: {DB_URL}')
# 4. Secret örneği (API anahtarı)
API_KEY = os.getenv('API_KEY')
if not API_KEY:
logger.error('API_KEY not set!')
@app.route('/')
def index():
logger.info('Root endpoint called')
return 'Üretim kontrol listesi çalışıyor!'
if __name__ == '__main__':
# Flask'ı production mode'da çalıştırmak için gunicorn önerilir
app.run(host='0.0.0.0', port=int(os.getenv('PORT', 8000)))
Bu kodu app.py adıyla kaydedin, bir sanal ortam oluşturup bağımlılıkları kurun ve çalıştırın:
python -m venv venv
source venv/bin/activate
pip install flask python-dotenv
export LOG_LEVEL=INFO
export DATABASE_URL=postgresql://user:pass@localhost/db
export API_KEY=super-secret-key
python app.py
PHP ile Üretim Kontrol Listesi Örnekleri
Python örneğiyle paralel olarak, aynı konseptleri PHP’de de nasıl uygulayabileceğinizi gösteren iki örnek hazırladık. Bu örnekler, loglama ve health endpointi oluşturmayı kapsar.
1. Basit Loglama (Monolog)
pushHandler(new StreamHandler(__DIR__.'/logs/app.log', Logger::INFO));
$log->info('Uygulama başlatıldı');
$log->warning('Örnek uyarı mesajı');
$log->error('Örnek hata mesajı');
?>
Bu dosyayı log_example.php olarak kaydedin ve composer require monolog/monolog komutuyla Monolog paketini ekleyin. Çalıştırdığınızda logs/app.log içinde INFO ve üzeri seviyedeki kayıtları göreceksiniz.
2. Health Check Endpointi (Slim Framework)
get('/healthz', function ($request, $response, $args) {
$data = ['status' => 'UP'];
$payload = json_encode($data);
$response->getBody()->write($payload);
return $response->withHeader('Content-Type', 'application/json');
});
$app->run();
?>
Bu örnek için composer require slim/slim:"4.*" komutunu çalıştırın ve php -S localhost:8080 health_example.php ile sunucuyu başlatın. http://localhost:8080/healthz adresine GET isteği gönderdiğinizde {"status":"UP"} yanıtını alacaksınız.
Sık Karşılaşılan Hatalar ve Çözüm Önerileri
- DEBUG seviyesinin açık kalması: Çevre değişkeni
LOG_LEVELyanlış ayarlandığında uygulama DEBUG logları üretir. Çözüm: CI/CD pipeline’daLOG_LEVELdeğerini zorunlu olarakINFOya daWARNINGyapın. - Secret’ların kod içinde hardcode edilmesi: Güvenlik açığı yaratır. Çözüm:
dotenvveya bir secret manager kullanın; kodda sadece ortam değişkeni okuması bulunsun. - Health endpointinin 404 dönmesi: Route tanımlaması eksik veya sunucu yeniden başlatılmamış olabilir. Çözüm: Framework dökümantasyonuna göre route kaydedin ve sunucuyu yeniden başlatın.
- Log dosyasının yazılamaması: Dosya izinleri yetersiz. Çözüm:
chmod 664 logs/app.logve dizin sahibi ayarlarını kontrol edin.
Kontrol Listesi
- Log seviyesi
INFOveya daha yüksek olarak ayarlandı mı? - Health endpointi
/healthzdoğru yanıt veriyor mu? - Yapılandırma değerleri
.envdosyasından okunuyor mu? - Gizli anahtarlar ortam değişkeni ya da secret manager üzerinden sağlanıyor mu?
- Tüm testler CI/CD pipeline’da başarıyla geçiyor mu?
Sık Sorulan Sorular
1. Üretim ortamında DEBUG loglarını tamamen kapatmak yeterli mi?
Evet, DEBUG seviyesini kapatmak performans ve güvenlik açısından temel bir adımdır. Ancak INFO seviyesindeki logların da hassas veri içermediğinden emin olun.
2. Health endpointi sadece HTTP 200 döndürmek yeterli mi?
Basit bir kontrol için evet. Daha karmaşık sistemlerde veritabanı, dış servis ve disk kullanımı gibi alt bileşenlerin durumunu da kontrol eden detaylı bir JSON yanıtı önerilir.
3. Secret yönetimi için .env dosyası güvenli mi?
Geliştirme ve test ortamları için uygundur. Üretim ortamında bir secret manager (AWS Secrets Manager, HashiCorp Vault vb.) kullanmanız tavsiye edilir.
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.