itsanla/qashierwise repository overview

⁠Tutorial Setup dan Penggunaan Tools di Docker

Panduan lengkap untuk melakukan setup aplikasi Laravel dengan Docker, termasuk database migration, seeding, dan pembuatan user author.

⁠📋 Daftar Isi

1. Akses Docker Container⁠
2. Database Migration⁠
3. Database Seeding⁠
4. Membuat User Author⁠
5. Troubleshooting⁠

⁠Akses Docker Container

⁠Langkah 1: Masuk ke Docker Bash

Untuk mengakses container Docker, gunakan perintah berikut:

docker exec -it <nama_container> bash

Penjelasan:

• docker exec : Menjalankan perintah di dalam container yang sedang berjalan
• -it : Flag untuk interactive terminal
• <nama_container> : Ganti dengan nama container Anda (misal: laravel_app, my_app, dll)

Contoh:

docker exec -it laravel_app bash

Jika berhasil, terminal Anda akan berubah menampilkan prompt container.

⁠Database Migration

⁠Langkah 2: Jalankan Database Migration

Setelah berada di dalam container, jalankan perintah migrasi untuk membuat table baru di database:

php artisan migrate

Penjelasan:

• Perintah ini menjalankan semua file migration yang belum dijalankan
• Akan membuat table-table baru sesuai dengan structure yang didefinisikan
• Catatan: Langkah ini bersifat optional jika table blog sudah ada di database Anda

Output yang diharapkan:

Migrating: xxxx_xx_xx_xxxxxx_create_users_table
Migrated:  xxxx_xx_xx_xxxxxx_create_users_table
Migrating: xxxx_xx_xx_xxxxxx_create_posts_table
Migrated:  xxxx_xx_xx_xxxxxx_create_posts_table
...

⁠Database Seeding

⁠Langkah 3: Jalankan Seeder untuk Permission dan Role Author

Masukkan data permission dan role author ke database dengan perintah:

php artisan db:seed --class=AuthorRoleSeeder

Penjelasan:

• Perintah ini menjalankan seeder khusus AuthorRoleSeeder
• Akan membuat permission dan role "author" di database
• Data ini diperlukan untuk langkah selanjutnya (pembuatan user author)

Output yang diharapkan:

Database seeding completed successfully.

Setelah seeder berhasil dijalankan, Anda dapat melanjutkan ke langkah berikutnya.

⁠Membuat User Author

⁠Langkah 4: Jalankan Script Create-User

Setelah seeding berhasil, jalankan script untuk membuat user author:

./create-user.sh

Penjelasan:

• Script ini akan membuat user dengan role "author" secara otomatis
• Script akan memandu Anda melalui proses pembuatan user

Alur yang akan terjadi:

1. Script meminta input data user (nama, email, password, dll)
2. Script membuat user di database
3. Script memberikan role "author" kepada user
4. Proses selesai dan user "author" siap digunakan

⁠Troubleshooting

⁠Masalah: Permission Denied pada Script

Jika Anda mendapatkan error seperti:

bash: ./create-user.sh: Permission denied

Solusi:

Berikan izin eksekusi pada file script:

chmod +x create-user.sh

Kemudian jalankan script lagi:

./create-user.sh

Penjelasan:

• chmod +x : Memberikan izin eksekusi (execute permission) pada file
• create-user.sh : Nama file script yang ingin diberikan izin

⁠📝 Ringkasan Lengkap Perintah

Berikut adalah urutan lengkap perintah yang perlu dijalankan:

# 1. Masuk ke Docker Container
docker exec -it <nama_container> bash

# 2. Jalankan Migration (jika belum ada table)
php artisan migrate

# 3. Jalankan Seeder untuk Role dan Permission
php artisan db:seed --class=AuthorRoleSeeder

# 4. Jalankan Script Pembuatan User
./create-user.sh

# Jika error permission denied, jalankan ini terlebih dahulu:
# chmod +x create-user.sh
# ./create-user.sh

⁠✅ Checklist Penyelesaian

• Container Docker sudah berjalan
• Berhasil masuk ke Docker bash
• Berhasil menjalankan migration
• Berhasil menjalankan seeder AuthorRoleSeeder
• Berhasil menjalankan create-user.sh
• User "author" berhasil dibuat
• Dapat login dengan user author

⁠💡 Tips dan Catatan Penting

• Urutan sangat penting: Jangan skip langkah migration dan seeding sebelum membuat user
• Nama container: Pastikan Anda tahu nama container Anda sebelum mengakses
• Database connection: Pastikan database sudah running dan terkoneksi dengan baik
• Script location: Pastikan Anda menjalankan ./create-user.sh dari direktori yang benar
• Multiple attempts: Jika ada error, cek pesan error dan ikuti petunjuk troubleshooting

⁠📞 Informasi Lebih Lanjut

Untuk informasi lebih detail tentang Laravel Artisan commands, kunjungi:

• Laravel Documentation⁠
• Laravel Migrations⁠
• Laravel Seeders⁠

Terakhir diperbarui: 2026
Versi: 1.0