Tutorial Setup CI/CD GitHub Actions Projek Laravel 12 VPS Ubuntu: Panduan Lengkap 2025

oleh

Mengelola deployment aplikasi web secara manual seringkali menjadi beban yang melelahkan bagi para pengembang. Bayangkan jika setiap kali Anda melakukan perubahan kode, Anda harus masuk ke server melalui SSH, melakukan git pull, menjalankan migrasi database, hingga membersihkan cache secara manual. Risiko kesalahan manusia (human error) sangat tinggi dalam proses ini. Oleh karena itu, memahami tutorial setup ci/cd github actions projek laravel 12 vps ubuntu menjadi sangat krusial bagi Anda yang ingin meningkatkan efisiensi dan profesionalisme dalam pengembangan software.

Laravel 12 hadir dengan berbagai fitur mutakhir yang menuntut infrastruktur yang stabil dan proses deployment yang mulus. Dengan memanfaatkan GitHub Actions, Anda dapat mengotomatiskan seluruh alur kerja mulai dari pengujian kode hingga rilis ke server produksi (VPS Ubuntu). Artikel ini akan membahas secara mendalam dan teknis mengenai langkah-langkah implementasi CI/CD agar projek Laravel 12 Anda dapat dideploy secara otomatis hanya dengan satu kali git push.

Memahami Konsep CI/CD untuk Laravel 12

CI/CD adalah singkatan dari Continuous Integration dan Continuous Deployment. Dalam ekosistem Laravel 12, Continuous Integration (CI) berfokus pada otomatisasi pengujian kode. Setiap kali ada kode baru yang masuk ke repository, sistem akan menjalankan unit testing (Pest atau PHPUnit) untuk memastikan tidak ada fitur yang rusak.

Sementara itu, Continuous Deployment (CD) adalah tahap di mana kode yang telah lulus uji coba langsung dikirim ke server VPS Ubuntu Anda. Dengan tutorial setup ci/cd github actions projek laravel 12 vps ubuntu ini, kita akan menggabungkan keduanya. Keuntungannya bukan hanya soal kecepatan, tapi juga konsistensi lingkungan aplikasi antara tahap pengembangan dan produksi.

Menurut data dari State of DevOps Report, tim yang mengimplementasikan otomatisasi deployment memiliki frekuensi rilis 200 kali lebih tinggi dan tingkat kegagalan perubahan yang 3 kali lebih rendah dibandingkan tim manual.

Tahap 1: Persiapan Lingkungan VPS Ubuntu

Sebelum masuk ke konfigurasi GitHub Actions, pastikan VPS Ubuntu Anda sudah siap menjalankan Laravel 12. Laravel 12 membutuhkan spesifikasi minimal PHP 8.2 atau yang lebih baru (disarankan PHP 8.3 atau 8.4 untuk performa maksimal).

Lakukan update package manager dan instalasi dependensi dasar dengan perintah berikut:

sudo apt update && sudo apt upgrade -y
sudo apt install -y nginx mysql-server php8.3-fpm php8.3-curl php8.3-xml php8.3-mbstring php8.3-mysql unzip

Pastikan Anda juga telah menginstal Composer secara global. Composer sangat penting untuk mengelola dependensi Laravel di server. Gunakan perintah composer --version untuk memverifikasi instalasi. Jangan lupa untuk mengatur document root Nginx Anda ke direktori /public dari projek Laravel Anda agar aplikasi dapat diakses melalui browser.

Tahap 2: Konfigurasi Keamanan SSH Key

Agar GitHub Actions dapat mengakses VPS Ubuntu Anda tanpa memasukkan password secara manual (yang mana tidak mungkin dilakukan dalam proses otomatis), kita harus menggunakan SSH Key. Ini adalah metode yang jauh lebih aman dibandingkan menggunakan password teks biasa.

Pertama, generate SSH key baru di komputer lokal atau langsung di server:

ssh-keygen -t rsa -b 4096 -C "github-actions-deploy"

Simpan file tersebut dan salin isi dari public key (biasanya berakhiran .pub) ke dalam file ~/.ssh/authorized_keys di VPS Anda. Pastikan permission folder .ssh adalah 700 dan file authorized_keys adalah 600. Langkah ini sangat krusial dalam tutorial setup ci/cd github actions projek laravel 12 vps ubuntu untuk memastikan koneksi yang aman.

Tahap 3: Menyiapkan GitHub Secrets

Keamanan adalah prioritas utama. Jangan pernah menuliskan IP server, username, atau private key langsung di dalam file kode Anda. GitHub menyediakan fitur bernama Secrets untuk menyimpan data sensitif ini.

Buka repository GitHub Anda, lalu navigasikan ke Settings > Secrets and variables > Actions. Tambahkan secret berikut:

  • SSH_HOST: Alamat IP VPS Ubuntu Anda.
  • SSH_USERNAME: Username VPS Anda (misalnya: root atau ubuntu).
  • SSH_KEY: Isi dari private key yang Anda buat di tahap sebelumnya (biasanya file tanpa akhiran .pub).
  • SSH_PORT: Port SSH Anda (default adalah 22).

Dengan menyimpan data ini di GitHub Secrets, workflow Anda dapat mengakses server dengan aman tanpa mengekspos kredensial ke publik atau kontributor lainnya.

Tahap 4: Membuat File Workflow GitHub Actions

Sekarang kita sampai pada inti dari tutorial setup ci/cd github actions projek laravel 12 vps ubuntu. Kita akan membuat file konfigurasi YAML yang memberitahu GitHub apa yang harus dilakukan saat ada perubahan kode.

Buatlah direktori .github/workflows di root projek Laravel 12 Anda, lalu buat file bernama deploy.yml. Masukkan kode berikut:

name: Deploy Laravel Projek

on:
  push:
    branches: [ main ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Code
        uses: actions/checkout@v4

      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: '8.3'

      - name: Install Dependencies
        run: composer install --no-interaction --prefer-dist --optimize-autoloader

      - name: Deploy to Server
        uses: appleboy/ssh-action@master
        with:
          host: ${{ secrets.SSH_HOST }}
          username: ${{ secrets.SSH_USERNAME }}
          key: ${{ secrets.SSH_KEY }}
          port: ${{ secrets.SSH_PORT }}
          script: |
            cd /var/www/html/projek-laravel
            git pull origin main
            composer install --no-dev --no-interaction --prefer-dist --optimize-autoloader
            php artisan migrate --force
            php artisan config:cache
            php artisan route:cache
            php artisan view:cache
            php artisan queue:restart

Penjelasan Workflow:

  • on: push: Menjalankan workflow setiap kali ada push ke branch main.
  • actions/checkout: Mengambil kode terbaru dari repository.
  • appleboy/ssh-action: Melakukan SSH ke VPS dan menjalankan serangkaian perintah shell.
  • php artisan migrate –force: Menjalankan migrasi database di produksi tanpa konfirmasi interaktif.
  • Optimization commands: Perintah cache di Laravel 12 sangat penting untuk meningkatkan kecepatan akses aplikasi di server produksi.

Tahap 5: Optimasi dan Testing Deployment

Setelah file YAML disimpan, lakukan commit dan push ke GitHub. Anda dapat melihat progres deployment di tab Actions pada repository GitHub Anda. Jika semua langkah dalam tutorial setup ci/cd github actions projek laravel 12 vps ubuntu diikuti dengan benar, Anda akan melihat centang hijau yang menandakan deployment berhasil.

Untuk optimasi lebih lanjut, pertimbangkan untuk menambahkan tahapan pengujian (testing) sebelum deployment. Anda bisa menambahkan langkah php artisan test di dalam workflow untuk memastikan aplikasi tidak dideploy jika ada test yang gagal. Ini adalah praktik terbaik (best practice) dalam industri teknologi modern.

Tabel Perbandingan: Deployment Manual vs GitHub Actions

Fitur Deployment Manual GitHub Actions (CI/CD)
Kecepatan Lambat (5-15 menit) Cepat (< 2 menit)
Konsistensi Rawan kesalahan manusia Sangat konsisten
Keamanan Kredensial Sering tersimpan di lokal Tersinkripsi di GitHub Secrets
Rollback Sulit dan manual Mudah melalui riwayat Actions

Troubleshooting Masalah Umum

Dalam mempraktikkan tutorial setup ci/cd github actions projek laravel 12 vps ubuntu, Anda mungkin menemui beberapa kendala. Berikut adalah solusi untuk masalah yang paling sering muncul:

1. Permission Denied (Publickey):
Masalah ini biasanya terjadi karena SSH key belum terdaftar di authorized_keys atau GitHub Secrets salah menyalin private key. Pastikan tidak ada spasi tambahan saat menyalin key.

2. Folder /var/www Tidak Bisa Ditulis:
Pastikan user yang digunakan untuk SSH memiliki izin akses ke folder projek. Gunakan perintah sudo chown -R $USER:www-data /var/www/html/projek-laravel untuk mengatur kepemilikan folder.

3. Database Connection Failed:
Saat menjalankan php artisan migrate, pastikan file .env di server VPS sudah dikonfigurasi dengan benar sesuai dengan kredensial database lokal VPS Anda.

Kesimpulan dan Langkah Selanjutnya

Mengimplementasikan tutorial setup ci/cd github actions projek laravel 12 vps ubuntu adalah langkah besar untuk meningkatkan produktivitas Anda sebagai developer. Anda tidak lagi perlu membuang waktu untuk proses rutin yang membosankan dan berisiko. Dengan CI/CD, fokus Anda tetap pada penulisan kode berkualitas, sementara mesin menangani sisanya.

Ringkasan Langkah Penting:

  • Siapkan VPS Ubuntu dengan PHP 8.3+ dan Nginx.
  • Gunakan SSH Key untuk autentikasi yang aman.
  • Simpan data sensitif di GitHub Secrets.
  • Buat file workflow YAML yang terstruktur.
  • Selalu sertakan perintah optimasi cache Laravel di setiap deployment.

Setelah berhasil melakukan setup ini, langkah selanjutnya yang bisa Anda ambil adalah mengeksplorasi zero-downtime deployment menggunakan tool seperti Laravel Envoyer atau melakukan containerization dengan Docker untuk fleksibilitas yang lebih tinggi. Selamat mencoba dan semoga projek Laravel 12 Anda sukses!

Tinggalkan komentar