Skip to content
Browse files

Merge pull request #869 from ccjjmartin/master

Add docker-compose as dependency and fix broken links
  • Loading branch information...
Schnitzel committed Feb 28, 2019
2 parents b23bedd + f3a8fbf commit 042299e56fd6062ef0e08d1f6a318b456e962a72
Showing with 7 additions and 3 deletions.
  1. +7 −3 docs/developing_lagoon/
@@ -6,6 +6,10 @@ Development of Lagoon happens locally via Docker. We are using the new [Docker M

Please check the [official Docs of Docker]( how to install Docker.

### On Linux Install Docker Compose

Docker compose is included in Docker for Mac installations. For linux installations see the directions here: [](

## Start Services

1. Add `` to insecure registries in Docker (see [here]( how to do that). Also make sure that you give your Docker Host minimum 4 CPUs and 4GB Ram.
@@ -41,7 +45,7 @@ make logs
make tests

6. Look what happens in OpenShift: []() (developer/developer)
6. Look what happens in OpenShift: []( (developer/developer)

## Local Development

@@ -57,7 +61,7 @@ The services not only share many node packages, but also share actual custom cod

The API uses a puppet compatible yaml format to store it's data. On production this hiera is in another git repository. For local development there is a folder `local-hiera` which contains testdata that is used during development and testing, plus has no client related data in them. For easier development there is `local-hiera-watcher-pusher` which watches the `local-hiera` folder and on every changes pushes the changes into `local-git-server` which emulates a git server like it is on production. The api service is connecting to this local git server and updates it's data from it.

### Troubleshooting
## Troubleshooting

**I can't build any docker image for any Node.js based service**

@@ -78,7 +82,7 @@ Some ISPs set up a "search domain" to catch domain name errors. Virtualbox will
into minishift which can cause domain resolution errors in the openshift pods. To check for this
problem, look at the `/etc/resolv.conf` in your failing pod and check for errant search domains.

![OpenShift pod resolver settings](/images/pod_search_domains.jpg)
![OpenShift pod resolver settings](../images/pod_search_domains.jpg)

To fix, you must remove the extra search domain. Login to the minishift vm (`minishift ssh`) and
remove the setting from `/etc/resolv.conf`. Restart openshift docker, `sudo docker restart origin`.

0 comments on commit 042299e

Please sign in to comment.
You can’t perform that action at this time.