İmaj Hiyerarşisi

graph TD
    BASE["debian:13-slim"]

    BASE --> BUILDER

    subgraph BUILDER["builder"]
        B1["gcc-13 / clang-18"]
        B2["SDL3 sistem bağımlılıkları"]
        B3["Conan 2 + profil"]
        B4["Conan cache\nLinux Debug + Release\n(+ Vulkan varyantları)"]
    end

    BUILDER --> CI
    BUILDER --> WIN

    subgraph CI["ci"]
        C1["lcov / gcovr"]
        C2["mesa-vulkan-drivers\nlavapipe ICD + llvmpipe"]
        C3["SDL_VIDEODRIVER=offscreen\nSDL_AUDIODRIVER=dummy"]
        C4["VK_ICD_FILENAMES\n→ lavapipe sabitleme"]
    end

    subgraph WIN["windows-cross"]
        W1["mingw-w64 / wine64"]
        W2["windres wrapper"]
        W3["Conan profil: windows-mingw"]
        W4["Conan cache\nWindows Debug + Release"]
    end

Yerel Geliştirme Akışları

builder — Linux geliştirme ortamı

flowchart LR
    A([Geliştirici]) --> B["docker build\n--target builder\n-t sdl-painter:dev ."]
    B --> C["docker run --rm -it\n-v \$(pwd):/workspace\nsdl-painter:dev bash"]
    C --> D["conan install .\n(cache sıcak — saniyeler)"]
    D --> E["cmake --preset linux-debug"]
    E --> F["cmake --build\n--preset linux-debug"]
    F --> G["ctest --preset linux-debug\n--output-on-failure"]

docker build --target builder -t sdl-painter:dev .
docker run --rm -it -v "${PWD}:/workspace" sdl-painter:dev bash
 
# Container içinde — conan install atlanamaz: /workspace mount'u imajdaki
# build/ çıktısını gölgeler. Cache (~/.conan2) imajda sıcak olduğundan
# bu adım saniyeler sürer, hiçbir paket yeniden derlenmez.
conan install . --output-folder=build/linux-debug/generators --build=missing \
  -s build_type=Debug -s compiler=gcc -s compiler.version=13 -s compiler.libcxx=libstdc++11
cmake --preset linux-debug
cmake --build --preset linux-debug

ci — Headless test ve kod kapsama

flowchart LR
    A([CI / Geliştirici]) --> B["docker build\n--target ci\n-t sdl-painter:ci ."]
    B --> C["docker run --rm\n-v \$(pwd):/workspace\nsdl-painter:ci bash -c ..."]

    C --> D["conan install .\n(cache sıcak)"]
    D --> E["cmake --preset linux-debug"]
    E --> F["cmake --build\n--preset linux-debug"]
    F --> G{"Test türü"}

    G -->|Birim test| H["ctest --preset linux-debug\n--output-on-failure"]
    G -->|Kapsama| I["ctest ... &&\ngcovr -r . build/"]

docker build --target ci -t sdl-painter:ci .
 
# Debug test
docker run --rm -v "${PWD}:/workspace" sdl-painter:ci bash -c `
  "conan install . --output-folder=build/linux-debug/generators --build=missing -s build_type=Debug -s compiler=gcc -s compiler.version=13 -s compiler.libcxx=libstdc++11 && cmake --preset linux-debug && cmake --build --preset linux-debug && ctest --preset linux-debug --output-on-failure"
 
# Release test
docker run --rm -v "${PWD}:/workspace" sdl-painter:ci bash -c `
  "conan install . --output-folder=build/linux-release/generators --build=missing -s build_type=Release -s compiler=gcc -s compiler.version=13 -s compiler.libcxx=libstdc++11 && cmake --preset linux-release && cmake --build --preset linux-release && ctest --preset linux-release --output-on-failure"
 
# Vulkan destekli build + test (lavapipe ile headless)
docker run --rm -v "${PWD}:/workspace" sdl-painter:ci bash -c `
  "conan install . --output-folder=build/linux-release/generators --build=missing -s build_type=Release -s compiler=gcc -s compiler.version=13 -s compiler.libcxx=libstdc++11 -o '&:with_vulkan=True' && cmake --preset linux-release && cmake --build --preset linux-release && ctest --preset linux-release --output-on-failure"

windows-cross — Windows cross-compile (Linux host)

flowchart LR
    A([Geliştirici]) --> B["docker build\n--target windows-cross\n-t sdl-painter:windows-cross ."]
    B --> C["docker run --rm\n-v \$(pwd):/workspace\nsdl-painter:windows-cross bash -c ..."]

    C --> D["conan install .\n--profile:host=windows-mingw"]
    D --> E["cmake --preset\nwindows-mingw-debug"]
    E --> F["cmake --build\n--preset windows-mingw-debug"]
    F --> G[("Windows .exe / .dll")]

    G --> H{"Çalıştırma"}
    H -->|Konteyner içi| I["wine64 build/MyApp.exe"]
    H -->|Windows host'a kopyala| J["scp / mount"]

docker build --target windows-cross -t sdl-painter:windows-cross .
 
docker run --rm -v "${PWD}:/workspace" sdl-painter:windows-cross bash -c `
  "conan install . --output-folder=build/windows-mingw-debug/generators --build=missing -s build_type=Debug --profile:build=default --profile:host=windows-mingw && cmake --preset windows-mingw-debug && cmake --build --preset windows-mingw-debug"

GitLab CI/CD Entegrasyonu

Pipeline, bu repodaki Dockerfile'dan üretilip GitLab Container Registry'ye push'lanan imajları doğrudan kullanır. Ayrı bir .conan_base template'i veya before_script ile araç kurulumu yoktur — araçlar imajda hazır gelir.

Job	Image	Kaynak
build:linux:, test:unit, quality:*	$CI_REGISTRY_IMAGE	Dockerfile ci / builder hedefi
build:windows:*	$CI_REGISTRY_IMAGE/sdl-painter-win-cross	Dockerfile windows-cross hedefi (Linux + MinGW)
pages	ubuntu:24.04	Conan/CMake gerektirmez, yalnız Doxygen
release:publish	release-cli	v..* tag'inde çalışır

flowchart TD
    PUSH([git push]) --> PIPE[GitLab CI Pipeline]

    PIPE --> BUILD[build]
    PIPE --> TEST[test]
    PIPE --> QUALITY[quality]
    PIPE --> DOCS[docs]
    PIPE --> REL[release]

    BUILD --> BLD["build:linux:debug / release\n— $CI_REGISTRY_IMAGE\n-o with_vulkan=True"]
    BUILD --> BWIN["build:windows:debug / release\n— $CI_REGISTRY_IMAGE/sdl-painter-win-cross\nMinGW cross (Vulkan'sız)"]

    TEST --> TU["test:unit\n— $CI_REGISTRY_IMAGE\noffscreen + lavapipe ICD"]
    TEST --> TA["test:unit:asan\n— $CI_REGISTRY_IMAGE\nbağımsız çalışır"]
    TEST --> TWN["test:unit:windows\n— yorum satırı (devre dışı)"]

    QUALITY --> FMT["quality:clang-format\n— --Werror, allow_failure"]
    QUALITY --> TIDY["quality:clang-tidy\n— allow_failure"]

    DOCS --> DOC["pages\n— ubuntu:24.04, Doxygen\n(yalnızca main)"]

    REL --> RELP["release:publish\n— v*.*.* tag'i ile"]

    style BLD fill:#2d6a4f,color:#fff,stroke:#1b4332
    style TU fill:#2d6a4f,color:#fff,stroke:#1b4332

Not: build:windows:* job'ları SaaS Windows runner / MSVC değildir — Linux runner üzerinde MinGW cross-compile imajı (sdl-painter-win-cross) kullanır ve bu hedefte Vulkan desteklenmez (conanfile.py configure() otomatik kapatır). Native MSVC build için ayrı Dockerfile.windows imajı kullanılır (aşağıya bakın).

GitHub Actions Entegrasyonu

Aynı pipeline GitHub Actions'a da taşındı (.github/workflows/ci.yml). Linux job'ları yine bu repodaki Dockerfile'dan üretilen imajı kullanır; fark, imajın GitLab Container Registry yerine Docker Hub'dan çekilmesidir (yazilimperver/sdl-painter:ci-v1.0).

Job	Ortam	Kaynak
build-linux-, test-unit, quality-*	container: yazilimperver/sdl-painter:ci-v1.0	Dockerfile ci hedefi → Docker Hub
build-windows-*	windows-latest runner (container yok)	Native MSVC + actions/cache
docs	ubuntu-latest, apt ile Doxygen	Çıktı yalnız artifact (Pages publish yok)
release	ubuntu-latest, softprops/action-gh-release	v..* tag'inde, notlar CHANGELOG.md'den

flowchart LR
    B["build-linux-debug/release\nbuild-windows-debug/release"] --> T["test-unit\ntest-unit-asan"]
    T --> Q["quality-clang-format\nquality-clang-tidy"]
    Q --> D["docs\n(yalnız default branch)"]
    Q --> R["release\n(yalnız v*.*.* tag)"]

GitLab'dan ayrışan noktalar:

Windows stratejisi: MinGW cross-compile yerine native MSVC. ilammy/msvc-dev-cmd MSVC ortamını kurar, Conan pip ile yüklenir. Özel imaj olmadığından Conan cache'i actions/cache ile, hashFiles('conanfile.py') anahtarına bağlanarak saklanır — bağımlılık değişince cache otomatik tazelenir.
İmaj sürümleme: Docker Hub etiketi sürümlüdür (ci-v1.0). conanfile.py değiştiğinde yeni etiket push'lanıp workflow'daki imaj referansı güncellenmelidir.
DAG farkı: GitLab'da test:unit:asan ve quality:clang-format needs: [] ile pipeline başında bağımsız koşar; GitHub workflow'unda ise job'lar needs ile zincirlidir (build → test → quality → docs/release).
Concurrency: Art arda push'larda eski workflow koşusu otomatik iptal edilir; tag pipeline'ları bu iptalden muaftır.

Dockerfile.windows — Native MSVC İmajı

Linux Dockerfile'ının Windows muadili; tek başına çalışan, tek-OS bir imaj: VS Build Tools 17 (VS 2022) + standalone CMake + Python + Conan 2, ve MSVC ile ön-ısıtılmış Conan cache (Vulkan dahil). Linux Conan adımları bu imajda çalışmaz; onlar Linux Dockerfile'da kalır.

# Build — Docker, Windows containers modunda olmalı. --network nat ZORUNLU:
# aksi halde conan adımları DNS çözemez ("getaddrinfo failed").
docker build --network nat -f Dockerfile.windows -t sdl-painter-windows:latest .
 
# İlk doğrulama için Vulkan ön-cache'siz (çok daha hızlı):
docker build --network nat -f Dockerfile.windows `
  --build-arg WITH_VULKAN_PRECACHE=false -t sdl-painter-windows:latest .
 
# Native MSVC + Vulkan: derleme + testler:
docker run --rm --network nat --dns 8.8.8.8 -v ${PWD}:C:\workspace --entrypoint cmd `
  sdl-painter-windows:latest /S /C "call C:\BuildTools\VC\Auxiliary\Build\vcvars64.bat && cd /d C:\workspace && conan install . --output-folder=build/windows-release/generators --build=missing -s build_type=Release -s compiler.cppstd=17 -o ^&:with_vulkan=True && cmake --preset windows-release && cmake --build --preset windows-release && ctest --preset windows-release --output-on-failure"

DİKKAT: Bu MSVC imajını CI'daki sdl-painter-win-cross etiketine push'lamayın — o etiket Linux + MinGW imajıdır; MSVC ile değiştirilirse build:windows:* job'ları (Linux runner) kırılır. Yeri: yerel native MSVC build/test veya isteğe bağlı self-hosted Windows Docker runner (ayrı etiketle). Detay için Dockerfile.windows içindeki "CI durumu" notuna bakın.

Docker Hub'da Yayınlanan İmajlar

Tüm imajların hazır build'leri Docker Hub'da yayınlanır — lokalde imaj build etmek (özellikle Conan ön-ısıtma nedeniyle uzun sürer) yerine doğrudan çekilebilir:

Etiket	Dockerfile hedefi	Boyut (sıkıştırılmış)	Açıklama
ci-v1.0	Dockerfile → ci	~2,2 GB	GitHub Actions Linux job'larının kullandığı sürümlü etiket
ci	Dockerfile → ci	~2,2 GB	Sürümsüz takip etiketi — en güncel ci imajını gösterir
windows-cross-v1.0	Dockerfile → windows-cross	~3,5 GB	Linux + MinGW-w64 cross-compile (Linux container)
windows-v1.0	Dockerfile.windows → windows-msvc	~7,9 GB	Native MSVC + Vulkan (Windows container — Windows containers modu gerekir)

# Lokal build yerine hazır imajı çek
docker pull yazilimperver/sdl-painter:ci-v1.0
 
# Yukarıdaki ci akışındaki komutlar aynı şekilde çalışır:
docker run --rm -v "${PWD}:/workspace" yazilimperver/sdl-painter:ci-v1.0 bash -c `
  "conan install . --output-folder=build/linux-debug/generators --build=missing -s build_type=Debug -s compiler=gcc -s compiler.version=13 -s compiler.libcxx=libstdc++11 && cmake --preset linux-debug && cmake --build --preset linux-debug && ctest --preset linux-debug --output-on-failure"

Sürümleme: conanfile.py veya Dockerfile değiştiğinde yeni sürümlü etiket (ci-v1.1 vb.) push'lanır ve GitHub workflow'undaki imaj referansı güncellenir. Sürümlü etiketler değişmez (immutable) kabul edilir; ci takip etiketi ise her yayında en güncel imaja kaydırılır. GitLab tarafı ise aynı imajları kendi Container Registry'sinden ($CI_REGISTRY_IMAGE) kullanır.

Hızlı Başvuru

Dosya / Hedef	İmaj etiketi	Kullanım alanı
Dockerfile → builder	sdl-painter:dev	Yerel Linux geliştirme
Dockerfile → ci	sdl-painter:ci	Headless test, kod kapsama, Vulkan (lavapipe)
Dockerfile → ci	$CI_REGISTRY_IMAGE	GitLab CI Linux job'ları
Dockerfile → ci	yazilimperver/sdl-painter:ci-v1.0 (Docker Hub)	GitHub Actions Linux job'ları
Dockerfile → windows-cross	sdl-painter:windows-cross / $CI_REGISTRY_IMAGE/sdl-painter-win-cross / yazilimperver/sdl-painter:windows-cross-v1.0 (Docker Hub)	Windows cross-compile (MinGW, Vulkan'sız)
Dockerfile.windows → windows-msvc	sdl-painter-windows:latest / yazilimperver/sdl-painter:windows-v1.0 (Docker Hub)	Yerel native MSVC build + test (Vulkan destekli)