Skip to content
The examarchive source code for Fachschaft WiWi Uni Münster
Elixir Other
  1. Elixir 97.7%
  2. Other 2.3%
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows
assets
bin
config
lib
priv
rel
test
.dockerignore
.formatter.exs
.gitignore
Dockerfile
Klausuren.csv
LICENSE
README.md
docker-compose.development.yml
docker-compose.sync.yml
docker-compose.test.yml
docker-compose.user.yml
docker-compose.yml
mix.exs
mix.lock

README.md

Klausurarchiv

Dependabot Status Actions Status

Architecture

We have one Dockerfile which consists of three stages:

  1. A Elixir app which compiles, fetches dependencies, ...
  2. A node.js app which compiles the assets. It uses libraries from the Elixir app.
  3. A production stage which copies the results from (1) and (2) and runs them.

In development we split the Dockerfile up into two separate containers (using the target directive) to continously re-compile the app and its assets.

Both containers share a volume with docker-sync to perfomantly access changed files as well as for the Elixir app to deliver the compiled assets.

Developers can mount more Containers into the stack with a custom docker-compose.user.yml file. It can look like this:

  version: "3.4"

  services:
      adminer:
          image: adminer
          ports:
            - 8080:8080
          environment:
            ADMINER_DEFAULT_SERVER: db
            ADMINER_DESIGN: pepa-linha

Setup

Prerequisites

Install:

  • Docker
  • Docker-Compose

Development

  • Run bin/dev, it will run the three containers specified below. You can access the website by visiting http://localhost:4000.
  • Run bin/seed to seed the database.

After the initial start things might be wonky. Just restart the app and you should be fine. There are two cases where you need to interact with Docker directly:

  • In some cases the containers won't stop after ctrl + c and keep running in the background (docker ps). If so you need to run docker-compose down manually. The same goes for the tests.

Testing

If you like you can run bin/test --watch, which will start a separate stack which continuously runs tests agains a test database.

Hosting and Deployment

  • Production URL: klausurarchiv.fachschaft-wiwi.ms
  • GitHub builds containers for each commit. Master commits will be pushed to Docker Packages.
  • Server listens with watchtower for changes and restarts app container.

Learn more about Phoenix

License

Klausurarchiv

Copyright (C) 2019 Fachschaft WiWi Uni Münster

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

You can’t perform that action at this time.