Skip to content
if/Wiki

Configurer l'environnement Windows + WSL

Pré-requis: WSL

Allez dans les paramètres BIOS/UEFI de votre ordinateur. Activez la “Hardware virtualisation support”: “Hyper-V”, “Intel VT-x/EPT” ou “AMD-V/RVI”.

Si celle-ci n’est pas activée, vous aurez ce message d’erreur: “Installation failed with error 0x80070003 or error 0x80370102”.

Saisissez la commande suivante dans l’invite de commandes ou PowerShell:

Terminal window
wsl --install

Redémarrez votre ordinateur.

Lancez Ubuntu à partir de l’écran des applications dans le menu Démarrer.

Lors de la première utilisation, pensez à vous créer un utilisateur UNIX avec un mot de passe.

Installations sur WSL

Mise à jour des miroirs

Saisissez la commande suivante sur Ubuntu:

Terminal window
sudo apt update

PHP

Dans Ubuntu, lancez la commande suivante pour installer PHP et les extensions nécessaires:

Terminal window
sudo apt install -y net-tools && sudo apt install -y php php-ctype php-curl php-xml php-mbstring php-tokenizer php-mysql php-zip php-intl

Composer

Dans Ubuntu, lancez la commande suivante pour installer Composer:

Terminal window
sudo apt install -y php-cli unzip curl && curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer

make

Pour installer make, vous pouvez exécuter la commande suivante:

Terminal window
sudo apt install -y make

Installations sur Windows

Docker

Rendez-vous sur Docker Desktop pour Windows et téléchargez l’installateur pour votre architecture.

Une fois Docker Desktop installé, redémarrez l’ordinateur, puis connectez-vous ou créez un compte.

Allez dans les Paramètres (Settings).

Dans l’onglet Resources, sélectionnez WSL Integration.

Activez l’intégration avec Ubuntu.

Il faut ensuite fermer complètement Docker Desktop pour que les modifications prennent effet. Une fois la fenêtre fermée, Docker reste ouvert en mode économie d’énergie. Cliquez sur la flèche dans la barre des tâches (à droite) pour le fermer complètement.

VSCode

Installez Visual Studio Code depuis le site Internet officiel.

Dans la fenêtre de setup cochez la case pour ajouter VS Code à PATH.

Dans Ubuntu, lancez la commande suivante:

Terminal window
code .

Une fois dans VSCode, accédez à l’onglet des extensions (ou appuyez sur Ctrl + Shift + X).

Recherchez “Docker” et installez l’extension officielle.

Clonage du repository GitHub

Générer la Clé SSH

Si vous n’avez pas encore de clé SSH, vous pouvez en générer une en ouvrant le terminal et en exécutant la commande suivante (remplacez votre_email@example.com par votre email de GitHub):

Terminal window
ssh-keygen -t rsa -b 4096 -C "votre_email@example.com"

Appuyez sur Entrée pour accepter l’emplacement par défaut et suivez les instructions pour créer la clé.

Pour copier la clé publique, utilisez la commande suivante:

Terminal window
cat ~/.ssh/id_rsa.pub

Copiez la sortie affichée dans le terminal.

Ajouter la Nouvelle Clé SSH

Sur GitHub, cliquez sur votre photo de profil et sélectionnez Settings (Paramètres).

Dans le menu de gauche, cliquez sur SSH and GPG keys.

Cliquez sur le bouton New SSH key (Nouvelle clé SSH).

Donnez lui un nom, et dans le champ Key (Clé), collez la clé publique que vous avez copiée précédemment.

Cliquez sur Add SSH key (Ajouter une clé SSH).

Vérifier la Connexion

Pour vérifier que votre clé SSH fonctionne correctement, vous pouvez exécuter la commande suivante dans Ubuntu:

Terminal window
ssh -T git@github.com

Si tout est configuré correctement, vous devriez voir un message vous souhaitant la bienvenue.

Finaliser l’installation de l’environnement de travail

Vérifiez les dépendances:

Terminal window
php -v
composer -v
docker -v
make -v

Vérifiez que le Docker Engine est lancé (engine running).

Allez dans votre répertoire de projets (si vous n’en avez pas, créez en un) puis exécutez la commande suivante:

Terminal window
git clone git@github.com:itFlow-io/if-test.git && cd if-test && make dev

Cela va ouvrir le dossier du projet.

Vous pouvez rencontrer des erreurs si:

  • Vous n’êtes pas autorisé à accéder au répertoire, auquel cas veuillez contacter l’équipe de développement.
  • Le cd if-test ne fonctionne pas. Dans ce cas essayez de lancer les commandes séparément:
Terminal window
git clone git@github.com:itFlow-io/if-test.git
cd if-test
make dev