Redis

​

Włączanie uwierzytelniania hasłem

Jeśli korzystasz z zewnętrznej usługi Redis i musisz podać hasło, możesz to zrobić, ustawiając zmienne środowiskowe OVERLEAF_REDIS_PASS oraz REDIS_PASSWORD w pliku config/variables.env i uruchamiając polecenie bin/up -d, aby odtworzyć kontener sharelatex.

Jeśli uruchamiasz lokalną instancję Redis, musisz skonfigurować usługę redis tak, aby uruchamiała się z uwierzytelnianiem hasłem. Po ustawieniu powyższych zmiennych środowiskowych musisz wykonać również następujące dodatkowe kroki:

Utwórz plik docker-compose.override.yml w katalogu config/ o następującej zawartości:

config/docker-compose.override.yml

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

Jeśli masz włączoną trwałość AOF, musisz dodać --appendonly yes do command.

Uruchom bin/up -d, aby odtworzyć kontenery.

​

Włączanie trwałości Append-Only File

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

Trwałość Redis AOF (Append-Only File) zapewnia solidny sposób gwarantowania trwałości danych poprzez rejestrowanie każdej operacji zapisu otrzymanej przez serwer. W przeciwieństwie do migawek RDB, które tworzą kopie zbioru danych z określonego momentu, AOF przechowuje pełny zapis wszystkich zmian wprowadzonych w danych.

Wyłączenie RDB jest opcjonalne. Ogólnie zaleca się stosowanie obu metod trwałości jednocześnie. Przed wprowadzeniem jakichkolwiek zmian w środowisku produkcyjnym zapoznaj się z zaletami i wadami jednoczesnego korzystania z AOF i RDB.

Więcej informacji o włączaniu trwałości AOF w Redis znajdziesz tutaj: 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. Zaplanuj okno serwisowe na potrzeby aktualizacji.
2. Zatrzymaj instancję za pomocą bin/stop i wykonaj kopię zapasową katalogów config/ i data/.
3. Uruchom bin/up, aby wystartować instancję
4. Uruchom polecenie docker exec -it redis sh
5. Uruchom polecenie redis-cli, aby otworzyć interfejs wiersza poleceń Redis
6. W redis-cli uruchom polecenie config set appendonly yes
7. Teraz musisz poczekać, aż przepisywanie AOF zakończy utrwalanie danych. Możesz to zrobić, wpisując INFO persistence w redis-cli i czekając, aż aof_rewrite_in_progress oraz aof_rewrite_scheduled przyjmą wartość 0, a następnie sprawdzając, czy aof_last_bgrewrite_status ma wartość ok.
8. Wyjdź z redis-cli, wpisując exit i naciskając klawisz Enter
9. Wyjdź z kontenera redis, wpisując exit i naciskając klawisz Enter
10. Uruchom polecenie ls ./data/redis i upewnij się, że widzisz plik appendonly.aof
11. Edytuj plik config/overleaf.rc i zmień wartość zmiennej środowiskowej REDIS_AOF_PERSISTENCE z false na true
12. Uruchom bin/up -d i upewnij się, że aplikacja działa (edytor projektów i panel historii funkcjonują poprawnie).