Installationsvejledning

Første login og drift

Den første administrator, opgraderinger, backup, coming soon og sikkerhedspolitikken.

Den første administrator

Registrering er kun åben for dem med en invitationskode, og koderne genereres i konsollen — som ingen endnu kan åbne. Den første kode genereres på selve maskinen.

  1. Image: på serveren fra roden af repositoriet docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Mappe: i PowerShell i mappen $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Kommandoen skriver en kode på formen XXXX-XXXX-XXXX; invite-code 5 skriver fem.
  4. Klik på Log ind i portalen og derefter på Opret konto: indtast koden, registrer dig med den e-mail, der står i ADMINISTRATORS, og bekræft den med koden fra bekræftelses-e-mailen.
  5. Log ind: Diagnostik nederst på hver side åbner konsollen, hvor de øvrige invitationskoder genereres.

Tip Hvis bekræftelses-e-mailen ikke kommer, så tjek postkassens adgangskode: login-tjenesten siger ved start, når den mangler.

Opgrader

En opgradering udskifter imaget og beholder dataene: de ligger i containerens volume, som hører til projektet og ikke til imaget.

  1. Byg det nye image på udviklingsmaskinen med det opdaterede repositorium: .\rebuild_container_release.ps1 -NoSeedData.
  2. Kopiér det til serveren, kontrollér det, og indlæs det som første gang: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Start med samme kommando som første gang: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d opdager det nye image og genskaber containeren, med en afbrydelse på få sekunder.
  4. Åbn konsollen på fanen Opgradering: hvor en linje viser Opgradering tilgængelig, klikker du på Kør opgradering — indtil da forbliver tjenestens datafunktioner slået fra.

Tip Tjek før hver opgradering i diagnostikken, at kopierne af databaserne er i orden (kortet »Kopier af databaser«), og kopiér filerne: opgraderingen af databaserne arbejder på en kopi og beholder originalen, til kopien er kontrolleret, men kopierne er din egen vej tilbage.

Kopier og gendannelse

Hver tjeneste holder en løbende kopi af de databaser, den har ansvaret for — konti, dokumentindeks, mail, chats — højst omkring et sekund bagud, og kan gendanne den til et hvilket som helst tidspunkt inden for de sidste syv dage. Selve filerne — dokumenter, vedhæftede filer, forhåndsvisninger — skrives én gang og ændres aldrig: de kopieres for sig, eller de ligger i en S3-bucket.

  1. Flyt kopierne af databaserne væk fra maskinen: registrér en destination af klassen backups på en S3-bucket eller på en anden disk, og aktivér den.
  2. Image: kopiér filerne, uden databaserne, mens den kører: docker run --rm -v merydion-prod-allinone_merydion_state:/d:ro -v "$PWD/files":/b alpine sh -c 'tar czf /b/files-$(date +%F).tgz -C /d --exclude="*.db" --exclude="*.db-*" --exclude=./backups --exclude=./restores .' skriver et dateret arkiv i mappen files.
  3. Mappe: stop den med .\stop.ps1, kopiér hele mappen data, og start den derefter igen.
  4. Hvis en administrator har registreret en anden destination til filerne, så kopiér dens mappe i samme omgang: filerne, der er oprettet efter dens aktivering, ligger kun der.
  5. Opbevar kopierne langt fra den maskine, de beskytter.

Tip For at føre én database eller hele installationen tilbage til et bestemt tidspunkt skal du stoppe installationen og køre merydion-storage copies restore (proceduren »Kopier og gendannelse« i runbooken): den skriver de gendannede databaser i en ny mappe, som derefter træder i stedet for den gamle.

Sæt webstedet i coming soon

Coming soon viser hver besøgende kun en forhåndsvisningsside, mens installationen gøres klar: portalen, apps, Palatys og konsollen venter bag den, også for administratorer.

  1. Log ind som administrator, og åbn https://merydion.example.com/coming-soon.html?enabled=true: siden bekræfter, og webstedet er i coming soon.
  2. For at tænde webstedet igen åbner du https://merydion.example.com/coming-soon.html?enabled=false: efter bekræftelsen fører siden dig til forsiden.
  3. Hvis du ikke er logget ind, beder siden dig først om at logge ind; til en konto, der ikke er administrator, siger den det, og intet ændres.
  4. Tilstanden er filen site/coming-soon i datamappen: fjernes den, er webstedet tændt igen, også uden siden.

Tip Coming soon-siden findes på engelsk og italiensk; en besøgende med et andet sprog får den engelske.

Slå besøgsstatistikken til

Webstedet kan tælle sine besøg med Google Analytics 4 og beder først hver besøgende om samtykke: indtil en besøgende accepterer, indlæses intet fra Google. Statistikken forbliver slået fra, indtil installationen angiver sit målings-id, og administrationskonsollen har den aldrig.

  1. Opret i Google Analytics en ejendom og en webstrøm til webstedets adresse, og kopiér dens målings-id (det starter med G-).
  2. Image: i filen .env ved siden af docker-compose.yml tilføjer du MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX og genskaber containeren med docker compose up -d. Mappe: eksportér den samme variabel i sessionen før start.ps1.
  3. Åbn webstedet i et privat vindue: nederst til venstre vises meddelelsen om besøgsstatistik, og nederst på hver side vises »Cookieindstillinger«.
  4. For at slå statistikken fra tømmer du variablen og genskaber containeren: meddelelsen forsvinder, og browserne hos dem, der havde accepteret, holder op med at indlæse Google Analytics.

Tip Privatlivspolitikken og cookiepolitikken beskriver allerede statistikken, på alle sprog, for den installation, der slår den til. Indstil den dataopbevaring, du ønsker, i ejendommen — Google gemmer dataene fra et besøg i højst 14 måneder — og lad Google-signaler være slået fra: webstedet slår dem også fra på sin side.

Åbn webstedet for søgemaskiner

Hver installation beder søgemaskinerne om ikke at indeksere den, før den slår indekseringen til: en kopi af webstedet, der ikke er det officielle — en testinstallation, en organisations installation — konkurrerer aldrig med det i resultaterne. Adresserne, som siderne, forhåndsvisningerne og sitemaps angiver, peger på det officielle websted, https://merydion.eu, og kontosiderne, konsollen og siden for en adresse, der ikke findes, kommer aldrig i et indeks.

  1. Kun på den installation, der leverer det officielle websted. Image: i filen .env ved siden af docker-compose.yml tilføjer du MERYDION_SITE_INDEXING=1 og genskaber containeren med docker compose up -d. Mappe: eksportér den samme variabel i sessionen før start.ps1.
  2. Kontrollér: curl -I https://merydion.eu/ viser ikke længere headeren X-Robots-Tag: noindex, og https://merydion.eu/robots.txt peger på https://merydion.eu/sitemap.xml.
  3. I Google Search Console og i Bing Webmaster Tools bekræfter du domænet med en DNS-post og indsender https://merydion.eu/sitemap.xml.
  4. For at fjerne webstedet fra søgemaskinerne igen tømmer du variablen og genskaber containeren: hvert svar siger noindex igen, og søgemaskinerne fjerner siderne ved deres næste besøg.

Tip En portal, der genereres til en anden adresse, angiver MERYDION_SITE_ORIGIN (for eksempel https://www.example.com), når den genereres: de kanoniske adresser, sprogvarianterne, forhåndsvisningerne og sitemaps peger så på den adresse. Siden for en adresse, der ikke findes, svarer på sproget i sin mappe, med status 404.

Portalens Content-Security-Policy

Portalens sider kører under en streng Content-Security-Policy, som gatewayen sender: en side må kun bruge sine egne filer, forespørgsler til sin egen oprindelse, billeder også fra data: og blob: og ingen ramme fra et andet websted. Det er det, der forhindrer et fremmed stykke markup i at køre kode. Den eneste undtagelse er besøgsstatistikken: de sider, der må tælle besøg, tillader også Googles gtag.js, kun på dens sti, og indsamlingen til Google Analytics, som først indlæses, når en besøgende har accepteret.

  1. En tilpasset portal med scripts eller styles skrevet i siderne virker ikke: scripts og styles hører til i deres egne filer.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE og window.MERYDION_DIAGNOSTICS_BASE kan kun flytte en familie af forespørgsler til en anden sti på samme oprindelse; en adresse på en anden oprindelse ignoreres, med en fejl i browserens konsol.
  3. Siderne i installationens konsol har politikken uden undtagelsen for statistikken og kan desuden ikke vises i en ramme.
  4. Politikken findes i apps/portal-csp.mjs og i de tre Caddyfiler, og en test holder dem ens: ændr den alle fire steder på én gang.

Tip Identitetstjenestens loginformular og konsollens afvisningsside kommer med deres egen, endnu strengere politik.

Tilbage til guiden

Produktivitet, made in Italy.

Giv hele pakken til dit team – enkel, sikker og helt din.