Blockstudio Sitesi Dağıtımı
Bloklar için tema klasörünü sunucuya kopyalamak yeterlidir: Blockstudio blokları dosya sisteminden keşfeder ve önbellekleri değişen girdileri kendiliğinden algılar. Gerçek bir sitede daha fazla hareketli parça vardır. Dosya tabanlı sayfalar veritabanına ancak eşitlendiğinde ulaşır. Statik ön oluşturma, yerine yenisi konana kadar dünkü HTML çıktısını sunmaya devam eder. Önündeki bir CDN, önbelleğe aldığı içeriği sunmayı sürdürür.
Bu kılavuzda, Blockstudio öğesini Composer üzerinden paketleyen, acme adlı bir tema için dağıtım süreci oluşturuluyor. CI’da nelerin çalıştığı, dosyalar sunucuya ulaştıktan sonra orada nelerin çalıştığı, sayfa eşitleme raporunun nasıl okunacağı ve hangi wp bs komutlarının sürüme dahil edilmesi gerektiği ele alınıyor.
Tek görselde sürüm süreci
-
Derleme. CI, üretim Composer bağımlılıklarını yükler.
-
Yükleme.
vendor/dahil tema sunucuya ulaşır. -
Sayfaları eşitleme.
wp bs pages syncsayfa yazılarını dosyalarla eşitler ve bir rapor yazdırır. -
Kaynak önbelleğini yenileme. Sayfalar değiştiğinde depolanan HTML temizlenir, ardından yeniden ısıtılır.
-
CDN önbelleğini temizleme. Son olarak, kenar önbelleğinin güncel kaynaktan doldurulması için.
-
ve 4. adımlar sunucuda WP-CLI gerektirir. Aşağıdaki betik ayrıca
jqkullanarak JSON dosyasını okur.
1. Adım: CI’da Composer
Blockstudio dosyasını temaya ekleyin ve composer.lock dosyasını commit edin; böylece CI test ettiğiniz
sürümün aynısını yükler:
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
<?php
require_once __DIR__ . '/vendor/autoload.php';
CI’da geliştirme paketleri olmadan yükleyin:
composer install --no-dev --optimize-autoloader --no-interaction --prefer-dist
Blockstudio, autoloader’dan başlatılır; kendi çalışma zamanı bağımlılıkları
paketin içinde bir araya getirilmiş ve ad alanlarıyla yalıtılmıştır. Bir vendor/
dizininden yüklendiğinde yerleşik GitHub güncelleyicisi devre dışı kalır; böylece sürümü değiştirmenin tek yolu Composer olur.
2. Adım: Nelerin yazılabilir olması gerektiğine karar verin
Blockstudio çalışma zamanında dosyalar oluşturur. Bir dağıtım dizini değiştirmeden veya kilitlemeden önce bu dosyaların nereye yazıldığını öğrenin:
- Çalışma zamanı önbellekleri varsayılan olarak
wp-content/blockstudio/cache/altında bulunur. İstersenizcache.pathdeğişkenini yazılabilir özel bir birime yönlendirin. Yolu değiştirmek önbelleği boşaltır. - Derlenmiş blok varlıkları varsayılan olarak her bloğun yanındaki bir
_distklasörüne yazılır. Sürüm dizininiz salt okunursa veya her dağıtımda değiştiriliyorsa bunların önbellek dizinine yazılması içinassets.outputdeğişkeninicacheolarak ayarlayın:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"assets": {
"output": "cache"
}
}
Dağıtım sırasında önbellekleri temizlemeniz gerekmez. Her önbellek girdisinin anahtarı; blok dosyaları, ayarlar, etkin tema ve eklentiler ile WordPress, PHP ve Blockstudio sürümleri dahil olmak üzere girdilerine göre belirlenir; dolayısıyla bunları değiştiren bir sürüm yeni anahtarlar alır. production ve staging ortamlarında Blockstudio, dosyaları yeniden denetlemeden önce doğrulanmış bir izleme anlık görüntüsüne 20 saniye güvenir; bu nedenle bir değişikliğin fark edilmesi 20 saniyeyi bulabilir. blockstudio/cache/watch_debounce filtresi bu süreyi değiştirir.
3. Adım: Sayfaları eşitleme
Sayfa yazıları yalnızca açık bir eşitleme işlemiyle değişir. Ön yüz, yönetici paneli, Ajax, REST, cron ve olağan WP-CLI istekleri sayfa kaynaklarını bulmaz veya sayfa yazılarına yazmaz. Dağıtımın bunu istemesi gerekir:
wp bs pages sync --format=json
Temasında about ve contact olmak üzere iki sayfa bulunan bir sitede ilk çalıştırma
bu sayfaları oluşturur:
{
"discovered": 2,
"created": 2,
"updated": 0,
"unchanged": 0,
"removed": 0,
"failed": 0,
"fullReconciliation": true,
"sourceId": "f88baddfd5a1deb94eb8c9bbeca10d5a0d47a72f16b50efdb25a7127945af7dd",
"sourceIdentity": {
"commit": "",
"dirtyHash": "",
"inventoryHash": "aaec5b9dd13d74eea872117b6167caa7a5d5c1abad9572fba22f6ddf6340adfe",
"engineFingerprint": "2c442442bb49f91e7187560e6db8f3475caa0b62b47708cab95b6ff13aba4469",
"hash": "f88baddfd5a1deb94eb8c9bbeca10d5a0d47a72f16b50efdb25a7127945af7dd"
},
"pages": {
"about": {
"status": "created",
"postId": 545,
"locked": false
},
"contact": {
"status": "created",
"postId": 546,
"locked": false
}
},
"errors": []
}
Çıktıyı okuma:
created,updated,unchanged,removedvefailedsayfa sayılarını gösterir. Kaynak parmak izi değişmeyen bir sayfa için yazı veya yazı meta verisi yazılmaz ve güncelleme kancaları çalıştırılmaz.- Her geçişte tüm sayfa envanteri karşılaştırılır.
fullReconciliation, geçişin tam eşitleme sayılıp sayılmadığını bildirir: ilk çalıştırmada,--fullile birliktetruedeğerini alır veya eşitleme motorunun kendisi değiştiğinde; önceki başarılı bir eşitlemeden kalan bir kimlik varsafalsedeğerini alır. Alt sistemler bunu her şeyi yeniden derleyip derlemeyeceklerine karar vermek için kullanabilir. sourceIdentity, sayfa envanterinin ve eşitleme motorunun belirleyici bir parmak izidir. Komut bunu başarılı bir geçişten sonra kaydeder.
--format=json olmadan komut tek bir özet satırı ve başarı mesajı yazdırır. Terminal olmayan CI günlüğünde satır, sekmelerle ayrılmıştır:
discovered created updated unchanged removed failed source_id
2 0 1 1 0 0 7bd575b4ee6c0a948f439dd83ce5fa403f8113c9406c3b13b6ade2f2b19f3c2c
Success: File-backed pages synchronized.
Bu çalıştırma, about/index.php üzerinde yapılan düzenlemenin ardından gerçekleşti: bir sayfa güncellendi, biri değişmeden kaldı.
Eşitleme başarısız olduğunda
Keşif veya eşitleme bir hata bildirirse komut 1 durum koduyla çıkar ve CI adımı başarısız olur. JSON raporu yine de yazdırılır; bu nedenle günlüğe kaydedin.
Hatalı biçimlendirilmiş bir page.json şöyle görünür:
{
"discovered": 0,
...
"failed": 1,
...
"pages": [],
"errors": [
{
"code": "invalid_page_json",
"message": "Invalid page.json file.",
"context": {
"path": ".../wp-content/themes/acme/pages/pricing/page.json"
}
}
]
}
Kaynağı kaybolan yönetilen sayfalar yalnızca hatasız tamamlanan bir geçişten sonra temizlenir; böylece eşitlemesi başarısız olan bir sürüm canlı sayfaları silmez. Kaldırılan sayfalar varsayılan olarak çöp kutusuna taşınır; blockstudio/pages/orphan_action filtresi trash, delete veya keep döndürebilir.
Her dağıtımda çalıştırın
Hiçbir sayfa değişmemiş olsa bile eşitlemeyi çalıştırın. Sürüm dizinlerine dağıtım yapıp bir sembolik bağlantıyı değiştirdiğinizde, bir sonraki eşitleme bu yolları yenileyene kadar değişmeyen sayfa önceki sürümün şablon ve düzen yollarını kullanmaya devam eder. Bu yenileme post_content değerine veya değiştirilme tarihine dokunmaz.
--authoritative ve --full
Olağan bir eşitleme, editörlerin anahtarlı bloklarda değiştirdiği içeriği korur.
--authoritative ise yönetilen içeriği doğrudan dosyalardan alır ve bir Sayfa Eşitleme kilidini kaldırabilir. Dosyaların esas alınması gerektiğinde, örneğin hazırlık sitesini sıfırlarken veya dosya tabanlı sayfaları düzenleyicide kimsenin düzenlemediği bir sitede kullanın.
Etkin editörlerin bulunduğu bir sitenin her dağıtımında kullanmayın.
--full, depolanan kimlik ne olursa olsun geçişi tam eşitleme olarak işaretler. Sayfa karşılaştırması zaten her geçişte tamamlanır; bu nedenle bayrak hangi sayfaların denetlendiğini değil, rapordaki fullReconciliation değerini değiştirir. Sonraki bir adım tam yeniden derlemeyi bu değere göre yapacaksa bayrağı iletin.
PHP ile yazılmış araçlar doğrudan Blockstudio\Pages::reconcile() çağırabilir.
Aynı raporu döndürür, ancak kimliği kaydetmez: etkinleştirilmiş statik bir yapıt gibi sürümün geri kalanının doğrulandığından emin olduktan sonra Blockstudio\Pages::store_successful_source_identity() çağırın.
4. Adım: Statik önbelleği yenileme
Site, varsayılan signature modunda statik ön işleme kullanıyorsa WP-CLI üzerinden güncellenen sayfa yazıları depolanan HTML önbelleğini kendiliğinden temizlemez. Raporu okuyun; bir değişiklik varsa önbelleği temizleyin ve ardından ısıtın:
#!/usr/bin/env bash
set -euo pipefail
cd /var/www/example.com
report=$(mktemp)
# 1. Reconcile file-backed pages and keep the report.
if ! wp bs pages sync --format=json > "$report"; then
cat "$report"
exit 1
fi
jq '{discovered, created, updated, unchanged, removed}' "$report"
# 2. Drop stored HTML when page content changed.
changed=$(jq '.created + .updated + .removed' "$report")
if [ "$changed" -gt 0 ]; then
wp bs prerender purge
fi
# 3. Re-warm in bounded passes until a pass warms nothing.
for _ in $(seq 1 50); do
warmed=$(wp bs prerender warm | jq '.warmed')
[ "$warmed" -gt 0 ] || break
done
wp bs prerender status | jq '{files, queue}'
Her wp bs prerender warm çalıştırması, güncel olmayan herkese açık URL’leri sıraya alır, bunlardan en fazla warm.concurrency tanesini işler ve bir özet yazdırır. Bu geçişte sıraya alınan altı URL’den dördü alındı ve dördünün de işlenmesi başarısız oldu:
{"queued":6,"processed":4,"warmed":0,"skipped":0,"failed":4}
İşlenemeyen bir URL güncel olmayan durumda kalır ve sonraki çalıştırmada yeniden sıraya alınır. Bu nedenle döngü, sıra boşalana kadar beklemek yerine hiçbir şeyi ısıtmayan ilk geçişte durur. Geri kalanlar zamanlanmış ısıtıcı veya sonraki anonim ziyaret tarafından işlenir.
graph modunda her URL için çalışan ısıtıcı kapalıdır ve warm hiçbir şey sıraya almaz. Grafik siteleri 2. ve 3. adımların yerine, etkilenen URL’leri işleyen ve sonucu atomik biçimde etkinleştiren kendi derleme süreçlerini kullanır. Bkz. imza ve grafik modları.
5. Adım: CI iş akışı
Aşağıdaki iş akışı bir GitHub Actions örneğidir. Yapı her CI sistemine uyarlanabilir: derleyin, yükleyin, betiği sunucuda çalıştırın ve CDN önbelleğini temizleyin.
name: Deploy
on:
push:
branches: [main]
concurrency:
group: deploy-production
cancel-in-progress: false
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
steps:
- uses: actions/checkout@v4
- uses: shivammathur/setup-php@v2
with:
php-version: "8.2"
tools: composer:v2
- name: Install production dependencies
run: composer install --no-dev --optimize-autoloader --no-interaction --prefer-dist
- name: Configure SSH
run: |
mkdir -p ~/.ssh
echo "${{ secrets.DEPLOY_KEY }}" > ~/.ssh/id_ed25519
chmod 600 ~/.ssh/id_ed25519
ssh-keyscan example.com >> ~/.ssh/known_hosts
- name: Upload the theme
run: |
rsync -az --delete --exclude ".git" --exclude ".github" \
./ deploy@example.com:/var/www/example.com/wp-content/themes/acme/
- name: Sync pages and refresh the static cache
run: ssh deploy@example.com 'bash -s' < scripts/post-deploy.sh
- name: Purge the CDN
run: curl -fsS -X POST "${{ secrets.CDN_PURGE_URL }}"
concurrency, cancel-in-progress: false ile birlikte kullanıldığında çalışan bir dağıtımın arkasına ikinci bir gönderimi sıraya alır; böylece eşitlemenin ortasında iptal edilmesini önler. PHP 8.2, Blockstudio için gereken minimum sürümdür. Son adımı kendi CDN önbellek temizleme API işleminizle değiştirin.
Bakım komutları
Bunları her sürümde çalıştırmanız gerekmez; ancak dağıtım yönergenizde bu komutlar yer almalıdır.
Eski kilit kuyruğunu boşaltma. 7.6.14 öncesindeki sürümler, her içerik değişikliğinde bir .build.lock dosyası bırakıyordu. Yükseltme sonrasında WP-Cron bunları sınırlı gruplar halinde kaldırır. Denetlemek ve kuyruğu tek seferde boşaltmak için:
wp bs cache status
wp bs cache cleanup
0 legacy build lock(s) across 0 cache namespace(s).
Next cleanup batch in 0 second(s).
cleanup, bir saatten daha yeni olan veya çalışan bir istek tarafından hâlâ tutulan kilitleri bir sonraki geçiş için bırakır. Site trafik alırken kilit dosyalarını elle asla silmeyin.
Çalışma zamanı önbelleğini temizleme. wp bs cache clear geçerli siteye ait her şeyi, wp bs cache clear --scope=runtime ise tüm ad alanlarındaki tek bir kapsamı temizler. Sonraki istek önbelleği yeniden oluşturur; bu nedenle düşük trafikte ve yalnızca gerekli olduğunda çalıştırın: girdi değişiklikleri anahtarları zaten yeniler.
Blockstudio kaldırma. Bir Composer kurulumunda eklenti devre dışı bırakma kancası bulunmaz; bu nedenle paket kaldırıldığında cron etkinliklerinin zamanlamasını iptal eden veya erken sunum drop-in dosyasını kaldıran bir işlem gerçekleşmez. Bağımlılığı kaldırmadan önce şunu çalıştırın:
wp bs teardown
Bu komut, bu kurulumun sahibi olduğu cron etkinliklerini ve statik ön işleme durumunu kaldırır; başka eklentilerin drop-in dosyalarına ve yapılandırma dosyalarına dokunmaz ve yeniden etkinleştirildiğinde temiz bir başlangıç sağlar.
Sonraki adımlar
- Dosya Tabanlı Sayfalar Oluşturma: bu dağıtımın eşitlediği sayfalar.
- Sayfalar başvurusu: eşitleme davranışı, PHP eşitleme API ve dağıtım kimliği sözleşmesi.
- CLI başvurusu: tüm
wp bskomutları. - Önbelleğe alma: önbellek konumu, kimlik, saklama süresi ve kilit kuyruğu.
- WordPress’ı Statik HTML Olarak Sunma: 4. adımda yenilenen önbellek.
- Composer: eklenti, zorunlu eklenti, tema ve eklentiyle birlikte gelen kurulumlar.