Blockstudio vietnes izvietošana
Bloku gadījumā pietiek ar tēmas mapes kopēšanu uz serveri: Blockstudio atrod tos failu sistēmā, un kešatmiņas pašas pamana izmaiņas ievades datos. Taču īstā vietnē ir vēl citi elementi. Failos glabātās lapas nonāk datubāzē tikai pēc to sinhronizēšanas. Statiskā priekšrenderēšana turpina rādīt vakardienas HTML, līdz to aizstāj jaunā versija. Arī starpniekserveris CDN turpina rādīt visu, ko tas ir saglabājis kešatmiņā.
Šajā ceļvedī tiek izveidots izvietošanas process tēmai acme, kas apvieno Blockstudio, izmantojot Composer. Apskatīsim, kas tiek izpildīts CI vidē un serverī pēc failu ievietošanas, kā lasīt lapu sinhronizācijas pārskatu un kuras wp bs komandas jāiekļauj laidienā.
Laidiens vienā attēlā
-
Būvēšana. CI instalē ražošanas Composer atkarības.
-
Augšupielāde. Tēma, tostarp
vendor/, nonāk serverī. -
Lapu sinhronizēšana.
wp bs pages syncsaskaņo lapu ierakstus ar failiem un izdrukā pārskatu. -
Izcelsmes kešatmiņas atsvaidzināšana. Saglabātais HTML tiek iztīrīts, ja lapas ir mainījušās, un pēc tam atkal iesildīts.
-
CDN tīrīšana. Pēdējā darbība, lai malas kešatmiņa tiktu aizpildīta no svaigas izcelsmes.
-
un 4. darbībai serverī nepieciešams WP-CLI. Tālāk redzamais skripts izmanto arī
jq, lai nolasītu JSON.
1. darbība: Composer CI vidē
Iekļaujiet Blockstudio tēmā un iesniedziet composer.lock, lai CI instalētu
precīzi to versiju, kuru pārbaudījāt:
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
<?php
require_once __DIR__ . '/vendor/autoload.php';
CI vidē instalējiet bez izstrādes pakotnēm:
composer install --no-dev --optimize-autoloader --no-interaction --prefer-dist
Blockstudio inicializējas no automātiskā ielādētāja, un tā izpildlaika atkarības ir iekļautas un nosaukumtelpā nodalītas pašā pakotnē. Ielādējot no vendor/ direktorijas, iebūvētais GitHub atjauninātājs ir atspējots, tāpēc Composer ir vienīgais veids, kā mainīt versiju.
2. darbība: nosakiet, kam jābūt rakstāmam
Blockstudio izpildes laikā raksta ģenerētos failus. Pirms izvietošana aizstāj vai bloķē direktoriju, noskaidrojiet, kur tie tiek rakstīti:
- Izpildlaika kešatmiņas pēc noklusējuma atrodas zem
wp-content/blockstudio/cache/. Ja vēlaties, novirzietcache.pathuz īpaši paredzētu rakstāmu sējumu. Mainot ceļu, kešatmiņa sākas tukša. - Kompilētie bloku resursi pēc noklusējuma tiek rakstīti
_distmapē blakus katram blokam. Ja laidiena direktorija ir tikai lasāma vai tiek aizstāta katrā izvietošanas reizē, iestatietassets.outputvērtību uzcache, lai faili tiktu rakstīti kešatmiņas direktorijā:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"assets": {
"output": "cache"
}
}
Izvietošanas laikā kešatmiņas nav jātīra. Katrs kešatmiņas ieraksts ir piesaistīts savām ievaddatnēm, tostarp bloku failiem, iestatījumiem, aktīvajai tēmai un spraudņiem, kā arī WordPress, PHP un Blockstudio versijām, tāpēc laidienam, kurā tie mainās, tiek izveidotas jaunas atslēgas. Vidēs production un staging Blockstudio 20 sekundes uzticas validētam novērošanas momentuzņēmumam, pirms atkal pārbauda failus, tāpēc izmaiņu pamanīšana var aizņemt līdz 20 sekundēm. blockstudio/cache/watch_debounce filtrs maina šo intervālu.
3. darbība: sinhronizējiet lapas
Lapu ieraksti mainās tikai pēc skaidri pieprasītas sinhronizācijas. Frontend, administrācijas, Ajax, REST, cron un parastie WP-CLI pieprasījumi nekad nemeklē lapu avotus un neraksta lapu ierakstus. Izvietošanas procesam šī darbība jāpieprasa:
wp bs pages sync --format=json
Vietnē, kuras tēmā ir divas lapas, about un contact, pirmajā reizē tās tiek izveidotas:
{
"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": []
}
Kā lasīt šo pārskatu:
created,updated,unchanged,removedunfailedir lapu skaits. Ja lapas avota pirkstu nospiedums nav mainījies, ieraksts un ieraksta metadati netiek rakstīti un atjaunināšanas āķi netiek palaisti.- Katrā reizē tiek salīdzināts pilns lapu saraksts.
fullReconciliationnorāda, vai šī reize tiek uzskatīta par pilnu sinhronizāciju:truepirmajā reizē, ja ir--fullvai ir mainījies pats sinhronizācijas dzinis, unfalse, ja pastāv iepriekšējās veiksmīgās sinhronizācijas identitāte. Pakārtotie rīki var izmantot šo vērtību, lai izlemtu, vai pārbūvēt visu. sourceIdentityir deterministisks lapu saraksta un sinhronizācijas dziņa pirkstu nospiedums. Pēc veiksmīgas darbības komanda to saglabā.
Bez --format=json komanda izdrukā vienu kopsavilkuma rindu un veiksmes paziņojumu. CI žurnālā, kas nav terminālis, rinda ir atdalīta ar tabulācijas rakstzīmēm:
discovered created updated unchanged removed failed source_id
2 0 1 1 0 0 7bd575b4ee6c0a948f439dd83ce5fa403f8113c9406c3b13b6ade2f2b19f3c2c
Success: File-backed pages synchronized.
Šī darbība sekoja pēc about/index.php rediģēšanas: viena lapa tika atjaunināta, viena palika nemainīga.
Ja sinhronizācija neizdodas
Ja lapu atklāšanas vai sinhronizācijas laikā rodas kļūda, komanda iziet ar statusu 1 un CI darbība neizdodas. Pārskats JSON tik un tā tiek izdrukāts, tāpēc saglabājiet to žurnālā.
Nepareizi formatēts page.json izskatās šādi:
{
"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"
}
}
]
}
Pārvaldītās lapas, kuru avoti ir pazuduši, tiek dzēstas tikai pēc tam, kad darbība ir pabeigta bez kļūdām, tāpēc neveiksmīga sinhronizācija laidiena laikā neizdzēš aktīvās lapas. Pēc noklusējuma noņemtās lapas tiek pārvietotas uz atkritni; filtrs blockstudio/pages/orphan_action var atgriezt trash, delete vai keep.
Palaidiet katrā izvietošanas reizē
Palaidiet sinhronizāciju arī tad, ja neviena lapa nav mainījusies. Ja izvietojat jaunās laidiena direktorijās un pārslēdzat simbolisko saiti, nemainīta lapa joprojām norāda uz iepriekšējā laidiena veidnes un izkārtojuma ceļiem, līdz nākamā sinhronizācija tos atsvaidzina. Šī atsvaidzināšana nemaina post_content vai modificēšanas datumu.
--authoritative un --full
Parasta sinhronizācija saglabā saturu, ko redaktori mainījuši atslēgotajos blokos. --authoritative tā vietā aizstāj pārvaldīto saturu ar failu saturu un var noņemt lapas sinhronizācijas bloķējumu. Izmantojiet to, ja priekšroka dodama failiem, piemēram, atiestatot testēšanas vietni vai vietni, kurā neviens nerediģē failos glabātas lapas. Nelietojiet to katrā izvietošanas reizē vietnē ar aktīviem redaktoriem.
--full atzīmē darbību kā pilnu sinhronizāciju neatkarīgi no saglabātās identitātes. Lapas tiek pilnībā salīdzinātas katrā reizē, tāpēc šis karodziņš maina pārskata fullReconciliation vērtību, nevis to, kuras lapas tiek pārbaudītas. Nododiet to, ja nākamā darbība izmanto šo vērtību, lai veiktu pilnu pārbūvi.
Rīki, kas rakstīti PHP, var tieši izsaukt Blockstudio\Pages::reconcile().
Tā atgriež to pašu pārskatu, taču nesaglabā identitāti: izsauciet Blockstudio\Pages::store_successful_source_identity() pēc tam, kad ir pārbaudīta pārējā laidiena daļa, piemēram, aktivizēts statiskais artefakts.
4. darbība: atsvaidziniet statisko kešatmiņu
Ja vietne izmanto statisko iepriekšējo renderēšanu noklusējuma signature režīmā, no WP-CLI atjaunināti lapu ieraksti paši neiztīra saglabāto HTML. Izlasiet pārskatu un iztīriet kešatmiņu, ja kaut kas ir mainījies, pēc tam iesildiet to:
#!/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}'
Katrā wp bs prerender warm darbības reizē rindā ievieto novecojušos publiskos URL, atveido līdz warm.concurrency no tiem un izdrukā kopsavilkumu. Šajā reizē tika paņemti četri no sešiem rindā esošajiem URL, un visus četrus neizdevās atveidot:
{"queued":6,"processed":4,"warmed":0,"skipped":0,"failed":4}
URL, kuru neizdodas atveidot, paliek novecojis un tiek ievietots rindā nākamajā reizē. Tāpēc cikls apstājas pēc pirmās reizes, kad nekas netiek iesildīts, nevis gaida, līdz rinda ir tukša. Atlikušo darbu veic plānotais kešatmiņas iesildītājs vai nākamais anonīmais apmeklētājs.
graph režīmā iesildītājs katram URL ir izslēgts, un warm neko nepievieno rindai. Grafu vietnes aizstāj 2. un 3. darbību ar savu būvēšanas procesu, kas atveido ietekmētos URL un atomiski aktivizē rezultātu. Skatiet paraksta un grafa režīmus.
5. darbība: CI darbplūsma
Tālāk redzamā darbplūsma ir GitHub Actions piemērs. Šo struktūru var izmantot jebkurā CI sistēmā: būvējiet, augšupielādējiet, palaidiet skriptu serverī un iztīriet CDN.
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 ar cancel-in-progress: false ievieto otru laidienu rindā aiz pašlaik notiekošā, nevis atceļ to sinhronizācijas vidū. PHP 8.2 ir Blockstudio minimālā versija. Aizstājiet pēdējo darbību ar CDN kešatmiņas tīrīšanas API.
Uzturēšanas komandas
Tās nav jāiekļauj katrā laidienā, taču izvietošanas instrukcijā par tām jābūt informācijai.
Mantoto bloķējumu rindas iztukšošana. Laidieni pirms 7.6.14 katrām satura izmaiņām atstāja .build.lock failu. Pēc atjaunināšanas WP-Cron tos noņem ierobežota lieluma partijās. Lai pārbaudītu un iztukšotu visu rindu uzreiz:
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 atstāj bloķējumus, kas ir jaunāki par stundu vai ko joprojām izmanto aktīvs pieprasījums, līdz nākamajai reizei. Nekad nedzēsiet bloķējuma failus ar roku, kamēr vietne apkalpo datplūsmu.
Izpildlaika kešatmiņas tīrīšana. wp bs cache clear iztīra visu pašreizējai vietnei, bet wp bs cache clear --scope=runtime iztīra vienu tvērumu visās nosaukumtelpās. Nākamais pieprasījums visu izveidos no jauna, tāpēc palaidiet komandu, kad datplūsma ir maza, un tikai tad, ja tam ir iemesls: ievaddatu izmaiņas jau maina atslēgas.
Blockstudio noņemšana. Composer instalācijai nav spraudņa deaktivizēšanas āķa, tāpēc, pakotnei pazūdot, nekas neatsauc cron notikumus un nenoņem agrīnās apkalpošanas drop-in. Palaidiet šo komandu pirms atkarības noņemšanas:
wp bs teardown
Tā noņem šīs instalācijas pārziņā esošos cron notikumus un statiskās iepriekšējās renderēšanas stāvokli, neaizskar svešus drop-in failus un konfigurācijas failus, kā arī ļauj vēlāk tīri ieslēgt funkciju no jauna.
Nākamās darbības
- Lapu veidošana no failiem: lapas, ko šī izvietošana sinhronizē.
- Lapu uzziņa: sinhronizācijas darbība, PHPsinhronizācijasAPI un izvietošanas identitātes līgums.
- CLI uzziņa: katra
wp bskomanda. - Kešatmiņa: kešatmiņas atrašanās vieta, identitāte, saglabāšanas ilgums un bloķējumu rinda.
- WordPress apkalpošana kā statiska HTML: kešatmiņa, ko atsvaidzina 4. darbība.
- Composer: spraudņa, must-use, tēmas un spraudnī iekļautas instalācijas.