Päivitys
cd /path/to/conzent
bash scripts/backup.sh && bash scripts/install.sh --update
Tai mistä tahansa:
curl -sSL https://getconzent.com/install | sh -s -- --update
Ota ensin varmuuskopio. Siirrot tapahtuvat automaattisesti eivätkä ole palautettavissa.
Mitä päivitys tekee
| Vaihe | Vaikutus |
|---|---|
git fetch + git reset --hard | Seurattuja tiedostoja palautetaan julkaisuun. Paikalliset muokkaukset hylätään |
docker compose down | Kontit pysähtyvät. Volyymit säilytetään — tietokanta säilyy |
Poistaa app-public -volyymin | Vanha CSS/JS/media tyhjennetään, jotta uuden version varat toimitetaan |
docker compose build --no-cache --pull | Koko rakennus, ohittaen kerrosvälimuistin |
docker compose up -d | Kaikki käynnistyy uudelleen |
migrations:migrate | Vain odottavat skeeman siirrot sovelletaan |
scanner:register | Rekisteröi pakattu skanneri uudelleen (idempotentti) |
| Redis tyhjennys + mallin välimuistin tyhjennys | Poistaa vanhat istunnot ja käännetyt mallit |
| Adminin luominen | Ohitettu — käyttäjät pysyvät koskemattomina |
Odota muutama minuutti välimuistittoman uudelleenrakennuksen aikana.
Mitä säilyy: tietokanta, luodut suostumusohjelmat ja jokainen seurattu tiedosto — .env, .conzent-credentials, docker-compose.override.yml, backups/.
Mitä ei säily: muokkaukset seurattuihin tiedostoihin, kuten docker-compose.yml, nginx-konfiguraatio, mallit ja lähdetiedostot; app-public -volyymi; ja Redis-sisältö, joten kaikki kirjautuvat ulos.
Mukauttaminen ilman menettämistä
Sääntö: älä koskaan muokkaa seurattua tiedostoa. On kaksi tuettua paikkaa muutoksillesi.
.env sisältää kaikki asetukset — APP_URL, APP_PORT, SMTP, skannerin säätö, kolmannen osapuolen avaimet.
docker-compose.override.yml sisältää kaiken stackista itsestään. Compose yhdistää sen automaattisesti ja se on gitignored:
services:
# Julkaise skanneri, jotta etäasennukset voivat saavuttaa sen
scanner:
ports:
- "8300:8300"
# Anna MariaDB:lle enemmän muistia
mariadb:
command: --innodb-buffer-pool-size=1G
# Liitä mukautettu nginx-konfiguraatio
nginx:
volumes:
- ./docker/nginx/custom.conf:/etc/nginx/conf.d/default.conf:ro
Tiedostot, jotka lisäät — Caddyfile, mukautettu nginx-konfiguraatio — ovat seurattuja ja säilyvät päivityksissä. Tiedostot, joita muokkaat, eivät säily.
Päivityksen vahvistaminen
docker compose ps
docker compose exec app php bin/oci health
docker compose exec app php bin/oci scanner:health
Sen jälkeen lataa hallintapaneeli ja varmista, että mukautuksesi ovat ehjät. Jos banneri live-sivustolla näyttää väärältä sen jälkeen, suorita docker compose exec app php bin/oci scripts:regenerate.
Jos päivitys menee pieleen
# 1. Mikä meni rikki
docker compose logs --tail=100 app
# 2. Palauta koodi ja tiedot yhdessä
git checkout <edellinen-tagi>
docker compose build --no-cache && docker compose up -d
bash scripts/restore.sh backups/<arkisto-otettu-ennen-päivitystä>.tar.gz --yes
Ennen päivitystä otetun varmuuskopion palauttaminen on se, mikä kumoaa siirron — pelkkä koodin palauttaminen jättää uuden skeeman voimaan. Tämä on syy varmuuskopiointi ensin -sääntöön.
Poistaminen
bash scripts/install.sh --uninstall
Tämä suorittaa docker compose down -v, poistaen jokaisen volyymin, mukaan lukien tietokannan, ja poistaa sitten asennushakemiston. Se kysyy ensin vahvistusta. Ota varmuuskopio, jos on mitään mahdollisuutta, että haluat tiedot takaisin.
Koko viite löytyy koodista: docs/upgrading.md GitHubissa.