windows.fr.md
Les instructions ci-dessous vont te permettre de configurer ton ordinateur pour la formation AI Software Development du Wagon.
Lis-les attentivement et exécute toutes les commandes dans l’ordre suivant. En cas de blocage, n’hésite pas à demander au prof :raising_hand:
C’est parti :rocket:
Est-ce que tu as déjà un compte GitHub ? Si ce n’est pas le cas, inscris-toi maintenant.
:point_right: Télécharge une photo et indique correctement ton nom sur ton compte GitHub. C’est important, car notre tableau de bord interne utilise ton avatar. Fais-le maintenant avant de poursuivre la configuration de ton ordinateur.
:point_right: Activez l'authentification à deux facteurs (2FA). GitHub vous enverra des messages texte avec un code lorsque vous essayez de vous connecter. C'est important pour la sécurité et cela sera bientôt obligatoire pour contribuer du code sur GitHub.
Avant de commencer, on va vérifier que la version de Windows installée sur ton ordinateur est compatible avec ces instructions de configuration.
:warning: Note sur Windows 10 et la sécurité
La configuration du bootcamp Le Wagon fonctionne sur Windows 10. Cela dit, on recommande fortement de passer à Windows 11. Depuis le 14 octobre 2025, Microsoft a mis fin au support de Windows 10 : il ne reçoit plus de mises à jour de sécurité, ce qui peut exposer ta machine. Pour plus de détails, consulte le guide de Microsoft. Si ton ordinateur ne peut pas exécuter Windows 11, envisage de passer à Ubuntu.
Pour pouvoir configurer ton ordinateur, Windows 10 ou Windows 11 doit être installé dessus.
Pour connaître ta version de Windows :
Windows + RwinverEnter:heavy_check_mark: Si les premiers mots qui apparaissent dans cette fenêtre sont Windows 11, c’est bon :+1:
Si les premiers mots qui apparaissent dans cette fenêtre sont Windows 10, vérifie le numéro de version:
:heavy_check_mark: Si la version indique au moins 2004, c’est bon :+1:
:x: Sinon, il faut que tu mettes à jour ton Windows.
Ouvre Windows Update :
Windows + Rms-settings:windowsupdateEnter:heavy_check_mark: Si tu vois apparaître une coche verte et le message « Vous êtes à jour », c’est bon :+1:
:warning: Si tu vois apparaître un point d’exclamation rouge et le message « Mise à jour disponible », installe-la et recommence jusqu’à ce que le message « Vous êtes à jour » apparaisse :loop:
:x: Si tu vois apparaître un message d’erreur indiquant que Windows ne peut pas appliquer les mises à jour, demande au prof.
<details> <summary>Activer le service Windows Update pour corriger les mises à jour</summary>Certains antivirus et logiciels désactivent le service de mise à jour dont on a besoin, entraînant l’erreur que tu vois apparaître. On va corriger ça !
Windows + Rservices.mscEnterWindows Update ServiceStartup sur AutomaticStartOk
On va maintenant réessayer d’effectuer les mises à jour.Vérifie le numéro de version :
Windows + RwinverEnter:heavy_check_mark: Si la version indique au moins 1903, c’est bon :+1:
:x: S’il s’agit d’une version antérieure, demande au prof.
</details>On doit vérifier que les options de virtualisation sont activées dans le BIOS de ton ordinateur.
C’est déjà le cas sur de nombreux ordinateurs. Vérifions-le :
Windows + RtaskmgrEnterPerformanceCPU:heavy_check_mark: Si tu vois « Virtualisation : activée », c’est bon :+1:
:x: Si la ligne est manquante ou si la virtualisation est désactivée, demande au prof avant d’essayer d’activer la virtualisation
<details> <summary>Activer la virtualisation</summary>On a besoin d’accéder au BIOS / à l’UEFI de l’ordinateur pour activer la virtualisation.
Windows + Rshutdown.exe /r /o /t 1EnterTroubleshootAdvanced OptionsUEFI Firmware SettingsRestartTu dois activer l’option de virtualisation de ton processeur ici :
Intel VT-x, Intel Virtualization Technology, Virtualization Extensions, Vanderpool...SVM Mode ou AMD-VWSL est l’environnement de développement que l’on utilise pour exécuter Ubuntu. Pour en savoir plus sur WSL, consulte cette page.
Nous allons installer WSL 2 et Ubuntu en une seule commande via le Windows Command Prompt.
:warning: Dans les instructions suivantes, utilise la combinaison de touches Ctrl + Shift + Enter pour exécuter Windows Command Prompt en tant qu’administrateur au lieu de cliquer simplement sur Ok ou d’appuyer sur Enter.
Windows + RcmdCtrl + Shift + Enter:warning: Tu devras peut-être accepter la confirmation UAC concernant l’octroi des droits d’administrateur.
Une fenêtre de terminal apparaîtra :
Ctrl + C)Ctrl + V ou en faisant un clic droit dans la fenêtre)Enterwsl --install
:heavy_check_mark: Si la commande s’exécute sans erreur, redémarre ton ordinateur et suis les instructions ci-dessous :+1:
:x: Si tu obtiens un message d’erreur (ou si tu vois apparaître du texte en rouge dans la fenêtre), demande au prof.
<details> <summary>Dépannage pour Windows 10 (uniquement si nécessaire, vérifie avec un professeur)</summary>:warning: Dans les instructions suivantes, utilise la combinaison de touches Ctrl + Shift + Enter pour exécuter Windows PowerShell en tant qu’administrateur au lieu de cliquer simplement sur Ok ou d’appuyer sur Enter.
Windows + RpowershellCtrl + Shift + Enter:warning: Tu devras peut-être accepter la confirmation UAC concernant l’octroi des droits d’administrateur.
Une fenêtre de terminal bleue apparaîtra :
Ctrl + C)Ctrl + V ou en faisant un clic droit dans la fenêtre)EnterEnable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
:heavy_check_mark: Si les trois commandes s’exécutent sans erreur, redémarre ton ordinateur et suis les instructions ci-dessous :+1:
:x: Si tu obtiens un message d’erreur (ou si tu vois apparaître du texte en rouge dans la fenêtre), demande au prof
Si tu as Windows 10, on va maintenant mettre à jour WSL à la version 2.
Une fois que ton ordinateur a redémarré, on doit télécharger le programme d’installation de WSL 2.
SuivantTerminer:heavy_check_mark: Si tu ne rencontres aucun message d’erreur, c’est bon :+1:
:x: Si tu obtiens l’erreur « Cette mise à jour s’applique seulement aux machines avec le sous-système Windows pour Linux », fais un clic droit sur le programme et sélectionne uninstall ; tu devrais pouvoir l’installer normalement cette fois-ci.
Si tu as Windows 10, on va enfin définir la version 2 de WSL comme étant la version par défaut.
Maintenant que WLS 2 est installé, on va le définir comme version par défaut :
Windows + RcmdEnterDans la fenêtre qui apparaît, saisis :
wsl --set-default-version 2
:heavy_check_mark: Si tu vois apparaître « The operation completed successfully », tu peux fermer ce terminal et suivre les instructions ci-dessous :+1:
:x: Si le message qui s’affiche concerne la virtualisation, demande au prof
<details> <summary>Activer la fonction Virtual Machine Platform sous Windows</summary>Suis les étapes décrites ici pour activer <strong>Virtual Machine Platform</strong> et <strong>le sous-système Windows pour Linux</strong>
</details> <details> <summary>Activer la fonction Hyper-V sous Windows</summary>Suis les étapes décrites ici pour activer le groupe <strong>Hyper-V</strong>
:information_source: Si tu as Windows 10 Home edition, la fonction Hyper-V n'est pas disponible sur ton système d'exploitation. Ce n'est pas bloquant et tu peux continuer à suivre les instructions ci-dessous :ok_hand:
</details> </details>Si tu as Windows 11, après avoir redémarré ton ordinateur, tu devrais voir une fenêtre de terminal indiquant que WSL poursuit le processus d'installation d'Ubuntu. Lorsque c'est terminé, Ubuntu va se lancer.
<details> <summary>Résolution des problèmes pour Windows 10 (uniquement si nécessaire, vérifie avec un TA)</summary>Si l'installation d'Ubuntu ne reprend pas, essaye d'abord à nouveau : relance Powershell ou l'Invite de commandes et exécute la commande wsl --install une nouvelle fois.
Si tu as Windows 10, installons Ubuntu via le Microsoft Store :
StartMicrosoft StoreMicrosoft Store dans la listeUbuntu dans la barre de rechercheInstaller:warning: N’installe pas Ubuntu 18.04 LTS ni Ubuntu 20.04 !
<details> <summary>Désinstaller les mauvaises versions d’Ubuntu</summary>Pour désinstaller une mauvaise version d’Ubuntu, il te suffit d’aller dans la liste des programmes installés de Windows 10 :
Windows + Rms-settings:appsfeaturesEnterTrouve le logiciel à désinstaller et clique sur le bouton de désinstallation.
</details>Une fois l’installation terminée, le bouton « Installer » se transforme en bouton « Lancer » ; clique dessus.
</details>Au premier lancement, on te demandera de fournir des informations :
lewagon ou ton prenom:warning: Lorsque tu saisiras ton mot de passe, rien ne s’affichera à l’écran ; c’est normal. Il s’agit d’une mesure de sécurité permettant de masquer ton mot de passe et sa longueur. Saisis simplement ton mot de passe, puis appuie sur Enter.
Tu peux fermer la fenêtre Ubuntu maintenant qu’elle est installée sur ton ordinateur.
Windows + RcmdEnterSaisis la commande suivante :
wsl -l -v
:heavy_check_mark: Si la version de WSL sous Ubuntu est la 2, c’est bon. :+1:
:x: Si la version de WSL sous Ubuntu est la 1, il va falloir passer à la version 2.
<details> <summary>Passer de la version 1 à la version 2 de WSL sous Ubuntu</summary>Dans la fenêtre d’invite de commande, saisis :
wsl --set-version Ubuntu 2
:heavy_check_mark: Au bout de quelques secondes, tu devrais voir apparaître le message suivant : The conversion is complete.
:x: Si ce n’est pas le cas, il faut vérifier que les fichiers Ubuntu ne sont pas compressés.
<details> <summary>Vérifier que les fichiers sont décompressés</summary>Windows + R%localappdata%\PackagesEnterCanonicalGroupLimited.UbuntuonWindows...LocalStatePropertiesAdvancedCompresser le contenu n’est pas cochée, puis clique sur Ok.Applique les modifications à ce dossier uniquement et réessaie de convertir la version de WSL sous Ubuntu.
:x: Si la conversion ne fonctionne pas, demande au prof.
</details>Tu peux maintenant fermer cette fenêtre de terminal.
</details>Tape cette commande dans le terminal Ubuntu :
whoami
Cela devrait renvoyer le nom d'utilisateur que tu as choisi précédemment.
:x: Si cela affiche root, contacte un TA avant de continuer !
On va maintenant installer l’éditeur de texte Visual Studio Code.
Une fois l’installation terminée, lance VS Code.
Tu devrais voir un cadre dans le coin inférieur droit de VS Code indiquant qu’il détecte WSL. Accepte l’installation de l’extension de WSL pour VS Code.
:warning: Cette extension est obligatoire pour utiliser VS Code !
code --install-extension ms-vscode-remote.remote-wsl
Then open VS Code from your terminal:
code .
:heavy_check_mark: Si tu vois WSL: Ubuntu dans le coin inférieur gauche de la fenêtre VS Code, c'est tout bon :+1:
:x: Sinon, demande au prof
:information_source: Les instructions suivantes dépendent de ta version de Windows.
Si tu as Windows 11, le Windows Terminal est déjà installé et tu peux passer à la section suivante :point_down:
Si tu as Windows 10, nous allons installer le Windows Terminal, un terminal vraiment moderne.
<details> <summary><strong>Windows 10</strong>: Installer le Windows Terminal</summary>DémarrerMicrosoft StoreMicrosoft Store dans la listeWindows Terminal dans la barre de rechercheInstaller:warning: N’installe PAS Windows Terminal Preview, uniquement Windows Terminal !
<details> <summary>Désinstaller la mauvaise version de Windows Terminal</summary>Pour désinstaller une mauvaise version de Windows Terminal, il te suffit d’aller dans la liste des programmes installés de Windows 10 :
Windows + Rms-settings:appsfeaturesEnterTrouve le logiciel à désinstaller et clique sur le bouton de désinstallation.
</details>Une fois l’installation terminée, le bouton « Installer » se transforme en bouton « Lancer » ; clique dessus.
</details>On va définir Ubuntu comme terminal par défaut de ton application Windows Terminal.
Appuie sur Ctrl + ,
pour ouvrir les paramètres du terminal :
La partie à modifier est entourée en rouge :
Fichier de paramètres JSON de Windows Terminal
On va commencer par demander à Ubuntu de démarrer directement dans ton répertoire personnel Ubuntu au lieu du répertoire Windows :
"name": "Ubuntu","commandline": "wsl.exe ~",
:warning: N’oublie pas la virgule à la fin de la ligne !
On va ensuite désactiver les avertissements pour les commandes de copier-coller entre Windows et Ubuntu :
"defaultProfile": "{2c4de342-...}""warning.multiLinePaste": false,
:warning: N’oublie pas la virgule à la fin de la ligne !
Tu peux enregistrer ces modifications en appuyant sur Ctrl + S
:heavy_check_mark: Ton Windows Terminal est maintenant configuré :+1:
Ce terminal a des onglets ; tu peux choisir d’ouvrir un nouvel onglet de terminal en cliquant sur + à côté de l’onglet actuel.
Désormais, chaque fois que l'on fera référence au terminal ou à la console, il s’agira de celui-ci. N’utilise PLUS aucun autre terminal.
On va maintenant installer quelques extensions utiles à VS Code.
Copie-colle les commandes suivantes dans le terminal :
code --install-extension ms-vscode.sublime-keybindings
code --install-extension emmanuelbeziat.vscode-great-icons
code --install-extension MS-vsliveshare.vsliveshare
code --install-extension shopify.ruby-lsp
code --install-extension dbaeumer.vscode-eslint
code --install-extension Rubymaniac.vscode-paste-and-indent
code --install-extension alexcvzz.vscode-sqlite
code --install-extension anteprimorac.html-end-tag-labels
code --install-extension marcoroth.herb-lsp
code --install-extension rayhanw.erb-helpers
Voici la liste des extensions que tu es en train d'installer :
VS Code inclut de nombreuses fonctionnalités d'IA puissantes, qui sont un excellent outil une fois que vous savez déjà coder.
Cela dit, s'appuyer sur l'IA trop tôt peut masquer des concepts importants et rendre le débogage plus difficile à comprendre. Une fois à l'aise avec les fondamentaux, vous saurez quand et comment utiliser l'IA efficacement — sans lui laisser faire la réflexion à votre place.
Pour le début du bootcamp, nous allons désactiver ces fonctionnalités. Au bon moment du cours, nous les réactiverons afin que vous puissiez les utiliser à bon escient.
Dans VS Code :
Ctrl-Shift-P (Windows / Linux) ou Cmd-Shift-P (macOS).aifeatures jusqu'à voir "Chat: Learn How to Hide AI features". Cliquez dessus.
Plus tard, si vous souhaitez réactiver les fonctionnalités d'IA, vous pouvez suivre les mêmes instructions pour décocher la case.
Visual Studio Live Share est une extension de VS Code, qui te permet de partager du code dans ton éditeur de texte pour débugger et faire de la programmation en binôme. Configurons-le !
Lance VS Code depuis ton terminal en saisissant code et en appuyant sur Enter.
Clique sur la petite flèche en bas de la barre de gauche :point_down:
C’est bon !
Le concept de "locale" permet de personnaliser les programms en fonction de ta langue et ton pays.
Vérifions que la locale est bien en anglais dans le terminal :
locale
Si la commande ne renvoie pas quelque chose qui contient LANG=en_US.UTF-8, lance ceci dans un terminal Ubuntu :
sudo locale-gen en_US.UTF-8
Si après, tu reçois un avertissement (bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)) dans ton terminal, veuillez faire ce qui suit :
Veuillez exécuter ces lignes dans ton terminal.
sudo update-locale LANG=en_US.UTF8
sudo apt-get update
sudo apt-get install language-pack-en language-pack-en-base manpages
Au lieu d’utiliser le shell bash par défaut, nous utiliserons zsh.
Nous utiliserons aussi git, un logiciel en ligne de commande utilisé pour la gestion de versions.
Installons-les, avec d'autres outils utiles :
sudo apt update
sudo apt install -y curl git imagemagick jq unzip vim zsh
Ces commandes te demanderont ton mot de passe ; saisis-le.
:warning: Lorsque tu saisiras ton mot de passe, rien ne s’affichera à l’écran ; c’est normal. Il s’agit d’une mesure de sécurité permettant de masquer ton mot de passe et sa longueur. Saisis simplement ton mot de passe, puis appuie sur Enter.
On va maintenant installer la CLI officielle de GitHub (Command Line Interface, interface en ligne de commande). Il s’agit d’un logiciel qui te permet d’interagir avec ton compte GitHub via la ligne de commande.
Copie-colle les commandes suivantes dans ton terminal et saisis ton mot de passe s’il t’est demandé :
sudo apt remove -y gitsome # gh command can conflict with gitsome if already installed
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install -y gh
Pour vérifier que gh a bien été installé sur ta machine, tu peux exécuter :
gh --version
:heavy_check_mark: Si tu vois apparaître gh version X.Y.Z (YYYY-MM-DD), c’est bon :+1:
:x: Sinon, demande au la prof.
On va maintenant installer le plug-in zsh Oh My Zsh.
Exécute la commande suivante dans un terminal :
sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
Si tu vois apparaître la question « Do you want to change your default shell to zsh? ? », appuie sur Y
À la fin, ton terminal devrait ressembler à ceci :
:heavy_check_mark: Si c’est le cas, tu peux continuer :+1:
:x: Sinon, demande au prof
Pour que tu puisses interagir avec le navigateur installé sous Windows depuis ton terminal Ubuntu, on doit le définir comme navigateur par défaut.
:warning: Tu dois exécuter au moins une des commandes ci-dessous :
<details> <summary>Google Chrome est ton navigateur par défaut</summary>Exécute la commandes :
ls /mnt/c/Program\ Files\ \(x86\)/Google/Chrome/Application/chrome.exe
Si tu obtiens une erreur du type ls: cannot access..., exécute la commande suivante :
echo "export BROWSER=\"/mnt/c/Program Files/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc
echo "export GH_BROWSER=\"'/mnt/c/Program Files/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc
Sinon, exécute :
echo "export BROWSER=\"/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc
echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc
Exécute la commandes :
ls /mnt/c/Program\ Files\ \(x86\)/Mozilla\ Firefox/firefox.exe
Si tu obtiens une erreur du type ls: cannot access..., exécute la commande suivante :
echo "export BROWSER=\"/mnt/c/Program Files/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc
echo "export GH_BROWSER=\"'/mnt/c/Program Files/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc
Sinon, exécute :
echo "export BROWSER=\"/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc
echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc
Exécute la commandes :
echo "export BROWSER=\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"" >> ~/.zshrc
echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc
Redémarre ton terminal.
Puis vérifie que la commande suivante renvoie « Browser defined 👌 » :
[ -z "$BROWSER" ] && echo "ERROR: please define a BROWSER environment variable ⚠️" || echo "Browser defined 👌"
Si ce n’est pas le cas,
:heavy_check_mark: Si tu vois apparaître ce message, tu peux continuer :+1:
:x: Sinon, choisis un navigateur dans la liste ci-dessus et exécute la commande correspondante. Puis n’oublie pas de réinitialiser ton terminal :
exec zsh
N’hésite pas à demander au prof.
CLI est l’acronyme de Command-line Interface, interface en ligne de commande.
Dans cette section, tu vas installer GitHub CLI pour interagir avec GitHub directement depuis le terminal.
Nous allons utiliser GitHub CLI (gh) pour nous connecter à GitHub en utilisant SSH, un protocole pour s'authentifier en utilisant des clés SSH au lieu de la fameuse paire nom d'utilisateur et mot de passe.
Elle doit déjà être installée sur ton ordinateur grâce aux commandes précédentes.
Pour te connecter, commence par copier-coller la commande suivante dans ton terminal :
:warning: NE modifie PAS email
gh auth login -s 'user:email' -w --git-protocol ssh
gh va te poser quelques questions :
Generate a new SSH key to add to your GitHub account? Appuie sur Enter pour demander à gh de générer les clés SSH pour toi.
Si tu as déjà des clés SSH, tu verras à la place Upload your SSH public key to your GitHub account? Avec les flèches, sélectionne le chemain de ta clé publique et appuie sur Enter.
Enter a passphrase for your new SSH key (Optional). Saisis un mot de passe dont tu te souviendras. Ce mot de passe sert à protéger ta clé privée enregistrée sur ton disque sur. Ensuite, appuie sur Enter.
Title for your SSH key. Tu peux laisser ce qui est proposé par défaut, à savoir "GitHub CLI", appuie sur Enter.
Tu obtiendras le résultat suivant :
! First copy your one-time code: 0EF9-D015
- Press Enter to open github.com in your browser...
Sélectionne et copie le code (0EF9-D015 dans l’exemple), puis appuie sur Enter.
Ton navigateur s’ouvrira et te demandera d’autoriser GitHub CLI à utiliser ton compte GitHub. Accepte et patiente un instant.
Reviens au terminal, appuie à nouveau sur Enter et voilà.
Pour vérifier que tu es bien connecté, saisis :
gh auth status
:heavy_check_mark: Si tu vois apparaître Logged in to github.com as <YOUR USERNAME>, alors c’est bon :+1:
:x: Sinon, demande au prof.
Les hackers adorent perfectionner leur shell et leurs outils.
On va commencer avec une super configuration par défaut fournie par Le Wagon : lewagon/dotfiles.
Ta configuration est personnelle ; tu as donc besoin de ton propre dépôt de code (repository) pour la sauvegarder. Tu vas donc faire un fork, c’est-à-dire une copie, du dépôt Le Wagon.
Faire un fork consiste à créer un nouveau dépôt dans ton compte GitHub personnel $GITHUB_USERNAME/dotfiles, identique au dépôt Le Wagon d’origine et que tu pourras modifier librement.
Ouvre ton terminal et exécute les commandes suivantes :
export GITHUB_USERNAME=`gh api user | jq -r '.login'`
echo $GITHUB_USERNAME
:heavy_check_mark: Tu devrais voir apparaître ton nom d’utilisateur GitHub.
:x: Si ce n’est pas le cas, arrête-toi ici et demande de l’aide. Il se peut que tu aies rencontré un problème à l’étape précédente (gh auth).
Il est temps de faire un fork du dépôt et de le cloner sur ton ordinateur :
mkdir -p ~/code/$GITHUB_USERNAME && cd $_
gh repo fork lewagon/dotfiles --clone
Exécute le programme d’installation dotfiles :
cd ~/code/$GITHUB_USERNAME/dotfiles
zsh install.sh
Vérifie les adresses e-mail associées à ton compte GitHub. Tu devras en choisir une à l’étape suivante :
gh api user/emails | jq -r '.[].email'
:heavy_check_mark: Si tu vois la liste de tes adresses e-mail enregistrées, tu peux continuer :+1:
:x: Sinon, reconnecte-toi à GitHub avant d'exécuter cette commande à nouveau :point_up:.
Exécute le programme d’installation de git :
cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh
:point_up: On te demandera de fournir ton nom (FirstName LastName) et ton adresse e-mail.
:warning: Tu dois saisir l’une des adresses e-mail indiquées ci-dessus avec la commande gh api ... précédente. Sinon, Kitt ne pourra pas suivre tes progrès. 💡 Sélectionnez l'adresse @users.noreply.github.com si vous ne souhaitez pas que votre adresse e-mail apparaisse dans les dépôts publics auxquels vous pourriez contribuer.
Réinitialise ton terminal en exécutant :
exec zsh
Tu veux éviter d’avoir à fournir ta phrase secrète chaque fois que tu communiques avec un dépôt de code distant. Pour cela, tu as besoin d’ajouter le plug-in ssh-agent à oh my zsh :
Commence par ouvrir le fichier .zshrc :
code ~/.zshrc
Puis :
plugins=ssh-agent à la fin de la liste des plug-insLa liste doit ressembler à ça :
plugins=(gitfast last-working-dir common-aliases zsh-syntax-highlighting history-substring-search pyenv ssh-agent)
:heavy_check_mark: Enregistre le fichier .zshrc à l’aide des touches Ctrl + S et ferme ton éditeur de texte.
On va maintenant installer rbenv, un logiciel qui permet d’installer et de gérer des environnements ruby.
Pour commencer, tu dois nettoyer toute installation antérieure éventuelle de Ruby :
rvm implode && sudo rm -rf ~/.rvm
# If you got "zsh: command not found: rvm", carry on.
# It means `rvm` is not on your computer, that's what we want!
rm -rf ~/.rbenv
Puis dans le terminal, exécute :
sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
exec zsh
Tu peux maintenant installer la dernière version de ruby et en faire la version par défaut.
Exécute cette commande ; cela peut prendre un moment (5-10 minutes)
rbenv install 3.3.5
Une fois que l’installation de Ruby est terminée, exécute cette commande pour indiquer au système d’utiliser la version 3.3.5 par défaut.
rbenv global 3.3.5
Réinitialise ton ton terminal et vérifie ta version de Ruby :
exec zsh
Puis exécute :
ruby -v
:heavy_check_mark: Si tu vois apparaître un message commençant par ruby 3.3.5, tu peux continuer :+1:
:x: Sinon, demande au prof
:warning: Si tu es en Chine, mets à jour la procédure d’installation des gems avec les commandes suivantes.
# En Chine seulement !
gem sources --remove https://rubygems.org/
gem sources -a https://gems.ruby-china.com/
gem sources -l
# *** SOURCES ACTUELLES ***
# https://gems.ruby-china.com/
# Ruby-china.com doit maintenant figurer dans la liste
Que tu sois en Chine ou non, continue ici pour installer les gems.
Dans l’environnement ruby, les bibliothèques externes sont appelées des gems : ce sont des bouts de code ruby, que tu peux télécharger et exécuter sur ton ordinateur. On va en installer quelques-unes.
Tout d'abord, nous allons mettre à jour bundler, ce qui nous permet d'installer des gemmes :
gem update bundler
Copie-colle la commande suivante dans ton terminal :
gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp
:heavy_check_mark: Si tu vois apparaître xx gems installed, c’est bon :+1:
:x: Si tu obtiens l’erreur suivante :
ERROR: While executing gem ... (TypeError)
incompatible marshal file format (can't be read)
format version 4.8 required; 60.33 given
Exécute la commande suivante :
rm -rf ~/.gemrc
Exécute à nouveau la commande pour installer les gems.
:warning: N’installe JAMAIS une gem avec sudo gem install ! Et ce même si tu tombes sur une réponse de Stack Overflow (ou du terminal) t’invitant à le faire.
Node.js est un programme d’exécution JavaScript qui permet d’exécuter du code JavaScript dans le terminal. On va l’installer avec nvm, un gestionnaire de versions pour Node.js.
Exécute les commandes suivantes dans ton terminal :
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh
exec zsh
Puis exécute la commande suivante :
nvm -v
Tu devrais voir apparaître une version. Sinon, demande au prof.
On va maintenant installer node :
nvm install 20.17.0
Une fois l’installation terminée, exécute :
node -v
Si tu vois apparaître v20.17.0, l'installation a réussi :heavy_check_mark: Tu peux alors exécuter :
nvm cache clear
:x: Sinon, demande au prof
yarn est un gestionnaire de paquets, qui permet d’installer des bibliothèques JavaScript. Installons-le :
Exécute les commandes suivantes dans le terminal :
corepack enable
yarn set version stable
exec zsh
⚠️ Si tu rencontres des messages d'erreur, essaye d'exécuter npm install -g corepack puis exécute à nouveau les commandes ci-dessus.
Puis exécute la commande suivante :
yarn -v
:heavy_check_mark: Si tu vois apparaître une version, c’est bon :+1:
:x: Sinon, demande au prof
Dans quelques semaines, on abordera les bases de données et le SQL. SQLite est un système de gestion de base de données utilisé pour exécuter des requêtes SQL sur des bases de données d'un seul fichier. Installons-le :
Dans un terminal, exécute la commande suivante :
sudo apt-get install sqlite3 libsqlite3-dev pkg-config
Puis exécute celle-ci :
sqlite3 -version
:heavy_check_mark: Si tu vois une version s'afficher, c'est tout bon :+1:
:x: If not, demande au prof
Parfois, SQLite n'est pas suffisant et nous aurons besoin d'un outil plus avancé appelé PostgreSQL, un système de gestion de base de données adapté à la production, puissant et open source.
Installons-le maintenant.
Exécute les commandes suivantes :
sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential
sudo /etc/init.d/postgresql start
sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;"
Tu peux configurer le démarrage automatique de PostgreSQL afin de ne pas avoir à exécuter sudo /etc/init.d/postgresql start chaque fois que tu ouvres un nouveau terminal :
sudo echo "`whoami` ALL=NOPASSWD:/etc/init.d/postgresql start" | sudo tee /etc/sudoers.d/postgresql
sudo chmod 440 /etc/sudoers.d/postgresql
echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc
Ouvre un nouveau terminal.
:heavy_check_mark: Si tu vois apparaître le message * Starting postgresql (via systemctl): postgresql.service OU * Starting PostgreSQL 14 database server, c’est bon :+1:
:x: Sinon, demande au prof.
On va maintenant vérifier que tu as tout installé correctement.
Dans ton terminal, exécute la commande suivante :
exec zsh
Puis exécute :
curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb && ruby _.rb && rm _.rb || rm _.rb
:heavy_check_mark: Si tu vois apparaître en vert Awesome! Your computer is now ready!, c’est bon :+1:
:x: Sinon, demande au prof.
:warning: Si tu as reçu un e-mail du Wagon t’invitant à t’inscrire sur Kitt (notre plateforme pédagogique), tu peux passer cette étape. Suis plutôt les instructions contenues dans l’e-mail que tu as reçu, si tu ne l’as pas déjà fait.
Si tu n’es pas certain de ce que tu dois faire, suis ce lien. Si tu es déjà connecté, tu peux passer cette section. Si tu n’es pas connecté, clique sur Enter Kitt as a Student. Si tu réussis à te connecter, tu peux passer cette étape. Sinon, demande au prof si tu aurais dû recevoir un e-mail ou si tu dois suivre les instructions ci-dessous.
Inscris-toi en tant qu’alumni du Wagon sur kitt.lewagon.com/onboarding. Sélectionne ton batch, connecte-toi avec GitHub et renseigne toutes tes informations.
Le prof vérifiera ensuite avec toi que tu fais bien partie de ce batch. Tu peux lui demander de vérifier dès que tu as fini de remplir le formulaire d’inscription.
Une fois que le prof a vérifié ton profil, consulte ta messagerie. Tu devrais avoir reçu 2 e-mails :
lewagon. Accepte pour accéder aux cours.Slack est une plateforme de communication assez populaire dans le secteur de la technologie.
Télécharge l’application Slack et installe-la.
:warning: Si tu utilises déjà Slack dans ton navigateur, télécharge et installe l'application de bureau, qui comprend toutes les fonctionnalités.
Lance l’application et connecte-toi à l’organisation lewagon-alumni.
Pense à télécharger une photo de profil :point_down:
L’idée est de laisser Slack ouvert toute la journée pour partager des liens utiles / demander de l’aide / décider où aller manger, etc.
On va vérifier que tout fonctionne correctement ; pour cela, on va tester ta caméra et ton microphone :
Preferences depuis le menuAudio & video dans la colonne de gaucheTroubleshooting, clique sur Run an audio, video and screensharing test. Le test va s’ouvrir dans une nouvelle fenêtreStart test:heavy_check_mark: Une fois le test terminé, tu devrais voir apparaître des messages de succès en vert, au moins pour ton microphone et ta caméra. :+1:
:x: Sinon, demande au prof.
Tu peux également installer l’application Slack sur ton téléphone et te connecter à lewagon-alumni !
On a besoin d’un moyen simple pour transférer des fichiers de Windows à Ubuntu et inversement.
Pour cela, on va créer des raccourcis vers les répertoires Ubuntu dans l’explorateur de fichiers Windows :
WIN + E)\\wsl$\ (ou \\wsl$\Ubuntu si la première option ne fonctionne pas)Un autre moyen pour déplacer les fichiers consiste à ouvrir l’explorateur de fichiers Windows à partir du terminal Ubuntu :
explorer.exe . (ou wslview .)wsl --shutdown dans un Windows PowerShell et rouvre un terminal UbuntuIl se peut que tu aies besoin de connaître l’emplacement exact d’un répertoire Windows dans le système de fichiers Ubuntu ou l’inverse.
Pour convertir un chemin Windows en chemin Ubuntu et inversement :
wslpath "C:\Program Files" pour traduire un chemin Windows en chemin Ubuntuwslpath -w "/home" pour traduire un chemin Ubuntu en chemin Windowswslpath -w $(pwd) renvoie le chemin Windows vers le répertoire Ubuntu actuelTu utiliseras très souvent la plupart des applications que tu as installées aujourd’hui. Épingle-les à ta barre des tâches pour y accéder en un seul clic !
Pour épingler une application à ta barre des tâches, lance l’application, fais un clic droit sur l’icône dans la barre des tâches pour faire apparaître le menu contextuel et sélectionne « Épingler à la barre des tâches ».
Tu dois épingler :
Ton ordinateur est prêt pour la formation AI Software Development du Wagon :muscle: :clap:
Profite du bootcamp, tu vas assurer :rocket: