Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vuongxuongminh/docker-helm-laravel
Containerize template for Laravel.
https://github.com/vuongxuongminh/docker-helm-laravel
containerize docker docker-compose helm-chart kubernetes laravel php
Last synced: 2 months ago
JSON representation
Containerize template for Laravel.
- Host: GitHub
- URL: https://github.com/vuongxuongminh/docker-helm-laravel
- Owner: vuongxuongminh
- License: mit
- Created: 2020-03-02T17:31:22.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2021-05-01T01:33:29.000Z (over 3 years ago)
- Last Synced: 2023-03-02T18:01:43.536Z (almost 2 years ago)
- Topics: containerize, docker, docker-compose, helm-chart, kubernetes, laravel, php
- Language: Dockerfile
- Homepage:
- Size: 339 KB
- Stars: 19
- Watchers: 1
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 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](https://github.com/vuongxuongminh/docker-helm-laravel/releases), 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:
```shell script
$ 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:
```shell script
$ 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:
```shell script
$ helm dep update ./helm-chart/
```
And install chart:
```shell script
$ helm install app ./helm-chart/
```
The command deploys your project on the Kubernetes cluster in the default configuration. The [Parameters](#parameters) section lists the parameters that can be configured during installation.
### Uninstalling the Chart
To uninstall/delete the app deployment:
```shell script
$ 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,
```shell script
$ 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,
```shell script
$ helm install app ./helm-chart/ -f values.yaml
```
> Tip: You can use the default [values.yaml](/helm-chart/values.yaml) and read more Nginx parameters at [here](https://github.com/bitnami/charts/tree/master/bitnami/nginx).