Takip et

GitHub Actions ve GitHub Pages ile Özel Site Kurulumu

GitHub Actions ve GitHub Pages ile Özel Site Kurulumu

Merhaba! Bu makalede, GitHub Actions ve GitHub Pages kullanarak kendi özelleştirilmiş web sitenizi nasıl oluşturacağınızı ve dağıtacağınızı adım adım açıklayacağım. Bu güçlü araçlar sayesinde kodunuzda değişiklik yaptığınız anda sitenizi otomatik olarak güncelleyebilirsiniz. Öncelikle, temel kavramları anlamak önemlidir. GitHub Actions, GitHub depolarınızda otomasyon iş akışları çalıştırmanıza olanak tanır. GitHub Pages ise, statik web sitelerini barındırmak için tasarlanmış ücretsiz bir GitHub hizmetidir. Bu iki hizmeti birleştirerek, geliştirme sürecinizi oldukça kolaylaştırabilirsiniz.

Gerekli Adımlar

İlk adım olarak, bir GitHub hesabınız olması gerekiyor. Daha sonra, projeniz için bir depo oluşturun. Bu depo, web sitenizin tüm kodlarını ve kaynaklarını içerecektir. Sonrasında, sitenizin statik dosyalarını oluşturmak için bir build süreci tanımalısınız. Bu süreç, HTML, CSS ve JavaScript dosyalarınız gibi statik varlıkların bir araya getirilmesini içerir. Bu noktada, çeşitli araçlar kullanabilirsiniz. Örneğin, Jekyll, Hugo veya sadece basit bir npm script’i kullanabilirsiniz. Benim kişisel tercihim, projenin yapısına göre değişmekle birlikte, genellikle npm script’leri kullanmaktır.

Örneğin, bir npm script’i şu şekilde olabilir:


{
  "scripts": {
    "build": "npm run build:css && npm run build:js"
  }
}

Bu, CSS ve JavaScript dosyalarını derlemek için ayrı komutların çalıştırılmasını sağlar. Bu komutlar, package.json dosyanızda tanımlanmalıdır. Ardından, GitHub Actions’ı kullanarak bir iş akışı (workflow) oluşturacaksınız. Bu iş akışı, kodunuzda bir değişiklik tespit edildiğinde otomatik olarak çalışacak ve sitenizi yeniden oluşturacaktır. İş akışı dosyanız .github/workflows dizininizde bulunmalıdır.

Bir örnek main.yml dosyası:


name: Deploy to GitHub Pages

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: 16
      - run: npm install
      - run: npm run build
      - uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./dist

Bu iş akışı, main dalına yapılan her itmeden sonra çalışır, projenizi oluşturur ve dist klasöründeki dosyaları GitHub Pages’e yayınlar. Bu adımları tamamladıktan sonra siteniz otomatik olarak dağıtılacaktır. Bu süreç, zamandan tasarruf etmenizi ve sürekli en güncel sürümü yayınlamanızı sağlar. Daha detaylı bilgi için GitHub Actions ve GitHub Pages dokümantasyonuna göz atabilirsiniz. GitHub Actions Dokümanları ve GitHub Pages Dokümanları bu konuda yardımcı olacaktır.

Kendi Deneyimlerim ve İpuçları

Kendi web sitemi fatihsoysal.com için bu yöntemi kullandım ve oldukça başarılı buldum. Özellikle büyük projelerde, sürekli entegrasyon ve sürekli dağıtım (CI/CD) süreçlerinin önemini daha iyi anlıyorsunuz. Bu yöntem, hataları erken yakalamanıza ve hızlı bir şekilde düzeltmenize yardımcı olur. Ayrıca, birden fazla geliştirici ile çalışırken işbirliğini büyük ölçüde kolaylaştırır. Bu sistemin dezavantajlarından birisi, hata ayıklamanın biraz daha zor olabilmesidir. Ancak, GitHub Actions’ın sağladığı loglar ve hata raporları ile bu sorunu aşmak genellikle mümkündür. Unutmayın, projenizin yapısına uygun bir build süreci oluşturmak çok önemlidir. Bu, sitenizin performansını ve kararlılığını doğrudan etkiler.

Sonuç

GitHub Actions ve GitHub Pages ile özelleştirilmiş bir web sitesi oluşturmak ve dağıtmak, pek çok avantaj sunan oldukça verimli bir yöntemdir. Bu makalede anlatılan adımları izleyerek, kendi statik sitenizi otomatikleştirilmiş bir şekilde yönetebilirsiniz. Başlangıçta biraz zorlayıcı gelse de, alacağınız sonuçlar ve zamandan tasarruf ettiğiniz zaman bu çabayı fazlasıyla karşılayacaktır. Umarım bu makale faydalı olmuştur. Sorularınız veya eklemek istediğiniz noktalar varsa, lütfen yorumlarda belirtin.

#Etiketler: GitHub Actions, GitHub Pages, web sitesi kurulumu, otomatik dağıtım, static site, web geliştirme, Fatih Soysal, CI/CD, Jekyll, Hugo, npm, build process


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.