Migrera en Typesense Ubuntu-server till en annan server: Säkerhetskopiering + återställning

Att migrera din egenhostade Typesense-instans till en ny server är en avgörande uppgift – oavsett om du uppgraderar hårdvara, byter till en annan molnleverantör eller bara utför serverunderhåll.

Den här guiden guidar dig genom de korrekta stegen för att säkerhetskopiera, överföra och återställa dina Typesense-data säkert och tillförlitligt.

Viktiga begrepp

Typesense lagrar dina data i den sökväg som definieras av datakatalog parameter (t.ex. /var/lib/typesense). Denna data kan dock inte säkerhetskopieras på ett säkert sätt medan servern körs, eftersom filerna hålls öppna för skrivning.

För att undvika korruption tillhandahåller Typesense ett Snapshot API för att ta konsekventa säkerhetskopior.

1. Skapa en säkerhetskopia med hjälp av Snapshot API

Bästa alternativet om din Typesense-instans körs normalt.

Anropa Snapshot API:et för att skapa en filsystemsäker ögonblicksbild:

curl -X POST 'http://localhost:8108/snapshot' \ -H 'X-TYPESENSE-API-NYCKEL: DIN_ADMIN_API_NYCKEL' \ -H 'Innehållstyp: application/json' \ -d '{"snapshot_path": "/tmp/typesense-snapshot"}'

Arkivera sedan snapshot-katalogen:

tar -czvf backup.tar.gz -C /tmp typesense-snapshot

(Valfritt) Rensa upp snapshot-katalogen:

rm -rf /tmp/typesense-snapshot

2. Alternativ: Stoppa Typesense och kopiera datakatalogen

Om Snapshot API inte är tillgängligt (t.ex. om Typesense inte svarar):

Stoppa Typesense-servern:

sudo systemctl stoppa typesense-server.service

Arkivera sedan datakatalogen direkt:

tar -czvf backup.tar.gz -C /var/lib typesense

Viktig: Gör bara detta efter att du har stoppat servern för att säkerställa filkonsekvens.

3. Överför säkerhetskopian till en annan server med hjälp av SCP + SSH-nycklar

Generera SSH-nycklar (om du inte redan har gjort det) på din lokala dator:

ssh-keygen -t ed25519 -C "[email protected]"

Spara den på standardplatsen (~/.ssh/id_ed25519) och lämna lösenfrasen tom för automatisering.

Kopiera den publika nyckeln till den nya servern:

ssh-copy-id -i ~/.ssh/id_ed25519.pub användare@ny-server-ip

Överför säkerhetskopian med SCP:

scp -i ~/.ssh/id_ed25519 backup.tar.gz användare@ny-server-ip:/tmp/

Om detta inte fungerar, se först till att innehållet i ed25519.pub flyttas till en ny rad i filen:

~/.ssh/auktoriserade_nycklar

4. Återställ säkerhetskopian på den nya servern

Du kanske fortfarande behöver installera Typesense på den nya servern, konfigurera SSL, etc.

Stoppa sedan alla körande Typesense-instanser:

sudo systemctl stoppa typesense-server.service

Rensa den befintliga datakatalogen (verifiera att detta verkligen är din nya, tomma server, inte din gamla server med data):

sudo rm -rf /var/lib/typesense/*

Extrahera säkerhetskopian:

sudo tar -xzf /tmp/backup.tar.gz -C /var/lib/

Se till att den extraherade datan är på rätt sökväg, t.ex. /var/lib/typesense.

Starta Typesense igen och ta bort säkerhetskopian av tar-filen:

sudo systemctl start typesense-server.service rm /tmp/backup.tar.gz

Typesense kommer att upptäcka ögonblicksbilden vid start och återskapa dess index i minnet.

Slutlig checklista

• Säkerhetskopiering skapad med Snapshot API eller efter att Typesense stoppats
• Data arkiverade och verifierade
• SSH-nyckelbaserad åtkomst konfigurerad
• SCP-överföringen har slutförts säkert
• Typesense har startats om på den nya servern

Proffstips

• Testa din säkerhetskopia innan du förlitar dig på den i produktion. Försök att återställa den till en mellanlagringsserver.
• Automatisera vanliga ögonblicksbilder med hjälp av cron + ringla + tjära.
• Använd säkra API-nycklar och exponera aldrig Typesense-administratörsnyckeln i offentliga skript.
• Kontrollera alltid Typesense-loggarna efter att du startat tjänsten: journalctl -u typesense-server.service

Slutsats

Att migrera en Typesense-instans behöver inte vara skrämmande. Med en gedigen förståelse för hur snapshot-mekanismen fungerar och lite SSH-magi kan du flytta dina data mellan servrar pålitligt och säkert.

Om du stöter på problem med snapshot-API:et fungerar en kall avstängning och manuell säkerhetskopiering fortfarande – följ bara stegen noggrant.

Det är helt på egen risk.

Senast uppdaterad 30 juli 2025