Getting started

If you run into any problem, please post it as an issue on GitHub.

1. For this project you need to have installed on your machine:

   • Docker Engine CE.
   • Docker Compose (install the latest stable version, don't use apt-get and the likes).
   • Bash (same here, just try bash --version in a terminal).
   • Git (run git --version to see if you already have it installed).
   • A PHP IDE, preferably PhpStorm.

2. Clone this project to your machine:

   git clone [email protected]:matthiasnoback/building-autonomous-services-workshop.git
   

3. Next, cd into the project directory and run:

   bin/install
   

4. Run the application:

   bin/start
   

You should finally see a message asking you to open http://dashboard.localtest.me in your browser. When you do this, you should see a nice web application. Feel free to click around.

Troubleshooting

Docker says: "Bind for 0.0.0.0:80 failed: port is already allocated"

You have some service running that's already listening on port 80 (like a local Apache or Nginx or something). Close it first, then try again.

dashboard.localtest.me can't be resolved

In rare cases the *.localtest.me domains used by this project don't resolve to 127.0.0.1. If that's the case you have to add them your hosts file:

127.0.0.1 dashboard.localtest.me catalog.localtest.me stock.localtest.me sales.localtest.me purchase.localtest.me

A note for Windows users

This setup should work on Windows too, with Docker for Windows and Git Bash.

If you feel like you won't be able to install all the tools listed above on your Windows machine, you may want to take a look at Get started with Docker Machine and a local VM).

A note for Linux users

On Linux, to run docker without super user privileges, the desired user needs to be a member of the docker group (see https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user).