cst1/openstreetmap-website
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Clarifications to Docker instructions

Browse source
This commit is contained in:
Jamie Alessio 2020-03-02 03:18:25 +00:00 • committed by Michal Migurski
parent 255ce8708a
commit 395300d8f3
1 changed files with 11 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
DOCKER.md
View file

@ -1,18 +1,14 @@
# Using Docker and Docker Compose to run OpenStreetMap
# Using Docker and Docker Compose for Development and Testing
Using [Docker](https://www.docker.com/) will allow you to install the OpenStreetMap application and all its dependencies in Docker images and then run them in containers, almost with a single command. You will need to install Docker and Docker Compose on your development machine:
These instructions are designed for setting up The Rails Port for development and testing using [Docker](https://www.docker.com/). This will allow you to install the OpenStreetMap application and all its dependencies in Docker images and then run them in containers, almost with a single command. You will need to install Docker and Docker Compose on your development machine:
- [Install Docker](https://docs.docker.com/install/)
- [Install Docker Compose](https://docs.docker.com/compose/install/)
The first step is to fork/clone the repo to your local machine. The repository is reasonably large (~150MB) and it's unlikely that you need the full history. If you are happy to wait for it all to download, run:
The first step is to fork/clone the repo to your local machine:
git clone https://github.com/openstreetmap/openstreetmap-website.git
To clone only the most recent version (~23MB), instead use a 'shallow clone':
git clone --depth=1 https://github.com/openstreetmap/openstreetmap-website.git
Now change working directory to the `openstreetmap-website`:
cd openstreetmap-website
@ -35,7 +31,7 @@ This is a workaround. [See issues/2185 for details](https://github.com/openstree
## Installation
In the root directory run:
To build local Docker images run from the root directory of the repository:
docker-compose build
@ -54,7 +50,13 @@ This will launch one Docker container for each 'service' specified in `docker-co
Run the Rails database migrations:
docker-compose run --rm web rake db:migrate
docker-compose run --rm web bundle exec rake db:migrate
### Tests
Run the test suite by running:
docker-compose run --rm web bundle exec rake test:db
### Loading an OSM extract
@ -81,10 +83,6 @@ Once you have data loaded for Washington, DC you should be able to navigate to `
See `CONFIGURE.md` for information on how to manage users and enable OAuth for iD, JOSM etc.
### Tests
docker-compose run --rm web rake test:db
### Bash
If you want to get into a web container and run specific commands you can fire up a throwaway container to run bash in via: