Ubuntu 24.04 Üzerine SonarQube Kurulumu: Kod Kalitesini Artırmanın Anahtarı

Ubuntu 24.04 Üzerine SonarQube Kurulumu: Kod Kalitesini Artırmanın Anahtarı

Modern yazılım geliştirme süreçlerinde kod kalitesi, projelerin başarısı ve sürdürülebilirliği için kritik bir öneme sahiptir. Güvenlik açıkları, performans sorunları ve teknik borç, zamanla projelerin yönetilemez hale gelmesine yol açabilir. İşte tam bu noktada SonarQube devreye girerek, statik kod analizi (static code analysis) ile kodunuzdaki potansiyel sorunları proaktif bir şekilde tespit etmenizi sağlar. Bu kapsamlı rehberde, Ubuntu 24.04 işletim sistemi üzerine SonarQube’u adım adım nasıl kuracağınızı, yapılandıracağınızı ve kod kalitenizi nasıl zirveye taşıyacağınızı öğreneceksiniz.

SonarQube Nedir ve Neden Kullanmalıyız?

SonarQube, yazılım projelerinizin kod kalitesini ve güvenliğini sürekli olarak denetleyen açık kaynaklı bir platformdur. Binlerce kural seti ve onlarca programlama dili desteği ile kodunuzdaki hataları, güvenlik açıklarını, kod tekrarını (code duplication), potansiyel performans sorunlarını ve kötü tasarım kalıplarını otomatik olarak analiz eder. Bu analizler sonucunda, geliştiricilere ve proje yöneticilerine teknik borç (technical debt) hakkında değerli bilgiler sunar, böylece kod tabanının sağlığını sürekli olarak izleme ve iyileştirme imkanı tanır.

Peki, SonarQube’u neden kullanmalıyız? Birçok yazılım ekibi, geliştirme sürecinin hızına kapılarak kod kalitesi kontrollerini göz ardı edebiliyor. Ancak bu durum, uzun vadede ciddi maliyetlere ve sürdürülebilirlik sorunlarına yol açar. SonarQube, bu riskleri minimize etmenize yardımcı olur. Örneğin, bir e-ticaret platformu geliştiren bir ekibi düşünelim. Güvenlik açıkları, müşteri verilerinin çalınmasına neden olabilirken, performans sorunları sitenin yavaşlamasına ve müşteri kaybına yol açabilir. SonarQube, bu tür sorunları kod daha üretim ortamına geçmeden önce tespit ederek, hem zaman hem de maliyet açısından büyük tasarruflar sağlar. Geliştiriciler, SonarQube raporları sayesinde kodlarını daha iyi anlar, en iyi pratikleri (best practices) öğrenir ve sürekli olarak kendilerini geliştirirler. Bu, sadece bireysel geliştiricilerin değil, tüm ekibin kod kalitesi bilincini artırır.

Ayrıca, SonarQube’un görsel panosu (dashboard) sayesinde, projenin genel sağlık durumu, güvenlik derecesi, test kapsamı (test coverage) ve teknik borç seviyesi gibi kritik metrikleri kolayca takip edebilirsiniz. Bu sayede, hangi alanlara odaklanmanız gerektiğini hızlıca belirleyebilir ve stratejik kararlar alabilirsiniz. Sürekli entegrasyon (Continuous Integration – CI) ve sürekli dağıtım (Continuous Deployment – CD) boru hatlarına (pipeline) entegre edildiğinde, her kod değişikliğinde otomatik analizler tetiklenir ve potansiyel sorunlar anında geri bildirim olarak geliştiricilere iletilir. Bu, “hızlı geri bildirim” döngüsünü güçlendirerek, hataların erken aşamada yakalanmasını ve düzeltilmesini sağlar. Sonuç olarak, SonarQube, sadece bir kod analiz aracı değil, aynı zamanda daha kaliteli, güvenli ve sürdürülebilir yazılımlar geliştirmek için vazgeçilmez bir stratejik ortaktır.

Kuruluma Başlamadan Önce: Ön Gereksinimler ve Sistem Hazırlığı

SonarQube kurulumuna başlamadan önce, Ubuntu 24.04 sunucunuzun belirli gereksinimleri karşıladığından ve gerekli ön hazırlıkların yapıldığından emin olmalıyız. Bu adımlar, kurulum sürecinin sorunsuz ilerlemesi ve SonarQube’un en verimli şekilde çalışması için hayati öneme sahiptir. İlk olarak, sistemimizin güncel olduğundan emin olmalıyız. Bu, olası güvenlik açıklarını kapatır ve en yeni yazılım paketlerine erişim sağlar. Terminali açarak aşağıdaki komutları çalıştırmanız yeterlidir:

sudo apt update
sudo apt upgrade -y

SonarQube, Java tabanlı bir uygulama olduğu için sunucunuzda uygun bir Java Development Kit (JDK) sürümünün kurulu olması gerekmektedir. Ubuntu 24.04 üzerinde genellikle OpenJDK tercih edilir. SonarQube’un güncel sürümleri genellikle Java 17 veya daha yüksek sürümleri gerektirir. Kurulum için aşağıdaki komutu kullanabiliriz:

sudo apt install openjdk-17-jdk -y

Kurulum tamamlandıktan sonra, Java sürümünü kontrol ederek doğru kurulumu doğrulayabiliriz:

java -version

Bu komut, kurulu Java sürümünü gösterecektir. SonarQube, analiz sonuçlarını ve yapılandırma bilgilerini depolamak için bir veritabanına ihtiyaç duyar. Desteklenen veritabanları arasında PostgreSQL, Oracle ve Microsoft SQL Server bulunur. Performans ve kullanım kolaylığı açısından PostgreSQL, açık kaynak dünyasında en çok tercih edilen veritabanı yönetim sistemidir (DBMS). Bu rehberde de PostgreSQL kullanacağız. Sistem kaynakları açısından ise, SonarQube’un sorunsuz çalışabilmesi için belirli bir miktar RAM (bellek) ve CPU (işlemci) gücüne ihtiyacı vardır. Küçük ölçekli projeler için en az 2 GB RAM ve 2 CPU çekirdeği yeterli olabilirken, büyük ölçekli projeler ve çok sayıda analiz için daha fazla kaynağa ihtiyaç duyulacaktır. Resmi SonarQube belgelerindeki önerilere göz atmak her zaman en doğrusudur. Ayrıca, SonarQube’un kendisi için ayrı bir sistem kullanıcısı oluşturmak, güvenlik açısından iyi bir uygulamadır. Bu kullanıcı, SonarQube’un dizinlerine ve dosyalarına erişim sağlayacak, ancak root (kök) ayrıcalıklarına sahip olmayacaktır. Bu adımları tamamladıktan sonra, SonarQube’un temel altyapısı hazır hale gelmiş olacaktır.

PostgreSQL Veritabanı Kurulumu ve Yapılandırması

SonarQube’un çalışabilmesi için sağlam bir veritabanı altyapısına ihtiyacı vardır. Bu bölümde, Ubuntu 24.04 üzerine PostgreSQL veritabanı sunucusunu kuracak, SonarQube için özel bir veritabanı ve kullanıcı oluşturacak ve gerekli yapılandırmaları yapacağız. İlk olarak, PostgreSQL sunucusunu kurmak için aşağıdaki komutu kullanıyoruz:

sudo apt install postgresql postgresql-contrib -y

Kurulum tamamlandıktan sonra, PostgreSQL servisi otomatik olarak başlatılmalı ve etkinleştirilmelidir. Servisin durumunu kontrol etmek için:

sudo systemctl status postgresql

Şimdi, SonarQube için özel bir PostgreSQL kullanıcısı ve veritabanı oluşturmamız gerekiyor. Bu, güvenlik ve kaynak yönetimi açısından iyi bir uygulamadır. PostgreSQL varsayılan olarak postgres adlı bir süper kullanıcı (superuser) ile gelir. Bu kullanıcıya geçiş yaparak veritabanı işlemlerini gerçekleştirebiliriz:

sudo -i -u postgres

Şimdi PostgreSQL komut istemcisine (prompt) erişmek için psql komutunu çalıştırın:

psql

PostgreSQL komut istemcisinde iken, SonarQube için bir kullanıcı ve veritabanı oluşturalım. Kullanıcı adı olarak sonarqube ve bir şifre belirleyelim. Şifrenizi güçlü ve tahmin edilmesi zor bir şekilde seçtiğinizden emin olun.

CREATE USER sonarqube WITH PASSWORD 'GucluSifreniz123!';
CREATE DATABASE sonarqube OWNER sonarqube;
GRANT ALL PRIVILEGES ON DATABASE sonarqube TO sonarqube;
\q

\q komutu ile PostgreSQL komut istemcisinden çıkış yapabilirsiniz. Ardından exit yazarak postgres kullanıcısından da çıkış yaparak normal kullanıcıya geri dönebilirsiniz. Son olarak, PostgreSQL’in ağ bağlantılarını kabul etmesi ve SonarQube’un veritabanına erişebilmesi için bazı yapılandırmalar yapmamız gerekebilir. Genellikle bu, /etc/postgresql/16/main/pg_hba.conf dosyasında yapılır (PostgreSQL sürümünüz farklılık gösterebilir). Bu dosyayı bir metin düzenleyici ile açın:

sudo nano /etc/postgresql/16/main/pg_hba.conf

Dosyanın sonuna aşağıdaki satırı ekleyerek yerel bağlantılara izin verebilirsiniz. Eğer SonarQube ve PostgreSQL aynı sunucuda çalışacaksa bu yeterli olacaktır:

host    all             all             127.0.0.1/32            md5

Değişiklikleri kaydedip çıktıktan sonra, PostgreSQL servisini yeniden başlatarak yapılandırmaların etkili olmasını sağlayın:

sudo systemctl restart postgresql

Bu adımlarla birlikte, SonarQube için güvenli ve işlevsel bir PostgreSQL veritabanı altyapısı başarıyla kurulmuş ve yapılandırılmış olacaktır. Artık SonarQube’un kendisini indirme ve kurma aşamasına geçmeye hazırız.

SonarQube İndirme ve Ortam Ayarları

PostgreSQL veritabanımız hazır olduğuna göre, şimdi SonarQube’un kendisini indirme ve sistemimizde uygun şekilde yapılandırma zamanı. SonarQube’un en son topluluk sürümünü (Community Edition) resmi web sitesinden indireceğiz. İndirme işlemi için wget komutunu kullanabiliriz. Öncelikle, SonarQube’u indireceğimiz ve kuracağımız dizine gidelim. Genellikle /opt dizini bu tür uygulamalar için tercih edilir:

cd /opt

Ardından, SonarQube’un resmi indirme sayfasından en güncel sürümün doğrudan indirme bağlantısını alarak aşağıdaki gibi indirme işlemini gerçekleştirebiliriz. (Sürüm numarası zamanla değişebilir, bu yüzden lütfen resmi siteden güncel bağlantıyı kontrol edin.)

sudo wget https://binaries.sonarsource.com/Distribution/sonarqube/sonarqube-10.5.1.89294.zip

İndirme tamamlandıktan sonra, sıkıştırılmış dosyayı açmamız gerekiyor. Bunun için unzip aracına ihtiyacımız olabilir; eğer kurulu değilse kurun:

sudo apt install unzip -y
sudo unzip sonarqube-10.5.1.89294.zip
sudo rm sonarqube-10.5.1.89294.zip

Sıkıştırılmış dosyayı açtıktan sonra, genellikle sonarqube-x.x.x şeklinde bir dizin oluşacaktır. Bu dizinin adını daha basit bir hale getirmek iyi bir uygulamadır:

sudo mv sonarqube-10.5.1.89294 sonarqube

Güvenlik amacıyla, SonarQube’u root kullanıcısı yerine özel bir sistem kullanıcısı altında çalıştırmak en iyi pratiklerden biridir. Bu kullanıcıya sadece SonarQube dizinine erişim izni vereceğiz. Bir sonarqube kullanıcısı oluşturalım:

sudo adduser --system --no-create-home --group sonarqube

Şimdi, /opt/sonarqube dizininin sahipliğini bu yeni kullanıcıya verelim:

sudo chown -R sonarqube:sonarqube /opt/sonarqube

SonarQube’un veritabanı bağlantı bilgilerini ve diğer çalışma zamanı ayarlarını yapılandırmamız gerekiyor. Bu ayarlar /opt/sonarqube/conf/sonar.properties dosyasında bulunur. Bu dosyayı bir metin düzenleyici ile açın:

sudo nano /opt/sonarqube/conf/sonar.properties

Dosya içinde aşağıdaki satırları bulup, başlarındaki # işaretini kaldırarak (yorum satırı olmaktan çıkararak) ve kendi veritabanı bilgilerinizle doldurarak düzenleyin:

sonar.jdbc.url=jdbc:postgresql://localhost/sonarqube
sonar.jdbc.username=sonarqube
sonar.jdbc.password=GucluSifreniz123!

Ayrıca, SonarQube’un Java sanal makinesi (JVM) için bellek ayarlarını da optimize edebiliriz. Genellikle sonar.web.javaOpts ve sonar.ce.javaOpts satırlarını bularak bellek değerlerini sisteminizin RAM kapasitesine göre ayarlamanız önerilir. Örneğin:

sonar.web.javaOpts=-Xmx512m -Xms512m -XX:+HeapDumpOnOutOfMemoryError
sonar.ce.javaOpts=-Xmx512m -Xms512m -XX:+HeapDumpOnOutOfMemoryError

Bu değerler, SonarQube’un web arayüzü (web server) ve analiz motoru (compute engine) için minimum ve maksimum bellek tahsisini belirler. Değişiklikleri kaydedip dosyayı kapatın. Bu adımlarla, SonarQube’un temel dosyaları sisteme indirilmiş, güvenlik için bir kullanıcı atanmış ve veritabanı bağlantısı dahil temel yapılandırmalar tamamlanmış olacaktır. Artık SonarQube’u bir sistem servisi olarak yapılandırıp başlatmaya hazırız.

SonarQube Servisinin Yapılandırılması ve Başlatılması

SonarQube’u manuel olarak çalıştırmak yerine, onu bir sistem servisi (systemd service) olarak yapılandırmak, sunucu yeniden başlatıldığında otomatik olarak başlamasını ve arka planda sürekli çalışmasını sağlar. Bu, yönetim kolaylığı ve sistemin istikrarı açısından önemlidir. İlk olarak, SonarQube için bir systemd servis dosyası oluşturmamız gerekiyor. Bu dosyayı /etc/systemd/system/sonarqube.service yolunda oluşturacağız:

sudo nano /etc/systemd/system/sonarqube.service

Açılan dosyaya aşağıdaki içeriği yapıştırın:

[Unit]
Description=SonarQube systemd service
Documentation=https://docs.sonarqube.org/latest/
Requires=network.target remote-fs.target
After=network.target remote-fs.target

[Service]
ExecStart=/opt/sonarqube/bin/linux-x86-64/sonar.sh start
ExecStop=/opt/sonarqube/bin/linux-x86-64/sonar.sh stop
LimitNOFILE=65536
LimitNPROC=4096
User=sonarqube
Group=sonarqube
Type=forking
Restart=on-failure

[Install]
WantedBy=multi-user.target

Bu servis tanımı, SonarQube’un nasıl başlatılacağını, durdurulacağını, hangi kullanıcı ve grup altında çalışacağını ve sistem kaynakları üzerindeki limitleri belirtir. LimitNOFILE ve LimitNPROC değerleri, SonarQube’un çok sayıda dosya ve işlemle çalışırken sorun yaşamamasını sağlamak için önemlidir. Dosyayı kaydedip kapattıktan sonra, systemd’nin yeni servisimizi tanıması için yapılandırmayı yeniden yüklememiz gerekiyor:

sudo systemctl daemon-reload

Şimdi SonarQube servisini başlatabilir ve sistem açılışında otomatik olarak başlaması için etkinleştirebiliriz:

sudo systemctl start sonarqube
sudo systemctl enable sonarqube

Servisin durumunu kontrol ederek doğru bir şekilde çalıştığından emin olalım:

sudo systemctl status sonarqube

Durumun “active (running)” olarak görünmesi gerekmektedir. SonarQube varsayılan olarak 9000 numaralı portu kullanır. Eğer sunucunuzda bir güvenlik duvarı (firewall) etkinse (Ubuntu’da UFW yaygın olarak kullanılır), bu portu dışarıdan erişime açmanız gerekecektir:

sudo ufw allow 9000/tcp
sudo ufw enable

Güvenlik duvarını etkinleştirdikten sonra, tarayıcınızdan sunucunuzun IP adresi veya alan adıyla 9000 numaralı port üzerinden SonarQube’a erişebilirsiniz: http://[sunucu_ip_adresi]:9000. İlk erişiminizde, varsayılan yönetici kullanıcı adı admin ve şifre admin olacaktır. Giriş yaptıktan sonra, güvenlik amacıyla bu varsayılan şifreyi hemen değiştirmeniz şiddetle tavsiye edilir. SonarQube’un web arayüzüne başarılı bir şekilde eriştiyseniz ve şifreyi değiştirdiyseniz, temel kurulum süreci tamamlanmış demektir. Artık kod analizleri yapmaya ve projelerinizi yönetmeye hazırsınız. Ancak daha güvenli ve profesyonel bir kullanım için ileri düzey yapılandırmalar da mevcuttur.

İleri Düzey Yapılandırmalar ve Entegrasyon İpuçları

SonarQube’un temel kurulumu tamamlanmış olsa da, üretim ortamlarında daha güvenli, performanslı ve kullanışlı hale getirmek için bazı ileri düzey yapılandırmalar ve entegrasyonlar yapmak oldukça önemlidir. Bu bölümde, ters proxy (reverse proxy) kurulumu, SSL/TLS sertifikası entegrasyonu ve CI/CD (Sürekli Entegrasyon/Sürekli Dağıtım) araçlarıyla entegrasyon gibi konulara değineceğiz.

NGINX ile Ters Proxy Kurulumu

SonarQube’u doğrudan 9000 portu üzerinden erişime açmak yerine, NGINX veya Apache gibi bir ters proxy sunucusu arkasına almak, hem güvenlik hem de yönetim açısından birçok avantaj sağlar. Ters proxy, istekleri SonarQube’a iletirken, aynı zamanda SSL/TLS sonlandırma (termination), yük dengeleme (load balancing) ve statik dosya sunumu gibi görevleri üstlenebilir. NGINX kurulumu için:

sudo apt install nginx -y

Ardından, NGINX için bir yapılandırma dosyası oluşturalım (örneğin /etc/nginx/sites-available/sonarqube):

sudo nano /etc/nginx/sites-available/sonarqube

İçeriği aşağıdaki gibi düzenleyin (your_domain.com yerine kendi alan adınızı yazın):

server {
    listen 80;
    server_name your_domain.com;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 36000s;
        proxy_connect_timeout 36000s;
        proxy_send_timeout 36000s;
    }
}

Yapılandırma dosyasını etkinleştirmek için bir sembolik bağlantı (symbolic link) oluşturun ve NGINX’i yeniden başlatın:

sudo ln -s /etc/nginx/sites-available/sonarqube /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Artık SonarQube’a http://your_domain.com üzerinden erişebileceksiniz.

SSL/TLS Sertifikası Entegrasyonu (Let’s Encrypt)

Güvenli iletişim için SonarQube’a HTTPS üzerinden erişmek esastır. Let’s Encrypt ve Certbot kullanarak ücretsiz SSL/TLS sertifikaları edinebiliriz. NGINX yapılandırması tamamlandıktan sonra Certbot’u kurun:

sudo apt install certbot python3-certbot-nginx -y

Sertifikayı oluşturmak ve NGINX’i otomatik olarak yapılandırmak için:

sudo certbot --nginx -d your_domain.com

Certbot size birkaç soru soracak ve işlemi tamamlayacaktır. Bu işlemden sonra NGINX yapılandırma dosyanız otomatik olarak HTTPS için güncellenecektir. Güvenlik duvarınızdan 443 portunu açmayı unutmayın:

sudo ufw allow 443/tcp

Artık SonarQube’a https://your_domain.com üzerinden güvenli bir şekilde erişebilirsiniz.

CI/CD Araçlarıyla Entegrasyon

SonarQube’un gücünü tam anlamıyla kullanmak için onu CI/CD boru hatlarınıza entegre etmeniz gerekir. Her kod değişikliği veya birleştirme (merge) isteği (pull request) üzerinde otomatik olarak SonarQube analizi çalıştırmak, hataları ve güvenlik açıklarını erken aşamada tespit etmenizi sağlar. Popüler CI/CD araçları (Jenkins, GitLab CI, GitHub Actions, Azure DevOps) SonarQube ile entegrasyon için yerleşik eklentilere veya kolay yapılandırma seçeneklerine sahiptir. Örneğin, GitLab CI’da .gitlab-ci.yml dosyanıza aşağıdaki gibi bir aşama (stage) ekleyebilirsiniz:

stages:
  - build
  - test
  - analyze

sonarqube_analysis:
  stage: analyze
  image: maven:3.8.7-openjdk-17 # Projenizin diline uygun bir imaj kullanın
  variables:
    SONAR_HOST_URL: "https://your_domain.com"
    SONAR_TOKEN: "$SONAR_AUTH_TOKEN" # GitLab CI/CD Değişkenlerinde tanımlanmalı
  script:
    - mvn verify sonar:sonar -Dsonar.projectKey=my-java-project -Dsonar.sources=.

Bu örnek, bir Maven projesi için SonarQube analizini gösterir. SONAR_TOKEN, SonarQube arayüzünden oluşturabileceğiniz bir kimlik doğrulama belirtecidir (authentication token). Bu tür entegrasyonlar, geliştirme sürecinizin ayrılmaz bir parçası haline gelerek kod kalitesini sürekli olarak güvence altına alır. Bu ileri düzey yapılandırmalarla, SonarQube kurulumunuzu daha sağlam, güvenli ve otomatik hale getirebilirsiniz.

Sıkça Sorulan Sorular (SSS)

1. SonarQube neden başlamıyor veya web arayüzüne erişemiyorum?

Bu durumun birkaç yaygın nedeni olabilir:

• Java Sürümü: SonarQube’un gerektirdiği Java sürümünün (genellikle OpenJDK 17 veya üzeri) doğru kurulduğundan emin olun. java -version komutu ile kontrol edin.
• Bellek Limitleri: Sunucunuzda yeterli RAM olmadığında SonarQube başlamayabilir. /opt/sonarqube/conf/sonar.properties dosyasındaki sonar.web.javaOpts ve sonar.ce.javaOpts bellek ayarlarını kontrol edin ve sisteminizin kapasitesine göre ayarlayın.
• Veritabanı Bağlantısı: sonar.properties dosyasındaki veritabanı bağlantı bilgilerinin (URL, kullanıcı adı, şifre) doğru olduğundan ve PostgreSQL servisinin çalıştığından emin olun. PostgreSQL loglarını kontrol etmek faydalı olabilir.
• Kullanıcı İzinleri: SonarQube dizinlerinin (/opt/sonarqube) sonarqube kullanıcısına ait olduğundan ve bu kullanıcının dizinlere okuma/yazma izni olduğundan emin olun.
• Port Çakışması/Güvenlik Duvarı: SonarQube’un varsayılan 9000 portunun başka bir uygulama tarafından kullanılmadığından emin olun. Ayrıca, güvenlik duvarınızın (UFW) 9000 (veya NGINX kullanıyorsanız 80/443) portuna izin verdiğinden emin olun.
• SonarQube Logları: En iyi hata ayıklama yöntemi, SonarQube loglarını incelemektir. Log dosyaları /opt/sonarqube/logs dizininde bulunur (web.log, ce.log, es.log). Bu dosyalar, sorunun kök nedenini belirlemenize yardımcı olacaktır.

2. Veritabanı bağlantı hatası alıyorum, ne yapmalıyım?

Veritabanı bağlantı hataları genellikle aşağıdaki nedenlerden kaynaklanır:

• Yanlış Kimlik Bilgileri: /opt/sonarqube/conf/sonar.properties dosyasındaki sonar.jdbc.username ve sonar.jdbc.password bilgilerinin PostgreSQL’de oluşturduğunuz kullanıcı adı ve şifre ile tam olarak eşleştiğinden emin olun.
• Yanlış Veritabanı URL’si: sonar.jdbc.url içindeki veritabanı adının (varsayılan olarak sonarqube) doğru olduğundan emin olun.
• PostgreSQL Servisi Çalışmıyor: PostgreSQL servisinin aktif ve çalışır durumda olduğundan emin olun: sudo systemctl status postgresql.
• PostgreSQL Bağlantı İzinleri: /etc/postgresql/16/main/pg_hba.conf dosyasında yerel bağlantılara izin verildiğinden (örneğin host all all 127.0.0.1/32 md5) ve değişikliklerden sonra PostgreSQL’in yeniden başlatıldığından emin olun.
• Veritabanı Oluşturulmadı: SonarQube veritabanının (sonarqube) ve kullanıcısının (sonarqube) PostgreSQL içinde doğru bir şekilde oluşturulduğundan emin olun.

3. SonarQube’u güncelledikten sonra sorun yaşıyorum, nasıl geri dönebilirim?

SonarQube güncellemeleri genellikle veritabanı şeması değişikliklerini içerir. Bu nedenle, güncelleme yapmadan önce her zaman veritabanınızın ve SonarQube kurulum dizininin (/opt/sonarqube) yedeğini almanız şiddetle tavsiye edilir. Eğer bir sorunla karşılaşırsanız:

• Logları Kontrol Edin: Güncelleme sonrası oluşan sorunların nedenini anlamak için /opt/sonarqube/logs dizinindeki log dosyalarını inceleyin.
• Veritabanı Yedekten Geri Yükleme: Eğer yedek aldıysanız, PostgreSQL veritabanınızı güncelleme öncesi haline geri yükleyin.
• Eski SonarQube Dizinini Geri Yükleme: SonarQube’un eski sürümünün kurulum dizinini (yedeklediyseniz) geri yükleyin.
• Sürüm Uyumluluğu: Yeni SonarQube sürümünün Java ve veritabanı sürümünüzle uyumlu olduğundan emin olun.
• Eklentiler: Kurulu eklentilerinizin (plugins) yeni SonarQube sürümüyle uyumlu olduğundan emin olun. Uyumsuz eklentiler sorunlara yol açabilir.

Geri dönüş (rollback) işlemi, yedekleriniz varsa nispeten kolaydır. Yedekleme stratejisi, güncelleme planınızın önemli bir parçası olmalıdır.

4. SonarQube performans sorunları yaşıyorum, ne yapmalıyım?

Performans sorunları genellikle aşağıdaki noktalardan kaynaklanır:

• Yetersiz Sistem Kaynakları: Sunucunuzun yeterli RAM ve CPU’ya sahip olduğundan emin olun. Özellikle büyük projeler ve sık analizler için daha fazla kaynağa ihtiyaç duyulur. sonar.properties dosyasındaki JVM bellek ayarlarını (-Xmx, -Xms) artırmayı deneyin.
• Veritabanı Performansı: PostgreSQL’in performansını izleyin. Yavaş sorgular veya yetersiz disk I/O, SonarQube’u yavaşlatabilir. PostgreSQL yapılandırmasını (postgresql.conf) optimize etmeyi düşünebilirsiniz.
• Elasticsearch Performansı: SonarQube, arama ve indeksleme için Elasticsearch kullanır. Elasticsearch’in yeterli belleğe sahip olduğundan ve disk I/O’sunun iyi olduğundan emin olun. vm.max_map_count gibi kernel ayarlarını kontrol edin.
• Ağ Yapılandırması: SonarQube’a erişim veya analiz ajanlarının (SonarScanner) SonarQube sunucusuna bağlanmasında ağ gecikmeleri olup olmadığını kontrol edin.
• Proje Boyutu ve Ayarları: Çok büyük projeler veya çok sayıda kural içeren profiller, analiz sürelerini uzatabilir. Proje boyutunu optimize etmeyi veya analiz kapsamını daraltmayı düşünebilirsiniz.

5. SonarQube taramalarını otomatikleştirmek için ne kullanmalıyım?

SonarQube taramalarını otomatikleştirmek için en yaygın ve etkili yöntemler şunlardır:

• CI/CD Araçları: Jenkins, GitLab CI, GitHub Actions, Azure DevOps, Bitbucket Pipelines gibi sürekli entegrasyon ve sürekli dağıtım araçları, her kod değişikliğinde veya belirli zaman aralıklarında SonarQube analizini otomatik olarak tetiklemek için idealdir. Bu araçların çoğu için SonarQube eklentileri veya yerleşik entegrasyonları mevcuttur.
• SonarScanner CLI: SonarScanner, komut satırı üzerinden SonarQube analizlerini başlatmak için kullanılan bağımsız bir araçtır. CI/CD boru hatlarınıza entegre edilebileceği gibi, yerel geliştirme ortamlarında da manuel analizler için kullanılabilir.
• Derleme Araçları Entegrasyonu: Maven, Gradle, .NET gibi popüler derleme araçlarının SonarQube ile doğrudan entegrasyonu vardır. Bu sayede, projenizi derlerken aynı zamanda SonarQube analizini de çalıştırabilirsiniz.

Otomatik taramalar, kod kalitesinin sürekli olarak izlenmesini ve teknik borcun kontrol altında tutulmasını sağlayarak geliştirme sürecinin verimliliğini artırır.

Sonuç ve Kapanış

Bu kapsamlı rehberde, Ubuntu 24.04 işletim sistemi üzerine SonarQube’u adım adım nasıl kuracağınızı, PostgreSQL veritabanını nasıl yapılandıracağınızı ve sistemi nasıl optimize edeceğinizi detaylı bir şekilde öğrendiniz. Modern yazılım geliştirme pratiklerinde kod kalitesinin ve güvenliğinin ne denli kritik olduğunu bir kez daha vurgulamak gerekir. SonarQube gibi güçlü bir statik kod analiz platformu, teknik borcu erken aşamada tespit ederek, geliştirme maliyetlerini düşürür ve yazılımın uzun vadeli sürdürülebilirliğini sağlar.

Kurulum sürecinde dikkat ettiğimiz her adım, SonarQube’un sadece çalışır durumda olmasını değil, aynı zamanda güvenli, performanslı ve yönetilebilir bir şekilde faaliyet göstermesini sağlamayı amaçladı. Java kurulumundan PostgreSQL veritabanı yapılandırmasına, SonarQube servisinin oluşturulmasından NGINX ile ters proxy ve SSL/TLS entegrasyonuna kadar her detay, gerçek dünya senaryolarında karşılaşabileceğiniz ihtiyaçlara yönelik çözümler sunmaktadır. CI/CD araçlarıyla entegrasyon ipuçları ise, SonarQube’u geliştirme sürecinizin ayrılmaz bir parçası haline getirerek, sürekli kod kalitesi denetimi sağlamanız için yol göstermiştir.

Unutmayın ki SonarQube, sadece bir araç değil, aynı zamanda bir kültürdür. Ekibinizin kod kalitesi bilincini artırmak, teknik borcu düzenli olarak ele almak ve en iyi pratikleri benimsemek, SonarQube’dan elde edeceğiniz faydaları maksimize edecektir. Kurulumun ardından, SonarQube arayüzünü keşfetmeye, analiz profilleri oluşturmaya ve projelerinizi taramaya başlayarak kodunuzun gerçek potansiyelini ortaya çıkarabilirsiniz. Kod kalitesine yapılan bu yatırım, şüphesiz ki daha sağlam, güvenli ve başarılı yazılım projelerine dönüşecektir. Gelecek adımlarınızda, SonarQube’un zengin özellik setini daha derinlemesine incelemeniz ve projenizin özel ihtiyaçlarına göre özelleştirmeniz önerilir.

#SonarQube #Ubuntu #KodKalitesi #DevOps #YazılımGeliştirme