Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SpiralOutDotEu/dockervel
Laravel development environment in Docker containers
https://github.com/SpiralOutDotEu/dockervel
artisan-command docker docker-compose docker-container gulp laravel nginx nodejs redis
Last synced: 3 months ago
JSON representation
Laravel development environment in Docker containers
- Host: GitHub
- URL: https://github.com/SpiralOutDotEu/dockervel
- Owner: SpiralOutDotEu
- Created: 2015-12-28T01:12:58.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2018-11-24T09:44:53.000Z (almost 6 years ago)
- Last Synced: 2024-07-18T22:17:52.071Z (4 months ago)
- Topics: artisan-command, docker, docker-compose, docker-container, gulp, laravel, nginx, nodejs, redis
- Language: Shell
- Size: 15.6 KB
- Stars: 30
- Watchers: 5
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Dockervel
## A complete Laravel development environment in Docker Containers
### Update (11/18): Now with PHP7 & Unit test support
* Bring Up a Laravel development environment with a single command easy as `dup`
* Execute Artisan commands easy as `dartisan make:auth`
* Run Composer command easy as `dcomposer update`
* Run NodeJS script easy as `dnodejs npm install`
* Run gulp watch easy as `dgulp-watch`
* Containers managed with docker-compose
* Lightweight as it is mostly based in Linux Alpine base image of 5MB.
* Using Docker-composer version 2 (new)
### Containers included
* Nginx 1.14 & PHP 7.2 running in Alpine
* MySQL running in Alpine
* Redis running in Alpine
* Composer PHP running in Alpine.
* Artisan running in Alpine
* NodeJS with gulp, grunt and bower -g installed in official node:4.2.2-slim base image
* Volumes mounted as containers
## Usage
Make sure you have `docker` `docker-machine` and `docker-compose` installed. See [here for installing them](http://www.spiralout.eu/2015/12/docker-installation-in-linux-mint-and.html)
* clone this repo: `git clone https://github.com/SpiralOutDotEu/dockervel.git`
* cd in: `cd dockervel`
* run as su: `sudo su`
* add aliases: `. ./aliases.sh`
* run: `dup`
and you have a server running! Hit `localhost` in your browser and you will see nginx fault message becasuse there is no `www/public/index.php`.
* create new Laravel project: `dcomposer-create`
* or create new Lumen project: `dcomposer-create-lumen`
* fix permissions: `dpermit`
* change .env: [see below for options](https://github.com/SpiralOutDotEu/dockervel/blob/master/README.md#configure-laravel-for-mysql)
* run artisan commands: `dartisan make:auth` , `dartisan migrate`
* fix permissions: `dpermit`
Now you have a registration system active. Go to `localhost` and register a new user to see that db's are running ok.
* npm install: `dnodejs npm install`
* gulp install: `dnodejs gulp install`
* gulp watch: `dulp-watch`
Now there is one container running `gulp watch` and monitors changes on files according your `gulpfile.js`
* Run PhpUnit test with `dunit`
## aliases
aliases.sh contains shortcuts to common commands.
run dot space dot /aliases.sh to activate aliases for this terminal session.
```bash
. ./aliases.sh
```
and now for this terminal session you have aliases like `dartisan`, `dcomposer`, `dnodejs`, `dup`, `dstop`, `dunit`.
If you don't want to work with aliases, open the script and see the coressponding commands next to each alias.
In the following document it is supposed that you have executed `aliashes.sh` as `su` and you have the aliases active.
### Create new Laravel Project
* create new laravel project: `dcomposer-create`
* type `localhost` in your browser and you see the Laravel welcome screen
### or Create new Lumen Project
* create new laravel project: `dcomposer-create-lumen`
* type `localhost` in your browser and you see the Lumen welcome screen
### Fix permitions
since containers have different user in them, you have to change the permisions in www/ folder to be able to write. type:
```bash
dpermit
```
it will simply `chmod -R 777 www`
Remember to run `dpermit` after each time the `www` folder has a new file.
### Configure Laravel for mysql
change `DB_HOST` in `.env` to point to `mysql`. This is the name that it is used in docker-compose.yml (`link: -mysql:mysql`)
```ini
DB_HOST=mysql
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret
```
### Configure Laravel for redis
change `REDIS_HOST` in `.env` to point to `predis`. This is the name that it is used in docker-compose.yml (`link: -redis:predis`).
```ini
REDIS_HOST=predis
REDIS_PASSWORD=null
REDIS_PORT=6379
```
in Laravel 5.2 there are some issues with `redis` namespace, so to avoid conflicts `predis` is used.
Also you have to change /config/app.php, and replace:
```ini
'Redis' => Illuminate\Support\Facades\Redis::class,
```
with
```ini
'LaravelRedis' => Illuminate\Support\Facades\Redis::class,
```
Use it like:
```php
$redis= LaravelRedis::connection();
$redis->set('name', 'myname');
$redis->get('name');
```
### Running Artisan commands
type `dartisan` followed by an artisan command
```bash
example:
$ dartisan make:auth
$ dartisan migrate
$ dartisan tinker
```
### Running composer commands
type `dcomposer` followed by a composer command
```bash
example:
$ dcomposer update
$ dcomposer require predis/predis
```
### Nodejs
to install node modules in your project run
```bash
dnodejs npm install
```
### Gulp
install gulp with:
```bash
dnodejs gulp install:
```
run gulp once:
```bash
dgulp
```
add gulp watch:
```bash
dgulp-watch
```
## Credits
Thanx to:
* [Josh Sandlin](https://github.com/dydx)
* [Dylan Lindgren](https://github.com/dylanlindgren)
* [10Startups](https://github.com/tenstartups)
* [Tom Sowerby](https://medium.com/@tomsowerby)
* [Tim de Pater](https://github.com/TrafeX)