Oppgradering

Hva Conzent OCI-oppdatereren bevarer og hva den tilbakestiller, hvordan tilpasse en selvhostet installasjon slik at endringene dine overlever, og hvordan rulle tilbake.

Oppgradering

cd /path/to/conzent
bash scripts/backup.sh && bash scripts/install.sh --update

Eller, fra hvor som helst:

curl -sSL https://getconzent.com/install | sh -s -- --update

Ta sikkerhetskopien først. Migrasjoner kjører automatisk og kan ikke reverseres.

Hva oppdateringen gjør

Trinn Effekt
git fetch + git reset --hard Sporede filer tilbakestilles til utgivelsen. Lokale redigeringer til dem kastes
docker compose down Containere stopper. Volumer bevares — databasen din overlever
Fjerner app-public volumet Utdatert CSS/JS/media ryddes opp slik at de nye byggets ressurser serveres
docker compose build --no-cache --pull Full ombygging, ignorerer lagcache
docker compose up -d Alt starter på nytt
migrations:migrate Bruker bare ventende skjema-migrasjoner
scanner:register Registrerer den innebygde skanneren på nytt (idempotent)
Redis flush + malcache klarering Fjerner utdaterte økter og kompilte maler
Opprettelse av admin Hoppet over — brukerne dine er urørt

Forvent noen minutter for ombyggingen uten cache.

Hva overlever: databasen, genererte samtykkeskript, og hver ikke-sporet fil — .env, .conzent-credentials, docker-compose.override.yml, backups/.

Hva som ikke overlever: redigeringer av sporbare filer som docker-compose.yml, nginx-konfigurasjonen, maler og kildefiler; app-public volumet; og Redis-innhold, så alle blir logget ut.

Tilpasse uten å miste det

Regelen: aldri redigere en sporet fil. Det er to støttede steder for endringene dine.

.env inneholder all konfigurasjon — APP_URL, APP_PORT, SMTP, skannerjustering, tredjepartsnøkler.

docker-compose.override.yml inneholder alt om selve stakken. Compose slår det sammen automatisk og det er gitignored:

services:
  # Publiser skanneren slik at eksterne installasjoner kan nå den
  scanner:
    ports:
      - "8300:8300"

  # Gi MariaDB mer minne
  mariadb:
    command: --innodb-buffer-pool-size=1G

  # Monter tilpasset nginx-konfigurasjon
  nginx:
    volumes:
      - ./docker/nginx/custom.conf:/etc/nginx/conf.d/default.conf:ro

Filer du legger til — en Caddyfile, en tilpasset nginx-konf — er ikke-sporet og overlever oppdateringer. Filer du modifiserer gjør ikke det.

Verifisere en oppgradering

docker compose ps
docker compose exec app php bin/oci health
docker compose exec app php bin/oci scanner:health

Last deretter inn dashbordet og bekreft at tilpasningene dine er intakte. Hvis et banner på et live nettsted ser feil ut etterpå, kjør docker compose exec app php bin/oci scripts:regenerate.

Hvis en oppgradering går galt

# 1. Hva brøt
docker compose logs --tail=100 app

# 2. Rull tilbake kode og data sammen
git checkout <previous-tag>
docker compose build --no-cache && docker compose up -d
bash scripts/restore.sh backups/<archive-taken-before-the-upgrade>.tar.gz --yes

Å gjenopprette sikkerhetskopien før oppgraderingen er det som omgjør en migrasjon — å rulle tilbake kode alene etterlater det nye skjemaet på plass. Det er grunnen til regelen om å ta sikkerhetskopi først.

Avinstallere

bash scripts/install.sh --uninstall

Dette kjører docker compose down -v, sletter hvert volum inkludert databasen, og fjerner deretter installasjonskatalogen. Det ber først om bekreftelse. Ta en sikkerhetskopi hvis det er noen sjanse for at du vil ha dataene tilbake.

Den fullstendige referansen finnes med koden: docs/upgrading.md på GitHub.

Tilbake til Dokumentasjon