Git ile Sunucuya Deploy: Otomatik Yayınlama Rehberi

1. Adım: Ayrı bir deploy kullanıcısı

Uygulamayı ve deploy sürecini root yerine ayrı bir kullanıcıyla çalıştırın. Sunucunuza SSH ile bağlandıktan sonra:

sudo adduser deploy
sudo mkdir -p /var/www/proje
sudo chown deploy:deploy /var/www/proje
sudo su - deploy

2. Adım: Deploy anahtarı

Sunucunun depodan kod çekebilmesi için yalnızca o depoya erişebilen bir deploy anahtarı oluşturun:

ssh-keygen -t ed25519 -f ~/.ssh/deploy_key -N "" -C "deploy@sunucu"
cat ~/.ssh/deploy_key.pub

Açık anahtarı GitHub'da deponun Settings → Deploy keys → Add deploy key bölümüne ekleyin ve yazma iznini kapalı bırakın. Ardından SSH'a bu anahtarı GitHub için kullanmasını söyleyin; ~/.ssh/config dosyasına ekleyin:

Host github.com
    IdentityFile ~/.ssh/deploy_key
    IdentitiesOnly yes

Depoyu sunucuya klonlayın:

git clone git@github.com:kullanici/proje.git /var/www/proje

Deploy anahtarı yalnızca tek bir depoyu okuyabildiği için sunucu ele geçirilse bile saldırgan diğer depolarınıza ve hesabınıza ulaşamaz.

3. Adım: Yayınlama betiği

Her yayında çalışacak adımları bir betikte toplayın, örneğin /home/deploy/deploy.sh. Bir Node.js uygulaması için:

#!/bin/bash
set -euo pipefail

cd /var/www/proje
git fetch origin
git reset --hard origin/main

npm ci
npm run build

pm2 reload proje
echo "Yayınlandı: $(git log -1 --oneline)"

• set -euo pipefail: Herhangi bir adım başarısız olursa betik durur; yarım kalmış bir derleme yayına alınmaz.
• git reset --hard origin/main: Sunucudaki kodu deponun ana dalıyla birebir eşitler. Sunucuda elle yapılan değişiklikler silinir; kodu yalnızca depo üzerinden değiştirme alışkanlığı bu yüzden önemlidir.
• npm ci: package-lock.json dosyasındaki sürümleri birebir kurar.
• pm2 reload: Uygulamayı kesintisiz yeniden başlatır. pm2 ve systemd ile uygulama çalıştırmayı Discord botu 7/24 aktif tutma rehberimizde anlattık.

PHP projelerinde npm satırlarının yerine composer install --no-dev --optimize-autoloader, Laravel'de ek olarak php artisan migrate --force ve önbellek komutları gelir. Betiği çalıştırılabilir yapın:

chmod +x ~/deploy.sh

Artık bir yayın için sunucuda ~/deploy.sh çalıştırmanız yeterlidir.

4. Adım: GitHub Actions ile otomatik deploy

Bir adım ileri giderek ana dala her gönderimde betiğin kendiliğinden çalışmasını sağlayabilirsiniz.

1. Actions için ayrı bir SSH anahtarı oluşturun (kendi bilgisayarınızda):

   ssh-keygen -t ed25519 -f actions_key -N "" -C "github-actions"
   

   
   actions_key.pub içeriğini sunucuda deploy kullanıcısının ~/.ssh/authorized_keys dosyasına ekleyin.
2. GitHub'da gizli değişkenleri tanımlayın. Deponun Settings → Secrets and variables → Actions bölümüne DEPLOY_SSH_KEY (actions_key dosyasının içeriği) ve SERVER_HOST (sunucunuzun IP adresi) ekleyin.
3. İş akışı dosyasını oluşturun: .github/workflows/deploy.yml

   name: Deploy
   on:
       push:
           branches: [main]
   
   jobs:
       deploy:
           runs-on: ubuntu-latest
           steps:
               - name: Sunucuya yayınla
                 env:
                     SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
                     HOST: ${{ secrets.SERVER_HOST }}
                 run: |
                     mkdir -p ~/.ssh
                     echo "$SSH_KEY" > ~/.ssh/id_ed25519
                     chmod 600 ~/.ssh/id_ed25519
                     ssh-keyscan -H "$HOST" >> ~/.ssh/known_hosts
                     ssh deploy@"$HOST" '~/deploy.sh'
   

Bundan sonra main dalına her gönderimde GitHub, sunucunuza bağlanıp yayınlama betiğini çalıştırır. Sonucu deponun Actions sekmesinden izleyebilirsiniz. İsterseniz deploy adımından önce testlerinizi çalıştıran bir adım ekleyerek yalnızca testleri geçen kodun yayınlanmasını sağlayabilirsiniz.

Güvenlik önerileri

• Gizli bilgileri depoya koymayın. .env dosyasını .gitignore'a ekleyin, sunucuda elle oluşturun ve depoda yalnızca değerleri boş bir .env.example tutun.
• Deploy kullanıcısının yetkilerini sınırlayın. Kullanıcının sudo ile yalnızca uygulama servisini yeniden başlatabilmesi gerekiyorsa sudo visudo ile tek bir komuta izin verin:

  deploy ALL=(root) NOPASSWD: /bin/systemctl restart proje
  

• Actions anahtarını yalnızca deploy için kullanın. Bu anahtar sızarsa authorized_keys dosyasından silmeniz yeterli olur.
• SSH'ı koruyun. Şifreli girişi kapatın ve otomatik saldırılara karşı Fail2ban kurun.

Geri alma

Hatalı bir sürüm yayınladıysanız sunucuda önceki commit'e dönün:

cd /var/www/proje
git log --oneline -5
git reset --hard <onceki-commit>
npm ci && npm run build && pm2 reload proje

Daha temiz bir yol, hatalı commit'i kendi bilgisayarınızda git revert ile geri alıp ana dala göndermektir; otomatik deploy süreci düzeltilmiş sürümü kendisi yayınlar ve depo geçmişi sunucuyla tutarlı kalır. Veritabanı değişikliği (migration) içeren yayınlardan önce veritabanının yedeğini almayı alışkanlık hâline getirin; kodu geri almak veritabanını geri almaz.

Git ile deploy için Nodesty sunucuları

Nodesty AMD Ryzen 9 9950X VDS paketleri yüksek tek çekirdek hızıyla derleme adımlarını hızlandırır ve uygulamanıza düşük cevap süresi sağlar; AMD EPYC 7763 VDS paketleri ise aynı sunucuda birden fazla uygulama ve veritabanı çalıştırmak için bol RAM sunar. Tam root erişimiyle Git, Node.js, PHP ve Docker'ı dilediğiniz gibi kurabilir, NVMe disk ve 7 gün saklanan ücretsiz günlük yedeklemeyle projelerinizi güvende tutabilirsiniz.