README.md

Deploy with Docker

Prerequisites

• Install a maintained version of Docker Community Edition (CE) or Enterprise Edition (EE) on a supported platform. Install docker.
• Download the Docker folder of this repo.

Steps to follow

• Locate your terminal inside the docker folder that you recently downloaded.
• Run the following script to build the image with all the prerequisites from the Dockerfile file:

./buildDocker.sh

• Run the following script to create a container from the esug image:

./startDocker.sh

• Now you can see the page running in: http://localhost:8000/ESUG
• To stop the container

./stopDocker.sh

Connect to a running container

• The above script will make you enter a container terminal, where you must execute the following script:

./bashDocker.sh

• Connect to the shell that ran pharo

screen -r esug

• To exit this bash, type Ctr + d

Restore the data if the image breaks

The page generates a backup file after each modification to the database, to restore this data, follow the next steps:

• Connect to the container in which I create the image:

./bashDocker.sh

• Run the following script to re-create a fresh Pharo image:

./createPharoImage.sh

• And finally execute this command, to re-launch this fresh image:

screen -Sdm esug ./pharo esug.image --no-quit

Restore data when server stops unexpectedly

• Connect to the container in which I create the image:

./bashDocker.sh

• Run the following script to restore data and start the server (exists 2 cases)

1. If you want to use a specific backup file, you must change the path argument to the path of the file you wish to restore (it must have the name with the format: esug.positive_number, eg esug.2, esug.7, etc.)

screen -Sdm esug ./pharo esug.image restore --no-quit "/esug/Backup/esug.13"

2. If you want use the last backup path by default (/esug/Backup/esug.lastBackup)

screen -Sdm esug ./pharo esug.image restore --no-quit