Memasang dan memulai aplikasi¶
Halaman ini memberi tahu Anda cara memasang, memulai, menghentikan, meningkatkan versi, dan menghapus LUC Analytics (LUCA) pada laptop Windows atau Mac dengan Docker Desktop.
Di Mac, lakukan dahulu langkah-langkah di "Memasang di Mac". Kemudian lanjutkan di "Memulai kontainer".
Memasang atau meningkatkan versi dengan satu perintah¶
Skrip pemasangan adalah cara tercepat untuk memasang atau meningkatkan versi aplikasi. Skrip melakukan langkah-langkah di halaman ini untuk Anda. Bagian-bagian setelah bagian ini memberi tahu Anda cara melakukan langkah-langkah secara manual. Gunakan bagian-bagian tersebut jika Anda tidak dapat menggunakan skrip.
Skrip melakukan langkah-langkah ini:
-
Skrip menemukan build yang benar (amd64 atau arm64) untuk komputer Anda.
-
Skrip membaca versi mana yang terbaru. Jika aplikasi sudah memiliki versi ini, skrip berhenti dan tidak mengunduh file.
-
Skrip mengunduh file image terbaru dan file pemeriksaannya, lalu memeriksa file image. Jika pemeriksaan gagal, skrip berhenti dan tidak mengubah aplikasi.
-
Pada pemasangan pertama, skrip memulai kontainer dan menunjukkan tautan dengan kunci akses.
-
Jika aplikasi sudah terpasang, skrip meningkatkan versinya. Skrip menulis cadangan volume, memulai versi baru dengan volume, port, dan pengaturan yang sama, dan menyimpan image yang lebih lama.
-
Jika versi baru tidak mulai, skrip memulai lagi versi yang lebih lama.
Ada dua skrip: install-luca.ps1 untuk Windows dan install-luca.sh untuk Mac. Unduh skrip dari ? > Unduhan di aplikasi, atau dari tautan ini: install-luca.ps1 (Windows) dan install-luca.sh (Mac).
PERINGATAN: Jaga kerahasiaan file cadangan. File tersebut berisi kunci akses, penyimpanan kredensial terenkripsi, dan kunci penyimpanan tersebut. Skrip menulis file cadangan ke folder saat ini. Namanya dimulai dengan luc-analytics-data-backup-.
Menggunakan skrip di Windows¶
- Pasang Docker Desktop (lihat "Memasang Docker Desktop").
- Mulai Docker Desktop. Tunggu sampai Docker Desktop menunjukkan Engine running (mesin berjalan).
- Unduh file
install-luca.ps1ke folder Unduhan Anda. - Buka PowerShell dan ketik perintah-perintah ini:
cd $HOME\Downloads
powershell -ExecutionPolicy Bypass -File .\install-luca.ps1
- Tunggu sampai skrip menunjukkan
is installed,is upgraded, atauis already up to date(skrip menunjukkan pesannya dalam bahasa Inggris). Unduhan dapat memerlukan beberapa menit.
Menggunakan skrip di Mac¶
- Pasang Docker Desktop for Mac (lihat "Memasang Docker Desktop for Mac").
- Mulai Docker Desktop. Tunggu sampai Docker Desktop menunjukkan Engine running (mesin berjalan).
- Unduh file
install-luca.shke folder Unduhan Anda. - Buka aplikasi Terminal dan ketik perintah ini:
cd ~/Downloads && bash install-luca.sh
- Tunggu sampai skrip menunjukkan
is installed,is upgraded, atauis already up to date(skrip menunjukkan pesannya dalam bahasa Inggris). Unduhan dapat memerlukan beberapa menit.
Setelah skrip¶
Skrip membuka aplikasi di browser Anda. Pada pemasangan pertama, skrip juga menunjukkan tautan dengan kunci akses. Jangan berikan tautan ini kepada orang lain. Untuk membaca kunci akses lagi, lihat "Membuka aplikasi dengan kunci akses".
Skrip menyimpan image dari versi sebelumnya. Untuk menghapus image yang lebih lama saat Anda meningkatkan versi, tambahkan -PruneOld (Windows) atau --prune-old (Mac) ke perintah. Untuk kembali ke versi sebelumnya, tambahkan -Rollback (Windows) atau --rollback (Mac) ke perintah.
Jika skrip berhenti dengan kesalahan¶
| Pesan | Penyebab dan tindakan perbaikan |
|---|---|
Docker does not run |
Docker Desktop tidak mulai. Mulai Docker Desktop dan tunggu sampai muncul Engine running. Kemudian lakukan langkah itu lagi. |
checksum mismatch |
File yang diunduh tidak benar. Skrip tidak mengubah aplikasi. Lakukan langkah itu lagi. |
Could not download |
Pastikan komputer Anda terhubung ke internet. Atau gunakan file image yang sudah Anda miliki (lihat bagian berikutnya). |
Could not read |
Skrip tidak dapat mengetahui versi mana yang terbaru. Skrip tidak mengubah aplikasi. Pastikan komputer Anda terhubung ke internet. Lalu lakukan langkah itu lagi. |
The download folder changed |
Versi baru keluar selama unduhan. Skrip tidak mengubah aplikasi. Lakukan langkah itu lagi. |
docker run failed |
Port 8000 mungkin tidak bebas. Tambahkan -Port 8080 (Windows) atau --port 8080 (Mac) ke perintah. Kemudian buka aplikasi di http://localhost:8080/. |
ROLLED BACK |
Versi baru tidak mulai. Versi yang lebih lama berjalan lagi dengan data Anda. Kirim output skrip kepada orang yang memberi Anda aplikasi. |
Menggunakan file image yang sudah Anda miliki¶
Jika komputer Anda tidak terhubung ke internet, Anda dapat menggunakan file image dan file pemeriksaannya yang sudah Anda miliki. Skrip memeriksa file, lalu melakukan langkah-langkah yang sama.
Di Windows:
- Taruh
install-luca.ps1di folder yang berisi file image dan file pemeriksaan. - Lakukan langkah 1 sampai 3 di "Memeriksa file image". Perintah menyimpan nama file image di
$f. - Di jendela PowerShell yang sama, ketik perintah ini:
powershell -ExecutionPolicy Bypass -File .\install-luca.ps1 -ImageFile $f
Di Mac:
- Taruh
install-luca.sh, file image, dan file pemeriksaan di folder Unduhan Anda. - Lakukan langkah 1 dan 2 di "Memeriksa file image di Mac". Perintah menyimpan nama file image di
$f. - Di jendela Terminal yang sama, ketik perintah ini:
bash install-luca.sh --image-file "$f"
Kebutuhan sistem¶
Laptop Windows Anda harus memiliki item berikut:
-
Windows 10 atau Windows 11 versi 64-bit.
-
Prosesor Intel atau AMD, atau prosesor ARM.
-
Memori (RAM) 8 GB atau lebih.
-
Ruang disk kosong untuk image, file image, data Anda, dan salinan set data yang Anda unduh. Image dapat menggunakan sampai 3.5 GB.
-
Docker Desktop for Windows dengan back end WSL 2.
Anda tidak memerlukan akun Docker.
Memasang Docker Desktop¶
- Unduh Docker Desktop for Windows dari docker.com.
- Mulai program pemasang.
- Jangan ubah nilai bawaan di program pemasang.
- Pastikan bahwa Anda memilih Use WSL 2 instead of Hyper-V (gunakan WSL 2 sebagai pengganti Hyper-V).
- Jika program pemasang meminta Anda memulai ulang Windows, mulai ulang Windows.
- Mulai Docker Desktop.
- Tunggu sampai Docker Desktop menunjukkan Engine running (mesin berjalan).
- Buka PowerShell dan ketik perintah ini:
docker version
- Pastikan bahwa output memiliki bagian Server. Jika bagian Server tidak ada, mesin Docker tidak mulai.
Memilih build yang benar (amd64 atau arm64)¶
Anda mendapat file image dalam dua build. Build harus sesuai dengan prosesor laptop Anda:
| Build | Prosesor | File image | File pemeriksaan |
|---|---|---|---|
| amd64 | Intel atau AMD | luc-analytics-beta-...-amd64.tar.gz |
luc-analytics-beta-...-amd64.tar.gz.sha256 |
| arm64 | ARM (misalnya, Snapdragon) | luc-analytics-beta-...-arm64.tar.gz |
luc-analytics-beta-...-arm64.tar.gz.sha256 |
Dalam nama file, bagian di antara beta- dan build adalah commit, misalnya 105ef19. Commit adalah kode pendek yang menunjukkan versi aplikasi. Anda tidak mengetik commit. Perintah dalam panduan ini menemukannya di nama file.
Setiap build memiliki folder unduhan. Folder berisi file image terbaru dan file pemeriksaannya. Unduh kedua file untuk build Anda ke folder yang sama. Saat aplikasi berjalan, Anda dapat membuka folder unduhan dari aplikasi: tekan ? di bilah atas, lalu tekan Unduhan. Untuk pemasangan pertama, minta tautan kepada orang yang memberi Anda aplikasi.
- Di PowerShell, ketik perintah ini:
$env:PROCESSOR_ARCHITECTURE
- Baca output. Jika output adalah
AMD64, gunakan build amd64. Jika output adalahARM64, gunakan build arm64. - Pastikan bahwa Anda memiliki file image dan file pemeriksaan untuk build tersebut.
CATATAN: Jika Anda tidak memiliki file untuk build Anda, unduh file dari folder unduhan untuk build Anda (? > Unduhan di aplikasi). Atau minta file kepada orang yang memberi Anda aplikasi.
Memeriksa file image¶
CATATAN: Lakukan langkah-langkah di bagian ini dan di "Memuat image" di jendela PowerShell yang sama. Perintah menyimpan nama file di $f.
- Buka PowerShell di folder yang berisi file image dan file pemeriksaan.
- Ketik perintah ini. Perintah ini menemukan file image untuk prosesor laptop Anda dan menunjukkan namanya:
$f = (Get-ChildItem ".\luc-analytics-beta-*-$($env:PROCESSOR_ARCHITECTURE.ToLower()).tar.gz" | Sort-Object LastWriteTime | Select-Object -Last 1).Name; $f
- Pastikan bahwa output adalah nama file image Anda. Jika folder berisi lebih dari satu file image, perintah menggunakan file yang terbaru.
- Ketik perintah ini:
(Get-FileHash $f -Algorithm SHA256).Hash -eq (Get-Content "$f.sha256").Split(' ')[0]
- Baca output. Jika output adalah
True, file tersebut benar.
PERINGATAN: Jangan gunakan file image jika output adalah False. File tersebut rusak, atau file tersebut bukan file yang benar. Unduh lagi file image dan file pemeriksaan.
Memuat image¶
- Ketik perintah ini:
docker load -i $f
- Output menunjukkan baris
Loaded image: luc-analytics:beta-.... - Beri image nama pendek
luc-analytics. Perintah ini mengambil commit dari nama file:
docker tag ("luc-analytics:" + ($f -replace '^luc-analytics-(beta-[0-9a-f]+)-.*$','$1')) luc-analytics
- Untuk melihat build image, ketik perintah ini:
docker image inspect luc-analytics --format "{{.Architecture}}"
- Pastikan bahwa output (
amd64atauarm64) sesuai dengan build yang Anda temukan sebelumnya.
Setelah Anda memuat image, Anda dapat menghapus file image. Simpan file tersebut jika Anda ingin memuat image lagi.
Memasang di Mac¶
Di Mac, lakukan langkah-langkah di bagian ini sebagai pengganti bagian dari "Kebutuhan sistem" sampai "Memuat image". Gunakan aplikasi Terminal untuk semua perintah dalam panduan ini. Perintah docker sama dengan di PowerShell.
Kebutuhan sistem di Mac¶
Mac Anda harus memiliki item berikut:
-
Versi macOS yang didukung oleh Docker Desktop for Mac versi saat ini.
-
Chip Apple (M1 atau lebih baru), atau prosesor Intel.
-
Memori (RAM) 8 GB atau lebih.
-
Ruang disk kosong untuk image, file image, data Anda, dan salinan set data yang Anda unduh. Image dapat menggunakan hingga 3,5 GB.
Memasang Docker Desktop for Mac¶
- Temukan chip Mac Anda. Buka menu Apple dan pilih About This Mac (Tentang Mac Ini).
- Baca baris Chip atau Processor (prosesor):
- Jika baris dimulai dengan
Apple M, Mac Anda memiliki chip Apple. Gunakan build arm64 aplikasi. - Jika baris berisi
Intel, Mac Anda memiliki prosesor Intel. Gunakan build amd64 aplikasi. - Unduh Docker Desktop for Mac dari docker.com. Pilih unduhan untuk chip Anda: chip Apple atau chip Intel.
- Buka file unduhan
Docker.dmg. - Pindahkan ikon Docker ke folder Applications (Aplikasi).
- Mulai Docker dari folder Applications.
- Terima ketentuan perjanjian layanan. Jangan ubah pengaturan yang direkomendasikan.
- Tunggu sampai Docker Desktop menunjukkan Engine running (mesin berjalan).
- Buka aplikasi Terminal. Aplikasi ini ada di folder Applications > Utilities (Aplikasi > Utilitas).
-
Ketik perintah ini:
docker version -
Pastikan bahwa output memiliki bagian Server. Jika bagian Server tidak ada, mesin Docker tidak mulai.
Memeriksa file image di Mac¶
CATATAN: Lakukan langkah-langkah di bagian ini dan di "Memuat image di Mac" di jendela Terminal yang sama. Perintah menyimpan nama file di $f.
Perintah di bawah menggunakan folder Downloads (Unduhan). Jika file Anda ada di folder lain, gunakan folder tersebut sebagai pengganti ~/Downloads.
- Ketik perintah ini. Perintah ini menemukan file image untuk chip Mac Anda dan menunjukkan namanya:
cd ~/Downloads && a=$(uname -m | sed s/x86_64/amd64/) && f=$(ls -t luc-analytics-beta-*-$a.tar.gz | head -1) && echo $f
- Pastikan bahwa output adalah nama file image Anda. Jika folder berisi lebih dari satu file image, perintah menggunakan file yang terbaru.
- Ketik perintah ini:
shasum -a 256 -c "$f.sha256"
- Baca output. Jika output adalah nama file dan
OK, file tersebut benar.
PERINGATAN: Jangan gunakan file image jika output menunjukkan FAILED. File tersebut rusak, atau file tersebut bukan file yang benar. Unduh lagi file image dan file pemeriksaan.
CATATAN: Jika perintah di langkah 1 tidak menemukan file, mungkin Safari membuka file setelah unduhan. Maka folder berisi file .tar, bukan file .tar.gz. Di Safari, buka Settings > General (Pengaturan > Umum) dan hapus centang Open "safe" files after downloading (buka file "aman" setelah diunduh). Kemudian unduh file lagi.
Memuat image di Mac¶
- Ketik perintah ini:
docker load -i "$f"
- Output menunjukkan baris
Loaded image: luc-analytics:beta-.... - Beri image nama pendek
luc-analytics. Perintah ini mengambil commit dari nama file:
docker tag "luc-analytics:$(echo $f | sed -E 's/^luc-analytics-(beta-[0-9a-f]+)-.*$/\1/')" luc-analytics
- Untuk melihat build image, ketik perintah ini:
docker image inspect luc-analytics --format "{{.Architecture}}"
- Pastikan bahwa output sesuai dengan Mac Anda:
arm64untuk chip Apple,amd64untuk prosesor Intel.
Kemudian lanjutkan di "Memulai kontainer". Ketik perintah yang sama di Terminal.
Memori di Mac¶
Docker Desktop for Mac mengatur memori yang dapat digunakan Docker. Aplikasi memerlukan memori 5 GB atau lebih di Docker. Untuk mengubah memori, lakukan langkah-langkah berikut:
- Di Docker Desktop, buka Settings > Resources (Pengaturan > Sumber daya).
- Atur batas memori ke 5 GB atau lebih. Kami merekomendasikan 5 GB sampai 6 GB pada Mac dengan memori 8 GB.
- Tekan Apply & restart (terapkan dan mulai ulang).
Bagian "Pengaturan memori" di bawah hanya untuk Windows. Bagian terakhir dari bagian tersebut, tentang Pengaturan > Memori di aplikasi, juga benar di Mac.
Memulai kontainer¶
CATATAN: Pastikan bahwa port 8000 bebas di laptop Anda. Jika port 8000 tidak bebas, docker run gagal. Untuk tindakan perbaikan, lihat 07-troubleshooting.md.
- Ketik perintah berikut:
docker run -d --name luc-analytics -p 127.0.0.1:8000:8000 -v luc-analytics-data:/data luc-analytics
docker logs luc-analytics
Perintah pertama membuat kontainer dengan nama luc-analytics. Hanya program di laptop Anda yang dapat terhubung ke kontainer tersebut, di port 8000. Kontainer menyimpan semua datanya di volume Docker dengan nama luc-analytics-data.
Setelah sekitar 40 detik, halaman Containers (kontainer) di Docker Desktop menunjukkan kontainer sebagai sehat.
File konfigurasi¶
Pada awal mulai yang pertama, kontainer membuat file konfigurasi /data/config.yaml di volume. Kontainer menyalin file config.example.yaml dari image, dengan dua perubahan:
-
Unggahan daftar aktif.
-
Anda dapat mengunduh salinan set data ke folder
/data/datasets.
File salinan tersebut juga mengaktifkan peta dasar Copernicus (CDSE). Peta dasar CDSE juga memerlukan ID instans. Untuk ID instans, lihat 06-settings.md.
Kontainer membuat file ini hanya pada awal mulai yang pertama. Jika file /data/config.yaml sudah ada, kontainer tidak mengubahnya.
Membuka aplikasi dengan kunci akses¶
Aplikasi tidak memiliki akun pengguna. Aplikasi menggunakan kunci akses agar orang lain tidak dapat menggunakannya. Aplikasi membuat kunci aksesnya pada awal mulai yang pertama dan menyimpannya di volume, di file /data/state/access-key. Tidak ada kunci akses di dalam image.
PERINGATAN: Jangan berikan tautan dengan kunci akses kepada orang lain. Orang yang memiliki tautan tersebut dapat menggunakan aplikasi dan kredensial AWS Anda.
- Di output
docker logs luc-analytics, temukan baris ini:
serve: open http://localhost:8000/?access_key=... (once per browser).
- Salin tautan lengkap dari baris tersebut.
- Tempelkan tautan ke bilah alamat browser Anda.
Aplikasi menyimpan kunci di cookie di browser. Kemudian bilah alamat menunjukkan http://localhost:8000/. Lakukan langkah-langkah ini satu kali di setiap browser yang Anda gunakan.
Log menunjukkan tautan hanya pada awal mulai yang pertama. Untuk membaca kunci akses lagi (misalnya, untuk browser baru), lakukan langkah-langkah berikut:
- Pastikan bahwa kontainer berjalan.
- Ketik perintah ini:
docker exec luc-analytics cat /data/state/access-key
- Buka
http://localhost:8000/?access_key=<key>di browser Anda. Gunakan kunci dari langkah 2 sebagai pengganti<key>.
Menghentikan dan memulai aplikasi¶
- Untuk menghentikan aplikasi, ketik perintah ini:
docker stop luc-analytics
- Untuk memulai aplikasi lagi, ketik perintah ini:
docker start luc-analytics
Anda juga dapat menggunakan tombol stop dan start di halaman Containers di Docker Desktop. Saat Anda menghentikan aplikasi, Anda tetap memiliki semua data Anda. Kunci akses tidak berubah, jadi browser tidak meminta kunci itu lagi.
Memulai aplikasi setelah Anda memulai ulang laptop¶
Kontainer tidak mulai secara otomatis setelah Anda memulai ulang Windows atau macOS. Lakukan langkah-langkah berikut:
- Mulai Docker Desktop.
- Tunggu sampai Docker Desktop menunjukkan Engine running.
- Ketik perintah ini:
docker start luc-analytics
Jika Anda ingin kontainer mulai setiap kali mesin Docker mulai, ketik perintah ini satu kali:
docker update --restart unless-stopped luc-analytics
Untuk ini, Docker Desktop juga harus mulai saat Anda masuk (log in) ke komputer Anda. Anda mengatur hal ini di pengaturan Docker Desktop.
Meningkatkan ke image baru¶
Untuk meningkatkan versi dengan satu perintah, lakukan lagi langkah-langkah di "Memasang atau meningkatkan versi dengan satu perintah". Skrip menulis cadangan untuk Anda. Jika Anda tidak dapat menggunakan skrip, lakukan langkah-langkah di bagian ini.
Semua data Anda ada di volume luc-analytics-data. Peningkatan versi tetap menyimpan volume, jadi Anda tetap memiliki daftar, hasil, kredensial, dan kunci akses Anda. Log tidak menunjukkan tautan baru setelah peningkatan versi.
Pada awal mulai yang pertama, versi baru dapat mengubah database hasil. Versi yang lebih lama mungkin tidak dapat membaca database yang telah berubah. Jadi, cadangan adalah satu-satunya cara untuk kembali ke versi yang lebih lama.
PERINGATAN: Buat cadangan volume sebelum Anda meningkatkan versi. Jika Anda tidak memiliki cadangan, Anda tidak dapat kembali ke versi yang lebih lama.
- Baca changelog versi baru.
- Hentikan kontainer:
docker stop luc-analytics
- Buka PowerShell (di Mac, Terminal) di folder tempat Anda ingin menyimpan cadangan.
PERINGATAN: Jaga kerahasiaan file cadangan. File tersebut berisi kunci akses, penyimpanan kredensial terenkripsi, dan kunci penyimpanan tersebut.
- Tulis file cadangan ke folder tersebut:
docker run --rm --user 0 --entrypoint tar -v luc-analytics-data:/data -v "${PWD}:/backup" luc-analytics -C /data -czf /backup/luc-analytics-data-backup.tgz .
- Pastikan bahwa file
luc-analytics-data-backup.tgzada di folder tersebut. - Lakukan lagi langkah-langkah di "Memeriksa file image" dengan file image baru. Di Mac, lakukan langkah-langkah di "Memeriksa file image di Mac".
- Lakukan lagi langkah-langkah di "Memuat image" di jendela yang sama. Di Mac, lakukan langkah-langkah di "Memuat image di Mac".
- Hapus kontainer lama. Perintah ini tidak menghapus volume:
docker rm luc-analytics
- Buat kontainer baru pada volume yang sama:
docker run -d --name luc-analytics -p 127.0.0.1:8000:8000 -v luc-analytics-data:/data luc-analytics
File konfigurasi setelah peningkatan versi¶
Peningkatan versi tidak mengubah file /data/config.yaml Anda. Image baru tidak menyalin config.example.yaml barunya ke volume. Hal ini memiliki akibat berikut:
-
Pengaturan yang ada di file Anda tetap memiliki nilai lamanya. Nilai bawaan baru di versi baru tidak menggantikannya.
-
Pengaturan yang tidak ada di file Anda mendapat nilai yang tertanam di program. Nilai ini dapat berbeda dari nilai di
config.example.yamlyang baru.
Jadi, nilai bawaan baru tidak masuk ke instalasi yang Anda tingkatkan. Untuk menggunakan nilai bawaan baru, ubah pengaturan di /data/config.yaml dan mulai ulang kontainer. Jika pengaturan memiliki tanda [live] di config.example.yaml, Anda juga dapat mengubahnya di halaman Pengaturan. Changelog memberi tahu Anda tentang pengaturan baru. Untuk file konfigurasi, lihat 06-settings.md.
Menghapus aplikasi dan datanya¶
PERINGATAN: Buat cadangan sebelum Anda menghapus volume (lihat "Meningkatkan ke image baru", langkah 2 sampai 5). Saat Anda menghapus volume, Anda menghapus semua daftar, hasil, kredensial tersimpan, kunci akses, dan semua salinan set data yang diunduh. Anda tidak dapat mendapatkannya kembali.
- Hapus kontainer. Data tetap ada di volume:
docker rm -f luc-analytics
- Hapus volume. Perintah ini menghapus semua data Anda:
docker volume rm luc-analytics-data
- Hapus image. Perintah ini menghapus image dengan semua namanya:
docker image rm -f $(docker image inspect luc-analytics --format "{{.Id}}")
Untuk menghapus Docker Desktop, buka Settings > Apps (Pengaturan > Aplikasi) di Windows. Di Mac, gunakan prosedur pencopotan di dokumentasi Docker Desktop.
Pengaturan memori¶
Dengan back end WSL 2, Docker dapat menggunakan sebagian memori laptop Anda. Secara bawaan, bagian ini adalah sekitar setengah dari memori. Untuk melihat memori yang dapat digunakan Docker, ketik perintah ini:
docker info --format "{{.MemTotal}}"
Output dalam byte.
Aplikasi tidak menggunakan semua memori. Aplikasi menyisakan 3 GB atau 10% memori, mana yang lebih besar. Minimum yang disarankan untuk aplikasi adalah 2 GB. Jadi, Docker harus memiliki memori 5 GB atau lebih. Kami menyarankan agar Anda memberi Docker 5 GB sampai 6 GB pada laptop dengan memori 8 GB.
Untuk mengubah memori yang dapat digunakan Docker, lakukan langkah-langkah berikut:
- Jika file
C:\Users\<your user name>\.wslconfigtidak ada, buat file tersebut. - Buka file tersebut di editor teks.
- Tulis baris berikut di file tersebut:
[wsl2]
memory=6GB
- Simpan file tersebut.
- Keluar dari Docker Desktop.
- Ketik perintah ini di PowerShell:
wsl --shutdown
- Mulai Docker Desktop.
Di dalam Docker Desktop, aplikasi biasanya tidak dapat menemukan batas memori. Jika ini terjadi, aplikasi meminta batas tersebut kepada Anda. Lakukan langkah-langkah berikut:
- Di aplikasi, buka Pengaturan > Memori.
- Di Batas memori host / VM (GB), ketik memori yang dimiliki Docker.
CATATAN: Tutup program besar lainnya saat aplikasi melakukan analisis. Program-program tersebut menggunakan memori yang mungkin diperlukan aplikasi.
Jika aplikasi tidak menjawab¶
- Untuk melihat pesan dari aplikasi, ketik perintah ini:
docker logs luc-analytics
- Untuk melihat apakah kontainer berjalan, ketik perintah ini:
docker ps -a
- Jika Docker Desktop tidak menunjukkan Engine running, lakukan langkah-langkah berikut:
- Keluar dari Docker Desktop.
- Ketik
wsl --shutdowndi PowerShell. - Mulai Docker Desktop lagi.
Untuk masalah lain dan tindakan perbaikannya, lihat 07-troubleshooting.md.