vuongxuongminh / docker-helm-laravel

Containerize template for Laravel.

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.