Instalasi OpenSID dengan Docker Container

Panduan ini khusus untuk teman-teman yang tertarik untuk melakukan instalasi OpenSID dengan Docker. Docker merupakan sebuah aplikasi yang bersifat open source yang berfungsi sebagai wadah/container untuk membungkus/memasukkan sebuah perangkat lunak secara lengkap beserta semua hal yang dibutuhkan oleh perangkat lunak tersebut agar dapat berfungsi. Dengan Docker, seorang developer maupun sysadmin dapat membangun, mengemas, dan menjalankan aplikasi di mana pun dengan cepat dan efisien.

1. Kebutuhan Sistem
2. Instalasi Docker
3. Instalasi Docker Compose
4. Clone repository
5. Jalankan Instalasi

1. Kebutuhan Sistem

Docker sendiri dapat berjalan lancar di server VPS dengan RAM 1GB dan 1 vCPU, namun sangat direkomendasikan menggunakan spesifikasi yang lebih besar.

Pada panduan ini dibuat menggunakan spesifikasi sebagai berikut:

Komponen	Spesifikasi
OS	Ubuntu 18.04
RAM	1GB
CPU	1 core
HDD	20GB

Namun dapat pula diterapkan di server dengan OS apapun.

2. Instalasi Docker

Langkah instalasi Docker dapat dibaca di https://docs.docker.com/install/

khususnya untuk Ubuntu dapat dilakukan dengan mengetikkan perintah-perintah berikut di terminal

sudo apt update
sudo apt install docker.io git

paket git diperlukan pada langkah berikutnya. Aktifkan service docker dengan perintah ini

sudo systemctl enable docker
sudo systemctl start docker

Verifikasi hasil instalasi docker dengan mengetikan perintah berikut

sudo docker info

agar docker dapat dieksekusi oleh user biasa, tambahkan user ke group docker

sudo usermod -aG docker `whoami`

perintah di atas dijalankan dengan asumsi bahwa saat ini Anda sedang menggunakn user biasa. Namun jika Anda sedang menggunakan user root, silakan ganti `whoami` dengan nama user yang dimaksud.

Logout/exit, lalu login lagi agar perubahan yang baru saja kita lakukan dapat berfungsi.

exit

3. Instalasi Docker Compose

Docker Compose adalah alat untuk menjalankan dan mendefinisikan aplikasi berbasis docker dengan metode multi-container. Dengan Compose, kita dapat menggunakan file docker-compose.yml untuk mengonfigurasi service aplikasi kita. Lalu dengan satu perintah, kita membuat dan menjalankan semua service dari file konfigurasi tadi.

Oke, langsung saja ke instalasinya ya...

Eksekusi perintah berikut untuk mendownload docker-compose

sudo curl -L "https://github.com/docker/compose/releases/download/1.25.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Beri hak akses eksekusi

sudo chmod +x /usr/local/bin/docker-compose

verifikasi hasil instalasinya dengan mengetikkan

docker-compose

Selengkapnya untuk instalasi docker compose dapat merujuk ke https://docs.docker.com/compose/install/

4. Clone repository

Clone/Unduh repositori OpenSID dengan perintah berikut:

git clone -b umum https://github.com/OpenSID/OpenSID.git
cd OpenSID

Download repo samsulmaarif/opensid-docker, lalu copy/salin folder .docker dan berkas docker-compose.yml ke dalam folder OpenSID sehingga struktur direktorinya menjadi seperti ini:

├── assets
├── cacert.pem
├── catatan_rilis.md
├── catatan_singkat_library_yang_digunakan.md
├── contoh_data_awal_20220301.sql
├── desa
├── desa-contoh
├── .docker
├── docker-compose.yml
├── donjo-app
├── favicon.ico
├── .git
├── .gitattributes
├── .github
├── .gitignore
├── htaccess.txt
├── idm_2022_3301092008.json
├── index.php
├── LICENSE
├── logs
├── README.md
├── securimage
├── system
├── template-surat
├── themes
├── vendor
└── version.json

lakukan perubahan yang diperlukan pada berkas docker-compose.yml, misal Anda ingin mengubah password MySQL-nya, ganti rahasia dengan password yang lebih aman.

Selanjutnya, buat/salin folder desa dari desa-contoh

cp -a desa-contoh desa

pada file desa/config/database.php, sesuaikan konfigurasi database-nya dengan file yml tadi. Misalnya sebagai berikut

$db['default']['hostname'] = 'db';
$db['default']['username'] = 'opensid';
$db['default']['password'] = 'rahasia';
$db['default']['database'] = 'opensid';

CATATAN: db hostname harus ditulis sebagai db, jika tidak, aplikasi akan error karena tidak dapat terhubung dengan database. Kecuali Anda mengubah file docker-compose.yml pada bagian nama service db.

5. Jalankan Instalasi

Jika proses di atas sudah dilakukan, sekarang saatnya kita jalankan proses deployment-nya.

docker-compose up --build

Tunggu hingga sekitar 10-30 menit. Kecepatannya tentunya tergantung dari spesifikasi server Anda dan koneksi internet yang digunakan. Setelah selesai, silakan akses melalui browser di url http://localhost atau http://ip-server

Sekian!