Docker

Installation

Getting Docker

Mac (Homebrew)

1. brew cask install docker
2. Launch /Applications/Docker.app.

Other (older Ubuntu versions)

See Install Docker CE. The recommended approach is to install using the repository. See section "Install Docker CE", subsection "Install using the repository" and follow the instructions for:

• SET UP THE REPOSITORY followed by
• INSTALL DOCKER CE

See Docker CE if additional information is required.

Setup

1. Launch Docker.
2. From the folder containing the Dockerfile, build the Docker image.
   • docker build -t cmu-db/terrier .

Usage

1. Run the Docker image: docker run -itd --name build cmu-db/terrier
2. Clone into the image: docker exec build git clone https://github.com/cmu-db/terrier.git /repo
3. Run CMake:

• docker exec build mkdir -p /repo/build
• docker exec -w /repo/build build cmake ..
• docker exec -w /repo/build build make
• docker exec -w /repo/build build make unittest

You can interact with the Docker image with

• single commands: docker exec [-w WORKING_DIRECTORY] build BASH_COMMAND
• interactive: docker exec -it build bash

Note: The below step DELETES all the work you have on Docker.

To stop the Docker image, run both:

1. docker container stop build
2. docker rm build

Quirks

Docker on Windows and Docker on Mac do not behave nicely with LSAN. LSAN needs to be allowed to spawn a ptrace thread. You'll need to docker run --cap-add SYS_PTRACE ... to get it working.