DFotos hemsida

Versionsnummer: v1

Detta är koden till Datateknologsektionens fotoförenings, hemsida.

För att få inloggning(kerberos) att fungera i fixa krb5.conf såhär: http://dtek.se/wiki/Main/Kerberos. Detta behöver endast göras server-side.

Requirements

Installera

• node/nodejs
• gulp
• kerberos config

Fetch & Build

$> git clone https://github.com/dtekcth/dfotose
$> cd dfotose
$> npm install
...
$> cp src/config/config.yml{.sample,}
$> vim src/config/config.yml
...
$> gulp server:build
$> gulp
...

Besök sidan på http://localhost:4000/ . När du ändrar i koden laddar den om sig själv by default.

Docker

Du kan lätt få upp sidan genom att använda docker.

Först behöver du klona repot, och skapa en config-fil, se till att ändra session-secret till något gött och bra långt!

$> git clone https://github.com/dtekcth/dfotose
$> cd dfotose
...
$> cp src/config/config.yml{.sample,}
$> vim src/config/config.yml
...

När du satt upp det behöver du installera både docker och docker-compose, googla om du inte vet hur. Efter detta är det lätt att slänga igång sidan:

$> docker-compose build
...

För att starta sidan i en produktionsmiljö, kör:

$> make up-prod
...

För att starta den i en utvecklingsmiljö, kör:

$> make up-dev
...

Sidan borde starta tillsammans med mongodb och redis i bakgrunden. Om det är en första gången setup (vilket det oftast är, annars ändra docker-compose.yml till att peka mot andra docker containers) så behöver du ge en första person admin access på sidan. Gör detta genom att öppna en mongo-client (e.g. docker exec -it dfotose_mongo_1 mongo) och sedan slänga in { cid: '<ditt cid>, role: 'Admin' } i usereligibleforrole tabellen.

Sidan exponeras på port 4000 by default, vilket går att ändra i docker-compose.yml.

REST api

DFoto har ett öppet rest-liknande api för att kunna hämta bilder och gallerier. All data returneras formaterad som json.

notera: alla paths prefixas med ett versionsnummer. Se versionsnummret i readme-filen.

Exempel: /gallery => /v1/gallery