Tovább a tartalomhoz

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ő.

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.

A Trellis CLI-t Homebrew-val telepítheted (macOS és Linux):

Terminál
brew install roots/tap/trellis-cli

Új projekt létrehozása (az oldal domainje legyen a név, mert egyedi marad):

Terminál
trellis new example.com

A projekt két részből áll:

example.com/
├── trellis/ # a szerver beállításai
└── site/ # a Bedrock-alapú WordPress-oldal

Az 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).

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:

Terminál
trellis vm start

Az 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.

Az érzékeny adatok (jelszavak, kulcsok) a vault.yml fájlokban vannak. Titkosítsd őket, mielőtt a repóba tennéd:

Terminál
trellis vault encrypt

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

Terminál
trellis vault view production
trellis vault edit group_vars/production/vault.yml

A trellis vault decrypt parancsot kerüld, mert könnyű elfelejteni visszatitkosítani a fájlt commit előtt.

  1. Hozz létre egy Ubuntu 24.04 LTS szervert, amelyre SSH-kulccsal be tudsz lépni.
  2. Másold át a wordpress_sites blokkot a development fájlból a group_vars/production/wordpress_sites.yml fájlba, és állítsd be az éles értékeket (domain, ssl, repo, branch).
  3. Írd be a szerver címét a hosts/production fájlba.
  4. Add meg a felhasználók nyilvános SSH-kulcsát a group_vars/all/users.yml fájlban.
  5. Futtasd a szerverbeállítást:
Terminál
trellis provision production

A 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.

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:

Terminál
trellis deploy production example.com

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

Terminál
trellis rollback production

Az 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.

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.

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.

Készült: Frissítve:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások