Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 99 – Kontrol listesi: üretim

Üretim ortamı için log, health, config ve secret yönetimini kapsayan kontrol listesi, adım adım örneklerle anlatılıyor.

Ders 99 – Kontrol listesi: üretim

Ü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.

  1. Log seviyesini DEBUG dışına ayarlayın: Üretimde ayrıntılı debug logları performansı düşürür ve güvenlik riski oluşturur. logging.INFO veya logging.WARNING seviyeleri tercih edilmelidir.
  2. Sağlık endpointi oluşturun: /healthz gibi bir URL, servisinizin “up” olduğunu gösteren basit bir JSON yanıt döndürür.
  3. Yapılandırma dosyasını dışa taşıyın: .env veya config.yaml gibi dosyalar, kod içinde sabit değerler tutmaktan kaçınmanızı sağlar.
  4. Gizli anahtarları güvenli bir vault'tan çekin: AWS Secrets Manager, HashiCorp Vault veya Docker secret'ları gibi çözümler kullanılabilir.
  5. 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_LEVEL yanlış ayarlandığında uygulama DEBUG logları üretir. Çözüm: CI/CD pipeline’da LOG_LEVEL değerini zorunlu olarak INFO ya da WARNING yapın.
  • Secret’ların kod içinde hardcode edilmesi: Güvenlik açığı yaratır. Çözüm: dotenv veya 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.log ve dizin sahibi ayarlarını kontrol edin.

Kontrol Listesi

  • Log seviyesi INFO veya daha yüksek olarak ayarlandı mı?
  • Health endpointi /healthz doğru yanıt veriyor mu?
  • Yapılandırma değerleri .env dosyası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.

Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

Python ile web, veri, otomasyon ve AI alanlarına yön veren ileri seviye bir yol haritası, adım ad…

Ders 98 – Mikroservis iletişimi fikri

Mikroservis mimarisinde HTTP/JSON sözleşmesiyle versiyonlu endpoint oluşturma, adım adım örnekler…

Ders 97 – Veri doğrulama katmanı

Veri doğrulama katmanını Pydantic ve Cerberus ile nasıl kuracağınızı adım adım öğrenin, örnek PHP…

Ders 96 – Web scraping etiği

Web scraping yaparken yasal ve etik sorumlulukları, rate limit ve hizmet şartlarını nasıl uygulay…

Demo
Büyütülmüş Görsel