Redis

​

Aktivering af adgangskodegodkendelse

Hvis du bruger en ekstern Redis-tjeneste og skal angive en adgangskode, kan du gøre det ved at sætte miljøvariablerne OVERLEAF_REDIS_PASS og REDIS_PASSWORD i filen config/variables.env og køre kommandoen bin/up -d for at genskabe sharelatex-containeren.

Hvis du kører en lokal Redis-instans, skal du konfigurere redis-tjenesten til at starte med adgangskodegodkendelse. Når du har sat ovenstående miljøvariabler, skal du også udføre disse yderligere trin:

Opret en docker-compose.override.yml-fil i mappen config/ med følgende indhold:

config/docker-compose.override.yml

services:
    redis:
        command: "redis-server --requirepass <YOUR-PASSWORD>"

Hvis du har AOF-persistens aktiveret, skal du tilføje --appendonly yes til command.

Kør bin/up -d for at genskabe containerne.

​

Aktivering af Append-Only File-persistens

(Original: https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/redis#enabling-append-only-file-persistence)

Redis AOF-persistens (Append-Only File) giver en robust måde at sikre dataholdbarhed på ved at logge hver skriveoperation, som serveren modtager. I modsætning til RDB-snapshots, der tager øjebliksbilleder af dit datasæt, gemmer AOF en komplet registrering af alle ændringer i dine data.

Det er valgfrit at deaktivere RDB. Det anbefales generelt at bruge begge persistensmetoder sammen. Før du foretager ændringer i produktion, bør du gennemgå fordele og ulemper ved at køre AOF og RDB sammen.

Du kan læse mere om aktivering af AOF-persistens i Redis her: https://redis.io/docs/latest/operate/oss_and_stack/management/persistence/#how-i-can-switch-to-aof-if-im-currently-using-dumprdb-snapshotsarrow-up-right

1. Planlæg et vedligeholdelsesvindue til opgraderingen.
2. Stop instansen med bin/stop, og tag en sikkerhedskopi af mapperne config/ og data/.
3. Kør bin/up for at starte instansen
4. Kør kommandoen docker exec -it redis sh
5. Kør kommandoen redis-cli for at åbne Redis’ kommandolinjegrænseflade
6. Kør kommandoen config set appendonly yes i redis-cli
7. Nu skal du vente på, at AOF-omskrivningen er færdig med at persistere dataene. Det kan du gøre ved at skrive INFO persistence i redis-cli og vente på, at aof_rewrite_in_progress og aof_rewrite_scheduled er 0, samt kontrollere, at aof_last_bgrewrite_status er ok.
8. Forlad redis-cli ved at skrive exit og trykke på Enter
9. Forlad redis-containeren ved at skrive exit og trykke på Enter
10. Kør kommandoen ls ./data/redis, og bekræft, at du kan se filen appendonly.aof
11. Rediger filen config/overleaf.rc, og ændr miljøvariablen REDIS_AOF_PERSISTENCE fra false til true
12. Kør bin/up -d, og sørg for, at applikationen fungerer (projekteditoren og historikpanelet virker).