Instructions de préparation de votre poste

Pendant les séances des différents modules vous devrez peut-être utiliser votre propre machine. Nous ne souhaitons pas vous imposer un environnement de développement clef en main mais plutôt vous permettre d'installer et d'administrer vous-mêmes les logiciels nécessaires à l'exécution des différentes tâches que nous proposerons.

Les logiciels nécessaires dépendent du module suivi. Les formateurs vous transmettront les informations en amont du cours.

Si vous disposez déjà de tous ces outils sur votre machine, vous n'avez rien à faire !

Sauf si vous utilisez Windows, nous vous recommandons tout de même d'effectuer les mises à jour et d'installer WSL 2.

WindowsLinuxmacOs

Nous conseillons aux utilisateurs et utilisatrices de Windows d'installer WSL 2. Vous pouvez consulter ce document pour en savoir plus.

WSL 2

Pour utiliser WSL 2, vous devez avoir Windows 11 ou alors Windows 10 avec les versions suivantes :

Pour les systèmes x64 : version 1903 ou ultérieure, avec build 18362.1049 ou version ultérieure.
Pour les systèmes ARM64 : version 2004 ou ultérieure, avec build 19041 ou version ultérieure.

Sur Windows 10, pour vérifier numéro de version et de build, appuyez sur ⊞ Win+ `, tapez winver et sélectionnez OK.

Si votre numéro de version ou de build est inférieur à ceux indiqués ci-dessus, vous ne pourrez pas installer WSL 2 à moins de mettre à jour Windows dans le menu Paramètres.

Ouvrir PowerShell en tant qu'administrateur\ (Menu démarrer > PowerShell > clic droit > Run as administrator)

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Redémarrer votre ordinateur pour terminer l'installation et la mise à jour WSL vers WSL 2.

Ouvrir PowerShell en tant qu'administrateur et vérifier la version de WSL installée

(Menu démarrer > PowerShell > clic droit > Run as administrator)

wsl --version

Si cette commande échoue, téléchargez https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi et exécutez-le.

Toujours dans PowerShell, définir WSL 2 comme version par défaut

wsl --set-default-version 2

Télécharger la distribution Ubuntu 24.04

Récupérez le fichier https://wslstorestorage.blob.core.windows.net/wslblob/Ubuntu2404-240425.AppxBundle puis une fois la distribution téléchargée, accédez au dossier contenant le fichier téléchargé. Si vous l'avez téléchargé dans le dossier "Téléchargement" par défaut, vous pouvez utiliser la commande suivante :

cd "$([Environment]::GetFolderPath('UserProfile'))\Downloads"

Sinon naviguez jusqu'au dossier en question :

cd C:\Users\Vous\NomDuDossier

Une fois dans ce dossier, exécutez la commande suivante :

Add-AppxPackage .\Ubuntu2404-240425.AppxBundle

Lancez Ubuntu 24.04 LTS Vous serez amené à créer un compte d'utilisateur et un mot de passe pour votre nouvelle distribution Linux.

Si vous rencontrez une erreur :

vérifier si l'erreur est présente sur la page https://learn.microsoft.com/fr-fr/windows/wsl/troubleshooting#installation-issues et si une résolution est proposée, merci de nous en faire part !

Git

Les instructions sont données sur la page https://git-scm.com/downloads/win.

SSH

Si vous utilisez WSL ou si vous êtes sur Windows 11, ssh est disponible par défaut.

Sinon, pour Windows 10 :

- Paramètres > Applications > Fonctionnalités facultatives
- Ajouter une fonctionnalité > OpenSSH Client
- cliquer sur Installer

Vérification : en ligne de commande

ssh -V
...

Docker

Si vous n'avez pas Docker installé sur votre machine, télécharger et installer Docker Desktop : https://www.docker.com/products/docker-desktop/.

Si vous avez déjà Docker installé sur votre machine, veuillez effectuer les vérifications suivantes :

Vérifier que Docker Desktop utilise bien WSL 2 comme backend
- Ouvrir Docker Desktop
- Aller dans Settings (roue dentée) > General
- S'assurer que l'option Use the WSL 2 based engine est cochée
Vérifier s'il est possible de faire une mise à jour via l'interface Docker Desktop.
Vérifier que l'intégration WSL 2 est activée pour Ubuntu :
- Dans Settings (roue dentée) > Resources > WSL Integration, s'assurer que :
  - Enable integration with my default WSL distro est coché
  - Ubuntu est activé dans la liste des distributions

S'il ne vous semble pas possible de cocher Use the WSL 2 based engine même après avoir mis à jour Docker Desktop, il est suggéré de réinstaller Docker Desktop.

Apptainer

Sous WSL

$ sudo apt update
$ sudo apt install -y software-properties-common
$ sudo apt install -y wget
$ cd /tmp
$ wget https://github.com/apptainer/apptainer/releases/download/v1.4.1/apptainer_1.4.1_amd64.deb
$ sudo apt install -y ./apptainer_1.4.1_amd64.deb

Avant d'installer de nouveaux paquets pour les distributions Debian-like, il est conseillé de mettre à jour la liste des paquets connus par votre système :

sudo apt update

Git

Les instructions pour la plupart des distributions sont données sur la page https://git-scm.com/downloads/linux.

Par exemple, pour une distribution Debian-like :

sudo apt install git

SSH

Rien à faire, disponible par défaut.

Docker

Suivre cette documentation : https://docs.docker.com/engine/install/.

Par exemple, pour Ubuntu :

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Apptainer

Sous Ubuntu

sudo apt update
sudo apt install -y software-properties-common

Sous Debian

sudo apt update
sudo apt install -y wget
cd /tmp
wget https://github.com/apptainer/apptainer/releases/download/v1.4.1/apptainer_1.4.1_amd64.deb
sudo apt install -y ./apptainer_1.4.1_amd64.deb

Vous devrez utiliser le gestionnaire de paquet Homebrew.

Homebrew

Dans le Finder, ouvrez le dossier /Applications/Utilitaires, puis cliquez deux fois sur Terminal.\ Saisir la commande suivante :

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Git

Les instructions sont données sur la page https://git-scm.com/downloads/mac.

Par exemple, avec Homebrew :

brew install git

SSH

Rien à faire, disponible par défaut.

Docker

Quatre alternatives :

colima (à préférer, ce sera utile pour Apptainer) :

brew install docker
brew install colima
brew install lima-additional-guestagents

colima start --arch x86_64

Ensuite les commandes docker devraient fonctionner :

$ docker run busybox date
Unable to find image 'busybox:latest' locally
latest: Pulling from library/busybox
189fdd150837: Pull complete 
Digest: sha256:f85340bf132ae937d2c2a763b8335c9bab35d6e8293f70f606b9c6178d84f42b
Status: Downloaded newer image for busybox:latest
Fri Jun 20 07:18:48 UTC 2025

https://www.docker.com/products/docker-desktop/ (version officielle)
https://orbstack.dev/download (plus léger mais non standard)

Apptainer

Si vous avez installé colima :

limactl start --arch x86_64 template://apptainer

limactl shell apptainer

```

Merci aux organisateurs de l'école thématique SO-SHS qui ont rédigé et partagé la documentation dont nous nous sommes fortement inspiré pour cette page.