Takip et

Laravel Uygulamanızı VPS’ye GitHub Actions ile Dağıtma

Laravel Uygulamanızı VPS’ye GitHub Actions ile Dağıtma

Merhaba! Bu rehberde, Laravel uygulamanızı bir VPS sunucusuna GitHub Actions kullanarak nasıl kolayca ve güvenli bir şekilde dağıtabileceğinizi adım adım açıklayacağım. GitHub Actions’ın otomasyon gücüyle, kodunuz GitHub’a her push edildiğinde uygulamanız otomatik olarak güncellenecektir. Bu, zamandan tasarruf etmenizi ve sürekli entegrasyon/sürekli dağıtım (CI/CD) sürecinizi optimize etmenizi sağlayacaktır. Hadi başlayalım!

Gereksinimler

Başlamadan önce, aşağıdaki gereksinimleri karşıladığınızdan emin olun:

  • Bir GitHub hesabı
  • Bir VPS (Sanal Özel Sunucu) – Benim önerim DigitalOcean veya Vultr gibi sağlayıcıları kullanmanızdır.
  • VPS’nizde SSH erişimi
  • Bir SSH anahtarı çifti (public ve private key)
  • VPS’nizde Composer ve gerekli PHP uzantılarının kurulu olması
  • Bir Laravel projesi

Adım 1: SSH Anahtarının Oluşturulması ve VPS’ye Eklenmesi

İlk adımınız, bir SSH anahtar çifti oluşturmak ve bu anahtar çiftinin public kısmını VPS’nizin yetkili anahtarlar dosyasına eklemektir. Bu, GitHub Actions’ın VPS’nize güvenli bir şekilde bağlanmasını sağlar. SSH anahtarlarını oluşturmak için terminalinizde aşağıdaki komutları kullanabilirsiniz:


ssh-keygen -t ed25519 -C "your_email@example.com"

Komutu çalıştırdıktan sonra, size bir dosya yolu sorulacaktır. Varsayılan yolu kullanabilirsiniz. Sonrasında ise bir parola girmeniz istenecektir. Parola girmemenizi öneririm. Daha sonra oluşturulan id_ed25519.pub dosyasının içeriğini kopyalayın. Bu public key’i VPS’nizin yetkili anahtarlar dosyasına eklemeniz gerekiyor. Genellikle bu dosyanın yolu /root/.ssh/authorized_keys’tir. Bu dosyayı düzenleyebilir ve public key’inizi içine ekleyebilirsiniz. Bu işlemin ardından VPS’nizle güvenli bir şekilde bağlantı kurabilirsiniz.

Adım 2: GitHub Deposunda SSH Anahtarını Saklama

Şimdi, oluşturduğunuz private key’i GitHub deponuzda güvenli bir şekilde saklamanız gerekmektedir. Bunun için GitHub’ın sunduğu “Secrets” özelliğini kullanacağız. Deponuzun “Settings” bölümüne gidin ve “Secrets” sekmesine tıklayın. Yeni bir secret oluşturun ve ismini “SSH_PRIVATE_KEY” olarak belirleyin. Daha sonra private key’inizin içeriğini bu alana yapıştırın. **Önemli:** Private key’inizi kimseyle paylaşmayın!

Adım 3: GitHub Actions Çalışma Akışının Oluşturulması

Son adımda, GitHub Actions ile otomatikleştirilmiş dağıtım sistemimizi oluşturacağız. Projenizin kök dizinine .github/workflows klasörü oluşturun ve içine deploy.yml adında bir dosya ekleyin. Bu dosyaya aşağıdaki kodu yapıştırın:


name: Deploy to VPS

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v3

      - name: Setup SSH
        uses: shimataro/ssh-action@v2
        with:
          host: ${{ secrets.VPS_HOST }}
          username: ${{ secrets.VPS_USERNAME }}
          key: ${{ secrets.SSH_PRIVATE_KEY }}
          known_hosts: ${{ secrets.KNOWN_HOSTS }}
          strictHostKeyChecking: false # Güvenlik için bunu production ortamında değiştirmeyi unutmayın

      - name: Deploy
        run: |
          ssh ${{ secrets.VPS_USERNAME }}@${{ secrets.VPS_HOST }} "cd /var/www/your-laravel-project && git pull origin main && composer install --no-dev --optimize-autoloader && php artisan migrate --force && php artisan route:cache && php artisan config:clear && php artisan view:clear && php artisan cache:clear"

Bu kodda, secrets.VPS_HOST, secrets.VPS_USERNAME ve secrets.KNOWN_HOSTS gibi değişkenlerin GitHub Secrets olarak tanımlanması gerekmektedir. Bu değerleri GitHub deponuzun “Secrets” bölümünde eklemelisiniz. your-laravel-project kısmını kendi projenizin adıyla değiştirmeyi unutmayın. Ayrıca, strictHostKeyChecking: false satırını güvenlik için production ortamınızda true olarak değiştirmelisiniz. Bu adımda dikkatli olmalı ve güvenlik açıklarını önlemek için gerekli önlemleri almalısınız.

Adım 4: Dağıtımın Test Edilmesi

Her şey doğru yapıldıysa, kodunuzu main dalına push ettiğinizde GitHub Actions otomatik olarak çalışacak ve uygulamanızı VPS’nize dağıtacaktır. Dağıtım sürecinin başarılı olup olmadığını kontrol etmek için GitHub Actions’ın loglarını inceleyebilirsiniz. İlk dağıtımda bazı hatalar alabilirsiniz. Bu hataları dikkatlice inceleyerek çözüm üretmelisiniz. Sisteminizin sağlığı için düzenli olarak güncellemeler yapmanız önemlidir. Bu, hem güvenlik hem de performans açısından kritiktir.

Ek İpuçları ve Kaynaklar

Daha güvenli bir dağıtım için, deploy adımını bir docker container içerisinde çalıştırmayı düşünebilirsiniz. Bu, sunucunuzun güvenliğini artıracaktır. Ayrıca, fatihsoysal.com sitesinden daha fazla Laravel ipuçları ve kaynaklara ulaşabilirsiniz.

Umarım bu rehber Laravel uygulamanızı VPS’ye dağıtmanızda yardımcı olmuştur. Herhangi bir sorunuz olursa bana ulaşmaktan çekinmeyin!

#Etiketler: Laravel, VPS, GitHub Actions, SSH, Dağıtım, Otomasyon, CI/CD, Güvenlik, Composer, PHP, DigitalOcean, Vultr

Yorumlar
İçeriği beğendiniz mi? Bir tartışma başlatın veya görüşlerinizi paylaşın.
Yorum Yaz

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

E-posta Bülteni
Yazılım Topluluğuna Katılın
En son güncellemeleri, yaratıcı ipuçlarını ve özel kaynakları doğrudan e-posta kutunuza alın. Tasarım ve inovasyonun geleceğini birlikte keşfedelim.