This project aims to make a ready to start Apostrophe boilerplate using Docker containers and docker-compose. Apostrophe Boilerplate is a minimal starting point for Apostrophe 2 projects. Docker provides a way to run applications securely isolated in a container, packaged with all its dependencies and libraries. MongoDB is a great document database used by Apostrophe and many other software products.
Once you have a local copy of this project, make sure you have Docker installed on your system.
From the root of the project dir exec the following:
$ docker-compose upThis will launch two docker containers, one with mongoDB and the other running Apostrophe with the boilerplate project.
Now you're all set! Start building your own Apostrophe site, changes made to the source files will be automatically reloaded with the help from nodemon. Head to localhost:3000 in your web browser to view your Apostrophe site.
In the folder db_backup you will find a script to make a dump of the mongo database. The script will prompt you if you wish to backup or restore the database dump.
$ ./db_backup/backup_script.shAfter a backup the database dump will be located in db_backup/dump/. Use this dump to restore your work on a different machine or for deployment.
- More documentation on Apostrophe, go to the A2 documentation site.
- Documentation on Docker, go to the Docker Documentation
- For an excellent introduction to Node.js in Containers Using Docker, visit webapplog's blog post