İçeriğe geç

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

  1. Derleme. CI, üretim Composer bağımlılıklarını yükler.

  2. Yükleme. vendor/ dahil tema sunucuya ulaşır.

  3. Sayfaları eşitleme. wp bs pages sync sayfa yazılarını dosyalarla eşitler ve bir rapor yazdırır.

  4. Kaynak önbelleğini yenileme. Sayfalar değiştiğinde depolanan HTML temizlenir, ardından yeniden ısıtılır.

  5. CDN önbelleğini temizleme. Son olarak, kenar önbelleğinin güncel kaynaktan doldurulması için.

  6. ve 4. adımlar sunucuda WP-CLI gerektirir. Aşağıdaki betik ayrıca jq kullanarak 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:

JSON
{
  "require": {
    "blockstudio/blockstudio": "^7.0"
  }
}
PHP
<?php
require_once __DIR__ . '/vendor/autoload.php';

CI’da geliştirme paketleri olmadan yükleyin:

Kabuk
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. İsterseniz cache.path değ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 _dist klasö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çin assets.output değişkenini cache olarak ayarlayın:
JSON
{
  "$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:

Kabuk
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:

JSON
{
    "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, removed ve failed sayfa 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, --full ile birlikte true değerini alır veya eşitleme motorunun kendisi değiştiğinde; önceki başarılı bir eşitlemeden kalan bir kimlik varsa false değ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:

Text
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:

JSON
{
    "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:

Kabuk
#!/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:

JSON
{"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.

YAML
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:

Kabuk
wp bs cache status
wp bs cache cleanup
Text
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:

Kabuk
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