Trellis
A Trellis Ansible-alapú WordPress-szerverkezelő: helyi fejlesztői gép Lima-val, szerverbeállítás és leállás nélküli deploy Bedrock-oldalakhoz.
A Trellis a Roots csapat eszköze WordPress-szerverek felállítására és Bedrock-alapú oldalak kitelepítésére. A szerver beállítását Ansible végzi, így a konfiguráció YAML-fájlokban van, és a repóban követhető.
Mit állít be a szerveren?
Szekció neve “Mit állít be a szerveren?”A Trellis egy üres Ubuntu 24.04 szerverre telepíti és beállítja ezeket:
- PHP 8.3 vagy újabb
- Nginx (HTTP/2, HTTP/3, opcionális FastCGI-gyorsítótár)
- MariaDB
- Let’s Encrypt SSL-tanúsítvány
- Composer és WP-CLI
- Fail2ban és ferm (tűzfal)
- Memcached és levélküldés (sSMTP)
Egy szerveren több oldal is futhat.
Telepítés
Szekció neve “Telepítés”A Trellis CLI-t Homebrew-val telepítheted (macOS és Linux):
brew install roots/tap/trellis-cliÚj projekt létrehozása (az oldal domainje legyen a név, mert egyedi marad):
trellis new example.comA projekt két részből áll:
example.com/├── trellis/ # a szerver beállításai└── site/ # a Bedrock-alapú WordPress-oldalAz oldal beállításait két fájlban találod: trellis/group_vars/development/wordpress_sites.yml (helyi gép) és trellis/group_vars/production/wordpress_sites.yml (éles szerver).
Helyi fejlesztés
Szekció neve “Helyi fejlesztés”A helyi környezet Lima virtuális gépben fut (a régi Vagrant-os megoldást a Trellis lecserélte). Indítás a projekt bármely mappájából:
trellis vm startAz első indítás kb. 5 percig tart: létrejön a gép, és a Trellis telepíti a WordPresst. Az oldal a trellis new közben megadott címen nyílik meg.
| Parancs | Mit csinál |
|---|---|
trellis vm start |
létrehozza vagy elindítja a gépet |
trellis vm stop |
leállítja |
trellis vm shell |
terminált nyit a gépen |
trellis vm delete |
törli a leállított gépet |
Az oldal fájljai szinkronban vannak a saját géped és a virtuális gép között, ezért nem kell külön feltölteni őket. A Composert és a WP-CLI-t a virtuális gépen futtasd, a front-end építőeszközöket a saját gépeden.
Jelszavak titkosítása
Szekció neve “Jelszavak titkosítása”Az érzékeny adatok (jelszavak, kulcsok) a vault.yml fájlokban vannak. Titkosítsd őket, mielőtt a repóba tennéd:
trellis vault encryptA Trellis létrehozza a vault-jelszót a trellis/.vault_pass fájlban. Ezt nem teszi a Git-repóba, ezért ments el belőle egy másolatot, és add át a csapattársaidnak. Titkosított fájlt megnézni vagy szerkeszteni így lehet:
trellis vault view productiontrellis vault edit group_vars/production/vault.ymlA trellis vault decrypt parancsot kerüld, mert könnyű elfelejteni visszatitkosítani a fájlt commit előtt.
Éles szerver beállítása
Szekció neve “Éles szerver beállítása”- Hozz létre egy Ubuntu 24.04 LTS szervert, amelyre SSH-kulccsal be tudsz lépni.
- Másold át a
wordpress_sitesblokkot a development fájlból agroup_vars/production/wordpress_sites.ymlfájlba, és állítsd be az éles értékeket (domain,ssl,repo,branch). - Írd be a szerver címét a
hosts/productionfájlba. - Add meg a felhasználók nyilvános SSH-kulcsát a
group_vars/all/users.ymlfájlban. - Futtasd a szerverbeállítást:
trellis provision productionA beállítást nyugodtan futtathatod újra, ha módosítasz valamit a konfigurációban. Egyes részeket címkével is újrafuttathatsz, például trellis provision --tags users production.
Ha a szolgáltatód támogatott (DigitalOcean vagy Hetzner Cloud), a trellis server create production a szervert is létrehozza.
Kitelepítés és visszaállás
Szekció neve “Kitelepítés és visszaállás”A Trellis a Git-repóból telepít. A wordpress_sites.yml fájlban add meg a repo (SSH-cím) és a branch értékét, majd:
trellis deploy production example.comA kitelepítés leállás nélküli: az új verzió külön mappába kerül, és a váltás egyetlen szimbolikus link átállítása. Alapból az utolsó öt verziót őrzi.
Ha hiba van, visszaállhatsz az előző verzióra:
trellis rollback productionAz első deploynál a WordPress telepítőképernyőjét látod. A Trellis nem telepíti a WordPresst az éles szerverre, neked kell importálnod egy meglévő adatbázist vagy újat telepítened. Az adatbázis-séma módosítását (például új bővítmény után) a deploy sem végzi el.
Deploy-horgok
Szekció neve “Deploy-horgok”Egyedi lépéseket (például npm ci és npm run build) a deploy-horgokkal futtathatsz. A horgok feladatfájlok, amelyeket a deploy egy-egy szakasza előtt vagy után fut le (deploy_build_before, deploy_build_after stb.). Ha felülírod az alapértelmezett listát, vedd bele az eredeti fájlt is, különben a hozzá tartozó lépések kimaradnak.
Hibakeresés
Szekció neve “Hibakeresés”A fejlesztői gépen az Xdebug alapból be van állítva, csak egy kompatibilis hibakereső kell hozzá. Az Xdebug működéséről lásd az Xdebug cikket.
Források
Szekció neve “Források”Készült: Frissítve: