GitLab Notları ve İpuçları

İçindekiler

Hesap Yönetimi
Proje Yönetimi
Depo İşlemleri
Sorunlar ve Birleştirme İstekleri
CI/CD
GitLab Pages
GitLab Runner
İşbirliği Özellikleri
GitLab Güvenliği
GitLab API
En İyi Uygulamalar

Hesap Yönetimi

Yeni bir hesap oluşturma

https://gitlab.com adresine gidin
"Register now" (Şimdi Kaydol) düğmesine tıklayın
Bilgilerinizi doldurun ve "Register" (Kaydol) düğmesine tıklayın

İki faktörlü kimlik doğrulamayı (2FA) etkinleştirme

Ayarlar > Hesap bölümüne gidin
"Two-Factor Authentication" (İki Faktörlü Kimlik Doğrulama) bölümüne kaydırın
"Enable two-factor authentication" (İki faktörlü kimlik doğrulamayı etkinleştir) düğmesine tıklayın

SSH anahtarı ekleme

Bir SSH anahtar çifti oluşturun

ssh-keygen -t ed25519 -C "e-posta_adresiniz@ornek.com"

Ayarlar > SSH Anahtarları bölümüne gidin
Genel anahtarınızı yapıştırın ve "Add key" (Anahtar ekle) düğmesine tıklayın

Proje Yönetimi

Yeni bir proje oluşturma

Kontrol panelinizde "New project" (Yeni proje) düğmesine tıklayın
"Create blank project" (Boş proje oluştur) seçeneğini seçin
Proje ayrıntılarını doldurun ve "Create project" (Proje oluştur) düğmesine tıklayın

Bir projeyi içe aktarma

Kontrol panelinizde "New project" (Yeni proje) düğmesine tıklayın
"Import project" (Projeyi içe aktar) seçeneğini seçin
Kaynağı seçin (örn. GitHub, Bitbucket) ve yönergeleri izleyin

Grup oluşturma

Üst menüde "Groups" (Gruplar) seçeneğine tıklayın
"New group" (Yeni grup) düğmesine tıklayın
Grup ayrıntılarını doldurun ve "Create group" (Grup oluştur) düğmesine tıklayın

Depo İşlemleri

Bir depoyu klonlama

git clone https://gitlab.com/kullaniciadi/depo.git

Yeni bir dal oluşturma

git checkout -b yeni-dal-adi

Değişiklikleri GitLab'e gönderme

git push origin dal-adi

Komut satırından birleştirme isteği oluşturma

git push -u origin dal-adi
gitlab mr create --source-branch dal-adi --target-branch main

Sorunlar ve Birleştirme İstekleri

Yeni bir sorun oluşturma

Projenizin "Issues" (Sorunlar) sayfasına gidin
"New issue" (Yeni sorun) düğmesine tıklayın
Başlık ve açıklamayı doldurun
"Submit issue" (Sorunu gönder) düğmesine tıklayın

Birleştirme isteği oluşturma

Projenizin "Merge Requests" (Birleştirme İstekleri) sayfasına gidin
"New merge request" (Yeni birleştirme isteği) düğmesine tıklayın
Kaynak ve hedef dalları seçin
Başlık ve açıklamayı doldurun
"Submit merge request" (Birleştirme isteğini gönder) düğmesine tıklayın

Birleştirme isteği inceleme

"Merge Requests" (Birleştirme İstekleri) sayfasına gidin
İncelemek istediğiniz birleştirme isteğine tıklayın
Yorum yapın, onaylayın veya değişiklik isteyin

Birleştirme çakışmalarını çözme

Birleştirme isteğinde "Resolve conflicts" (Çakışmaları çöz) düğmesine tıklayın
Çakışan dosyaları düzenleyin
Değişiklikleri aşamalayın ve taahhüt edin
Çakışmaları çözmek için değişiklikleri gönderin

CI/CD

CI/CD ayarlama

Depo kök dizininizde bir .gitlab-ci.yml dosyası oluşturun
Pipeline aşamalarınızı ve işlerinizi tanımlayın

Örnek .gitlab-ci.yml:

stages:
  - build
  - test
  - deploy

build_job:
  stage: build
  script:
    - echo "Proje derleniyor..."

test_job:
  stage: test
  script:
    - echo "Testler çalıştırılıyor..."

deploy_job:
  stage: deploy
  script:
    - echo "Üretime dağıtılıyor..."
  only:
    - main

Pipeline sonuçlarını görüntüleme

Projenizin "CI/CD > Pipelines" sayfasına gidin
Ayrıntılarını ve iş günlüklerini görmek için bir pipeline'a tıklayın

GitLab Pages

GitLab Pages'i etkinleştirme

Deponuzda bir .gitlab-ci.yml dosyası oluşturun
Statik sitenizi oluşturan bir iş ekleyin

Jekyll sitesi için örnek:

pages:
  stage: deploy
  script:
    - bundle exec jekyll build -d public
  artifacts:
    paths:
      - public
  only:
    - main

GitLab Pages sitenize erişme

Siteniz https://kullaniciadi.gitlab.io/proje-adi adresinde kullanılabilir olacak

GitLab Runner

GitLab Runner'ı yükleme

https://docs.gitlab.com/runner/install/ adresindeki talimatları izleyin

Bir runner'ı kaydetme

gitlab-runner register

Runner'ı başlatma

gitlab-runner start

İşbirliği Özellikleri

Proje üyeleri ekleme

Projenizin "Settings > Members" (Ayarlar > Üyeler) bölümüne gidin
"Invite members" (Üye davet et) düğmesine tıklayın
Kullanıcının adını veya e-postasını girin ve rolünü seçin

Takım oluşturma

Grubunuzun sayfasına gidin
"Subgroups and projects" (Alt gruplar ve projeler) seçeneğine tıklayın
Bir takım oluşturmak için "New subgroup" (Yeni alt grup) düğmesine tıklayın

Kod inceleme ayarları

Projenizin "Settings > Merge requests" (Ayarlar > Birleştirme istekleri) bölümüne gidin
Onay kurallarını ve diğer birleştirme isteği ayarlarını yapılandırın

GitLab Güvenliği

Bağımlılık Taramasını Etkinleştirme

"Security & Compliance > Configuration" (Güvenlik ve Uyumluluk > Yapılandırma) bölümüne gidin
"Dependency Scanning" (Bağımlılık Taraması) seçeneğini etkinleştirin

Konteyner Taramasını Ayarlama

"Security & Compliance > Configuration" (Güvenlik ve Uyumluluk > Yapılandırma) bölümüne gidin
"Container Scanning" (Konteyner Taraması) seçeneğini etkinleştirin

Güvenlik politikası oluşturma

Deponuzda bir SECURITY.md dosyası oluşturun
Güvenlik politikanızı ve güvenlik açığı bildirme sürecini tanımlayın

GitLab API

Kişisel erişim belirteci oluşturma

Ayarlar > Erişim Belirteçleri bölümüne gidin
Gerekli kapsamlara sahip yeni bir belirteç oluşturun

API isteği yapma

Curl kullanarak:

curl --header "PRIVATE-TOKEN: erişim_belirteciniz" "https://gitlab.com/api/v4/projects"

Python requests kullanarak:

import requests

url = "https://gitlab.com/api/v4/projects"
headers = {"PRIVATE-TOKEN": "erişim_belirteciniz"}
response = requests.get(url, headers=headers)
print(response.json())

En İyi Uygulamalar

Anlamlı taahhüt mesajları kullanın: Yapılan değişiklikleri açıklayan net, özlü taahhüt mesajları yazın.
Birleştirme isteği şablonlarını kullanın: Tutarlı ve kapsamlı açıklamalar sağlamak için birleştirme istekleri için şablonlar oluşturun.
GitLab CI/CD'den yararlanın: GitLab CI/CD pipeline'larını kullanarak test, derleme ve dağıtım süreçlerinizi otomatikleştirin.
Proje yönetimi için GitLab Sorunlarını kullanın: Sorunlar, etiketler, kilometre taşları ve panolar kullanarak işinizi organize edin.
Kod inceleme yönergeleri uygulayın: Ekibiniz içinde kod inceleme en iyi uygulamalarını belirleyin ve takip edin.
GitLab Wiki'yi kullanın: Projenizi GitLab'in yerleşik Wiki özelliğini kullanarak kapsamlı bir şekilde belgeleyin.
Düzenli yedeklemeler: Verilerinizin güvende ve kurtarılabilir olmasını sağlamak için GitLab'in yedekleme özelliklerini kullanın.
GitLab örneğinizi izleyin: Kendi sunucunuzda barındırıyorsanız, örneğinizin sağlığını takip etmek için GitLab'in izleme araçlarını kullanın.
Birleştirme isteği onaylarını kullanın: Kod kalitesini ve güvenliğini sağlamak için onay kuralları belirleyin.
GitLab'in yerleşik güvenlik özelliklerinden yararlanın: Projenizin güvenliğini artırmak için SAST, bağımlılık taraması ve konteyner taraması gibi özellikleri kullanın.