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 🙋
C’est parti 🚀
Est-ce que tu as déjà un compte GitHub ? Si ce n’est pas le cas, inscris-toi maintenant.
👉 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.
👉 Active l'authentification à deux facteurs (2FA). GitHub t'enverra des messages texte avec un code lorsque tu essaies de te connecter. C'est important pour la sécurité et cela sera bientôt obligatoire pour contribuer du code sur GitHub.
On va maintenant installer l’éditeur de texte Visual Studio Code.
Copie (Ctrl + C) les commandes ci-dessous, puis colle-les dans ton terminal (Ctrl + Shift + v) :
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/
sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
rm -f packages.microsoft.gpg
sudo apt update
sudo apt install -y codeCes commandes te demanderont ton mot de passe ; saisis-le.
Enter.
On va maintenant lancer VS Code depuis le terminal :
code✔️ Si une fenêtre VS Code s’ouvre, c’est bon. 👍
❌ Sinon, demande au prof.
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-helpersVoici la liste des extensions que tu es en train d'installer :
- Sublime Text Keymap and Settings Importer
- VSCode Great Icons
- Live Share
- Ruby
- ESLint
- Paste and Indent
- SQLite
VS Code inclut de nombreuses fonctionnalités d'IA puissantes, qui sont un excellent outil une fois que tu sais 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, tu sauras quand et comment utiliser l'IA efficacement — sans lui laisser faire la réflexion à ta place.
Pour le début du bootcamp, on va désactiver ces fonctionnalités. Au bon moment du cours, on les réactivera afin que tu puisses les utiliser à bon escient.
Dans VS Code :
- Ouvre la "Palette de commandes" de VS Code : tape
Ctrl-Shift-P(Windows / Linux) ouCmd-Shift-P(macOS). - La Palette de commandes s'ouvrira : une petite zone de texte en haut de l'écran. Commence à taper
aifeaturesjusqu'à voir "Chat: Learn How to Hide AI features". Clique dessus.
- Cela ouvrira les paramètres et affichera l'option "Disable and hide built-in AI features ...". Coche la case devant cette option.
Plus tard, si tu souhaites réactiver les fonctionnalités d'IA, tu peux 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 👇
- Clique sur le bouton « Partager », puis sur « GitHub (connecte-toi avec ton compte GitHub) ».
- Une popup t’invitant à te connecter avec GitHub apparaît. Clique sur « Autoriser ».
- Tu arriveras alors sur une page GitHub dans ton navigateur, où on te demandera d’autoriser Visual Studio Code ; clique sur « Continuer », puis « Autoriser GitHub ».
- Il se peut que VS Code affiche d’autres popups ; ferme-les en cliquant sur « OK ».
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 :
localeSi 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-8Si 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 :
Générer la localisation
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 manpagesAu 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 :
- Ouvre un terminal
- Copie-colle les commandes suivantes :
sudo apt updatesudo apt install -y curl git imagemagick jq unzip vim zshCes commandes te demanderont ton mot de passe ; saisis-le.
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 ghPour vérifier que gh a bien été installé sur ta machine, tu peux exécuter :
gh --version✔️ Si tu vois apparaître gh version X.Y.Z (YYYY-MM-DD), c’est bon 👍
❌ 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 :
✔️ Si c’est le cas, tu peux continuer 👍
❌ Sinon, demande 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 :
email — Même si user:email ressemble à un emplacement réservé pour ta véritable adresse e-mail, ce n'est pas le cas — ne le remplace pas.
gh auth login -s 'user:email' -w --git-protocol sshgh va te poser quelques questions :
-
Generate a new SSH key to add to your GitHub account?Appuie surEnterpour 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 chemin de ta clé publique et appuie surEnter. -
Enter a passphrase for your new SSH key (Optional):- POUR LA PLUPART DES GENS : Appuie simplement sur
Enterpour passer. Tu n'as pas besoin d'une passphrase pour le bootcamp et cela te serait demandé à chaque utilisation de la clé. Il y a cependant un risque que si quelqu'un vole ton ordinateur, il puisse pousser du code sur GitHub. - SI LA SÉCURITÉ EST VRAIMENT IMPORTANTE POUR TOI : Saisis une passphrase de ton choix et appuie sur
Enter. Il est vraiment important que si tu saisis une passphrase, tu la notes immédiatement quelque part et ne la perdes/oublies pas. Tu devras la saisir fréquemment.
- POUR LA PLUPART DES GENS : Appuie simplement sur
-
Title for your SSH key. Tu peux laisser ce qui est proposé par défaut, à savoir "GitHub CLI", appuie surEnter.
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✔️ Si tu vois apparaître Logged in to github.com as <YOUR USERNAME>, alors c’est bon 👍
❌ 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✔️ Tu devrais voir apparaître ton nom d’utilisateur GitHub.
❌ 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 --cloneExécute le programme d’installation dotfiles :
cd ~/code/$GITHUB_USERNAME/dotfiles
zsh install.shVé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'✔️ Si tu vois la liste de tes adresses e-mail enregistrées, tu peux continuer 👍
❌ Sinon, reconnecte-toi à GitHub avant d'exécuter cette commande à nouveau ☝️.
Exécute le programme d’installation de git :
cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh☝️ On te demandera de fournir ton nom (FirstName LastName) et ton adresse e-mail.
gh api ... précédente. Sinon, Kitt ne pourra pas suivre tes progrès. 💡 Sélectionne l'adresse @users.noreply.github.com si tu ne souhaites pas que ton adresse e-mail apparaisse dans les dépôts publics auxquels tu pourrais contribuer.
Réinitialise ton terminal en exécutant :
exec zshCela recharge ton shell afin qu'il prenne en compte la nouvelle configuration.
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 ~/.zshrcPuis :
- Localise la ligne commençant par
plugins= - Ajoute
ssh-agentà la fin de la liste des plug-ins
La liste doit ressembler à ça :
plugins=(gitfast last-working-dir common-aliases zsh-syntax-highlighting history-substring-search pyenv ssh-agent)✔️ 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 ~/.rbenvPuis 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-devgit clone https://github.com/rbenv/rbenv.git ~/.rbenvgit clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
exec zshTu 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.5Une 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.5Réinitialise ton terminal et vérifie ta version de Ruby :
exec zshPuis exécute :
ruby -v✔️ Si tu vois apparaître un message commençant par ruby 3.3.5, tu peux continuer 👍
❌ Sinon, demande au prof
Si tu es en Chine 🇨🇳 clique ici
# 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 listeQue 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 bundlerCopie-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✔️ Si tu vois apparaître xx gems installed, c’est bon 👍
❌ 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 givenExécute la commande suivante :
rm -rf ~/.gemrcExécute à nouveau la commande pour installer les gems.
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 zshPuis exécute la commande suivante :
nvm -vTu devrais voir apparaître une version. Sinon, demande au prof.
On va maintenant installer node :
nvm install 20.17.0Une fois l’installation terminée, exécute :
node -vSi tu vois apparaître v20.17.0, l'installation a réussi ✔️ Tu peux alors exécuter :
nvm cache clear❌ 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 stablenpm install -g corepack puis exécute à nouveau les commandes ci-dessus.
exec zshPuis exécute la commande suivante :
yarn -v✔️ Si tu vois apparaître une version, c'est bon 👍
❌ 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-configPuis exécute celle-ci :
sqlite3 -version✔️ Si tu vois une version s'afficher, c'est tout bon 👍
❌ 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-essentialsudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;"On va maintenant vérifier que tu as tout installé correctement.
Dans ton terminal, exécute la commande suivante :
exec zshPuis exécute :
curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb && ruby _.rb && rm _.rb || rm _.rb✔️ Si tu vois apparaître en vert Awesome! Your computer is now ready!, c’est bon 👍
❌ Sinon, demande au prof.
Tu devrais avoir reçu un e-mail du Wagon t'invitant à t'inscrire sur Kitt (notre plateforme pédagogique). En soumettant ton formulaire d'inscription sur Kitt, tu devrais avoir reçu deux invitations supplémentaires :
- Une de Slack, t'invitant à rejoindre la communauté Slack des anciens étudiants du Wagon (où tu pourras discuter avec tes amis et tous les anciens élèves). Clique sur Rejoindre et renseigne tes informations.
- Une de GitHub, t'invitant à rejoindre l'équipe
lewagon. Accepte-la, sinon tu ne pourras pas accéder aux slides des cours.
Si ce n'est pas le cas, contacte ton équipe pédagogique.
Slack est une plateforme de communication assez populaire dans le secteur de la technologie.
Télécharge l’application Slack et installe-la.
Lance l’application et connecte-toi à l’organisation lewagon-alumni.
Pense à télécharger une photo de profil 👇
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 :
- Ouvre l’application Slack
- Clique sur ta photo de profil en haut à droite
- Clique sur
Preferencesdepuis le menu - Sélectionne
Audio & videodans la colonne de gauche - En dessous de
Troubleshooting, clique surRun an audio, video and screensharing test. Le test va s’ouvrir dans une nouvelle fenêtre - Vérifie que ton microphone, caméra, et enceintes soient bien sélectionnés, puis clique sur
Start test
✔️ 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. 👍
❌ Sinon, demande au prof.
Tu peux également installer l’application Slack sur ton téléphone et te connecter à lewagon-alumni !
Sur notre plateforme pédagogique (Kitt, que tu découvriras bientôt), on propose des vidéos. Par défaut, Firefox sur Linux ne peut pas les lire, car elles utilisent un codec qui n’est pas pris en charge (H264). Pour pouvoir lire ces vidéos, tu dois exécuter la commande suivante :
sudo apt install libavcodec-extra -ytree est un outil pratique qui permet de visualiser une arborescence de dossiers à l’intérieur du terminal.
ncdu est un utilitaire de disque à interface texte.
htop est un visualiseur de processus interactif.
tig est une interface en mode texte pour git.
sudo apt install tree ncdu htop tigUbuntu surveille toutes les modifications apportées à tes dossiers ; pour cela, il utilise inotify. Par défaut, la limite Ubuntu est fixée à 8 192 fichiers surveillés.
La programmation implique de travailler avec un grand nombre de fichiers ; on doit donc relever cette limite. Dans ton terminal, exécute :
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -pTu utiliseras très souvent la plupart des applications que tu as installées aujourd’hui. Épingle-les pour y accéder en un seul clic !
Pour épingler une application à ton Dock, lance l’application, fais un clic droit sur l’icône dans le Dock pour faire apparaître le menu contextuel et choisis « Ajouter aux favoris ».
Tu dois épingler :
- ton terminal
- ton explorateur de fichiers
- VS Code
- ton navigateur Internet
- Slack
Ton ordinateur est prêt pour la formation AI Software Development du Wagon 💪 👏
Profite du bootcamp, tu vas assurer 🚀