Uppgradering

Vad Conzent OCI-uppdateraren bevarar och vad den återställer, hur man anpassar en självhostad installation så att dina ändringar överlever, och hur man återställer.

Uppgradering

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

Eller, var som helst:

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

Ta säkerhetskopian först. Migrationer körs automatiskt och är inte reversibla.

Vad uppdateringen gör

Steg Effekt
git fetch + git reset --hard Spårade filer återställs till versionen. Lokala ändringar av dem kasseras
docker compose down Containrar stoppas. Volymer bevaras — din databas överlever
Tar bort app-public volymen Utdaterad CSS/JS/media rensas så att den nya byggens tillgångar serveras
docker compose build --no-cache --pull Fullständig ombyggnad, utan att ta hänsyn till lager-cache
docker compose up -d Allt startar om
migrations:migrate Tillämpar endast utestående schemamigrationer
scanner:register Registrerar om den inbyggda skannern (idempotent)
Redis flush + rensa mallcache Tar bort utdaterade sessioner och kompilerade mallar
Admin skapande Översprungen — dina användare påverkas inte

Förvänta dig några minuter för ombyggnaden utan cache.

Vad som överlever: databasen, genererade samtyckesskript och varje oregistrerad fil — .env, .conzent-credentials, docker-compose.override.yml, backups/.

Vad som inte gör: ändringar av spårade filer som docker-compose.yml, nginx-konfigurationen, mallar och källfiler; app-public volymen; och Redis-innehåll, så att alla blir utloggade.

Anpassa utan att förlora det

Regeln: redigera aldrig en spårad fil. Det finns två stödda platser för dina ändringar.

.env innehåller all konfiguration — APP_URL, APP_PORT, SMTP, skannerinställningar, tredjepartsnycklar.

docker-compose.override.yml innehåller allt om själva stacken. Compose slår samman det automatiskt och det är gitignored:

services:
  # Publicera skannern så att fjärrinstallationer kan nå den
  scanner:
    ports:
      - "8300:8300"

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

  # Montera anpassad nginx-konfiguration
  nginx:
    volumes:
      - ./docker/nginx/custom.conf:/etc/nginx/conf.d/default.conf:ro

Filer du lägger till — en Caddyfile, en anpassad nginx-konf — är oregistrerade och överlever uppdateringar. Filer du ändrar gör det inte.

Verifiera en uppgradering

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

Ladda sedan instrumentpanelen och bekräfta att dina anpassningar är intakta. Om en banner på en live-sida ser fel ut efteråt, kör docker compose exec app php bin/oci scripts:regenerate.

Om en uppgradering går fel

# 1. Vad gick sönder
docker compose logs --tail=100 app

# 2. Återställ kod och data tillsammans
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

Återställning av säkerhetskopian före uppgraderingen är vad som ångrar en migration — att bara återställa koden lämnar det nya schemat på plats. Det är anledningen till regeln att ta säkerhetskopian först.

Avinstallera

bash scripts/install.sh --uninstall

Detta kör docker compose down -v, tar bort varje volym inklusive databasen, och tar sedan bort installationskatalogen. Det ber om bekräftelse först. Ta en säkerhetskopia om det finns någon chans att du vill ha tillbaka datan.

Den fullständiga referensen finns med koden: docs/upgrading.md på GitHub.

Tillbaka till Dokumentation