Photonia

A self hosted photo sharing webapp.

Technologies

• The backend is Ruby on Rails with Sidekiq as the job processor
• Frontend is VueJS 3 - Development, testing and bundling is done by ViteJS
• Uses GraphQL for communicating between the front and backend, except the photo upload which is a REST call (for now)

Features

• The photos are stored on Amazon S3
• Amazon Rekognition is run on each photo - this creates labels and tags
• Thumbnails are based on what Rekognition identifies in the photos
• Imports photos and metadata exported from Flickr

Development

Setup

sudo apt install libpq-dev libexif-dev imagemagick

Running the dev servers

In separate terminals:

bin/rails s
bin/vite dev
bundle exec sidekiq

Or use overmind: overmind s -N -f Procfile.dev

Starting Docker containers for system specs

docker run -d \
    --name selenium-hub \
    -p 4442-4444:4442-4444 \
    --net grid \
    selenium/hub:latest

docker run -d \
    --net grid \
    --shm-size="2g" \
    -e SE_EVENT_BUS_HOST=selenium-hub \
    -e SE_EVENT_BUS_PUBLISH_PORT=4442 \
    -e SE_EVENT_BUS_SUBSCRIBE_PORT=4443 \
    selenium/node-chrome:latest

Selenium Grid becomes available at http://localhost:4444/ui

Note: For the moment system specs are configured not to run from the .rspec config file.

Versioning & Releases

1. Draft a new release on the releases page
   • Create a tag with the prefix release- and the version, eg: 0.20.0 (resulting tag: release-0.20.0)
   • Prefix the release title with the release version, eg: 0.20.0 - An awesome release
2. Publish the release

Setting up the Docker host

The sitemap file will be persisted outside the container. The following commands should be run in the directory where you plan to run the container before the first deployment:

mkdir -p ./photonia-web/sitemap
touch ./photonia-web/sitemap/sitemap.xml.gz
chmod 777 ./photonia-web/sitemap/sitemap.xml.gz