Bilgi Bankası

Hizmetlerin kullanım şekli ve çeşitli konularda karşılaşılan sorunlara
çözüm yolları içeren makalelere Bilgi Bankası ile ulaşabilirsiniz.

cPanel’de Git ile Deploy: .cpanel.yml Kullanımı

cPanel’de Git ile Deploy: .cpanel.yml Kullanımı

İçerik

    Git reposunu cPanel'e klonladığınızda dosyalar repositories klasöründe kalır, sitenizde görünmez. Dosyaları sitenizin klasörüne (örneğin public_html) kopyalamak için repoya bir .cpanel.yml dosyası eklersiniz ve Deploy HEAD Commit düğmesiyle çalıştırırsınız. Bu rehberde dosyayı nasıl yazacağınızı, deploy'u nasıl çalıştıracağınızı ve sonucu nasıl kontrol edeceğinizi göstereceğim. Sonda Laravel projesi için örnek bir yapılandırma da var.

    Repo kullanımı konusunda desteğe ihtiyacınız varsa public repo için cPanel'de Git ile Public Repo Klonlama ve Güncelleme rehberine bakabilirsiniz. Private repo rehberi de eklenecek.

    Gereksinimler

    • cPanel'e klonlanmış bir repo.
    • Sitede yayınlanacak dosyaların repodaki yerini bilmeniz. Örnek repoda dosyalar src klasöründedir; sizin reponuzda src olmak zorunda değildir. Dosyalarınız repo kökünde ya da başka bir klasördeyse komuttaki yolu buna göre yazarsınız.
    • Deploy edilecek klasörün (örnekte public_html) içindeki aynı adlı dosyaların üzerine yazılacağını bilmeniz. Önemli dosyalarınız varsa önce yedek alın.

    Adım 1 – .cpanel.yml dosyasını yazın

    Repo kökünde .cpanel.yml adlı bir dosya oluşturun. Dosya reponun kökünde olmalı, bir alt klasörde olmamalıdır. İçeriği:

    ---
    deployment:
      tasks:
        - export DEPLOYPATH=$HOME/public_html/
        - /bin/cp -R src/. $DEPLOYPATH
    • DEPLOYPATH: Dosyaların kopyalanacağı klasör. $HOME hesabınızın ev dizinidir, yani public_html klasörü $HOME/public_html/ olur.
    • /bin/cp -R src/. $DEPLOYPATH: Örnek reponun src klasörünün içindekileri hedefe kopyalar. Kendi reponuzda src yerine dosyalarınızın bulunduğu klasörü yazın. klasor/. yazımı klasörün kendisini değil, içindekileri kopyalar; örnekte index.html doğrudan public_html içine düşer.
    • tasks altındaki her satır bir komuttur ve sırayla çalışır. Komutların tam yolunu yazın (/bin/cp).

    Örnekteki repo şöyle görünür: index.html ve info.php dosyaları src klasöründe, .cpanel.yml ise reponun kökündedir. Komuttaki src bu yüzden yazıldı. Dosyalarınız kökte ya da başka bir klasördeyse komuttaki yolu repodaki yerlerine göre yazın.

    GitHub'da repo yapısı: src klasörü, .cpanel.yml ve README.md

    Ana alan adının dosyaları public_html klasöründedir. Ek alan adı ya da subdomain için DEPLOYPATH değerini o alan adının belge kökü yapın. Belge kökünü cPanel'de Domains sayfasında görebilirsiniz. Yolu panelde gördüğünüz değerle birebir yazın.

    Hedef public_html gibi web'den erişilen bir klasörse repo kökünü olduğu gibi kopyalamayın (cp -R .). .git klasörü ve .cpanel.yml dosyası da sitenize taşınır ve tarayıcıdan erişilebilir hale gelir. Yayına gidecek dosyalar için repoda ayrı bir klasör kullanın ya da kopyalanacak dosya ve klasörleri tek tek yazın.

    Adım 2 – Dosyayı repoya ekleyin ve çekin

    cPanel deploy için repodaki işlenmiş (commit'lenmiş) dosyaları kullanır. Bu yüzden .cpanel.yml dosyasını repoya commit'leyip GitHub'a gönderin. GitHub'da Add file > Create new file ile de oluşturabilirsiniz.

    Ardından cPanel'de Git™ Version Control sayfasında repo için Manage düğmesine tıklayın ve Pull or Deploy sekmesinde Update from Remote ile commit'i çekin. .cpanel.yml geldiğinde cPanel "The checked-out branch includes new deployable changes." bilgisini gösterir ve Deploy HEAD Commit düğmesi etkinleşir.

    Pull or Deploy sekmesinde etkin Deploy HEAD Commit düğmesi

    Düğme pasif kalıyorsa cPanel şu koşullardan birini karşılamıyor demektir: repoda geçerli bir .cpanel.yml bulunmalı ve çekilmiş branch'te işlenmemiş (uncommitted) değişiklik olmamalı. Sunucudaki klonda dosyayı elle değiştirirseniz düğme pasifleşir.

    Pull or Deploy sekmesinde

    Bu durumda değişikliği geri alın ya da repoya commit'leyip yeniden çekin.

    Adım 3 – Deploy edin

    Deploy HEAD Commit düğmesine tıklayın. Düğme deploy sürerken pasifleşir. cPanel işlem bitince şu mesajı verir: "The deployment that you triggered on … is complete."

    Deploy tamamlandı mesajı

    Kısa süre sonra Last Deployment Information bölümü dolar: deploy zamanı, deploy edilen commit'in kimliği (SHA), yazarı, tarihi ve mesajı.

    Last Deployment Information bölümü

    Deploy edilen commit, HEAD Commit ile aynı olmalıdır. Farklıysa son commit'i çekmediniz ya da deploy etmediniz demektir.

    Adım 4 – Siteyi kontrol edin

    Dosyalar public_html içinde görünmeli. Tarayıcınızda https://alanadiniz.com adresini açın; src klasöründeki index.html açılmalıdır. Örnekte src/info.php dosyası da kopyalandı ve https://alanadiniz.com/info.php adresinden çalıştı.

    GitHub'a commit göndermek siteyi güncellemez. Deploy otomatik çalışmaz; her değişiklikte aynı sırayı izlersiniz: GitHub'a commit gönderin, Update from Remote ile çekin, Deploy HEAD Commit ile yayına alın. Deploy HEAD Commit çekilmiş branch'in (Currently Checked-Out Branch) son commit'ini deploy eder.

    Sık görülen durumlar

    • Deploy HEAD Commit pasif: .cpanel.yml repoda yok, kökte değil ya da sunucudaki klonda işlenmemiş değişiklik var. Yukarıdaki iki koşulu kontrol edin.
    • Aynı adlı dosyaların üzerine yazılır: cp hedefte aynı adlı dosya varsa onu değiştirir. Hedef klasördeki başka dosyalara dokunmaz.
    • Repodan sildiğiniz dosya sitede kalabilir: cp komutu hedefteki dosyaları silmez. Repodan sildiğiniz dosyaları gerekirse File Manager'dan silmelisiniz.
    • Komut hata verirse: Görevler sırayla çalışır. Komutun tam yolunu ve dosya adlarını kontrol edin.

    Laravel projesi için örnek

    Laravel projeleri için Laravel Hosting hizmetini öneriyoruz. Laravel Hosting'de terminal erişimi vardır; composer install ve php artisan gibi komutları terminalden çalıştırabilirsiniz. Web hosting paketlerinde terminal erişimi yoktur. Bu yüzden web hostingde Composer ve artisan komutlarına ihtiyaç duyan bir Laravel projesini yönetmek zordur.

    Bu bölümdeki Laravel yapılandırması örnektir, tam olarak test edilmemiştir ve projenizin klasör yapısına göre farklılık gösterebilir. Örnek .cpanel.yml yalnızca dosyaları yerleştirir. Bu örneğe Composer ve artisan komutları dahil değildir; bunları terminalden çalıştırmanızı öneriyoruz. Laravel sürümünüzün gerektirdiği PHP sürümünü cPanel'de MultiPHP Manager ile seçin.

    Laravel'de web sunucusunun yalnızca public klasörünü görmesi gerekir. Projenin geri kalanı public_html dışında durmalıdır. Düzen şöyle olur:

    • $HOME/laravel-app/: Uygulamanın kendisi (app, bootstrap, config, routes, vendor vb.).
    • $HOME/public_html/: Yalnızca public klasörünün içeriği (index.php, .htaccess, build vb.).

    .cpanel.yml:

    ---
    deployment:
      tasks:
        - export APPPATH=$HOME/laravel-app/
        - export PUBLICPATH=$HOME/public_html/
        - /bin/mkdir -p $APPPATH
        - /bin/cp -R . $APPPATH
        - /bin/cp -R public/. $PUBLICPATH

    cp -R . repodaki her şeyi (kendi eklediğiniz klasörler dahil) laravel-app içine kopyalar. public_html dışında olduğu için .git ve .cpanel.yml gibi dosyalar sitenizden erişilemez. .env repoda yoksa kopyalama onu etkilemez. public klasörü laravel-app içine de kopyalanır; web kökü olarak yalnızca public_html kullanılır.

    Repoda vendor klasörü genellikle bulunmaz. Deploy'dan sonra Laravel Hosting'de terminalden $HOME/laravel-app klasörüne girip composer install --no-dev çalıştırın. Alternatif olarak vendor klasörünü repoya ekleyebilirsiniz; cp -R . onu da kopyalar, ama repo büyür. Composer kullanımını ve terminal erişimini bu rehberde anlatmadım.

    Bu yapılandırmada üç şeyi kendiniz yapmanız gerekir:

    1. public/index.php dosyasındaki yolları düzeltin. public klasörü laravel-app dışına taşındığı için index.php içindeki ../ ile başlayan yolları güncelleyin. Örneğin:
      require __DIR__.'/../laravel-app/vendor/autoload.php';
      $app = require_once __DIR__.'/../laravel-app/bootstrap/app.php';

      Laravel sürümünüze göre index.php içinde bu yollara ek olarak ../storage/framework/maintenance.php gibi başka ../ yolları da olabilir; hepsinin başına ../laravel-app/ yazın. Bunu her seferinde elle düzeltmek istemezseniz kendi reponuzda düzenleyin.

    2. .env dosyasını repoya koymayın. Parolalar ve anahtarlar repoda durmaz. $HOME/laravel-app/.env dosyasını File Manager'dan oluşturun. Repoda .env yoksa deploy bu dosyaya dokunmaz. Repoya koyarsanız cp -R . onu da kopyalar ve repoyu görebilen herkes parolalarınıza ulaşır.
    3. storage ve bootstrap/cache yazılabilir olsun. Laravel bu klasörlere yazar. Klasörlerin izinlerini File Manager'da kontrol edin.

    Alternatif: public_html'i symlink yapmak

    public içeriğini kopyalamak yerine public_html klasörünü public klasörüne işaret eden bir symlink'e çevirebilirsiniz. Bu yöntemde dikkat edilecek noktalar var:

    • public_html zaten bir klasör olarak varsa ln -s komutu onu symlink'e çevirmez; symlink klasörün içine kurulur ve public_html olduğu gibi kalır. İlk kez kurarken mevcut public_html klasörünü önceden File Manager'dan yeniden adlandırın (örneğin public_html_old). Klasörü silerseniz içindeki dosyalar da gider; yeniden adlandırırsanız korunur. Bu adım tek seferliktir, deploy'a yazmayın.
    • Deploy her çalıştığında komut yeniden çalışır. Symlink zaten varsa ln -s onu yenilemez, hedef klasörün içine ikinci bir symlink kurar. Bunu önlemek için aşağıdaki örnekte ln -sfn kullanıldı.
    • Web sunucusunun symlink'in gösterdiği klasöre ulaşabilmesi gerekir. repositories klasörünün izni 0700 olarak gelebilir; bu durumda siteniz 404 verir. Klasörün iznini 0711 yapmanız gerekir. Bu izin klasördeki dosyaların listelenmesine izin vermez, yalnızca klasörün içinden geçişe izin verir. Uygulamanızı ev dizininizde başka bir klasöre koyarsanız o klasörün izinlerini de kontrol edin.

    Symlink public klasörünün kendisine işaret ettiği için public içeriğini kopyalamanız ve index.php yollarını değiştirmeniz gerekmez; uygulama klasörü olduğu yerde kalır. Aşağıdaki örnekte uygulama önce $HOME/laravel-app klasörüne kopyalanır, symlink bu klasördeki public dizinini gösterir:

    ---
    deployment:
      tasks:
        - export APPPATH=$HOME/laravel-app/
        - /bin/mkdir -p $APPPATH
        - /bin/cp -R . $APPPATH
        - /bin/ln -sfn $APPPATH/public $HOME/public_html

    Symlink oluşturmayı (ln -s) ana alan adının public_html klasörü için test hesabında denedik.

    Bu deploy adımlarını sizin kendi projeniz ve hosting hesabınızın izin verdiği ölçüde denemeniz tavsiye edilir.

    Deploy bittiğinde sitenizi açıp Laravel'in karşılama sayfasını ya da kendi rotalarınızı kontrol edin. Hata alırsanız $HOME/laravel-app/storage/logs/laravel.log dosyasına bakın.

    Sonuç

    Last Deployment Information deploy ettiğiniz commit'in kimliğini gösteriyorsa ve sitenizde dosyalar görünüyorsa deploy tamamdır. Dosyalar sitede görünmüyorsa DEPLOYPATH değerini, kopyalanan klasörün yolunu ve .cpanel.yml dosyasının repo kökünde olduğunu kontrol edin. public_html için symlink kullandıysanız web sunucusunun symlink'in hedefine ulaşabildiğinden (klasör izinleri) emin olun.

    Deploy hata veriyorsa destek ekibimizden yardım isteyebilirsiniz; biletinize .cpanel.yml içeriğini, Last Deployment Information bölümünün ekran görüntüsünü ve hata mesajını ekleyin.

    Veridyen Destek

    Hizmetleriniz için 7/24 destek sunuyoruz.

    Veridyen Müşteri Hizmetleri