Use Alpine linux for damspas image

- Change from Debian base to Alpine linux. This brings the overall image
size down from 2.2G to 650M..
- Update documentation to reflect usage patterns after some feedback
from Vivian and others

Author: mcritchlow

Dockerfile

@@ -1,24 +1,33 @@
-FROM ruby:2.3.7
+FROM ruby:2.3.7-alpine
 
 # Maintainer
 MAINTAINER "Matt Critchlow <mcritchlow@ucsd.edu">
 
-RUN apt-get update -yqq \
- && apt-get install -yqq --no-install-recommends nodejs libicu-dev libfontconfig1-dev libjpeg-dev libfreetype6 \
- && apt-get clean
+RUN apk add --no-cache \
+  build-base \
+  busybox \
+  ca-certificates \
+  curl \
+  git \
+  gnupg1 \
+  gpgme \
+  less \
+  libffi-dev \
+  libxml2-dev \
+  libxslt-dev \
+  linux-headers \
+  libsodium-dev \
+  nodejs \
+  openssh-client \
+  postgresql-dev \
+  tzdata \
+  rsync \
+  wget
 
-ENV PHANTOM_JS_TAG 2.1.1
-
-# Downloading bin, unzipping & removing zip
-WORKDIR /tmp
-RUN wget -q http://cnpmjs.org/mirrors/phantomjs/phantomjs-${PHANTOM_JS_TAG}-linux-x86_64.tar.bz2 -O phantomjs.tar.bz2 \
-  && tar xjf phantomjs.tar.bz2 \
-  && rm -rf phantomjs.tar.bz2 \
-  && mv phantomjs-* phantomjs \
-  && mv /tmp/phantomjs/bin/phantomjs /usr/local/bin/phantomjs
-
-RUN echo "phantomjs binary is located at `which phantomjs`" \
-  && echo "just run 'phantomjs' (version `phantomjs -v`)"
+# Install phantomjs
+RUN wget -qO- "https://github.com/dustinblackman/phantomized/releases/download/2.1.1a/dockerized-phantomjs.tar.gz" | tar xz -C / \
+  && npm config set user 0 \
+  && npm install -g phantomjs-prebuilt
 
 # Trick to copy in Gemfile before other files.
 # This way bundle install step only runs again if THOSE files change

docker/README.md

@@ -12,16 +12,41 @@ You have two choices for running damspas with Docker:
 
 Setup rails databases:
 - Self contained:
-    - `docker-compose -f docker/dev/docker-compose.yml exec web bundle exec rake db:setup`
+    - `docker-compose -f docker/dev/docker-compose.yml exec -e RAILS_ENV=test web bundle exec rake db:create db:migrate`
 - Dependencies only:
-    - `bundle exec rake db:setup`
+    - `RAILS_ENV=test bundle exec rake db:create db:migrate`
 
 Run damspas test suite:
 - Self contained:
     - `docker-compose -f docker/dev/docker-compose.yml exec web bundle exec rake spec`
 - Dependencies only:
     - `bundle exec rake spec`
 
+# Development Workflow
+If you make changes to the damspas codebase that you want to test, you will need to rebuild the `web`
+container which hosts the damspas application. This can be done as follows:
+
+- Kill/stop the running docker-compose session
+- Rebuild web container: `docker-compose -f docker/dev/docker-compose.yml build`
+- Start docker-compose session again: `docker-compose -f docker/dev/docker-compose.yml up`
+- This should only rebuild what is necessary. And won't run `bundle install`
+  unless you change the Gemfile
+
+## Errors w/ the web container
+
+If you get an error like:
+```
+web_1 | A server is already running. Check /usr/src/app/tmp/pids/server.pid.
+```
+
+You probably didn't cleanly shut down the web container, leaving `tmp` files in
+the container and your local repo that prevent a clean start again. In this case, you should remove any files in `tmp/pids` on your local machine/host.
+
+Now recreate the container so it removes the internal temp files:
+```
+docker-compose -f docker/dev/docker-compose.yml up --force-recreate
+```
+
 # Teardown
 To remove all containers:
 `docker-compose rm`

docker/dev/docker-compose.yml

@@ -17,6 +17,8 @@ services:
 
   database:
     image: ucsdlib/docker-postgres-damsrepo
+    ports:
+      - "5432:5432"
     # volumes:
     #   - db-data:/var/lib/postgresql/data
     env_file:
@@ -37,6 +39,8 @@ services:
 
   tomcat:
     image: ucsdlib/docker-tomcat-damsrepo
+    ports:
+      - "8080:8080"
     command: ["dockerize", "-wait", "tcp://solr:8983", "-timeout", "1m", "-wait", "tcp://database:5432", "-timeout", "1m", "catalina.sh", "run"]
     depends_on:
       - database