Deploy Private Repository Laravel ke Hosting Rumahweb

Panduan ini menjelaskan cara deploy project Laravel dari private repository GitHub ke hosting Rumahweb menggunakan SSH key dan deploy key.

1. Generate SSH Key di Hosting

Buka terminal hosting melalui cPanel atau remote SSH.

Jalankan command berikut:

ssh-keygen -t rsa -f ~/.ssh/repo -b 4096

Ganti repo dengan nama repository atau nama project.

Contoh:

ssh-keygen -t rsa -f ~/.ssh/erp1 -b 4096

Saat diminta passphrase, boleh diisi atau dikosongkan.

Cek isi folder .ssh:

ls ~/.ssh

Jika belum ada file config, buat file tersebut:

touch ~/.ssh/config
chmod 0600 ~/.ssh/config

Buka file config:

nano ~/.ssh/config

Isi dengan konfigurasi berikut:

Host erp1
    HostName github.com
    User git
    IdentityFile ~/.ssh/erp1
    IdentitiesOnly yes

Keterangan:

• Host erp1 adalah alias untuk repository.
• IdentityFile ~/.ssh/erp1 harus sesuai dengan SSH key yang dibuat.

2. Register SSH Key ke GitHub Deploy Key

Login ke GitHub, lalu buka private repository yang ingin di-deploy.

Masuk ke:

Settings > Deploy Keys > Add deploy key

Isi:

• Title: bebas, misalnya Rumahweb Hosting
• Key: isi dengan public key dari file .pub

Untuk melihat public key:

cat ~/.ssh/erp1.pub

Centang:

Allow write access

Lalu klik Add key.

3. Clone Private Repository ke Hosting

Masuk ke terminal cPanel.

Cek apakah folder repositories sudah ada:

ls ~/repositories

Jika belum ada, buat folder:

mkdir ~/repositories

Masuk ke folder:

cd ~/repositories

Clone repository:

git clone git@erp1:username/repo.git

Contoh:

git clone git@erp1:alamsyahkuba/erp1.git

Keterangan:

• erp1 adalah alias dari SSH config.
• username adalah username GitHub.
• repo.git adalah nama repository.

4. Setting Environment Laravel

Pastikan versi PHP dan Composer sesuai dengan project Laravel.

Cek versi:

php --version
composer --version

Contoh panduan ini menggunakan:

PHP 8.2.30
Composer 2.9.3

Misalnya menggunakan alias:

php82
composer82

Masuk ke folder repository:

cd ~/repositories/repo

Install dependency:

composer82 install

Copy file .env:

cp .env.example .env

Generate app key:

php82 artisan key:generate

Edit file .env, lalu sesuaikan konfigurasi berikut:

APP_URL=https://domain-kamu.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=sesuaikan
DB_USERNAME=sesuaikan
DB_PASSWORD=sesuaikan

Jalankan migration:

php82 artisan migrate

Clear dan optimize Laravel:

php82 artisan optimize:clear
php82 artisan optimize

Jika ingin pindah branch:

git checkout nama-branch

5. Deploy Laravel ke Document Root

Masuk ke folder repository:

cd ~/repositories/repo

Atur permission:

chmod -R 775 storage bootstrap/cache

Buat symlink dari folder public Laravel ke document root domain:

ln -s ~/repositories/repo/public/* ~/public_html/document_root

Contoh jika document root domain adalah erp1:

ln -s ~/repositories/ERP1/public/* ~/public_html/erp1/

Cek hasil symlink:

ls -l ~/public_html/document_root

Contoh hasil:

build -> /home/user/repositories/ERP1/public/build
css -> /home/user/repositories/ERP1/public/css
favicon.ico -> /home/user/repositories/ERP1/public/favicon.ico
fonts -> /home/user/repositories/ERP1/public/fonts
index.php -> /home/user/repositories/ERP1/public/index.php
js -> /home/user/repositories/ERP1/public/js
robots.txt -> /home/user/repositories/ERP1/public/robots.txt

6. Buat File .htaccess

Buka cPanel File Manager, lalu masuk ke folder document root domain.

Contoh:

~/public_html/erp1/

Buat file baru:

.htaccess

Isi file .htaccess:

# php -- BEGIN cPanel-generated handler, do not edit
# Set the “ea-php82” package as the default “PHP” programming language.
<IfModule mime_module>
  AddHandler application/x-httpd-ea-php82___lsphp .php .php8 .phtml
</IfModule>
# php -- END cPanel-generated handler, do not edit

Options +FollowSymLinks
Options -Indexes
DirectoryIndex index.php

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /

    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule . index.php [L]
</IfModule>

Simpan file.

7. Testing

Akses domain Laravel melalui browser:

https://domain-kamu.com

Jika berhasil, aplikasi Laravel akan tampil.

Catatan Penting

Peringatan

• Pastikan versi PHP hosting sesuai dengan versi Laravel.
• Pastikan database sudah dibuat di cPanel.
• Pastikan konfigurasi .env sudah benar.
• Pastikan folder storage dan bootstrap/cache memiliki permission yang sesuai.
• Jangan upload file .env ke repository.