https://github.com/bkuhl/laravel-starter

https://github.com/bkuhl/laravel-starter

Last synced: 30 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/bkuhl/laravel-starter
• Owner: bkuhl
• Created: 2017-08-04T16:23:52.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2018-04-26T18:03:41.000Z (almost 7 years ago)
• Last Synced: 2024-11-07T06:46:24.678Z (3 months ago)
• Size: 397 KB
• Stars: 8
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
## Laravel Docker

This [Laravel](https://www.laravel.com) starter template is intended to be used for new projects that utilize Docker for local development and/or production.



### What's Included

 * Pre-configured `docker-compose.yml` that uses nginx, php-fpm and MySQL.

 * [`gitlab`](https://github.com/bkuhl/laravel-starter/tree/gitlab) branch for a CI pipeline that builds, tests and pushes containers to the registry.  Add a deploy step to meet your needs and you're done

 * [`travis-ci`](https://github.com/bkuhl/laravel-starter/tree/travis-ci) branch includes examples using [Travis-CI](https://travis-ci.org) for building docker containers, running tests against them and pushing them to Dockerhub.  

 



### Using This Repository

Take the contents of this repository and drop these files into the root of your project.  Then run the following commands:

 * `docker-compose up` - Brings the containers online.  The fist time through this will build your containers

 * `docker-compose exec web php artisan migrate --seed` - Runs the migrations/seeders from within the docker container

 * Access your site at http://localhost

#### GitLab

No configuration required.

#### Travis-CI & Dockerhub Setup

Create a repository and replace `bkuhl/laravel-starter` with your project's repository information in `.travis-ci.yml` and `docker-compose.yml`.

#### Travis-CI Setup

Configure the following environment variables:

 * `DOCKER_USERNAME`

 * `DOCKER_PASSWORD`

This user needs to have permission to write to the DockerHub repository so that it can push images.

### Development requirements

* [Docker Toolbox](https://www.docker.com/products/docker-toolbox)

* [GIT Version Control client](https://git-scm.com/)