Redis

​

Aktivere passordautentisering

Hvis du bruker en ekstern Redis-tjeneste og må oppgi et passord, kan du gjøre dette ved å angi miljøvariablene OVERLEAF_REDIS_PASS og REDIS_PASSWORD i filen config/variables.env og kjøre kommandoen bin/up -d for å gjenopprette sharelatex-containeren.

Hvis du kjører en lokal Redis-instans, må du konfigurere redis-tjenesten til å starte med passordautentisering. Etter at du har angitt miljøvariablene ovenfor, må du også fullføre disse ekstra trinnene:

Opprett en fil docker-compose.override.yml i katalogen config/ med følgende innhold:

config/docker-compose.override.yml

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

Hvis du har aktivert AOF-persistens, må du legge til --appendonly yes i command.

Kjør bin/up -d for å gjenopprette containerne.

​

Aktivere 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) gir en robust måte å sikre at data bevares på, ved å logge hver skriveoperasjon som serveren mottar. I motsetning til RDB-øyeblikksbilder, som tar kopier av datasettet ditt på et bestemt tidspunkt, holder AOF en fullstendig oversikt over alle endringer i dataene dine.

Det er valgfritt å deaktivere RDB. Det anbefales generelt at begge persistensmetodene brukes sammen. Før du gjør endringer i produksjon, bør du vurdere fordeler og ulemper ved å kjøre AOF og RDB sammen.

Du kan lese mer om å aktivere 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. Planlegg et vedlikeholdsvindu for oppgraderingen.
2. Stopp instansen med bin/stop og ta en sikkerhetskopi av mappene config/ og data/.
3. Kjør bin/up for å starte instansen
4. Kjør kommandoen docker exec -it redis sh
5. Kjør kommandoen redis-cli for å åpne Redis-kommandolinjegrensesnittet
6. I redis-cli kjører du kommandoen config set appendonly yes
7. Nå må du vente til AOF-omskrivingen er ferdig med å lagre dataene. Det kan du gjøre ved å skrive INFO persistence i redis-cli og vente til aof_rewrite_in_progress og aof_rewrite_scheduled er 0, og bekrefte at aof_last_bgrewrite_status er ok.
8. Avslutt redis-cli ved å skrive exit og trykke på returtasten
9. Avslutt redis-containeren ved å skrive exit og trykke på returtasten
10. ​Kjør kommandoen ls ./data/redis og bekreft at du kan se filen appendonly.aof
11. Rediger filen config/overleaf.rc og endre miljøvariabelen REDIS_AOF_PERSISTENCE fra false til true
12. Kjør bin/up -d og sørg for at applikasjonen fungerer (prosjekteditoren og historikkpanelet fungerer).