Skip to content

Ruby-Starter-Kits/Docker-Rails-Template

Repository files navigation

Use this template

Rails App

Welcome to your Ruby On Rails app.

Setup & Running Locally

Clone down the repo, install Docker & run:

$ ./bin/docker/setup
$ ./bin/docker/start

This will build the docker image, then setup the bin/setup file which will run bundle, yarn & create the database.

Then navigate your browser to https://127.0.0.1:3000/ to see your site.

Running one of commands

To run a one off command, run it within the web service, e.g:

$ ./bin/docker/bundle exec rails db:migrate
$ ./bin/docker/bundle
$ ./bin/docker/yarn

Restoring a database

If you have an existing database dump in a file called latest.dump, you can restore it by turning on just the postgres service in one terminal tab, and running pg_restore in a secondary tab:

$ docker-compose up postgres
$ pg_restore --verbose --clean --no-acl --no-owner -j 2 -h localhost -d App_development --username postgres latest.dump

Tests

The template comes preconfigured with RSpec for tests, and comes with a GitHub Action to run them when you push to GitHub.

You can run RSpec locally by running:

$ docker-compose -f docker-compose.ci.yml run --rm test

Linting

This app uses Standard for Ruby and includes a GitHub Action to check future commits are up to standard.

Contributing

This was generated by Ruby-Starter-Kits/Docker-Rails-Generator, if you have any ideas please report them there :)

Usage

Feel free to use these as a starting point for your own Ruby on Rails project!

Resources

License

MIT

Copyright (c) 2020-present, Mike Rogers