Build Docker image for Laravel Framework

https://youtube.dimas-maryanto.com/posts/devops/docker/dockerfile/study-cases/08k-build-laravel-apps

Hai semuanya, di materi kali ini kita akan membahas Build docker image untuk PHP Framework yang paling popular yaitu Laravel v8.x. Supaya pembahasannya tidak terlalu panjang kita bagi menjadi beberapa section diantaranya:

Setup SDK Local environment
Deployment using Apache2/Httpd
Build & Running docker image
Cleanup

Setup SDK Local environment

Untuk meng-setup Software Development project Laravel sebetulnya ada banyak cara seperti yang di Official Documentation Laravel Seperti contohnya

Within WSL2
Docker
Sail Service
Composer
Laravel Installer

Klo saya sendiri lebih sering menggunakan Composer. Sebelum kita membuat project Laravel dengan Composer kita harus configure dulu PHP environtmennya seperti

PHP >= 7.3
BCMath PHP Extension
Ctype PHP Extension
Fileinfo PHP Extension
JSON PHP Extension
Mbstring PHP Extension
OpenSSL PHP Extension
PDO PHP Extension
Tokenizer PHP Extension
XML PHP Extension
mcrypt PHP Extension

Setelah kita configure engine PHP nya, selanjutnya kita install untuk package managernya yaitu menggunakan Composer, Selantutnya kita buat project dengan menggunakan perintah seperti berikut:

composer create-project laravel/laravel docker-laravel && \
cd docker-laravel && \
composer install

Setelah itu kita bisa config dulu system Laravelnya seperti

Copy .env.example menjadi .env menggunakan perintah berikut: php -r "file_exists('.env') || copy('.env.example', '.env');"
Set APP_KEY dengan php artisan package:discover --ansi && php artisan key:generate --ansi

Kemudian kita bisa jalankan sebagai development mode yaitu menggunakan perintah seperti berikut

php artisan serve

Jika di jalankan, maka hasilnya seperti berikut:

➜ docker-laravel  php artisan serve
Starting Laravel development server: http://127.0.0.1:8000
[Sat Jul 24 11:33:08 2021] PHP 8.0.7 Development Server (http://127.0.0.1:8000) started

Kemudian kita akses di browser dengan url di atas, hasilnya seperti berikut:

Deployment using Apache2/Httpd

Ok setelah kita membuat project kemudian kita menjalankan development mode, sekarang kita akan deploy ke Server (Production Mode). Untuk deploy production mode ada beberapa cara yaitu

Nginx (PHP-FPM)
Httpd/Apache2

Jadi kali ini kita akan menggunakan Web Server Httpd/Apache dan OS Ubuntu Server. Langsung aja berikut yang harus kita install di server

## install software dependency
apt update && apt -y upgrade && \
apt install -y software-properties-common \
    apache2 \
    curl \
    git \
    libicu-dev \
    libpq-dev \
    libmcrypt-dev \
    openssl \
    unzip \
    vim \
    zip \
    zlib1g-dev \
    libpng-dev \
    libzip-dev 

## install php 8.x
export PHP_VERSION=8.0

add-apt-repository -y ppa:ondrej/php && \
apt update && \
apt install -y php${PHP_VERSION} \
    php${PHP_VERSION}-cli \
    libapache2-mod-php${PHP_VERSION} && \
systemctl restart apache2.service

## install php-extension required by laravel
apt install -y php${PHP_VERSION}-mcrypt \
    php${PHP_VERSION}-fileinfo \
    php${PHP_VERSION}-bcmath \
    php${PHP_VERSION}-gd \
    php${PHP_VERSION}-exif \
    php${PHP_VERSION}-pdo \
    php${PHP_VERSION}-mbstring \
    php${PHP_VERSION}-curl \
    php${PHP_VERSION}-xml \
    php${PHP_VERSION}-json \
    php${PHP_VERSION}-dom

## enable rewrite apache2
a2enmod rewrite

## install composer
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/bin/ --filename=composer

## allow write folder / file to /var/www/php
mkdir -p /var/www/php && \
chmod -R 777 /var/www/php

Setelah kita install, sekarang kita upload source-codenya ke server menggunakan tools seperti scp atau git. Berikut perintahnya:

scp -r * username@your-server.hostname:/var/www/php && \
scp env.example username@your-server.hostname:/var/www/php

Setelah itu kita edit apache2 confignya pada file /etc/apache2/sites-enabled/000-default.conf untuk mengarahkan ROOT Document ke /var/www/php/public seperti berikut:

<VirtualHost *:80>
        ServerAdmin webmaster@localhost
        DocumentRoot /var/www/php/public

        <Directory /var/www/php/public>
            Options Indexes FollowSymLinks
            AllowOverride All
            Require all granted
        </Directory>

        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Kemudian kita restart server apache2 dengan perintah seperti berikut:

systemctl restart apache2

Kemudian kita build sourcenya menjadi production mode sesuai dengan arahan dari official website nya. seperti berikut

## build .env
php -r "file_exists('.env') || copy('.env.example', '.env');" && \
sed -i "s|APP_DEBUG=true|APP_DEBUG=false|g" .env && \
sed -i "s|APP_URL=http://localhost|APP_URL=""|g" .env && \
sed -i "s|APP_ENV=local|APP_ENV=production|g" .env

## install production mode
composer install --optimize-autoloader --no-dev && \
php artisan package:discover --ansi && \
php artisan key:generate --ansi && \
php artisan optimize

Sekarang kita coba access menggunakan browser ke http://your-server.hostname maka hasilnya seperti berikut:

Build & Running docker image

Ok setelah kita mencoba manual deployment menggunakan Apache2 di Ubuntu Server, sekarang kita buat Docker imagenya. Seperti biasanya untuk membuat docker image kita pilih dulu base image yang mau digunakan, jadi karena kita menggunakan Apache2 untuk web-servernya dan versi PHP 8 maka kita pilih php:8.0-apache jadi berikut adalah Dockerfile

	ARG PHP_VERSION=8.0-apache
	FROM php:${PHP_VERSION} as php_laravel

	# install dependencies for laravel 8
	RUN apt-get update && apt-get install -y \
	curl \
	git \
	libicu-dev \
	libpq-dev \
	libmcrypt-dev \
	openssl \
	unzip \
	vim \
	zip \
	zlib1g-dev \
	libpng-dev \
	libzip-dev && \
	rm -r /var/lib/apt/lists/*

	# install extension for laravel 8
	RUN pecl install mcrypt-1.0.4 && \
	docker-php-ext-install fileinfo exif pcntl bcmath gd && \
	docker-php-ext-enable mcrypt && \
	a2enmod rewrite

	# install composer
	RUN curl -sS https://getcomposer.org/installer \| php -- --install-dir=/usr/bin/ --filename=composer

	FROM php_laravel as executeable

	ENV APP_SOURCE /var/www/php
	ENV APP_DEBUG=false
	ENV APP_URL=""
	ENV APP_ENV=production

	# Set working directory
	WORKDIR $APP_SOURCE

	# set DocumentRoot to lavavel framework uploaded
	RUN sed -i "s\|DocumentRoot /var/www/html\|DocumentRoot ${APP_SOURCE}/public\|g" /etc/apache2/sites-enabled/000-default.conf

	# copy source laravel
	COPY . .

	# give full access
	RUN mkdir -p public/storage && \
	chmod -R 777 storage/* && \
	chmod -R 777 public/storage

	# install dependency laravel
	RUN php -r "file_exists('.env') \|\| copy('.env.example', '.env');" && \
	composer install --no-interaction --optimize-autoloader --no-dev && \
	php artisan package:discover --ansi && \
	php artisan key:generate --ansi --force && \
	php artisan optimize

	VOLUME ${APP_SOURCE}/storage

	# expose port default 80
	EXPOSE 80/tcp

view raw 08k-dockerfile hosted with ❤ by GitHub

Serta berikut file .dockerignore nya:

### Jetbraint ###
.idea/
*.iml

### JS libs
/node_modules
package-lock.json
npm-debug.log
yarn-error.log

### Laravel
/public/hot
/public/storage
/storage/*.key
/vendor
.env
.env.backup
.phpunit.result.cache
tests/

### docker
docker-compose.override.yml
Homestead.json
Homestead.yaml

### visual studio
/.vscode

view raw 08k-dockerignore hosted with ❤ by GitHub

Jika di jalankan maka outputnya seperti berikut:

➜ docker-laravel git:(master) docker build -t dimmaryanto93/docker-laravel:2021.07.24.19.43-release .
[+] Building 13.2s (14/14) FINISHED
 => [internal] load build definition from Dockerfile                                   0.0s
 => => transferring dockerfile: 1.49kB                                                 0.0s
 => [internal] load .dockerignore                                                      0.0s
 => => transferring context: 35B                                                       0.0s
 => [internal] load metadata for docker.io/library/php:8.0-apache                      3.2s
 => [php_laravel 1/4] FROM docker.io/library/php:8.0-apache@sha256:bc3bf769aff70e8f81  0.0s
 => [internal] load build context                                                      0.0s
 => => transferring context: 19.75kB                                                   0.0s
 => CACHED [php_laravel 2/4] RUN apt-get update && apt-get install -y   curl   git     0.0s
 => CACHED [php_laravel 3/4] RUN pecl install mcrypt-1.0.4 &&   docker-php-ext-instal  0.0s
 => CACHED [php_laravel 4/4] RUN curl -sS https://getcomposer.org/installer | php --   0.0s
 => CACHED [executeable 1/5] WORKDIR /var/www/php                                      0.0s
 => [executeable 2/5] RUN sed -i "s|DocumentRoot /var/www/html|DocumentRoot /var/www/" 0.2s
 => [executeable 3/5] COPY . .                                                         0.1s
 => [executeable 4/5] RUN mkdir -p public/storage && chmod -R 777 storage/* && chmod   0.2s
 => [executeable 5/5] RUN php -r "file_exists('.env') || copy('.env.example', '.env')" 9.0s
 => exporting to image                                                                 0.4s
 => => exporting layers                                                                0.4s
 => => writing image sha256:14d3276fc4f91d338994fc50c50261df00593d12688ea43ded32afab6  0.0s
 => => naming to docker.io/dimmaryanto93/docker-laravel:2021.07.24.19.43-release

Sekarang jika kita jalankan containernya dengan perintah seperti berikut:

docker container run --name apache-laravel -p 80:80 -d dimmaryanto93/docker-laravel:2021.07.24.19.43-release

Maka hasilnya seperti berikut:

Cleanup

Seperti biasa setelah kita mencoba schenario studi kasus tersebut. sekarang kita bersih-bersih dulu ya berikut perintahnya:

For Bash script:

docker container rm -f apache-laravel && \
docker volume prune -f && \
docker image prune -f

view raw 08k-cleanup.bash hosted with ❤ by GitHub

For Powershell script:

docker container rm -f apache-laravel | `
docker volume prune -f | `
docker image prune -f

view raw 08k-cleanup.ps1 hosted with ❤ by GitHub

Yuk simak juga videonya,

Dan jika temen-temen belajar hal baru kali ini jangan lupa buat Like, Subcribe, dan Share ke temen kalian. Terimakasih!!!

Referensi

https://docs.docker.com/

https://laravel.com/docs/8.x#installation-via-composer

https://laravel.com/docs/8.x/deployment

Kumpulan Tutorial Kito

Selasa, 29 November 2022

DOCKER-image create

Build Docker image for Laravel Framework

Setup SDK Local environment

Deployment using Apache2/Httpd

Build & Running docker image

Cleanup

Yuk simak juga videonya,

Referensi

Tidak ada komentar:

Posting Komentar

	### Jetbraint ###
	.idea/
	*.iml

	### JS libs
	/node_modules
	package-lock.json
	npm-debug.log
	yarn-error.log

	### Laravel
	/public/hot
	/public/storage
	/storage/*.key
	/vendor
	.env
	.env.backup
	.phpunit.result.cache
	tests/

	### docker
	docker-compose.override.yml
	Homestead.json
	Homestead.yaml

	### visual studio
	/.vscode

	docker container rm -f apache-laravel && \
	docker volume prune -f && \
	docker image prune -f

	docker container rm -f apache-laravel \| `
	docker volume prune -f \| `
	docker image prune -f