Opslag en back-ups
Kanera bevat twee dingen die u niet opnieuw kunt genereren: de PostgreSQL-database en geüploade bestanden. Bepaal waar iedereen woont voordat je mensen uitnodigt.
Opslag uploaden
Standaard worden geüploade bestanden opgeslagen in de kanera_uploads Docker-volume.
Voor S3-compatibele opslag stelt u het volgende in:
S3_REGION=auto
S3_BUCKET=kanera
S3_ACCESS_KEY_ID=...
S3_SECRET_ACCESS_KEY=...
S3_ENDPOINT=https://s3.example.com
S3_PUBLIC_URL_PREFIX=https://cdn.example.com/kanera
Wanneer de vereiste S3-waarden zijn ingesteld, heeft S3 voorrang op lokale uploadopslag.
Organisatiebeheerders kunnen ook kiezen voor een lokale schijf of S3 Instellingen -> Organisatie -> Opslag in de app, onder Opslag-backend. Omgevingswaarden hebben voorrang en de pagina markeert de besturingselementen als alleen-lezen wanneer ze zijn ingesteld.
Zelf-gehoste Kanera heeft geen opslagquotum, dus de bijlagecapaciteit is afhankelijk van het volume of de bucket. Bestandsvolume en -retentie bepalen meestal de schijfvereisten meer dan Kanera zelf, dus wees alert op schijfgroei. Op dezelfde pagina Opslag wordt weergegeven hoeveel elke werkruimte gebruikt en kunnen beheerders grote of oude bestanden vinden en verwijderen, inclusief bestanden op gearchiveerde kaarten. Zie Opslag.
Back-ups
Maak een back-up van beide:
| Gegevens | Locatie |
|---|---|
| PostgreSQL-gegevens | kanera_pgdata Docker-volume. |
| Geüploade bestanden | kanera_uploads Docker-volume, tenzij S3-opslag is geconfigureerd. |
Handmatige PostgreSQL-back-up:
docker compose exec -T postgres pg_dump -U kanera kanera | gzip > kanera-$(date +%F).sql.gz
Kanera kan ook gecodeerde volledige PostgreSQL-back-ups uitvoeren naar S3-compatibele opslag:
DB_BACKUPS_ENABLED=true
DB_BACKUP_ENCRYPTION_PASSPHRASE=<openssl rand -hex 32>
DB_BACKUP_TIMES_UTC=00:15,12:15,16:45
DB_BACKUP_RETENTION_DAYS=14
DB_BACKUP_S3_PREFIX=backups/postgres
De back-upservice comprimeert de dump, codeert deze met GPG symmetrische AES-256, uploadt deze naar S3 en verwijdert oude back-ups na succesvolle uploads. Winkel DB_BACKUP_ENCRYPTION_PASSPHRASE ook ergens duurzaam buiten de inzet; het is vereist om back-ups te herstellen.
Bewaar back-ups van databases en geüploade bestanden buiten de primaire schijf van de server. Een back-up op hetzelfde volume als de gegevens overleeft de storing waarvoor deze bestaat niet.
Geheimen die de moeite waard zijn om te bewaren
Als u deze verliest, kost dit u gegevens in plaats van uptime:
| Waarde | Als het verandert of verloren gaat |
|---|---|
DB_BACKUP_ENCRYPTION_PASSPHRASE | Bestaande gecodeerde back-ups kunnen niet worden hersteld. |
SECRETS_ENCRYPTION_KEY | Opgeslagen integratiegegevens, zoals chatbestemming en persoonlijke webhookgeheimen, kunnen niet langer worden gedecodeerd. |
MFA_ENCRYPTION_KEY | Ingeschreven authenticators en openstaande MFA-uitdagingen worden ongeldig. |
MEDIA_SIGNING_SECRET | Bestaande ondertekende media-URL's worden niet meer opgelost. |
JWT_SECRET | Iedereen is afgemeld. |