Preskoči na vsebino

Hiter začetek z Dockerjem

Z Docker Compose zaženite ločeno namestitev ReportHub na svojem strežniku. Izberite Community za javne prijave ali Safety / VZD za interne nevarnosti in korektivne ukrepe. Vsaka namestitev uporablja en modul.

Želite upravljano gostovanje? Pišite CELEONU za dogovor o namestitvi in obsegu upravljanja.

Že imate dostop do aplikacije? Začnite z uporabniškimi vodniki za Community in Safety / VZD.

1. Pripravite strežnik

Razdelek 1. Pripravite strežnik

Potrebujete strežnik Linux z Docker Engine, dodatkom Docker Compose, curl in OpenSSL. Potrebujete tudi gostiteljsko ime, usmerjeno na strežnik, ter dostopna vhodna priključka 80 in 443 za Caddyjevo nastavitev HTTPS. Za vsako namestitev uporabite svojo mapo in gostiteljsko ime.

Ukazi so namenjeni novi namestitvi. Do izdelave skrbniškega računa omejite dostop do začetne nastavitve, na primer z začasnim pravilom požarnega zidu za svoj naslov IP.

Terminal
mkdir reporthub
cd reporthub
curl --fail --location \
--output docker-compose.yml \
https://reporthub.celeon.si/downloads/reporthub/docker-compose.yml
curl --fail --location \
--output Caddyfile \
https://reporthub.celeon.si/downloads/reporthub/Caddyfile.txt
curl --fail --location \
--output .env \
https://reporthub.celeon.si/downloads/reporthub/env.example

docker-compose.yml · Caddyfile · .env

Datoteke uporabljajo objavljeno sliko ghcr.io/cuaupro/reporthub; izvorni repozitorij in lokalna namestitev Node.js nista potrebna. Vključeni so Caddy, ReportHub in PostgreSQL/PostGIS. Javno je dostopen samo Caddy; aplikacija in podatkovna zbirka ostaneta v internem omrežju Compose.

Odprite .env v urejevalniku besedila. Zamenjajte vzorčno gostiteljsko ime in e-pošto ter izpolnite obe prazni skrivnosti:

Nastavitev Kaj vpišete
APP_HOST Gostiteljsko ime vaše namestitve, na primer reports.example.org, brez https:// in poti. DNS mora kazati na ta strežnik.
CADDY_EMAIL E-poštni naslov, ki ga spremljate, za postopke s potrdili HTTPS.
POSTGRES_PASSWORD Novo močno geslo podatkovne zbirke.
ANALYTICS_HASH_SECRET Ločeno naključno skrivnost za psevdonimizacijo analitike aplikacije na podlagi privolitve. Med ponovnimi zagoni je ne spreminjajte. S tem ne omogočite analitike produktnega spletnega mesta.
TZ Časovni pas IANA; predloga uporablja Europe/Ljubljana.
REPORTHUB_TAG Oznako slike aplikacije. Predloga uporablja latest; za nadzorovano produkcijsko uvedbo izberite preverjeno oznako izdaje.

Z naslednjim ukazom ustvarite vrednost, nato ga za drugo skrivnost zaženite še enkrat. Različna izpisa vnesite v .env:

Terminal
openssl rand -hex 32

Datoteko .env hranite zasebno in zunaj nadzora izvorne kode. V Linuxu omejite njene pravice:

Terminal
chmod 600 .env

Privzeta shramba datotek je lokalna, v trajnem nosilcu Docker z javno in zasebno mapo. SMTP in shramba, združljiva s S3, sta neobvezna. Potrjevanje po e-pošti, vabila in e-poštna obvestila potrebujejo delujoč SMTP; pošiljanje je privzeto izključeno. V pregledu spremenljivk okolja so vse podprte nastavitve, primeri za pošto in S3 ter navodila za uveljavitev sprememb.

3. Zaženite ReportHub

Razdelek 3. Zaženite ReportHub

V mapi s tremi prenesenimi datotekami zaženite:

Terminal
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps

Compose ustvari trajne nosilce za podatkovno zbirko, datoteke in Caddy. Aplikacija ob zagonu izvede migracije. Počakajte, da so storitve zdrave, nato v brskalniku odprite https:// in svoje ime APP_HOST. Caddy samodejno pridobi potrdilo HTTPS, ko sta DNS in omrežni dostop ustrezno nastavljena.

Če zagon ne uspe, preglejte dnevnik aplikacije:

Terminal
docker compose logs --tail 100 reporthub

Preverite gostiteljsko ime, razpoložljivost priključkov, DNS in obvezne vrednosti .env. Ukaza docker compose down -v ne uporabljajte za odpravljanje težav: izbriše trajne nosilce in njihove podatke.

4. Začnite preizkus

Razdelek 4. Začnite preizkus
  1. Ob prvem obisku izberite Community ali Safety / VZD.
  2. Ustvarite začetni skrbniški račun. Modul se shrani skupaj s tem računom in ga v tej namestitvi ni mogoče pozneje zamenjati.
  3. V razdelku Namestitev / licenca izberite Začni preizkus. 30-dnevni preizkus z vsemi funkcijami ne zahteva uvoza licenčne datoteke.
  4. Za napolnjeno testno okolje se vrnite v Namestitev / licenca (/installation) in izberite Pripravi demo namestitev, preden vnesete lastne nastavitve ali prijave. Postopek zaključi nastavitve in ustvari izmišljene uporabnike, lokacije in prijave. Vaš skrbniški račun ostane ohranjen, pošiljanje e-pošte pa je izključeno. Demo računi uporabljajo geslo, prikazano v aplikaciji; dostop omejite na uporabnike preizkusa.
  5. Namesto dema lahko zaključite nastavitve z lastnimi organizacijami, kategorijami, odgovornostmi in podatki o zasebnosti.

Preizkus začne teči ob začetku preizkusa, ne ob prenosu ali zagonu vsebnikov. Priprava dema samodejno začne še neuporabljen preizkus. Po poteku sta branje in izvoz ohranjena, oddaja in spremembe pa se ustavijo. Ustrezno komercialno licenco lahko uvozite med preizkusom ali po njem. Produkcijska uporaba zahteva komercialni dogovor ali pisno odobritev.

Nadaljujte s prvimi koraki v aplikaciji.

Ohranite nadzor nad namestitvijo

Razdelek Ohranite nadzor nad namestitvijo

Če pogodba ne določa drugače, skrbite za varnost strežnika, posodobitve, nadzor, kopije podatkovne zbirke in datotek ter preverjanje obnovitve. Podatkovno zbirko in datoteke varnostno kopirajte skupaj; sama kopija podatkovne zbirke ne vsebuje fotografij, tlorisov ali dokazil.

Za začasno ustavitev, ki ohrani podatke:

Terminal
docker compose stop

Isto namestitev spet zaženete z docker compose up -d iz iste mape. Ohranite ime projekta Compose in .env; gesla že inicializirane podatkovne zbirke ne menjajte brez usklajene spremembe v podatkovni zbirki.