Modern containerize template for Laravel

About it

This is a template base on laravel/laravel (Laravel 8) and set of Docker services, include basic Helm chart help you save time to start a new containerize project with Laravel.

Prerequisites

Helm version 3.0+
Docker compose 1.17+
Docker engine 17.09+
Kubernetes cluster 1.14+

Getting started

Start by downloading distribution .tar.gz file, or generate a GitHub repo from this repo.

After download and extract, open a terminal, and navigate to the directory containing your project. Run the following command to start all services using Docker Compose:

$ docker-compose pull # Download the latest versions of the pre-built images.
$ docker-compose run --rm setup # Setup project (first time only).
$ docker-compose up -d # Running in detached mode

This starts the following services:

Name	Description	Ports	Environments
fpm	FastCGI process manager with PHP-FPM, Composer.	n/a	all
nginx	Reverse proxy handle request with NGINX.	80	all
setup	Setup service help install Composer package.	n/a	development

This results in the following running containers:

$ docker-compose ps

           Name                          Command                  State                   Ports             
------------------------------------------------------------------------------------------------------------
docker-helm-laravel_fpm_1     docker-entrypoint fpm            Up (healthy)                                 
docker-helm-laravel_nginx_1   /opt/bitnami/scripts/nginx ...   Up (healthy)   0.0.0.0:80->8080/tcp, 8443/tcp
docker-helm-laravel_setup_1   docker-entrypoint setup          Exit 0

If you want to change a PHP or Nginx version, open docker-compose.yaml and add build args:

PHP_VERSION for change php version (ex: PHP_VERSION: '7.3').

Now you can visiting your Laravel app: http://localhost

Deploy project into Kubernetes cluster

Install

Firstly you need to update helm dependencies by running:

$ helm dep update ./helm-chart/

And install chart:

$ helm install app ./helm-chart/

The command deploys your project on the Kubernetes cluster in the default configuration. The Parameters section lists the parameters that can be configured during installation.

Uninstalling the Chart

To uninstall/delete the app deployment:

$ helm uninstall app

Parameters

The following table lists the configurable parameters of this chart and their default values.

Parameter	Description	Default
global.fpm.image.repository	Image repo.	`vuongxuongminh/docker-helm-laravel`
global.fpm.image.tag	Image tag.	`production`
global.fpm.image.pullPolicy	Image pull policy.	`IfNotPresent`
global.fpm.env	Use to set `APP_ENV` env in FPM container.	`production`
global.fpm.debug	Use to set `APP_DEBUG` env in FPM container.	`false`
global.fpm.key	Use to set `APP_KEY` env in FPM container.	`base64:!ChangeMe!`
global.fpm.url	Use to set `APP_URL` env in FPM container.	`http://example`

Specify each parameter using the --set key=value[,key=value] argument to helm install. For example,

$ helm install app ./helm-chart --set global.fpm.env="production" --set global.fpm.debug="false"

The above command sets the environment variables APP_ENV to production, APP_DEBUG to false.

Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart. For example,

$ helm install app ./helm-chart/ -f values.yaml

Tip: You can use the default values.yaml and read more Nginx parameters at here.

vuongxuongminh/docker-helm-laravel