GitLab Rehberi

GitLab Rehberi

GitLab, Denomas'ın kod yönetimi, CI/CD ve proje takibi platformudur. Self-hosted GitLab instance'ımız, tüm geliştirme sürecinin merkezinde yer alır.

Erişim

Temel Özellikler

Repository Yönetimi

GitLab, Denomas'ın tüm kaynak kodunu, altyapı konfigürasyonlarını ve dokümantasyonunu barındırır:

Repository Organizasyonu:

code.denomas.com/
├── denomas/              — Ürün kaynak kodları
│   ├── backend/
│   ├── frontend/
│   └── mobile/
├── infra/                — Altyapı ve otomasyon
│   ├── ansible-roles/
│   ├── terraform-infra/
│   ├── infra-automation/
│   └── runbooks/
├── internal/             — İç araçlar ve scriptler
├── docs/                 — Dokümantasyon
└── sandbox/              — Deney ve test projeleri

Merge Request (MR) İş Akışı

Merge request, Denomas'taki tüm kod değişikliklerinin incelenme ve onaylanma sürecidir:

Detaylı MR Süreci:

1. Branch Oluştur: main'den yeni feature branch oluşturun
2. Geliştirme: Değişiklikleri commit edin (Conventional Commits formatında)
3. MR Aç: GitLab üzerinden MR oluşturun:
   • Açıklayıcı başlık ve açıklama yazın
   • İlgili issue'yu bağlayın (Closes #123)
   • İncelemeci atayın (CODEOWNERS otomatik atar)
   • Uygun label'ları ekleyin
4. CI Pipeline: Otomatik lint, test, build ve güvenlik taramaları çalışır
5. Kod İnceleme: En az 1 onay gereklidir (Kod İnceleme standartlarına uygun)
6. Düzeltme: Geri bildirimler doğrultusunda güncellemeler yapılır
7. Onay ve Merge: Pipeline başarılı + incelemeci onayı → squash merge
8. Temizlik: Feature branch otomatik silinir

MR Kontrol Listesi:

• CI pipeline başarılı
• En az 1 incelemeci onayı
• Çakışma (conflict) yok
• Güvenlik taraması geçti
• Test coverage düşmedi
• Dokümantasyon güncellendi (gerekirse)

CI/CD Pipeline

CI/CD pipeline yapılandırması .gitlab-ci.yml dosyasıyla tanımlanır:

stages:
  - lint
  - test
  - security
  - build
  - deploy

lint:
  stage: lint
  script:
    - pre-commit run --all-files

test:
  stage: test
  script:
    - pytest --cov
  coverage: '/TOTAL.*\s+(\d+%)$/'

security:
  stage: security
  script:
    - trivy fs --severity HIGH,CRITICAL .
    - gitlab-sast

build:
  stage: build
  script:
    - docker build -t $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA .
    - docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA

deploy_staging:
  stage: deploy
  script:
    - ansible-playbook -i inventory/staging deploy.yml
  only:
    - develop
  environment:
    name: staging

deploy_production:
  stage: deploy
  script:
    - ansible-playbook -i inventory/production deploy.yml
  only:
    - main
  when: manual
  environment:
    name: production

Pipeline Aşamaları:

Issue Tracking (Görev Takibi)

GitLab issue tracking, görev ve hata takibi için kullanılır:

Issue Oluşturma Kuralları:

• Açıklayıcı başlık kullanın
• Yeniden üretim adımları ekleyin (hata raporlarında)
• Uygun label'ları atayın
• Sprint milestone'una ekleyin
• Sorumlu kişiyi atayın

Wiki Kullanımı

Her GitLab projesi için wiki sayfası oluşturulabilir:

Wiki En İyi Pratikleri:

• Markdown formatında yazın
• Sayfa hiyerarşisi oluşturun (sidebar)
• Görsel ve diyagram ekleyin (Mermaid desteği mevcuttur)
• Güncelliği koruyun (stale sayfaları işaretleyin)

Container Registry

• Docker imaj depolama (her proje için)
• Otomatik imaj tarama (Trivy)
• Sürüm etiketleme (latest, v1.2.3, commit SHA)
• Geçiş süresi dolan imajların otomatik temizliği

En İyi Pratikler

Commit Mesajları

Conventional Commits formatını kullanın:

<tur>(<kapsam>): <açıklama>

[govde]

[altbilgi]

Branch İsimlendirme

Merge Request Süreci (Özet)

1. Feature branch oluşturun (feature/ABC-123-açıklama)
2. Değişiklikleri commit edin (Conventional Commits)
3. MR açın ve incelemeci atayın
4. Kod inceleme tamamlansın
5. CI pipeline başarılı olsun
6. Merge yapın (squash merge tercih edilir)

İlgili Sayfalar

• Araç ve İpuçları
• Nextcloud Rehberi
• Odoo Rehberi
• CI/CD Pipeline
• Kod İnceleme
• Mühendislik

Sayfa kaynağını görüntüle - Bu sayfayı düzenle - please contribute.