Compare commits

..

27 Commits

Author SHA1 Message Date
4f9cdb02c6 link global gulp to be used locally 2016-06-03 14:16:46 +03:00
eda286ded2 Merge pull request #87 from LaraDock/appleboy-patch-1
Appleboy patch 1 (fixing volumes mounting)
2016-06-03 01:52:24 +03:00
a8b4b61e28 update the volumes mounting of the DB containers 2016-06-03 01:50:11 +03:00
99b54c5f7d remove unnecessary data volume of redis.
Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
2016-06-01 13:44:41 +08:00
8993cccc2c basic updates to the reamdme 2016-05-31 19:15:29 +03:00
e7decdaaf7 add debugging section to the readme 2016-05-28 11:04:05 +03:00
18bf12bfde Merge pull request #74 from abyshakes/master
Issue #73 unable to install workspace container
2016-05-26 21:17:51 +03:00
d829482a06 Issue #73 unable to install workspace container 2016-05-25 22:33:29 +05:30
86c6389650 Merge pull request #70 from Gummibeer/patch-2
Issue #69
2016-05-24 19:49:35 +03:00
991e28046d Issue #69
add memcached to php-cli
2016-05-24 16:44:52 +02:00
ccbc73c6bc update the readme file 2016-05-24 14:01:07 +03:00
246c7366ba Merge pull request #68 from Gummibeer/patch-1
Issue #67
2016-05-24 13:23:13 +03:00
762e2ec07b Issue #67
Issue #67
simpler docker IP-Address get command
2016-05-24 11:54:07 +02:00
adaaa25f47 remove the Laravel installer from the workspace container 2016-05-23 23:32:59 +03:00
11a13a0c33 Merge pull request #66 from AminMkh/workspace-postgres-driver
added postgres driver
2016-05-23 23:24:27 +03:00
c642560993 added postgres driver
added postgres driver to workspace container.
2016-05-23 23:20:07 +03:00
ea9f5c635f Merge pull request #64 from AminMkh/master
Update docker-compose.yml
2016-05-23 23:00:09 +03:00
fd4253afb6 Update docker-compose.yml 2016-05-23 22:23:10 +03:00
73310e45e8 Merge pull request #62 from AminMkh/master
Update README.MD
2016-05-23 21:53:55 +03:00
7f91fc9798 Update README.MD 2016-05-23 21:45:38 +03:00
a8a7685a40 basic changes to the readme format 2016-05-21 19:19:03 +03:00
06c4c19a6f replace official neo4j image with tpires/neo4j
because of this wired error
(https://github.com/neo4j/docker-neo4j/issues/33)
2016-05-20 21:21:19 +03:00
8bff7656f6 add neo4j support to the readme file 2016-05-20 20:37:00 +03:00
5c9eb97db5 Support Neo4j DB (beta) 2016-05-20 20:35:10 +03:00
588819ab6d turn errors and access logs on by default for nginx 2016-05-20 20:32:33 +03:00
170b63a3ba edit redis volume 2016-05-20 09:26:29 +03:00
19813e48c3 add demo video to the readme 2016-05-20 09:24:26 +03:00
6 changed files with 106 additions and 89 deletions

136
README.md
View File

@ -21,6 +21,7 @@ It's like Laravel Homestead but for Docker instead of Vagrant.
- [What is Laravel](#what-is-laravel) - [What is Laravel](#what-is-laravel)
- [Why Docker not Vagrant](#why-docker-not-vagrant) - [Why Docker not Vagrant](#why-docker-not-vagrant)
- [LaraDock VS Homestead](#laradock-vs-homestead) - [LaraDock VS Homestead](#laradock-vs-homestead)
- [Demo Video](#Demo)
- [Requirements](#Requirements) - [Requirements](#Requirements)
- [Installation](#Installation) - [Installation](#Installation)
- [Usage](#Usage) - [Usage](#Usage)
@ -47,6 +48,7 @@ It's like Laravel Homestead but for Docker instead of Vagrant.
- [Run a Docker Virtual Host](#Run-Docker-Virtual-Host) - [Run a Docker Virtual Host](#Run-Docker-Virtual-Host)
- [Find your Docker IP Address](#Find-Docker-IP-Address) - [Find your Docker IP Address](#Find-Docker-IP-Address)
- [Use custom Domain](#Use-custom-Domain) - [Use custom Domain](#Use-custom-Domain)
- [Debugging](#debugging)
- [Help & Questions](#Help) - [Help & Questions](#Help)
@ -89,6 +91,7 @@ docker-compose up nginx mysql redis
- MySQL - MySQL
- PostgreSQL - PostgreSQL
- MariaDB - MariaDB
- Neo4j
- Redis - Redis
- Memcached - Memcached
- Beanstalkd - Beanstalkd
@ -155,7 +158,10 @@ Running a virtual Container is much faster than running a full virtual Machine.
<a name="Demo"></a>
## Demo Video
What's better than a [**Demo Video**](https://www.youtube.com/watch?v=-DamFMczwDA) :)
<a name="Installation"></a> <a name="Installation"></a>
## Installation ## Installation
@ -202,7 +208,7 @@ docker-compose up -d nginx mysql
*Note: the PHP-FPM, Workspace, Application and Data Containers will automatically run.* *Note: the PHP-FPM, Workspace, Application and Data Containers will automatically run.*
Supported Containers: `nginx`, `mysql`, `redis`, `postgres`, `mariadb`, `memcached`, `beanstalkd`, `beanstalkd-console`, `workspace`, `data`, `php-fpm`, `application`. Supported Containers: `nginx`, `mysql`, `redis`, `postgres`, `mariadb`, `neo4j`, `memcached`, `beanstalkd`, `beanstalkd-console`, `workspace`, `data`, `php-fpm`, `application`.
@ -237,13 +243,11 @@ DB_HOST=xxx.xxx.xxx.xxx
5 - Open your browser and visit your `{Docker-IP}` address (`http://xxx.xxx.xxx.xxx`). 5 - Open your browser and visit your `{Docker-IP}` address (`http://xxx.xxx.xxx.xxx`).
<br> <br>
**Debugging**: in case you faced an error here, run this command from the Laravel root directory: **Debugging**: if you are facing any problem here check the [Debugging](#debugging) section.
```bash
sudo chmod -R 777 storage && sudo chmod -R 777 bootstrap/cache
```
If you need a special support. Contact me, more details in the [Help & Questions](#Help) section.
<br> <br>
@ -253,12 +257,12 @@ sudo chmod -R 777 storage && sudo chmod -R 777 bootstrap/cache
<a name="Docker"></a> <a name="Docker"></a>
### Docker ### [Docker]
<a name="List-current-running-Containers"></a> <a name="List-current-running-Containers"></a>
#### List current running Containers ### List current running Containers
```bash ```bash
docker ps docker ps
``` ```
@ -274,7 +278,7 @@ docker-compose ps
<br> <br>
<a name="Close-all-running-Containers"></a> <a name="Close-all-running-Containers"></a>
#### Close all running Containers ### Close all running Containers
```bash ```bash
docker-compose stop docker-compose stop
``` ```
@ -292,7 +296,7 @@ docker-compose stop {container-name}
<br> <br>
<a name="Delete-all-existing-Containers"></a> <a name="Delete-all-existing-Containers"></a>
#### Delete all existing Containers ### Delete all existing Containers
```bash ```bash
docker-compose down docker-compose down
``` ```
@ -307,7 +311,7 @@ docker-compose down
<br> <br>
<a name="Enter-Container"></a> <a name="Enter-Container"></a>
#### Enter a Container (SSH into a running Container) ### Enter a Container (SSH into a running Container)
1 - first list the current running containers with `docker ps` 1 - first list the current running containers with `docker ps`
@ -326,7 +330,7 @@ docker exec -it {container-name} bash
<br> <br>
<a name="Edit-Container"></a> <a name="Edit-Container"></a>
#### Edit default container configuration ### Edit default container configuration
Open the `docker-compose.yml` and change anything you want. Open the `docker-compose.yml` and change anything you want.
Examples: Examples:
@ -354,7 +358,7 @@ Change Redis defaut port to 1111:
<br> <br>
<a name="Edit-a-Docker-Image"></a> <a name="Edit-a-Docker-Image"></a>
#### Edit a Docker Image ### Edit a Docker Image
1 - Find the `dockerfile` of the image you want to edit, 1 - Find the `dockerfile` of the image you want to edit,
<br> <br>
@ -381,7 +385,7 @@ docker-compose build mysql
<br> <br>
<a name="Build-Re-build-Containers"></a> <a name="Build-Re-build-Containers"></a>
#### Build/Re-build Containers ### Build/Re-build Containers
If you do any change to any `dockerfile` make sure you run this command, for the changes to take effect: If you do any change to any `dockerfile` make sure you run this command, for the changes to take effect:
@ -401,7 +405,7 @@ docker-compose build {container-name}
<br> <br>
<a name="Add-Docker-Images"></a> <a name="Add-Docker-Images"></a>
#### Add more Software's (Docker Images) ### Add more Software's (Docker Images)
To add an image (software), just edit the `docker-compose.yml` and add your container details, to do so you need to be familiar with the [docker compose file syntax](https://docs.docker.com/compose/compose-file/). To add an image (software), just edit the `docker-compose.yml` and add your container details, to do so you need to be familiar with the [docker compose file syntax](https://docs.docker.com/compose/compose-file/).
@ -415,7 +419,7 @@ To add an image (software), just edit the `docker-compose.yml` and add your cont
<br> <br>
<a name="View-the-Log-files"></a> <a name="View-the-Log-files"></a>
#### View the Log files ### View the Log files
The Nginx Log file is stored in the `logs/nginx` directory. The Nginx Log file is stored in the `logs/nginx` directory.
However to view the logs of all the other containers (MySQL, PHP-FPM,...) you can run this: However to view the logs of all the other containers (MySQL, PHP-FPM,...) you can run this:
@ -430,31 +434,27 @@ docker logs {container-name}
<br> <br>
<a name="Laravel"></a> <a name="Laravel"></a>
### Laravel ### [Laravel]
<a name="Install-Laravel"></a> <a name="Install-Laravel"></a>
## Install Laravel from a Docker Container ### Install Laravel from a Docker Container
1 - First you need to enter the Workspace Container. 1 - First you need to enter the Workspace Container.
2 - Install Laravel anyway you like. 2 - Install Laravel.
Example using the Laravel Installer:
```bash
laravel new my-cool-app
```
Example using Composer Example using Composer
```bash ```bash
composer create-project laravel/laravel my-cool-app "5.1.*" composer create-project laravel/laravel my-cool-app "5.2.*"
``` ```
For more about this check out this [link](https://laravel.com/docs/master#installing-laravel). > We recommand using `composer create-project` instead of the Laravel installer, to install Laravel.
For more about the Laravel installation click [here](https://laravel.com/docs/master#installing-laravel).
3 - Edit `docker-compose.yml` to Map the new application path: 3 - Edit `docker-compose.yml` to Map the new application path:
@ -477,8 +477,9 @@ cd my-cool-app
<br>
<a name="Run-Artisan-Commands"></a> <a name="Run-Artisan-Commands"></a>
#### Run Artisan Commands ### Run Artisan Commands
You can run artisan commands and many other Terminal commands from the Workspace container. You can run artisan commands and many other Terminal commands from the Workspace container.
@ -524,7 +525,7 @@ laravel new blog
<br> <br>
<a name="Use-Redis"></a> <a name="Use-Redis"></a>
#### Use Redis ### Use Redis
1 - First make sure you run the Redis Container with the `docker-compose` command. 1 - First make sure you run the Redis Container with the `docker-compose` command.
@ -577,7 +578,7 @@ composer require predis/predis:^1.0
<br> <br>
<a name="PHP"></a> <a name="PHP"></a>
### PHP ### [PHP]
@ -585,7 +586,7 @@ composer require predis/predis:^1.0
<a name="Install-PHP-Extensions"></a> <a name="Install-PHP-Extensions"></a>
#### Install PHP Extensions ### Install PHP Extensions
Before installing PHP extensions, you have to decide whether you need for the `FPM` or `CLI` because each lives on a different container, if you need it for both you have to edit both containers. Before installing PHP extensions, you have to decide whether you need for the `FPM` or `CLI` because each lives on a different container, if you need it for both you have to edit both containers.
@ -603,7 +604,7 @@ The PHP-CLI extensions should be installed in `workspace/Dockerfile`.
<br> <br>
<a name="Change-the-PHP-FPM-Version"></a> <a name="Change-the-PHP-FPM-Version"></a>
#### Change the PHP-FPM Version ### Change the PHP-FPM Version
By default **PHP-FPM 7.0** is running. By default **PHP-FPM 7.0** is running.
>The PHP-FPM is responsible of serving your application code, you don't have to change the PHP-CLI version if you are planing to run your application on different PHP-FPM version. >The PHP-FPM is responsible of serving your application code, you don't have to change the PHP-CLI version if you are planing to run your application on different PHP-FPM version.
@ -650,7 +651,7 @@ For more details about the PHP base image, visit the [official PHP docker images
<br> <br>
<a name="Change-the-PHP-CLI-Version"></a> <a name="Change-the-PHP-CLI-Version"></a>
#### Change the PHP-CLI Version ### Change the PHP-CLI Version
By default **PHP-CLI 7.0** is running. By default **PHP-CLI 7.0** is running.
>Note: it's not very essential to edit the PHP-CLI verion. The PHP-CLI is only used for the Artisan Commands & Composer. It doesn't serve your Application code, this is the PHP-FPM job. >Note: it's not very essential to edit the PHP-CLI verion. The PHP-CLI is only used for the Artisan Commands & Composer. It doesn't serve your Application code, this is the PHP-FPM job.
@ -671,14 +672,14 @@ Right now you have to manually edit the `Dockerfile` or create a new one like it
<br> <br>
<a name="Misc"></a> <a name="Misc"></a>
### Misc ### [Misc]
<a name="Run-Docker-Virtual-Host"></a> <a name="Run-Docker-Virtual-Host"></a>
#### Run a Docker Virtual Host ### Run a Docker Virtual Host
These steps are only for **Windows & MAC** users *(Linux users don't need a virtual host)*: These steps are only for **Windows & MAC** users *(Linux users don't need a virtual host)*:
@ -708,10 +709,12 @@ eval $(docker-machine env)
<br> <br>
<a name="Find-Docker-IP-Address"></a> <a name="Find-Docker-IP-Address"></a>
#### Find your Docker IP Address ### Find your Docker IP Address
**On Windows & MAC:** **On Windows & MAC:**
Run this command in your terminal:
```bash ```bash
docker-machine ip default docker-machine ip default
``` ```
@ -719,36 +722,26 @@ If your Host name is different then `default`, you have to specify it (`docker-m
*(The default IP is 192.168.99.100)* *(The default IP is 192.168.99.100)*
<br>
> **boot2docker** users: run `boot2docker ip` *(when boot2docker is up)*. > **boot2docker** users: run `boot2docker ip` *(when boot2docker is up)*.
<br> <br>
**On Linux:** **On Linux:**
1 - Run `ifconfig` in the terminal. Run this command in your terminal:
2 - In the result search for `docker0`, your IP address will be next to `inet addr`.
Example: (In this example your IP address is `172.17.0.1`).
```shell ```shell
docker0 Link encap:Ethernet HWaddr 02:42:41:2d:c4:24 ifconfig docker0 | grep 'inet' | cut -d: -f2 | awk '{ print $1}' | head -n1
inet addr:172.17.0.1 Bcast:0.0.0.0 Mask:255.255.0.0
UP BROADCAST MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
``` ```
>If you have an easier way to do it, share it with us.
*(The default IP is 172.17.0.1)*
<br> <br>
<a name="Use-custom-Domain"></a> <a name="Use-custom-Domain"></a>
#### Use custom Domain (instead of the Docker IP) ### Use custom Domain (instead of the Docker IP)
Assuming your custom domain is `laravel.dev` and your current `Docker-IP` is `xxx.xxx.xxx.xxx`. Assuming your custom domain is `laravel.dev` and your current `Docker-IP` is `xxx.xxx.xxx.xxx`.
@ -777,6 +770,24 @@ server_name laravel.dev;
``` ```
<br>
<a name="debugging"></a>
### Debugging
*Here's a list of the common problems you might face, and the possible solutions.*
#### + I see a blank (white) page instead of the Laravel 'Welcome' page!
run this command from the Laravel root directory:
```bash
sudo chmod -R 777 storage bootstrap/cache
```
#### + I see "Welcome to nginx" instead of the Laravel App!
use `http://127.0.0.1` instead of `http://localhost` in your browser.
@ -790,30 +801,21 @@ server_name laravel.dev;
This little project was built by one man who has a full time job and many responsibilities, so if you like this project and you find that it needs a bug fix or support for new software or upgrade any container, or anything else.. Do not hesitate to contribute, you are more than welcome :) This little project was built by one man who has a full time job and many responsibilities, so if you like this project and you find that it needs a bug fix or support for new software or upgrade any container, or anything else.. Do not hesitate to contribute, you are more than welcome :)
## Support
To suggest a features or report a bug, open a new [Issue](https://github.com/laradock/laradock/issues).
<a name="Help"></a> <a name="Help"></a>
## Help & Questions ## Help & Questions
If you need help with anything related to this project, shedule a live call with me on [Codementor](https://www.codementor.io/mahmoudz), I'd love to help. If you need any help with Docker and Laravel, you can schedule a live call with the creator of this project at [Codementor.io](https://www.codementor.io/mahmoudz), He would love to help.
If you have a short question, send me a direct message on LaraChat, my username is `mahmoud_zalt`. For general questions you can open [Issues](https://github.com/laradock/laradock/issues) here on Github (We will label them as questions).
Additionally, you can contact Mahmoud Zalt (the creator of this project) via a direct message on LaraChat, (his username is `mahmoud_zalt`). Or send him an email (`mahmoud@zalt.me`).
## Credits ## Credits
[![Mahmoud Zalt](https://img.shields.io/badge/Author-Mahmoud%20Zalt-orange.svg)](http://www.zalt.me) - [Mahmoud Zalt](https://github.com/Mahmoudz) (Twitter [@Mahmoud_Zalt](https://twitter.com/Mahmoud_Zalt))
- [Awesome list of contributors](https://github.com/LaraDock/laradock/graphs/contributors)
Twitter: [@Mahmoud_Zalt](https://twitter.com/Mahmoud_Zalt)
<br>
Website: [http://zalt.me](http://zalt.me)
<br>
Email: `mahmoud@zalt.me`
## License ## License

View File

@ -27,11 +27,12 @@ services:
data: data:
build: ./data build: ./data
volumes: volumes:
- /var/lib/mysql - /var/lib/mysql:/var/lib/mysql
- /var/lib/postgres - /var/lib/postgres:/var/lib/postgres
- /var/lib/mariadb - /var/lib/mariadb:/var/lib/mariadb
- /var/lib/redis - /var/lib/memcached:/var/lib/memcached
- /var/lib/memcached - /var/lib/neo4j:/var/lib/neo4j/data
- /var/lib/redis:/data
### Nginx Server Container ################################## ### Nginx Server Container ##################################
@ -60,8 +61,6 @@ services:
MYSQL_USER: homestead MYSQL_USER: homestead
MYSQL_PASSWORD: secret MYSQL_PASSWORD: secret
MYSQL_ROOT_PASSWORD: root MYSQL_ROOT_PASSWORD: root
links:
- php-fpm
### PostgreSQL Container #################################### ### PostgreSQL Container ####################################
@ -75,12 +74,10 @@ services:
POSTGRES_DB: homestead POSTGRES_DB: homestead
POSTGRES_USER: homestead POSTGRES_USER: homestead
POSTGRES_PASSWORD: secret POSTGRES_PASSWORD: secret
links:
- php-fpm
### MariaDB Container ####################################### ### MariaDB Container #######################################
mariadb: mariadb:
build: ./mariadb build: ./mariadb
volumes_from: volumes_from:
- data - data
@ -91,8 +88,18 @@ services:
MYSQL_USER: homestead MYSQL_USER: homestead
MYSQL_PASSWORD: secret MYSQL_PASSWORD: secret
MYSQL_ROOT_PASSWORD: root MYSQL_ROOT_PASSWORD: root
links:
- php-fpm ### Neo4j Container #########################################
neo4j:
build: ./neo4j
ports:
- "7474:7474"
- "1337:1337"
environment:
- NEO4J_AUTH=homestead:secret
volumes_from:
- data
### Redis Container ######################################### ### Redis Container #########################################
@ -102,8 +109,6 @@ services:
- data - data
ports: ports:
- "6379:6379" - "6379:6379"
links:
- php-fpm
### Memcached Container ##################################### ### Memcached Container #####################################

7
neo4j/Dockerfile Normal file
View File

@ -0,0 +1,7 @@
FROM tpires/neo4j
MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
VOLUME /var/lib/neo4j/data
EXPOSE 7474 1337

View File

@ -17,8 +17,8 @@ http {
types_hash_max_size 2048; types_hash_max_size 2048;
include /etc/nginx/mime.types; include /etc/nginx/mime.types;
default_type application/octet-stream; default_type application/octet-stream;
access_log off; access_log on;
error_log off; error_log on;
gzip on; gzip on;
gzip_disable "msie6"; gzip_disable "msie6";
include /etc/nginx/conf.d/*.conf; include /etc/nginx/conf.d/*.conf;

View File

@ -4,6 +4,8 @@ MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
#COPY redis.conf /usr/local/etc/redis/redis.conf #COPY redis.conf /usr/local/etc/redis/redis.conf
CMD [ "redis-server" ] VOLUME /data
EXPOSE 6379 EXPOSE 6379
CMD ["redis-server"]

View File

@ -20,7 +20,7 @@ RUN add-apt-repository -y \
ppa:ondrej/php ppa:ondrej/php
# Install PHP-CLI 7, some PHP extentions and some useful Tools with APT # Install PHP-CLI 7, some PHP extentions and some useful Tools with APT
RUN apt-get update && apt-get install -y \ RUN apt-get update && apt-get install -y --force-yes \
php7.0-cli \ php7.0-cli \
php7.0-common \ php7.0-common \
php7.0-curl \ php7.0-curl \
@ -29,9 +29,11 @@ RUN apt-get update && apt-get install -y \
php7.0-mbstring \ php7.0-mbstring \
php7.0-mcrypt \ php7.0-mcrypt \
php7.0-mysql \ php7.0-mysql \
php7.0-pgsql \
php7.0-sqlite \ php7.0-sqlite \
php7.0-sqlite3 \ php7.0-sqlite3 \
php7.0-zip \ php7.0-zip \
php7.0-memcached \
sqlite3 \ sqlite3 \
libsqlite3-dev \ libsqlite3-dev \
git \ git \
@ -50,6 +52,9 @@ RUN npm install -g \
gulp \ gulp \
bower bower
# Link the global gulp to be used locally
RUN npm link gulp
# Add a symbolic link for Node # Add a symbolic link for Node
RUN ln -s /usr/bin/nodejs /usr/bin/node RUN ln -s /usr/bin/nodejs /usr/bin/node
@ -61,10 +66,6 @@ RUN curl -s http://getcomposer.org/installer | php \
&& mv composer.phar /usr/local/bin/ \ && mv composer.phar /usr/local/bin/ \
&& echo "alias composer='/usr/local/bin/composer.phar'" >> ~/.bashrc && echo "alias composer='/usr/local/bin/composer.phar'" >> ~/.bashrc
# Install the Laravel Installer
RUN composer.phar global require "laravel/installer" \
&& echo "export PATH='~/.composer/vendor/bin:$PATH'" >> ~/.bashrc
# Source the bash # Source the bash
RUN . ~/.bashrc RUN . ~/.bashrc