Kursus MariaDB / Membuat Lingkungan Belajar Lokal dengan Docker Compose
Docker Compose dapat mendefinisikan kontainer MariaDB, port koneksi, dan penyimpanan persisten dalam satu berkas. Dengan begitu, Anda dapat membuat lingkungan belajar terpisah tanpa memasang layanan MariaDB langsung pada komputer. Menghapus kontainer dan menghapus volume data mempunyai akibat yang berbeda.
Tentukan lingkungan latihan dan periksa prasyarat
Docker menjalankan aplikasi dalam kontainer, sedangkan Compose mendeskripsikan pengaturannya dalam YAML, format teks untuk data terstruktur. Latihan ini menyediakan akses basis data pada 127.0.0.1:3307. Port host yang terpisah memungkinkan server latihan berjalan bersama server lain yang memakai 3306. Panduan diagnosis koneksi lokal dan jarak jauh membantu membedakan jalur koneksi, sedangkan panduan pencadangan basis data menjelaskan salinan yang perlu disimpan di luar volume.
Pasang Docker Engine dengan plugin Compose atau Docker Desktop mengikuti petunjuk resmi pemasangan Compose. Pada Windows, gunakan kontainer Linux. Jalankan mesin Docker dan pastikan kedua perintah terminal ini bekerja sebelum menyiapkan basis data:
docker version
docker compose version
Konfigurasi ini sengaja memakai keluarga image mariadb:11.8. Tag tersebut dapat menunjuk ke versi patch yang lebih baru. Jika reproduksi yang persis diperlukan, catat tag patch atau digest yang disetujui; digest adalah pengenal isi image. Pemeriksaan struktur YAML dan SQL tidak menggantikan pengujian awal kontainer, healthcheck, serta ketahanan volume dalam lingkungan Docker.
Siapkan proyek dan berkas kata sandi
- Buat folder baru bernama
mariadb-appops, lalu buka terminal di dalamnya. Jangan jalankan perintah dari proyek Compose lain. - Buat subfolder
secretsberisiroot-password.txtdanapp-password.txt. Simpan satu kata sandi latihan yang berbeda dalam setiap berkas teks UTF-8, tanpa kalimat penjelasan. Jangan biarkan berkas kosong. - Simpan konfigurasi lengkap pada bagian berikut sebagai
compose.yaml. Buat juga.gitignoredengan dua baris di bawah ini agar berkas kata sandi tidak masuk kendali versi, lalu batasi akses berkasnya.
secrets/
.env
Compose secrets menyediakan berkas hanya kepada layanan yang ditentukan. Mekanisme ini tidak mengubah berkas sumber lokal menjadi brankas kata sandi terenkripsi. Lindungi berkas dan akses Docker. Dokumentasi resmi Compose secrets menjelaskan pemasangan berkas serta persyaratan kontainer Linux.
Pahami konfigurasi Compose yang lengkap
name: mariadb-appops
services:
db:
image: mariadb:11.8
ports:
- "127.0.0.1:3307:3306"
environment:
MARIADB_ROOT_PASSWORD_FILE: /run/secrets/root_password
MARIADB_DATABASE: appops_lab
MARIADB_USER: app_user
MARIADB_PASSWORD_FILE: /run/secrets/app_password
secrets:
- root_password
- app_password
volumes:
- db_data:/var/lib/mysql
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
timeout: 5s
retries: 10
start_period: 30s
secrets:
root_password:
file: ./secrets/root-password.txt
app_password:
file: ./secrets/app-password.txt
volumes:
db_data:
Komputer menyediakan port 3307, sementara MariaDB di dalam kontainer memakai 3306. Klien pada komputer host mengakses 127.0.0.1:3307; layanan lain pada jaringan Compose yang sama mengakses db:3306. Pengikatan ke alamat loopback membatasi akses port yang dipublikasikan ini melalui jalur lokal host.
Volume bernama db_data menyimpan direktori data. Variabel dengan akhiran _FILE menunjuk berkas kata sandi. Referensi resmi variabel lingkungan image MariaDB menjelaskan pembuatan basis data dan akun ketika direktori data masih baru. Mengedit berkas kata sandi tidak otomatis mengubah akun yang sudah tersimpan pada volume yang telah diinisialisasi.
Skrip resmi healthcheck.sh memeriksa koneksi dan inisialisasi InnoDB. Kontainer berstatus berjalan belum membuktikan bahwa basis data siap menerima kueri latihan.
Jalankan layanan dan verifikasi baris yang disimpan
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=80 db
Perintah pertama memeriksa konfigurasi melalui Compose. Pastikan layanan kemudian mencapai status healthy; jika tidak, periksa log inisialisasi. Berkas secret yang hilang atau port host yang sudah dipakai harus diperbaiki sebelum mencoba ulang. Tinjau log untuk informasi sensitif sebelum membagikannya.
docker compose exec db mariadb --default-character-set=utf8mb4 -u app_user -p appops_lab
Masukkan kata sandi dari app-password.txt saat diminta. Jalankan SQL lengkap berikut di dalam klien; hasilnya satu baris. Pembuatan tabel ditujukan untuk eksekusi pertama. Jika tabel sudah ada, periksa keadaan latihan yang tersimpan sebelum mengulang penyiapan.
USE appops_lab;
CREATE TABLE docker_notes (
note_id INT NOT NULL PRIMARY KEY,
note_text VARCHAR(80) NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
INSERT INTO docker_notes VALUES (1, 'volume survives container replacement');
SELECT note_id, note_text FROM docker_notes;
Teks Inggris yang disimpan berarti “volume tetap ada setelah kontainer diganti” dan dipertahankan sebagai nilai contoh. Keberadaan baris yang sama sesudah penggantian kontainer akan menjadi pemeriksaan penyimpanan persisten.
Jika klien mariadb tersedia pada komputer, perintah berikut mengakses server yang sama melalui port host yang dipublikasikan. Menggunakan 3306 pada jalur ini dapat menghubungkan Anda ke server lokal yang berbeda:
mariadb --protocol=tcp --host=127.0.0.1 --port=3307 --default-character-set=utf8mb4 -u app_user -p appops_lab
Ganti kontainer dengan tetap mempertahankan volume
docker compose down
docker compose up -d
Pada konfigurasi ini, down tanpa opsi tambahan menghapus kontainer dan jaringan proyek, tetapi mempertahankan volume data bernama. Setelah layanan pengganti mencapai healthy, sambungkan kembali dan jalankan SELECT * FROM docker_notes;. Baris yang sebelumnya dimasukkan seharusnya tetap ada. Kueri ulang tersebut memeriksa data yang tersimpan, bukan sekadar mengasumsikan volume bertahan.
docker compose down --volumes turut menghapus volume dan dapat membuang basis data. Gunakan hanya setelah memastikan bahwa data latihan proyek ini boleh dibuang. Perintah itu bukan cara biasa untuk memulai ulang server. Volume tetap memerlukan cadangan basis data yang terpisah untuk data yang perlu dipertahankan. Referensi resmi Compose down menjelaskan cakupan penghapusannya.
Diagnosis kesalahan sebelum menginisialisasi data ulang
| Gejala | Hal yang diperiksa |
|---|---|
| Mesin Docker tidak dapat dihubungi | Apakah Docker Desktop atau Engine berjalan dan konteks Docker yang dipilih benar |
| Port yang dipublikasikan sudah dipakai | Port host 3307; jika diubah, sesuaikan port pada klien komputer |
| Access denied | Akun dan kata sandi saat inisialisasi serta apakah volume sudah ada sebelumnya |
| Kontainer berjalan tetapi SQL belum tersedia | Status healthcheck, log inisialisasi, serta perbedaan db dalam jaringan dan 127.0.0.1 pada host |
| Data tidak sesuai setelah kontainer dibuat ulang | Nama proyek mariadb-appops, folder kerja, port koneksi, dan volume yang dipasang |
Jangan jadikan penghapusan volume sebagai langkah diagnosis pertama. Kenali server dan direktori data yang dipakai, lalu tentukan apakah masalah memerlukan perbaikan konfigurasi atau inisialisasi baru yang disengaja.




