DOCKER_README.MD

In this page you will find our recommended way of installing Docker on your machine. This guide is made for OSX users.

Install docker

First install Docker using Homebrew

$ brew install docker

You can then install Docker Desktop if you wish, or use docker-machine. As we prefer the second option, we will only document this one.

Setup your docker

Install docker-machine

$ brew install docker-machine

Then install VirtualBox with Homebrew Cask to get a driver for your Docker machine

$ brew cask install virtualbox

You may need to enter your password and authorize the application in your System Settings > Security & Privacy.

Create now a new machine, set it up as default and connect your shell to it (here we use zsh. The commands should anyway be displayed in each steps' output)

$ docker-machine create --driver virtualbox default
$ docker-machine env default
$ eval "$(docker-machine env default)"

Now you're all setup to use our provided Docker image!

Build the image

docker build -t algolia-rails .

Run the image

You need to provide few environment variables at runtime to be able to run the Common Test Suite. You can set them up directly in the command:

docker run -it --rm --env ALGOLIA_APP_ID=XXXXXX [...] -v $PWD:/app -w /app algolia-rails bash

However, we advise you to export them in your .bashrc or .zshrc. That way, you can use Docker's shorten syntax to set your variables.

docker run -it --rm --env ALGOLIA_APPLICATION_ID \
                    --env ALGOLIA_API_KEY \
-v $PWD:/app -w /app algolia-rails bash

Once your container is running, any changes you make in your IDE are directly reflected in the container.

To launch the tests, you can use one of the following commands

# run the whole test suite
bundle exec rspec

# run a single test
bundle exec rspec ./path/to/test_spec.rb:#line_number

Feel free to contact us if you have any questions.