Installer et démarrer l'application¶
Cette page vous indique comment installer, démarrer, arrêter, mettre à niveau et supprimer LUC Analytics (LUCA) sur un ordinateur portable Windows ou sur un Mac, avec Docker Desktop.
Sur un Mac, faites d'abord les étapes de "Installer sur un Mac". Puis continuez à "Démarrer le conteneur".
Installer ou mettre à niveau avec une seule commande¶
Le script d'installation est le moyen le plus rapide d'installer ou de mettre à niveau l'application. Le script fait pour vous les étapes de cette page. Les sections qui suivent cette section vous indiquent comment faire les étapes à la main. Utilisez-les si vous ne pouvez pas utiliser le script.
Le script fait ces étapes :
-
Il trouve la version correcte (amd64 ou arm64) pour votre ordinateur.
-
Il lit quelle version est la plus récente. Si l'application a déjà cette version, le script s'arrête et ne télécharge aucun fichier.
-
Il télécharge le fichier image le plus récent et son fichier de contrôle, puis contrôle le fichier image. Si le contrôle échoue, le script s'arrête et ne modifie pas l'application.
-
À la première installation, il démarre le conteneur et affiche le lien avec la clé d'accès.
-
Si l'application est déjà installée, il la met à niveau. Il écrit une sauvegarde du volume, démarre la nouvelle version avec le même volume, le même port et les mêmes réglages, et garde l'image plus ancienne.
-
Si la nouvelle version ne démarre pas, le script démarre à nouveau la version plus ancienne.
Il y a deux scripts : install-luca.ps1 pour Windows et install-luca.sh pour un Mac. Téléchargez les scripts dans ? > Téléchargements dans l'application, ou depuis ces liens : install-luca.ps1 (Windows) et install-luca.sh (Mac).
AVERTISSEMENT : Gardez le fichier de sauvegarde privé. Il contient la clé d'accès, le coffre chiffré des identifiants et la clé de ce coffre. Le script écrit le fichier de sauvegarde dans le dossier actuel. Son nom commence par luc-analytics-data-backup-.
Utiliser le script sur Windows¶
- Installez Docker Desktop (consultez "Installer Docker Desktop").
- Démarrez Docker Desktop. Attendez que Docker Desktop affiche Engine running (le moteur fonctionne).
- Téléchargez le fichier
install-luca.ps1dans votre dossier Téléchargements. - Ouvrez PowerShell et saisissez ces commandes :
cd $HOME\Downloads
powershell -ExecutionPolicy Bypass -File .\install-luca.ps1
- Attendez que le script affiche
is installed,is upgradedouis already up to date(le script affiche ses messages en anglais). Le téléchargement peut prendre quelques minutes.
Utiliser le script sur un Mac¶
- Installez Docker Desktop pour Mac (consultez "Installer Docker Desktop pour Mac").
- Démarrez Docker Desktop. Attendez que Docker Desktop affiche Engine running (le moteur fonctionne).
- Téléchargez le fichier
install-luca.shdans votre dossier Téléchargements. - Ouvrez l'application Terminal et saisissez cette commande :
cd ~/Downloads && bash install-luca.sh
- Attendez que le script affiche
is installed,is upgradedouis already up to date(le script affiche ses messages en anglais). Le téléchargement peut prendre quelques minutes.
Après le script¶
Le script ouvre l'application dans votre navigateur. À la première installation, il affiche aussi le lien avec la clé d'accès. Ne donnez pas ce lien à d'autres personnes. Pour lire à nouveau la clé d'accès, consultez "Ouvrir l'application avec la clé d'accès".
Le script garde l'image de la version précédente. Pour supprimer les images plus anciennes lors d'une mise à niveau, ajoutez -PruneOld (Windows) ou --prune-old (Mac) à la commande. Pour revenir à la version précédente, ajoutez -Rollback (Windows) ou --rollback (Mac) à la commande.
Si le script s'arrête avec une erreur¶
| Message | Cause et action corrective |
|---|---|
Docker does not run |
Docker Desktop n'a pas démarré. Démarrez Docker Desktop et attendez Engine running. Puis refaites l'étape. |
checksum mismatch |
Le fichier téléchargé n'est pas correct. Le script n'a pas modifié l'application. Refaites l'étape. |
Could not download |
Assurez-vous que votre ordinateur est connecté à internet. Ou utilisez un fichier image que vous avez déjà (consultez la section suivante). |
Could not read |
Le script ne peut pas savoir quelle version est la plus récente. Le script n'a pas modifié l'application. Assurez-vous que votre ordinateur est connecté à internet. Puis refaites l'étape. |
The download folder changed |
Une nouvelle version est sortie pendant le téléchargement. Le script n'a pas modifié l'application. Refaites l'étape. |
docker run failed |
Le port 8000 n'est peut-être pas libre. Ajoutez -Port 8080 (Windows) ou --port 8080 (Mac) à la commande. Puis ouvrez l'application à http://localhost:8080/. |
ROLLED BACK |
La nouvelle version n'a pas démarré. La version plus ancienne fonctionne à nouveau avec vos données. Envoyez la sortie du script à la personne qui vous a donné l'application. |
Utiliser un fichier image que vous avez déjà¶
Si votre ordinateur n'est pas connecté à internet, vous pouvez utiliser un fichier image et son fichier de contrôle que vous avez déjà. Le script contrôle le fichier puis fait les mêmes étapes.
Sur Windows :
- Mettez
install-luca.ps1dans le dossier qui contient le fichier image et le fichier de contrôle. - Faites les étapes 1 à 3 de "Contrôler le fichier image". La commande garde le nom du fichier image dans
$f. - Dans la même fenêtre PowerShell, saisissez cette commande :
powershell -ExecutionPolicy Bypass -File .\install-luca.ps1 -ImageFile $f
Sur un Mac :
- Mettez
install-luca.sh, le fichier image et le fichier de contrôle dans votre dossier Téléchargements. - Faites les étapes 1 et 2 de "Contrôler le fichier image sur un Mac". La commande garde le nom du fichier image dans
$f. - Dans la même fenêtre Terminal, saisissez cette commande :
bash install-luca.sh --image-file "$f"
Configuration nécessaire¶
Votre ordinateur portable Windows doit avoir ces éléments :
-
Une version 64 bits de Windows 10 ou de Windows 11.
-
Un processeur Intel ou AMD, ou un processeur ARM.
-
8 GB de mémoire (RAM) ou plus.
-
De l'espace disque libre pour l'image, le fichier image, vos données et les copies de jeux de données que vous téléchargez. L'image peut utiliser jusqu'à 3.5 GB.
-
Docker Desktop pour Windows avec le moteur WSL 2.
Vous n'avez pas besoin d'un compte Docker.
Installer Docker Desktop¶
- Téléchargez Docker Desktop pour Windows sur docker.com.
- Démarrez le programme d'installation.
- Ne modifiez pas les valeurs par défaut du programme d'installation.
- Assurez-vous de sélectionner Use WSL 2 instead of Hyper-V (utiliser WSL 2 au lieu de Hyper-V).
- Si le programme d'installation vous demande de redémarrer Windows, redémarrez Windows.
- Démarrez Docker Desktop.
- Attendez que Docker Desktop affiche Engine running (le moteur fonctionne).
- Ouvrez PowerShell et saisissez cette commande :
docker version
- Assurez-vous que la sortie a une partie Server (serveur). Si la partie Server n'est pas là, le moteur Docker n'a pas démarré.
Sélectionner la version correcte (amd64 ou arm64)¶
Vous recevez le fichier image en deux versions. La version doit correspondre au processeur de votre ordinateur portable :
| Version | Processeur | Fichier image | Fichier de contrôle |
|---|---|---|---|
| amd64 | Intel ou AMD | luc-analytics-beta-...-amd64.tar.gz |
luc-analytics-beta-...-amd64.tar.gz.sha256 |
| arm64 | ARM (par exemple, Snapdragon) | luc-analytics-beta-...-arm64.tar.gz |
luc-analytics-beta-...-arm64.tar.gz.sha256 |
Dans le nom du fichier, la partie entre beta- et la version est le commit, par exemple 105ef19. Le commit est un code court qui identifie la version de l'application. Vous ne saisissez pas le commit. Les commandes de ce guide le trouvent dans le nom du fichier.
Chaque version a un dossier de téléchargement. Le dossier contient le fichier image le plus récent et son fichier de contrôle. Téléchargez les deux fichiers de votre version dans le même dossier. Quand l'application fonctionne, vous pouvez ouvrir les dossiers de téléchargement depuis l'application : appuyez sur ? dans la barre supérieure, puis appuyez sur Téléchargements. Pour la première installation, demandez les liens à la personne qui vous a donné l'application.
- Dans PowerShell, saisissez cette commande :
$env:PROCESSOR_ARCHITECTURE
- Lisez la sortie. Si la sortie est
AMD64, utilisez la version amd64. Si la sortie estARM64, utilisez la version arm64. - Assurez-vous d'avoir le fichier image et le fichier de contrôle de cette version.
REMARQUE : Si vous n'avez pas les fichiers de votre version, téléchargez-les depuis le dossier de téléchargement de votre version (? > Téléchargements dans l'application). Ou demandez les fichiers à la personne qui vous a donné l'application.
Contrôler le fichier image¶
REMARQUE : Faites les étapes de cette section et de "Charger l'image" dans la même fenêtre PowerShell. Les commandes gardent le nom du fichier dans $f.
- Ouvrez PowerShell dans le dossier qui contient le fichier image et le fichier de contrôle.
- Saisissez cette commande. Elle trouve le fichier image pour le processeur de votre ordinateur portable et affiche son nom :
$f = (Get-ChildItem ".\luc-analytics-beta-*-$($env:PROCESSOR_ARCHITECTURE.ToLower()).tar.gz" | Sort-Object LastWriteTime | Select-Object -Last 1).Name; $f
- Assurez-vous que la sortie est le nom de votre fichier image. Si le dossier contient plus d'un fichier image, la commande utilise le fichier le plus récent.
- Saisissez cette commande :
(Get-FileHash $f -Algorithm SHA256).Hash -eq (Get-Content "$f.sha256").Split(' ')[0]
- Lisez la sortie. Si la sortie est
True, le fichier est correct.
AVERTISSEMENT : N'utilisez pas le fichier image si la sortie est False. Le fichier est endommagé, ou ce n'est pas le bon fichier. Téléchargez à nouveau le fichier image et le fichier de contrôle.
Charger l'image¶
- Saisissez cette commande :
docker load -i $f
- La sortie affiche la ligne
Loaded image: luc-analytics:beta-.... - Donnez à l'image le nom court
luc-analytics. Cette commande prend le commit dans le nom du fichier :
docker tag ("luc-analytics:" + ($f -replace '^luc-analytics-(beta-[0-9a-f]+)-.*$','$1')) luc-analytics
- Pour voir la version de l'image, saisissez cette commande :
docker image inspect luc-analytics --format "{{.Architecture}}"
- Assurez-vous que la sortie (
amd64ouarm64) correspond à la version que vous avez trouvée avant.
Après le chargement de l'image, vous pouvez supprimer le fichier image. Gardez le fichier si vous voulez charger l'image à nouveau.
Installer sur un Mac¶
Sur un Mac, faites les étapes de cette section à la place des sections de "Configuration nécessaire" à "Charger l'image". Utilisez l'application Terminal pour toutes les commandes de ce guide. Les commandes docker sont les mêmes que dans PowerShell.
Configuration nécessaire sur un Mac¶
Votre Mac doit avoir ces éléments :
-
Une version de macOS que la version actuelle de Docker Desktop pour Mac prend en charge.
-
Une puce Apple (M1 ou plus récente), ou un processeur Intel.
-
8 Go de mémoire (RAM) ou plus.
-
De l'espace disque libre pour l'image, le fichier image, vos données et les copies de jeux de données que vous téléchargez. L'image peut utiliser jusqu'à 3,5 Go.
Installer Docker Desktop pour Mac¶
- Trouvez la puce de votre Mac. Ouvrez le menu Apple et sélectionnez About This Mac (À propos de ce Mac).
- Lisez la ligne Chip (puce) ou Processor (processeur) :
- Si la ligne commence par
Apple M, votre Mac a une puce Apple. Utilisez la version arm64 de l'application. - Si la ligne contient
Intel, votre Mac a un processeur Intel. Utilisez la version amd64 de l'application. - Téléchargez Docker Desktop pour Mac depuis docker.com. Sélectionnez le téléchargement pour votre puce : puce Apple ou puce Intel.
- Ouvrez le fichier téléchargé
Docker.dmg. - Déplacez l'icône Docker dans le dossier Applications.
- Démarrez Docker depuis le dossier Applications.
- Acceptez les conditions du contrat de service. Ne changez pas les réglages recommandés.
- Attendez que Docker Desktop affiche Engine running (le moteur fonctionne).
- Ouvrez l'application Terminal. Elle est dans le dossier Applications > Utilities (Applications > Utilitaires).
-
Saisissez cette commande :
docker version -
Assurez-vous que la sortie a une partie Server (serveur). Si la partie Server n'est pas là, le moteur Docker n'a pas démarré.
Contrôler le fichier image sur un Mac¶
REMARQUE : Faites les étapes de cette section et de "Charger l'image sur un Mac" dans la même fenêtre Terminal. Les commandes gardent le nom du fichier dans $f.
Les commandes ci-dessous utilisent le dossier Downloads (Téléchargements). Si vos fichiers sont dans un autre dossier, utilisez ce dossier à la place de ~/Downloads.
- Saisissez cette commande. Elle trouve le fichier image pour la puce de votre Mac et affiche son nom :
cd ~/Downloads && a=$(uname -m | sed s/x86_64/amd64/) && f=$(ls -t luc-analytics-beta-*-$a.tar.gz | head -1) && echo $f
- Assurez-vous que la sortie est le nom de votre fichier image. Si le dossier contient plus d'un fichier image, la commande utilise le fichier le plus récent.
- Saisissez cette commande :
shasum -a 256 -c "$f.sha256"
- Lisez la sortie. Si la sortie est le nom du fichier et
OK, le fichier est correct.
AVERTISSEMENT : N'utilisez pas le fichier image si la sortie affiche FAILED. Le fichier est endommagé, ou ce n'est pas le bon fichier. Téléchargez à nouveau le fichier image et le fichier de contrôle.
REMARQUE : Si la commande de l'étape 1 ne trouve aucun fichier, Safari a peut-être ouvert le fichier après le téléchargement. Alors le dossier contient un fichier .tar, pas un fichier .tar.gz. Dans Safari, allez dans Settings > General (Réglages > Général) et décochez Open "safe" files after downloading (ouvrir les fichiers "fiables" après téléchargement). Puis téléchargez à nouveau les fichiers.
Charger l'image sur un Mac¶
- Saisissez cette commande :
docker load -i "$f"
- La sortie affiche la ligne
Loaded image: luc-analytics:beta-.... - Donnez à l'image le nom court
luc-analytics. Cette commande prend le commit dans le nom du fichier :
docker tag "luc-analytics:$(echo $f | sed -E 's/^luc-analytics-(beta-[0-9a-f]+)-.*$/\1/')" luc-analytics
- Pour voir la version de l'image, saisissez cette commande :
docker image inspect luc-analytics --format "{{.Architecture}}"
- Assurez-vous que la sortie correspond à votre Mac :
arm64pour une puce Apple,amd64pour un processeur Intel.
Puis continuez à "Démarrer le conteneur". Saisissez les mêmes commandes dans Terminal.
Mémoire sur un Mac¶
Docker Desktop pour Mac règle la mémoire que Docker peut utiliser. L'application a besoin de 5 Go de mémoire ou plus dans Docker. Pour changer la mémoire, faites ces étapes :
- Dans Docker Desktop, allez dans Settings > Resources (Paramètres > Ressources).
- Réglez la limite de mémoire sur 5 Go ou plus. Nous recommandons 5 Go à 6 Go sur un Mac avec 8 Go de mémoire.
- Appuyez sur Apply & restart (appliquer et redémarrer).
La section "Réglages de la mémoire" ci-dessous est pour Windows uniquement. La dernière partie de cette section, sur Paramètres > Mémoire dans l'application, est aussi correcte sur un Mac.
Démarrer le conteneur¶
REMARQUE : Assurez-vous que le port 8000 est libre sur votre ordinateur portable. Si le port 8000 n'est pas libre, docker run échoue. Pour l'action corrective, consultez 07-troubleshooting.md.
- Saisissez ces commandes :
docker run -d --name luc-analytics -p 127.0.0.1:8000:8000 -v luc-analytics-data:/data luc-analytics
docker logs luc-analytics
La première commande crée un conteneur avec le nom luc-analytics. Seuls les programmes de votre ordinateur portable peuvent s'y connecter, sur le port 8000. Le conteneur garde toutes ses données dans un volume Docker avec le nom luc-analytics-data.
Après environ 40 secondes, la page Containers (conteneurs) de Docker Desktop affiche le conteneur comme sain (healthy).
Le fichier de configuration¶
Au premier démarrage, le conteneur crée le fichier de configuration /data/config.yaml dans le volume. Il copie le fichier config.example.yaml de l'image, avec deux modifications :
-
Les téléversements de listes sont activés.
-
Vous pouvez télécharger des copies de jeux de données dans le dossier
/data/datasets.
Le fichier copié active aussi le fond de carte Copernicus (CDSE). Le fond de carte CDSE a aussi besoin d'un ID d'instance. Pour l'ID d'instance, consultez 06-settings.md.
Le conteneur crée ce fichier uniquement au premier démarrage. Si le fichier /data/config.yaml existe, le conteneur ne le modifie pas.
Ouvrir l'application avec la clé d'accès¶
L'application n'a pas de comptes d'utilisateur. L'application utilise une clé d'accès pour que d'autres personnes ne puissent pas l'utiliser. L'application crée sa clé d'accès au premier démarrage et la garde dans le volume, dans le fichier /data/state/access-key. L'image ne contient pas de clé d'accès.
AVERTISSEMENT : Ne donnez pas le lien avec la clé d'accès à d'autres personnes. Une personne qui a le lien peut utiliser l'application et votre identifiant AWS.
- Dans la sortie de
docker logs luc-analytics, trouvez cette ligne :
serve: open http://localhost:8000/?access_key=... (once per browser).
- Copiez le lien complet de cette ligne.
- Collez le lien dans la barre d'adresse de votre navigateur.
L'application garde la clé dans un cookie du navigateur. Ensuite, la barre d'adresse affiche http://localhost:8000/. Faites ces étapes une fois dans chaque navigateur que vous utilisez.
Le journal affiche le lien uniquement au premier démarrage. Pour lire la clé d'accès à nouveau (par exemple, pour un nouveau navigateur), faites ces étapes :
- Assurez-vous que le conteneur fonctionne.
- Saisissez cette commande :
docker exec luc-analytics cat /data/state/access-key
- Ouvrez
http://localhost:8000/?access_key=<key>dans votre navigateur. Utilisez la clé de l'étape 2 à la place de<key>.
Arrêter et démarrer l'application¶
- Pour arrêter l'application, saisissez cette commande :
docker stop luc-analytics
- Pour démarrer l'application à nouveau, saisissez cette commande :
docker start luc-analytics
Vous pouvez aussi utiliser les boutons d'arrêt et de démarrage de la page Containers de Docker Desktop. Quand vous arrêtez l'application, vous gardez toutes vos données. La clé d'accès ne change pas, donc le navigateur ne la demande pas à nouveau.
Démarrer l'application après un redémarrage de l'ordinateur portable¶
Le conteneur ne démarre pas automatiquement après un redémarrage de Windows ou de macOS. Faites ces étapes :
- Démarrez Docker Desktop.
- Attendez que Docker Desktop affiche Engine running.
- Saisissez cette commande :
docker start luc-analytics
Si vous voulez que le conteneur démarre chaque fois que le moteur Docker démarre, saisissez cette commande une fois :
docker update --restart unless-stopped luc-analytics
Pour cela, Docker Desktop doit aussi démarrer quand vous ouvrez une session sur votre ordinateur. Vous réglez cela dans les paramètres de Docker Desktop.
Mettre à niveau vers une nouvelle image¶
Pour mettre à niveau avec une seule commande, refaites les étapes de "Installer ou mettre à niveau avec une seule commande". Le script écrit la sauvegarde pour vous. Si vous ne pouvez pas utiliser le script, faites les étapes de cette section.
Toutes vos données sont dans le volume luc-analytics-data. Une mise à niveau garde le volume, donc vous gardez vos listes, vos résultats, vos identifiants et votre clé d'accès. Le journal n'affiche pas de nouveau lien après la mise à niveau.
À son premier démarrage, une nouvelle version peut modifier la base de données des résultats. Une version plus ancienne ne peut peut-être pas lire la base de données modifiée. Donc, la sauvegarde est le seul moyen de revenir à la version plus ancienne.
AVERTISSEMENT : Faites une sauvegarde du volume avant la mise à niveau. Si vous n'avez pas de sauvegarde, vous ne pouvez pas revenir à la version plus ancienne.
- Lisez le journal des modifications (changelog) de la nouvelle version.
- Arrêtez le conteneur :
docker stop luc-analytics
- Ouvrez PowerShell (sur un Mac, Terminal) dans le dossier où vous voulez garder la sauvegarde.
AVERTISSEMENT : Gardez le fichier de sauvegarde privé. Il contient la clé d'accès, le coffre chiffré des identifiants et la clé de ce coffre.
- Écrivez le fichier de sauvegarde dans ce dossier :
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 .
- Assurez-vous que le fichier
luc-analytics-data-backup.tgzest dans le dossier. - Faites à nouveau les étapes de "Contrôler le fichier image" avec le nouveau fichier image. Sur un Mac, faites les étapes de "Contrôler le fichier image sur un Mac".
- Faites à nouveau les étapes de "Charger l'image" dans la même fenêtre. Sur un Mac, faites les étapes de "Charger l'image sur un Mac".
- Supprimez l'ancien conteneur. Cette commande ne supprime pas le volume :
docker rm luc-analytics
- Créez un nouveau conteneur sur le même volume :
docker run -d --name luc-analytics -p 127.0.0.1:8000:8000 -v luc-analytics-data:/data luc-analytics
Le fichier de configuration après une mise à niveau¶
La mise à niveau ne modifie pas votre fichier /data/config.yaml. La nouvelle image ne copie pas son nouveau config.example.yaml dans le volume. Cela a ces conséquences :
-
Un réglage qui est dans votre fichier garde son ancienne valeur. Une nouvelle valeur par défaut de la nouvelle version ne la remplace pas.
-
Un réglage qui n'est pas dans votre fichier reçoit la valeur intégrée au programme. Cette valeur peut être différente de la valeur du nouveau
config.example.yaml.
Donc, une nouvelle valeur par défaut n'entre pas dans une installation que vous mettez à niveau. Pour utiliser une nouvelle valeur par défaut, modifiez le réglage dans /data/config.yaml et redémarrez le conteneur. Si le réglage a la marque [live] dans config.example.yaml, vous pouvez aussi le modifier sur la page Paramètres. Le journal des modifications vous informe des nouveaux réglages. Pour le fichier de configuration, consultez 06-settings.md.
Supprimer l'application et ses données¶
AVERTISSEMENT : Faites une sauvegarde avant de supprimer le volume (consultez "Mettre à niveau vers une nouvelle image", étapes 2 à 5). Quand vous supprimez le volume, vous supprimez toutes les listes, tous les résultats, les identifiants enregistrés, la clé d'accès et toutes les copies de jeux de données téléchargées. Vous ne pouvez pas les récupérer.
- Supprimez le conteneur. Les données restent dans le volume :
docker rm -f luc-analytics
- Supprimez le volume. Cette commande supprime toutes vos données :
docker volume rm luc-analytics-data
- Supprimez l'image. Cette commande supprime l'image avec tous ses noms :
docker image rm -f $(docker image inspect luc-analytics --format "{{.Id}}")
Pour supprimer Docker Desktop, allez dans Settings > Apps (Paramètres > Applications) dans Windows. Sur un Mac, utilisez la procédure de désinstallation de la documentation de Docker Desktop.
Réglages de la mémoire¶
Avec le moteur WSL 2, Docker peut utiliser une partie de la mémoire de votre ordinateur portable. Par défaut, cette partie est environ la moitié de la mémoire. Pour voir la mémoire que Docker peut utiliser, saisissez cette commande :
docker info --format "{{.MemTotal}}"
La sortie est en octets.
L'application n'utilise pas toute la mémoire. Elle laisse libres 3 GB ou 10% de la mémoire, la plus grande des deux valeurs. Le minimum recommandé pour l'application est 2 GB. Donc, Docker doit avoir 5 GB de mémoire ou plus. Nous vous recommandons de donner 5 GB à 6 GB à Docker sur un ordinateur portable avec 8 GB de mémoire.
Pour modifier la mémoire que Docker peut utiliser, faites ces étapes :
- Si le fichier
C:\Users\<your user name>\.wslconfign'existe pas, créez-le. - Ouvrez le fichier dans un éditeur de texte.
- Écrivez ces lignes dans le fichier :
[wsl2]
memory=6GB
- Enregistrez le fichier.
- Quittez Docker Desktop.
- Saisissez cette commande dans PowerShell :
wsl --shutdown
- Démarrez Docker Desktop.
Dans Docker Desktop, l'application ne trouve généralement pas la limite de mémoire. Dans ce cas, l'application vous demande la limite. Faites ces étapes :
- Dans l'application, allez dans Paramètres > Mémoire.
- Dans Limite de mémoire de l'hôte / VM (Go), saisissez la mémoire que Docker a.
REMARQUE : Fermez les autres grands programmes pendant que l'application fait une analyse. Ces programmes utilisent de la mémoire dont l'application a peut-être besoin.
Si l'application ne répond pas¶
- Pour voir les messages de l'application, saisissez cette commande :
docker logs luc-analytics
- Pour voir si le conteneur fonctionne, saisissez cette commande :
docker ps -a
- Si Docker Desktop n'affiche pas Engine running, faites ces étapes :
- Quittez Docker Desktop.
- Saisissez
wsl --shutdowndans PowerShell. - Démarrez Docker Desktop à nouveau.
Pour d'autres problèmes et leurs actions correctives, consultez 07-troubleshooting.md.