Gitea ile Kendi Git Sunucunuz Eğitimi

Eğitim Hakkında

Kendi sunucunuzda barındırılan hafif bir Git forge'un kurulumu ve işletimi

Eğitim, Gitea'yı Docker Compose ve PostgreSQL ile kurmayı, app.ini ayarlarını, nginx veya Caddy arkasında HTTPS ve SSH yönlendirmesini işler. Kullanıcı ve organizasyon yönetimi, LDAP/OAuth2, dal koruma, pull request akışı, Gitea Actions ve act_runner, GitHub'dan depo migration, mirror, webhook, gitea dump ile yedekleme ve güvenlik sertleştirmesi uygulamalı olarak ele alınır.

Süre ve Format

2 Gün. Her gün dört modül; 1. gün Kurulum, Erişim ve Ekip Akışı; 2. gün Otomasyon, Operasyon ve Güvenlik.

Seviye

Orta Seviye — Gitea kurulumu, PR akışı, Actions, mirror ve operasyon yönetimini kapsayan self-hosted Git forge yelpazesi

Öğrenme Metodu

Katılımcılar bir Linux VM üzerinde Docker Compose ile Gitea kurar, PostgreSQL, HTTPS ve SSH'ı yapılandırır, act_runner ekler ve gerçek depoları migration ile taşır.

Neden Bu Eğitim?

🏠Veri Egemenliği

Kaynak kodunuzu kendi altyapınızda tutan, kurumsal politikalara uyumlu bir forge kurmayı öğrenirsiniz.

🪶Hafif ve Hızlı

Düşük kaynakla çalışan Gitea'yı üretime hazır şekilde yapılandırırsınız.

🔄Kolay Geçiş

GitHub ve GitLab'dan depoları migration ve mirror ile sorunsuz taşırsınız.

Anahtar Konular

gitea eğitimigitea kurulumuself-hosted gitgitea actionsact_runnergitea docker composegithub alternatifigitlab alternatifigitea migrationgitea yedekleme

“Kodunuzun nerede durduğunu bilmek, bağımsızlığın ilk adımıdır.”

Ön Koşullar

Eğitimden verim almak için faydalı olacak bilgi ve ortam gereksinimleri

1

Linux Temelleri

Temel Linux komutları, servis yönetimi ve dosya izinleri bilgisi gerekir.

2

Docker Bilgisi

Docker ve Docker Compose ile konteyner çalıştırmaya aşinalık beklenir.

3

Git Deneyimi

Temel Git komutlarını ve dal mantığını bilmek gerekir.

4

Laboratuvar Ortamı

Docker kurulu bir Linux VM veya WSL2 ortamı ve alan adı/hosts kaydı yapabilme imkânı gerekir.

Eğitim İçeriği

Programın gün gün akışı aşağıdadır. Bir güne tıklayarak o günün modüllerini ve içeriklerini görebilirsiniz.

Günün hedefiKatılımcı gün sonunda Gitea'yı kurar, kimlik doğrulamasını yapılandırır ve PR ile dal koruma akışını ekibe uygular.

Modül 1

Gitea Kurulumu ve Yapılandırması

Docker Compose ile Gitea + PostgreSQL kurulumu, tek ikili dosya (binary) ve systemd servisi seçenekleri
app.ini yapılandırması: [server], [database], [service], [security] bölümleri ve ROOT_URL
Reverse proxy (nginx/Caddy) arkasında HTTPS, SSH port yönlendirmesi ve SSH_DOMAIN ayarı
Kullanıcı, organizasyon, takım ve depo izinleri; kayıt kapatma ve admin hesabı yönetimi
LDAP, OAuth2 (Keycloak, Google) ve SMTP entegrasyonu
gitea dump ile yedekleme, geri yükleme ve minor sürüm yükseltme prosedürü

Modül 2

Gitea'da Depo, Pull Request ve Proje Yönetimi

Depo oluşturma, şablon depolar, README/LICENSE/.gitignore şablonları ve LFS desteği
Pull request akışı: inceleme, onay, çakışma çözümü ve merge stilleri (merge, rebase, squash, fast-forward-only)
Dal koruma: korumalı dal, push beyaz listesi, zorunlu onay ve durum kontrolü, imzalı commit gereksinimi
Issue takibi, etiketler, milestone, bağımlılıklar, zaman takibi ve proje panoları
Wiki, release oluşturma, release eki (attachment) ve etiketten otomatik arşiv
Bildirimler, e-posta ile issue yanıtlama ve kullanıcı/organizasyon takım izinleri

Modül 3

Dallanma Stratejileri: Git Flow, GitHub Flow, Trunk-Based

Git Flow modeli: main, develop, feature, release ve hotfix dallarının rolleri ve ömürleri
GitHub Flow: tek ana dal, kısa ömürlü dal ve pull request ile sürekli dağıtım
Trunk-based development: küçük commit'ler, günlük entegrasyon ve feature flag kullanımı
Release dalı yönetimi, sürüm bakım dalları (release/1.x) ve hotfix'in ana dallara geri aktarımı
Takım büyüklüğü, dağıtım sıklığı ve ürün tipine göre strateji seçim kriterleri
Dal isimlendirme standartları (feature/, bugfix/, release/) ve dal koruma kurallarıyla zorunlu kılma

Modül 4

Git Hooks ve Otomatik Kalite Kontrolleri

client-side hook'lar: pre-commit, prepare-commit-msg, commit-msg, pre-push
.git/hooks dizini ve core.hooksPath ile hook'ların depoyla paylaşılması
pre-commit framework: .pre-commit-config.yaml, black, flake8, eslint ve trailing-whitespace kontrolleri
Husky ve lint-staged ile Node.js projelerinde commit öncesi lint ve test
commit-msg hook ile Conventional Commits doğrulaması (commitlint)
Sunucu tarafı hook'lar (pre-receive, update, post-receive) ve --no-verify kullanımının riskleri

Günün hedefiKatılımcı gün sonunda Gitea Actions, mirror ve migration kurar; yedekleme, izleme ve güvenlik sertleştirmesini tamamlar.

Modül 1

Gitea Actions, Mirror ve Göç

Gitea Actions ile act_runner kurulumu, runner kaydı ve GitHub Actions uyumlu workflow'lar
Depo göçü (migration): GitHub, GitLab ve Gogs'tan issue, PR ve wiki ile birlikte taşıma
Pull mirror ve push mirror ile dış depolarla otomatik eşitleme
Webhook'lar (Slack, Jenkins, Drone) ve token tabanlı API kullanımı
Paket kaydı (container, npm, Maven) ve Gitea Pages benzeri statik yayın seçenekleri
Gitea, Forgejo, GitLab CE ve GitHub karşılaştırması: kaynak tüketimi, özellik ve lisans değerlendirmesi

Modül 2

Gitea Operasyonu: Güvenlik, Yedekleme ve İzleme

Gömülü SSH sunucusu ile sistem sshd arasındaki seçim ve SSH_PORT / SSH_LISTEN_PORT ayarları
Güvenlik: kayıt kapatma, 2FA, parola politikası, fail2ban, INSTALL_LOCK ve SECRET_KEY koruması
Yedekleme: gitea dump, depo dizini + veritabanı + app.ini + custom dizini ve geri yükleme testi
Prometheus metrikleri (ENABLED=true), sağlık kontrolü ve log yapılandırması
Performans: veritabanı seçimi (SQLite/PostgreSQL), Redis önbelleği, kuyruk ayarları ve arama indeksleyici (Bleve/Elasticsearch)
Yükseltme planı, sürüm notları okuma ve Gitea/Forgejo arasındaki farklar

Modül 3

Altyapı Kodu için Sürüm Kontrolü

Infrastructure as Code depolarında Git: Terraform, Ansible ve Kubernetes manifest yapısı
Ortam dalı ile ortam dizini yaklaşımı (dev/stage/prod) ve değişiklik akışının karşılaştırılması
terraform.tfstate dosyasını Git'e koymama kuralı, remote state ve .gitignore örnekleri
Pull request ile terraform plan çıktısı, onay ve apply otomasyonu
GitOps: Argo CD veya Flux ile Git'in tek doğru kaynak (single source of truth) olması
Sırların yönetimi: SOPS, sealed-secrets ve Vault ile şifreli konfigürasyon commit etme

Modül 4

Sorun Giderme: Bisect, Blame ve Tarihçe Temizliği

git bisect start/good/bad ve bisect run ile hatayı getiren commit'in otomatik bulunması
git blame -L, -w, -C ve git log -L ile satır ve fonksiyon geçmişi takibi
Yanlışlıkla commit edilen parola veya API anahtarının git filter-repo ve BFG ile tarihçeden silinmesi
Büyük dosyaların depoyu şişirmesi: git count-objects -vH, git rev-list --objects ve temizlik
Detached HEAD durumu, nedeni ve yeni dala bağlayarak çıkış yolu
git fsck, git gc --prune ve bozuk depo onarım senaryoları

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

Gitea Kurulumu

Gitea'yı Docker ile kurup HTTPS, SSH ve kimlik doğrulamasıyla üretime hazırlarsınız.

🎯

Gitea İş Akışı

Gitea'da PR, dal koruma ve issue süreçlerini ekip için yapılandırırsınız.

🔧

Strateji Seçimi

Takımınıza uygun dallanma stratejisini seçip uygulayabilirsiniz.

🧩

Hook Otomasyonu

Commit ve push öncesi otomatik lint, test ve mesaj denetimi kurarsınız.

📦

Gitea Otomasyon

Gitea'ya act_runner ekleyip depoları mirror ve migration ile taşırsınız.

🚀

Gitea Operasyonu

Gitea sunucusunu yedekleme, izleme ve güvenlik sertleştirmesiyle işletirsiniz.

🔒

Altyapı ve Git

Altyapı kodunu PR tabanlı, denetlenebilir bir Git akışıyla yönetirsiniz.

📊

Hata Ayıklama

bisect ve blame ile regresyon kaynağını bulup sızan sırları tarihçeden temizlersiniz.

Kimler İçin Uygundur?

Sistem yöneticileri
DevOps mühendisleri
küçük
orta ölçekli ekipler ile verilerini kendi altyapısında tutmak isteyen yazılım kurumları için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Sistem yöneticileri, DevOps mühendisleri, küçük ve orta ölçekli ekipler ile verilerini kendi altyapısında tutmak isteyen yazılım kurumları için uygundur.

Gitea mi GitLab mı seçmeliyim?

Eğitimde kaynak tüketimi, özellik ve operasyon yükü açısından Gitea, Forgejo, GitLab CE ve GitHub karşılaştırılır; karar kriterleri verilir.

Gitea Actions GitHub Actions ile uyumlu mu?

Büyük ölçüde evet. act_runner kurulur ve GitHub Actions söz dizimine yakın workflow'lar çalıştırılır; uyumsuz noktalar da gösterilir.

Mevcut GitHub depolarımı taşıyabilir miyim?

Evet. Migration özelliğiyle issue, PR, wiki ve etiketlerle birlikte depo taşıma ve mirror kurulumu uygulanır.

Yedekleme ve geri yükleme işleniyor mu?

Evet. gitea dump, veritabanı ve depo dizini yedeği ile geri yükleme provası yapılır.

Sertifikalandırma

Bu eğitim Digital Vizyon Akademi Başarı Sertifikası ile tamamlanır.

Eğitim başında “Ön Test”, bitiminde “Son Test” uygulanarak gelişim ölçümlenir. Değerlendirme formunu dolduran katılımcılar sertifikalarını alır. Sertifikanızın geçerliliğini Sertifika Sorgulama sayfasından doğrulayabilirsiniz.

Örnek Sertifika

GİTEA: GITHUB VE GITLAB'IN YERİNİ ALAN KENDİ SUNUCUNUZDA BARINDIRILAN GIT FORGE EĞİTİMİ