Dağıtım

Deploy sekmesinde Git deposu URL'si, dal ve deploy yolunu yapılandırın.

Dağıtım yapılandırması

Git ile dağıtım, Git deposundan yeniden dağıtım ve webhook akışıdır. Herne’nin kayıtlı bir Git dalını isteğe bağlı olarak veya imzalı site webhook’u üzerinden çekmesi gerektiğinde kullanın.

Siteler → Dağıtım → Git ile dağıtım'e git ve doldur:

  • Depo URL’si — HTTPS veya SSH adresi (ör. git@github.com:user/repo.git)
  • Dal — dağıtımın yapılacağı dal (varsayılan: main)
  • Dağıtım yolu — sitenin kökü /var/www/example.com/web_root olarak sabittir. Yalnızca /current gibi güvenli bir yol eki ekleyebilirsiniz.

Dağıtım yolu geçerli sitenin web_root dizini dışına çıkamaz. .. gibi üst dizine çıkan yol bileşenleri reddedilir.

Site kökü modları

Yeni siteler oluştururken açık bir kök modu seçer. Boş / dağıtım hedefi ve Publisher ile yönetilen uygulama sadece /var/www/example.com/web_root ile başlar; Herne bu modlar için boş bir public/ dizini oluşturmaz. Laravel uygulaması ve Statik site web_root/public ile başlar çünkü başlangıç çalışma süreleri halka açık bir belge köküne ihtiyaç duyar.

Mevcut siteler kayıtlı document_root ayarlarını korur. Çalışma ortamını uygulayan işlem, kök modlarından önce oluşturulmuş kayıtlardaki eski genel belge köklerini hazırlamaya devam eder.

Çalışma ortamı kullanıcısı ve doğrulama

Uygulamalar mevcut sitenin proje yolunun içinde yürütülür. Mevcut checkouts'ların origin uzakları fetch/reset'ten önce kaydedilmiş depo URL'sine senkronize edilir, bu da eski depo URL'lerinin sessizce eski kodu uygulamasını engeller.

İşletim zamanına etki eden ayarlamalar uygulandıktan sonra, Herne yeniden yüklenmeden önce üretilen Nginx/işletim zamanı konfigürasyonunu doğrular. Eğer doğrulama başarısız olursa, aşamalı değişiklik bozuk bir aktif konfigürasyon bırakmak yerine geri döndürülür.

Derleme adımları

Yönetilen uygulamanın ihtiyacı olan adımları etkinleştir. Onlar git pull' den sonra bu sırayla çalışırlar:

  1. composer install --no-dev --optimize-autoloader
  2. npm ci && npm run build yalnızca kendi önyüz inşa boru hattını gönderen yönetilen uygulamalar için
  3. php artisan migrate --force
  4. php artisan config:cache && php artisan route:cache && php artisan view:cache

Herne Panel statik dosyalar kullanır. Vite, Tailwind, npm, kilit dosyaları, public/build veya public/hot kullanmaz. İsteğe bağlı npm kutusu yalnızca dağıttığınız site için geçerlidir. Panelin çalışma ortamına ve sürüm paketine uygulanmaz.

Özel depolar (dağıtım anahtarları)

Özel depolar için bir Deploy Key oluşturun ve GitHub / GitLab'a salt okunur deploy anahtarı olarak ekleyin.

  1. Siteler → Dağıtım → Git ile dağıtıme gidin ve Dağıtım anahtarı oluşture tıklayın.
  2. Ekrandaki açık anahtarı kopyalayın.
  3. GitHub'da: Depo → Ayarlar → Dağıtım anahtarları → Dağıtım anahtarı ekle. Anahtarı yapıştırın. Sadece okuma erişimi yeterlidir.
  4. GitLab’da Depo → Ayarlar → Depo → Dağıtım anahtarları bölümünü açın.

Kurulum anahtarı storage/app/deploy-keys/ de depolanan bir ed25519 anahtar çiftidir. Panelde sadece açık anahtar gösterilir.

Dağıtımı başlatma

En son kodu çekmek ve yapılandırılmış adımları çalıştırmak için Deploy Now'a tıklayın. Siteler → Dağıtım → Git ile dağıtım ye gidin ve Şimdi Yükle düğmesine tıklayın.

Dağıtım günlükleri

Tüm deploy işlemleri kaydedilir — tam çıktıyı görmek için Son Deploy'lar listesindeki herhangi bir girdiye tıklayın. Her bir log girişi, tüm shell çıkışını, çıkış kodunu ve dağıtımın başarılı olup olmadığını gösterir.

Publisher ile dağıtım

Siteler → Dağıtım → Publisher ile dağıtım ekranıyla GitHub kullanmadan Publisher üzerinden dağıtım yapabilirsiniz. Publisher sunucusu, ürünü ve kanalı site bazında kaydedilebilir. Herne varsayılan bir ürün seçmez. Sunucusu kayıtlı olmayan siteler, güncel standart sürümlerin resmi Publisher sunucusu olan https://publisher.webblocksui.com adresini kullanır. Farklı bir sunucu için özel bir HTTPS adresi girin.

Ürünü oluşturun ve Üretici ürün yönetiminde bir Üretici Ürün Anahtarı oluşturun, sonra bu anahtarı Herne dağıtım formuna yapıştırın. Herne anahtarı Üretici meta veri/artefakt talepleri için kullanır. Yapıştırılan anahtarlar varsayılan olarak kalıcı değildir, ancak site başına şifrelenmiş olarak kaydedilebilir, değiştirilebilir veya temizlenebilir.

Herne, sürüm meta verileri ve paket istekleri için anahtarı seçilen Publisher sunucusuna gönderir. ZIP paketini indirir, SHA-256 sağlama toplamını doğrular, paketi bir hazırlık dizinine açar ve ardından seçilen güvenlik profilini uygular. Laravel paketleri sitenin dağıtım yoluna laravel_app ile kurulur. Statik paketler yalnızca Herne Statik sitelerinin kökleri için static_site kullanır ve sitenin gerçek genel erişim kök dizinine kurulur. Kökte yalnızca index.html, robots.txt, assets/**, games/**, site/**, favicon.ico, manifest.json ve version.json girdilerine izin verilir. Statik varlık dizinlerinde engelleme listesine dayalı bir profil kullanılır. Bu profille games/*/main.dart.js, games/*/icons/**, games/*/assets/shaders/*.frag, games/*/assets/packages/** ve games/*/canvaskit/** gibi Flutter web çıktıları, site/webblocks-play/css/site.css gibi ürün varlığı yolları ve NOTICES dosyaları dağıtılabilir. Gizli yollar, dizin dışına çıkma girişimleri, yedek ve geçici dosyalar, sunucu yapılandırmaları, yürütülebilir ve sunucu tarafı dosyalar engellenir. Statik güvenli güncellemede paket bir index.html içermiyorsa genel erişim kök dizinindeki mevcut dosya hazırlık dizinine alınarak korunur. Hazırlık dizininde veya mevcut kök dizinde bir indeks dosyası bulunmazsa dağıtım uygulanmadan iptal edilir.

  • Hedef boşsa Publisher ile dağıtım ilk kurulumu yapar.
  • Paket bir genel belge kökü içeriyorsa Publisher ile yapılan ilk dağıtım web_root/public dizinine geçer ve Laravel veya statik site çalışma ortamını uygular.
  • Mevcut bir Laravel uygulamasında Publisher ile dağıtım açık onay ister, değişen dosyaların anlık görüntüsünü alır ve güvenli bir güncelleme yapar.
  • Mevcut bir statik sitede Publisher ile dağıtım, açık static-site/static_site üst verilerini kabul eder. Laravel engeli yerine değiştirme uyarısı gösterir, kabul onayı ister, yeni genel belge kökünü hazırlar ve uygulamadan sonra index.html öğesini doğrular.
  • Laravel uygulamalarına benzemeyen boş olmayan hedefler güvenlik için engellenir.
  • Ürün anahtarı eksikse üst veriler alınmadan, paket indirilmeden, sağlama toplamı doğrulanmadan, arşiv açılmadan ve dağıtım sonrası adımlar başlamadan işlem durur.
  • Güvenli olmayan ZIP girişleri, yol kanalı, mutlak yollar, tespit edilebilir symlinkler, dot segmentleri, .env, .git, .github, kök düzeyinde bağımlılık klasörleri, storage/, bootstrap/cache/, üretilen ön çıktıları ve npm/yarn/pn kilit dosyaları. Bağımlılık yönetmenleri kök seviyesinde bloke edilir; Laravel resources/views/vendor/ yayınlanan görüş overrides izin verilir.
  • Paket denetimi başarısız olursa dağıtım günlüğünde ilk reddedilen göreli yol ve nedeni görünür. Erişim anahtarları, geçici yollar, sunucudaki mutlak yollar ve yığın izleri gösterilmez.
  • Mevcut .env, storage/, bootstrap/cache/, yüklemeler, ve yürütme dosyaları korunur.
  • Uygulama ve dağıtım sonrası adımlar hedef dizin ağacına yazabilen, site için yapılandırılmış çalışma ortamı veya dağıtım kullanıcısıyla yürütülmelidir. Herne’nin yönettiği standart siteler www-data sahiplik ve grup modelini kullanır.
  • Ön izin denetimi hedef kökü, paketin uygulama hedeflerini, Laravel çalışma dizinlerini, bootstrap/cache ve Composer vendor hedefini kontrol eder. İzinler güvenli değilse dosyalar değişmeden işlem durur.
  • İhtiyaç duyulan dağıtım sonrası adımlar composer install --no-dev --prefer-dist --optimize-autoloader, php artisan migrate --force ve optimize/cache clear olabilir.
  • Eğer .env eksikse, ustalık sonrası dağıtım adımları atlanır ve dağıtım log'u bir sonraki adımı açıklar.

Publisher Deploy, WebBlocks Workbench, CMS, Plugins, QuizTem veya gelecekteki ürünler de dahil olmak üzere herhangi bir desteklenen Publisher ürünü için tekrar kullanılabilir. Daha sonraki güncellemeler Publisher Deploy veya ürünün kendi Sistem Güncellemeleri ekranından alınabilir.

Uygulamaları hızlı kurma

Deploy hâlâ Git tabanlı uygulamalar için doğru araçtır. Desteklenen uygulamalar için, Siteler → Uygulamalar → Hızlı kurulum depo dağıtım adımsız bir uygulama oluşturabilir. WebBlocks CMS, CMS uygulamasını ve oluşturulan veritabanı kimlik bilgilerini hazırlar. Laravel App, yalnızca en son Laravel iskeletini oluşturur, sitenin çalışma zamanını Laravel olarak işaretler ve QuizTem gibi paket ürünleri Composer veya Terminal aracılığıyla sonradan yüklenmek üzere bırakır. Quick Install boş bir web_root veya boş bir public/ dizini kabul eder, ancak rastgele mevcut dosyaları reddediyor ve onları otomatik olarak silmiyor.

Siteye özel dağıtım webhook’u

Kaydedilmiş bir dağıtım konfigürasyonuna sahip her site, Git dağıtım sayfasında kendi webhook kartını da alır.

  • URL URL — POST /sites/{site}/webhook/deploy
  • Gizli anahtar — otomatik olarak oluşturulur ve panelde gösterilir
  • İmza başlığı — ham JSON yükünün HMAC SHA-256 imzasıyla X-Hub-Signature-256 gönder
  • Dalı filtresi — diğer dallara yapılan itmeler otomatik olarak göz ardı edilir

GitHub kurulumu

  1. GitHub'da depo webhook ayarlarınızı açın
  2. Payload URL'sini sitenin Git Deploy sayfasında gösterilen değere ayarla
  3. İçerik türü olarak application/json kullan
  4. Herne'den oluşturulan gizliyi webhook gizli alanına yapıştır
  5. Sadece it olayı seçin

Siteye özel bu webhook yalnızca kiracı uygulamalarının dağıtımı içindir. Herne’nin kendisini güncellemek yöneticiye özel ayrı bir işlemdir. Bunun için WebBlocks Publisher sürümlerini uygulayan Panel Güncellemeleri ekranını kullanın.