Deploy a RESTful API using Laravel and Docker

Getting Started

  • API Laravel Boilerplate 5.5
  • Apache 2
  • MySQL
  • Xdebug
  • Docker

You can manage a RESTful API in the fastest, simplest and funniest way! and with open source code dependencies.

However you can contribute for better performance, the goal is to focus on the code avoiding the configurations and having docker installed.


Prerequisites

Environments

Dev or Local Mode

  • docker-compose-dev.yml: generate automatically folders and require-dev dependencies on your local workspace including Xdebug. Note: the yaml file has a key called:”XDEBUG_MODE”, this yaml by default has the value true (1) to install it.

You can appreciate the dependencies generated automatically on your workspace!

Play with Docker Mode

http://play-with-docker.com?stack=https://raw.githubusercontent.com/jfernancordova/docker-laravel-api-dev/master/docker-compose-pwd.yml
  • docker-compose-pwd.yml: you can use it to visualize this environment and test it, however, you should see the container lists to verify the HEALTHCHECK.
# container lists docker ps # make sure that the docker dockerlaravelapidev_php_1 or php container is (healthy), normally the process begins in starting mode (health: starting)

Production Mode

  • docker-compose-prod.yml: if you are going to use this yaml, make sure to generate the migrations before!, you can modify the entrypoint to generate them.

Deployment

Docker Environments

Clone this repository and run the following commands based on your orchestrator.

Swarm Mode

Clone this repository and run the following commands:

cd docker-laravel-api-dev/ docker stack deploy -c docker-compose-dev.yml docker-laravel-api-dev 
# wait for the HEALTHCHECK in healthy mode

Docker Compose

Clone this repository and run the following commands:

cd docker-laravel-api-dev/ docker-compose -f docker-compose-dev.yml up --build -d or to see the logs docker-compose -f docker-compose-dev.yml up 
# wait for the HEALTHCHECK in healthy mode

Running the tests

You have a Travis Pipeline to apply Continous Integration, and other technology to test this environment.

You can modify the runtests.sh from the scripts folder

Insert jobs, instructions builds in this pipeline

Github Repository

docker-laravel-api-dev

API Boilerplate Reference

https://github.com/francescomalatesta/laravel-api-boilerplate-jwt/blob/master/readme.md

Author

License

This project is licensed under the MIT License — see the LICENSE.md file for details

Acknowledgments

  • Hat tip to anyone who’s code was used
  • Inspiration

Originally published at dev.to.

José Fernando Cordova

Written by

Software Developer. https://about.me/jfernancordova

More From Medium

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade