Local Environment

Using Docker for our local environment

Requirements

1. Having Docker installed (you will need to create a Hub account)
2. Having Git installed

Installation

1. Clone this repository into your projects folder using the git clone command

Instructions

1. After cloning the project, open your terminal and access the root folder using the cd /path/to/the/folder command.
2. To start the local environment, execute the command make run in your terminal. For Windows users, execute the command docker-compose -d up instead.

Note: The first time you run this command it will take some time because it will download all the required images from the Hub.

At this point, if you execute the command docker ps you should see a total of 4 containers running:

pw_local_env-nginx
pw_local_env-admin
pw_local_env-php
pw_local_env-db

The application should be running in the 8030 port of your local machine but, before trying it, lets add one entry to your hosts file.

For OSX users, this file should located at /etc/hosts. For Windows users, you can check this guide.

Edit the file and add the following entry:

127.0.0.1 pw.test

At this point, you should be able to access to the application by visiting the following address in your browser http://pw.test:8030/.

Database

There are multiple ways to access to the database inside the docker container. In this case we are going to cover two options:

1. Manually accessing the container
2. Using the adminer image

Manually

In order to manually access to the database, first, we need to copy the id of the pw_local_env-db container. To check it, use the docker ps command.

Now, we are going to ssh into the container using the command docker exec -it container_id bash. At this point, you should be able to notice that the terminal prompt has changed because now you are inside of the container.

To access the database, execute the command mysql -u root -p.

Adminer image

To access to the admin page, visit the URL http://localhost:8080/ in your browser.

The host should be db (the name of the service used in the docker-compose file).

The user should be root and the password is the one specified in the .env file in the MYSQL_ROOT_PASSWORD field.

QA

1. How to list all the running containers

Use the docker ps command. Use the -a flag to list also the stopped ones.

2. How to list all the docker images that I have installed

Run the command docker images

3. How to remove all the images that are no longer used

Run the command docker image prune

4. How to check the logs of an specific container

Run the command docker ps and copy the id of the container that you want to debug.

Now, run the command docker logs --follow container_id.

5. How to ssh into an specific container

Run the command docker ps and copy the id of the container that you want to debug.

Now, run the command docker exec -it container_id bash.

Note: If you are using the alpine version of image, you need to use ash instead of bash.

6. Where can I find more docker images to use them

You can check the Docker Hub.