Redis

​

Aktivera lösenordsautentisering

Om du använder en extern Redis-tjänst och behöver ange ett lösenord kan du göra det genom att ställa in miljövariablerna OVERLEAF_REDIS_PASS och REDIS_PASSWORD i filen config/variables.env och köra kommandot bin/up -d för att återskapa containern sharelatex.

Om du kör en lokal Redis-instans behöver du konfigurera tjänsten redis så att den startar med lösenordsautentisering. När du har ställt in miljövariablerna ovan behöver du även utföra följande ytterligare steg:

Skapa en fil docker-compose.override.yml i katalogen config/ med följande innehåll:

config/docker-compose.override.yml

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

Om du har AOF-persistens aktiverad måste du lägga till --appendonly yes i command.

Kör bin/up -d för att återskapa containrarna.

​

Aktivera persistens med Append-Only File

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

Redis AOF-persistens (Append-Only File) är ett robust sätt att säkerställa datans beständighet genom att logga varje skrivoperation som servern tar emot. Till skillnad från RDB-ögonblicksbilder, som tar kopior av datamängden vid en viss tidpunkt, behåller AOF en fullständig logg över alla ändringar som görs i dina data.

Att inaktivera RDB är valfritt. Det rekommenderas generellt att båda persistensmetoderna används tillsammans. Innan du gör några ändringar i produktion bör du gå igenom för- och nackdelarna med att köra AOF och RDB tillsammans.

Du kan läsa mer om hur du aktiverar AOF-persistens i Redis här: 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. Planera ett underhållsfönster för uppgraderingen.
2. Stoppa instansen med bin/stop och ta en säkerhetskopia av mapparna config/ och data/.
3. Kör bin/up för att starta instansen
4. Kör kommandot docker exec -it redis sh
5. Kör kommandot redis-cli för att öppna Redis kommandoradsgränssnitt
6. Kör kommandot config set appendonly yes i redis-cli
7. Nu måste du vänta tills AOF-omskrivningen har slutfört persisteringen av data. Det gör du genom att skriva INFO persistence i redis-cli och vänta tills aof_rewrite_in_progress och aof_rewrite_scheduled är 0, samt kontrollera att aof_last_bgrewrite_status är ok.
8. Avsluta redis-cli genom att skriva exit och trycka på returtangenten
9. Lämna redis-containern genom att skriva exit och trycka på returtangenten
10. Kör kommandot ls ./data/redis och bekräfta att filen appendonly.aof finns
11. Redigera filen config/overleaf.rc och ändra miljövariabeln REDIS_AOF_PERSISTENCE från false till true
12. Kör bin/up -d och kontrollera att applikationen fungerar (projekteditorn och historikpanelen fungerar).