cPanel Git ile Otomatik Yayınlama Nasıl Kurulur (.cpanel.yml)

Son doğrulama: Ekim 2026 · cPanel 136 test hesabında denendi

Hızlı çözüm

cPanel Git deployment, GitHub ya da GitLab’deki kodunuzu panelden tek tıkla sitenizin klasörüne kopyalamanızı sağlar. Paylaşımlı hostingte SSH olmadığı için doğru yöntem çekme (pull) dağıtımıdır:

  1. Deponuzun kök dizinine dağıtım komutlarını içeren bir .cpanel.yml dosyası ekleyin.
  2. cPanel → Dosyalar → Git™ Version Control ekranında Oluştur ile uzak depoyu klonlayın.
  3. Her güncellemede Yönet → Pull or Deploy sekmesinde Update from Remote‘a basın.
  4. Ardından Deploy HEAD Commit ile dosyaları sitenin klasörüne kopyalayın.
Panel cPanel (Git™ Version Control)
Sistem Paylaşımlı hosting
Yetki cPanel kullanıcısı; GitHub ya da GitLab’de depo erişimi
Narhost ürünü Web Hosting

Başlamadan önce

  • Deponuzun herkese açık (public) olup olmadığını öğrenin; özel depolar için ek erişim ayarı gerekir.
  • Sitenin hangi klasörde yayınlanacağını belirleyin (ana alan adı için public_html).
  • Hedef klasördeki mevcut dosyaların yedeğini alın; dağıtım aynı adlı dosyaların üzerine yazar.

cPanel Git deployment nasıl çalışır

cPanel’in Git dağıtım rehberi iki yöntem tanımlar. İtme (push) dağıtımında kodu bilgisayarınızdan doğrudan cPanel’deki depoya gönderirsiniz ve sunucu dağıtımı kendiliğinden yapar; bu yöntem SSH bağlantısı ister. Çekme (pull) dağıtımında kodu GitHub gibi bir uzak depoya gönderirsiniz, panelde Update from Remote ile değişiklikleri cPanel’deki kopyaya alırsınız ve Deploy HEAD Commit ile yayına çıkarırsınız. Paylaşımlı paketlerde SSH erişimi bulunmadığı için ikinci yöntem kullanılır.

Dağıtımın ne yapacağını deponun kök dizinindeki .cpanel.yml dosyası belirler. Rehbere göre dağıtım için üç şart vardır: kök dizinde geçerli bir .cpanel.yml dosyası, en az bir dal ve kaydedilmemiş değişiklik içermeyen temiz bir çalışma ağacı. Şartlardan biri eksikse panel dağıtım bilgisini göstermez ve düğmeyi kapatır.

cpanel git deployment akış şeması — .cpanel.yml, klonlama, Update from Remote ve Deploy HEAD Commit
Paylaşımlı hostingte dağıtım çekme yöntemiyle, iki düğmeyle yapılır.

Adım adım cPanel Git deployment kurulumu

  1. .cpanel.yml dosyasını yazın. Bilgisayarınızda deponun kök dizinine aşağıdaki dosyayı ekleyin, kullanici yerine cPanel kullanıcı adınızı yazın ve depoya gönderin:
    ---
    deployment:
      tasks:
        - export DEPLOYPATH=/home/kullanici/public_html/
        - /bin/cp index.html $DEPLOYPATH
        - /bin/cp -R css $DEPLOYPATH
        - /bin/cp -R img $DEPLOYPATH

    Her satır sırayla çalışan bir komuttur. Bütün dosyaları kopyalamak için yıldız (*) kullanmayın; rehber bunun .git klasörünü de yayına taşıyabileceği konusunda uyarır.

  2. Depoyu klonlayın.cPanel → Dosyalar → Git™ Version Control ekranını açın ve Oluştur‘a basın.
    cpanel git deployment için Git Version Control ekranında klonlanmış depo ve Yönet düğmesi
    Klonlanan depo listede görünür; dağıtım ayarları Yönet düğmesinden açılır.

    Açılan formda klonlama seçeneğini açık bırakın ve uzak deponun https:// adresini yazın. Depo yolu (Repository Path) için yayın klasöründen ayrı bir yol seçin (örneğin repositories/site), ardından formu kaydedin.

    cPanel Git Version Control Pull or Deploy sekmesi — Update from Remote ve Deploy HEAD Commit
    Pull or Deploy sekmesinde güncelleme ve dağıtım düğmeleri yan yana durur.

    Beklenen sonuç: depo listede görünür. Depoyu doğrudan public_html içine klonlamayın; dağıtım, kopyayı yayın klasörüne ayrı adımda taşır.

  3. Güncellemeleri alın. Listede deponun yanındaki Yönet düğmesine tıklayın, Pull or Deploy sekmesinde Update from Remote‘a basın.
  4. Yayına çıkarın. Aynı sekmede Deploy HEAD Commit‘e basın.

    Beklenen sonuç: sekmede son dağıtımın tarihi ve işlenen commit görünür; .cpanel.yml‘deki komutlar çalışır ve dosyalar public_html‘e kopyalanır.

Dikkat

Dağıtım komutları hedef klasördeki aynı adlı dosyaların üzerine yazar ve geri alınamaz. İlk dağıtımdan önce public_html‘in yedeğini alın; veritabanı kullanan sitelerde yapılandırma dosyalarını (örneğin wp-config.php) depoya koymayın ve kopyalama listesine eklemeyin.

Doğrulama

Sonuç

Sitenizi tarayıcıda açıp son commit’teki değişikliği görüyorsanız ve Pull or Deploy sekmesindeki son dağıtım bilgisi aynı commit’i gösteriyorsa cPanel Git deployment çalışıyordur. Dosyaların geldiğini Dosya Yöneticisi’nde değiştirilme tarihlerinden de kontrol edebilirsiniz.

Hâlâ çözülmediyse

  • Deploy HEAD Commit düğmesi soluk. Sekmedeki The system cannot deploy kutusu eksik şartı yazar: deponun kökünde geçerli bir .cpanel.yml yoktur ya da çalışma ağacında kaydedilmemiş değişiklik vardır. Dosyayı düzeltip gönderin, ardından Update from Remote ile yeniden alın.
  • Özel depo klonlanmıyor. Özel depolara erişim SSH anahtarı ister; cPanel’in özel depo rehberi bu ayarı anlatır. Paketinizde SSH erişimi yoksa destek talebi açın.
  • Git ekranının genel kullanımı. Depo oluşturma ve yönetme cPanel’de Git Version Control kullanımı kartında.

Narhost desteği

Talebe şunları ekleyin: alan adı, deponun adresi (herkese açık mı özel mi), .cpanel.yml dosyanızın içeriği ve Pull or Deploy sekmesindeki hata iletisi.

Destek talebi aç

Sıkça sorulan sorular

Her commit’te dağıtım kendiliğinden yapılır mı?

Çekme yönteminde hayır; Update from Remote ve Deploy HEAD Commit düğmelerine siz basarsınız. Kendiliğinden dağıtım itme yöntemiyle olur ve SSH bağlantısı gerektirir. Bu sayede her değişikliği bilinçli olarak yayına alırsınız. Paylaşımlı pakette kabuk erişimi olmadığı için panel cPanel deposunun klon adreslerini de göstermez.

WordPress sitesini Git ile yayınlayabilir miyim?

Tema ya da eklenti klasörünü depoda tutup yalnız o klasörü dağıtabilirsiniz. Veritabanı ve yüklenen görseller Git ile taşınmaz; WordPress çekirdeğini ve wp-config.php dosyasını depoya koymamak daha güvenlidir.

Dağıtımı geri alabilir miyim?

Panelde tek tuşla geri alma yoktur. Önceki commit’e dönen yeni bir commit gönderip yeniden dağıtım yapmak ya da dağıtımdan önce aldığınız yedeği geri yüklemek gerekir.

Bu makale sorununuzu çözdü mü?

Çözemediniz mi?

Teknik ekibimiz sunucu tarafındaki ayarları sizin için kontrol edebilir. Destek talebinizde alan adınızı ve aldığınız hata metnini paylaşmanız süreci hızlandırır.

Etiketler: gitdeployment

İlgili çözümler