Les instructions ci-dessous vont te permettre de configurer ton ordinateur pour la formation Développement Web 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 🚀
Pour interagir quand on ne sera pas dans la même pièce, on utilisera Zoom, un outil de visioconférence.
- Va sur zoom.us/download
- Sous Client Zoom, clique sur le bouton Télécharger
- Ouvre le fichier que tu viens de télécharger pour installer l’application
- Ouvre l’application Zoom
- Si tu as déjà un compte Zoom, connecte-toi avec tes identifiants
- Sinon, clique sur le lien Inscrivez-vous, c’est gratuit :
Sur le site Web de Zoom, remplis le formulaire.
Une fois que tu as terminé, retourne sur l’application Zoom et connecte-toi avec tes identifiants.
Tu devrais voir apparaître un écran ressemblant à ça :
Tu peux fermer l’application Zoom.
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.
Si tu as acheté ton ordinateur après fin 2020, il est probable qu’il soit équipé d’un nouveau processeur Apple Silicon au lieu de l’ancien processeur Intel : vérifions ça ensemble.
Ouvre une nouvelle fenêtre de terminal depuis Applications > Utilitaires ou fais une recherche avec Spotlight :
Copie-colle la commande suivante dans le terminal et appuie sur ENTRÉE pour l’exécuter.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/setup/master/utils/macos_list_processor_type.sh)"☝️ Le résultat de la commande devrait t’indiquer si ton ordinateur utilise Apple Silicon.
Si ton ordinateur utilise Apple Silicon, affiche et lis le paragraphe ci-dessous. Sinon, n’en tiens pas compte.
👉 Setup pour Apple Silicon 👈
Si une version native de Homebrew est installée sur ton ordinateur, tu dois la désinstaller.
Exécute la commande suivante dans le terminal :
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"Si brew n’est pas installé, tu verras apparaître le message suivant : brew: command not found!
Ouvre le Finder (ou fais une recherche avec Spotlight.
Va dans Applications > Utilitaires.
Duplique l’application Terminal (sélectionne-la, puis Cmd + C, Cmd + V) et renomme la copie Terminal Rosetta.
Appuie sur Cmd + I sur l’application Terminal Rosetta, puis coche la case « Ouvrir avec Rosetta ».
Cliquer sur la petite croix rouge dans le coin supérieur gauche de la fenêtre d’une application sur un Mac ne permet pas vraiment de quitter l’application, mais seulement de fermer une fenêtre active. Pour vraiment quitter une application, appuie sur Cmd + Q lorsque l’application est active, ou clique sur APP_NAME -> Quitter dans la barre de menu.
Pendant le processus de configuration, on te demandera de quitter et rouvrir des applications plusieurs fois ; assure-toi de le faire correctement 🙏
Ouvre un nouveau terminal, copie-colle la commande suivante et appuie sur ENTRÉE :
xcode-select --installSi tu vois apparaître le message suivant, passe directement à l’étape suivante.
# command line tools are already installed, use "Software Update" to install updatesSinon, une nouvelle fenêtre s’ouvrira, te demandant si tu souhaites installer certains logiciels : clique sur « Installer » et patiente.
✔️ Si tu vois apparaître le message « Le logiciel a été installé », alors c’est bon 👍
❌ Si la commande xcode-select --install échoue, réessaie. Les serveurs Apple sont parfois saturés.
❌ Si tu vois apparaître le message « Xcode is not currently available from the Software Update server », tu dois mettre à jour le catalogue de mise à jour de logiciels :
sudo softwareupdate --clear-catalogUne fois la mise à jour effectuée, réessaie d’installer le logiciel.
Homebrew est un gestionnaire de paquets : un logiciel servant à installer d’autres logiciels à partir de la ligne de commande. Installons-le !
Ouvre un terminal et exécute :
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"On te demandera de confirmer (appuie sur ENTRÉE) et de saisir ton mot de passe de compte utilisateur macOS (celui que tu utilises pour te connecter lorsque tu redémarres ton MacBook).
ENTRÉE.
Si tu as déjà Homebrew, le système te l’indiquera. Continue.
Installe ensuite quelques logiciels utiles :
brew updateSi tu vois apparaître une erreur /usr/local must be writable, exécute simplement :
sudo chown -R $USER:admin /usr/local
brew updateMessage d’erreur ou pas, exécute la commande suivante dans le terminal (tu peux copier-coller toutes les lignes en une seule fois).
brew upgrade git || brew install git
brew upgrade gh || brew install gh
brew upgrade wget || brew install wget
brew upgrade imagemagick || brew install imagemagick
brew upgrade jq || brew install jq
brew upgrade openssl || brew install opensslOn va maintenant installer l’éditeur de texte Visual Studio Code.
Copie (Cmd + C) la commande ci-dessous, puis colle-la dans ton terminal (Cmd + V) :
brew install --cask visual-studio-codePuis lance VS Code en exécutant la commande suivante dans ton 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 rebornix.ruby
code --install-extension dbaeumer.vscode-eslintVoici une liste des extensions que tu vas installer :
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 ENTRÉE.
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 !
Lance un terminal, clique sur Terminal > Preferences, puis sélectionne le thème « Pro » comme profil par défaut.
Quitte et redémarre ton terminal ; tu devrais maintenant voir apparaître un fond noir, plus agréable à l’œil.
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.
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
gh auth login -s 'user:email' -wTu 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 ENTRÉE.
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 ENTRÉE 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 <TON USERNAME>, alors c’est bon 👍
❌ Sinon, demande au prof.
Puis exécute la ligne de configuration suivante :
gh config set git_protocol sshOn doit générer des clés SSH qui serviront à t’authentifier dans GitHub. Vois ça comme un moyen de te connecter, mais différent de la combinaison courante nom d’utilisateur/mot de passe.
Si tu as déjà généré des clés que tu utilises avec d’autres services, tu peux passer cette étape.
Ouvre un terminal et copie-colle cette commande, en remplaçant l’adresse e-mail par la tienne (celle que tu as utilisée pour créer ton compte GitHub).
mkdir -p ~/.ssh && ssh-keygen -t ed25519 -o -a 100 -f ~/.ssh/id_ed25519 -C "[email protected]"On te demandera de fournir des informations. Appuie simplement sur Entrée jusqu’à ce qu’un mot de passe te soit demandée.
ENTRÉE.
Tu vas maintenant donner ta clé publique à GitHub.
Copie-colle la commande suivante dans ton terminal :
gh auth refresh -s write:public_keyUn code à usage unique (####-####) s’affichera à l’écran. Copie-le et appuie sur ENTRÉE, puis colle le code dans ton navigateur et suis les instructions pour autoriser GitHub.
De retour dans le terminal, appuie sur ENTRÉE et exécute la commande suivante :
gh ssh-key add ~/.ssh/id_ed25519.pubTu devrais voir apparaître ✓ Public key added to your account. Si ce n’est pas le cas, n’hésite pas à demander 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.
Quitte toutes les fenêtres de terminal ouvertes.
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
# Si tu vois apparaître « zsh: command not found: rvm », continue. Cela signifie que `rvm` n’est pas installé
# sur ton ordinateur, et c’est qu’on veut !
sudo rm -rf $HOME/.rbenv /usr/local/rbenv /opt/rbenv /usr/local/opt/rbenvENTRÉE.
Puis dans le terminal, exécute :
brew uninstall --force rbenv ruby-buildQuitte ensuite toutes les fenêtres de terminal ouvertes (Cmd + Q) et redémarres-en une. Exécute ensuite :
brew install rbenvTu 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 2.7.4Une fois que l’installation de Ruby est terminée, exécute cette commande pour indiquer au système d’utiliser la version 2.7.4 par défaut.
rbenv global 2.7.4Puis redémarre à nouveau ton terminal (ferme-le, puis rouvre-le).
ruby -v✔️ Si tu vois apparaître un message commençant par 2.7.4p, tu peux continuer 👍
❌ Sinon, demande au prof
Si tu es en Chine
# 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 listeDans 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.
Copie-colle la commande suivante dans ton terminal :
gem install rake bundler rspec rubocop rubocop-performance pry pry-byebug colored http 'rails:~>6.1'✔️ 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 la commande suivante dans ton terminal :
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.37.0/install.sh | zshRedémarre ton terminal et exécute la commande suivante :
nvm -vTu devrais voir apparaître une version. Sinon, demande au prof.
On va maintenant installer node :
nvm install 14.15Une fois l’installation terminée, exécute :
node -v✔️ Si tu vois apparaître v14.15, l’installation a réussi 👍
❌ Sinon, demande au prof
yarn est un gestionnaire de paquets, qui permet d’installer des bibliothèques JavaScript. Installons-le :
Exécute la commande suivante dans le terminal :
npm install --global yarnRedémarre ton terminal et 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, et tu auras besoin de 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 :
brew install postgresql
brew services start postgresqlUne fois que c’est fait, on va vérifier que tout a bien fonctionné :
psql -d postgresSi tu vois apparaître un nouveau message comme celui-ci, c’est bon !
psql (13.3)
Type "help" for help.
postgres=#Pour quitter PostgreSQL, saisis \q puis ENTRÉE.
On va maintenant vérifier que tu as tout installé correctement.
Quitte toutes les fenêtres Terminal ouvertes, ouvres-en une nouvelle et exécute les commandes suivantes :
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.
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 :
- un 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 Devenir membre et renseigne toutes les informations ;
- un de GitHub, t’invitant à rejoindre l’équipe
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.
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
- Dans la barre de message de n’importe quel channel, saisis
/call --testet appuie surENTRÉE - Clique sur le bouton vert « Démarrer le 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 !
Tu dois obligatoirement protéger ta session avec un mot de passe. Si ce n’est pas déjà le cas, va dans > Préférences système > Utilisateurs & groupes et modifie le mot de passe de ton compte. Va aussi dans > Préférences système > Sécurité > Général et configure la sécurité de façon à ce que ton mot de passe te soit demandé 5 secondes après la mise en veille ou le démarrage de l’économiseur d’écran.
Tu peux également aller dans > Préférences système > Mission Control et cliquer sur le bouton Hot Corners en bas à gauche. Choisis le coin inférieur droit pour démarrer l’économiseur d’écran. De cette façon, lorsque tu quitteras ton bureau, tu pourras rapidement verrouiller ton écran en plaçant ta souris dans le coin inférieur droit. Cinq secondes plus tard, ton Mac sera verrouillé et tu devras fournir ton mot de passe pour accéder à ta session.
Au fur et à mesure de ta formation de programmeur, tu comprendras que quitter le clavier fait perdre beaucoup de temps ; tu vas donc chercher à limiter ton utilisation du pavé tactile ou de la souris. Voici quelques astuces macOS pour t’aider.
Va dans > Préférences système > Clavier. Définis Répétition de touches sur la position la plus rapide (à droite) et Pause avant répétition sur la position la plus courte (à droite).
Va dans > Préférences système > Clavier. Clique sur le troisième onglet Raccourcis. En bas de la fenêtre, clique sur le bouton radio tous les contrôles. De cette façon, lorsque tu verras apparaître une popup avec plusieurs options, tu pourras saisir ENTRÉE pour confirmer ou SPACE pour annuler. Si tu as plus de deux options, tu peux utiliser la touche de tabulation pour aller et venir entre elles.
Lis ce script et sélectionne ce qui t’intéresse. Par exemple, tu peux saisir ce qui suit dans le terminal :
# Agrandir la fenêtre de sauvegarde par défaut
defaults write NSGlobalDomain NSNavPanelExpandedStateForSaveMode -bool true
defaults write NSGlobalDomain PMPrintingExpandedStateForPrint -bool true
defaults write NSGlobalDomain PMPrintingExpandedStateForPrint2 -bool true
# Enregistrer les captures d’écran sur le bureau (ou ailleurs)
defaults write com.apple.screencapture location "${HOME}/Desktop"
# etc..Tu utiliseras très souvent la plupart des applications que tu as installées aujourd’hui. Épingle-les à ton Dock 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 la barre des tâches pour faire apparaître le menu contextuel et choisis « Options », puis « Garder dans le Dock ».
Tu dois épingler :
- ton terminal
- ton explorateur de fichiers
- VS Code
- ton navigateur Internet
- Slack
- Zoom
Ton ordinateur est prêt pour la formation Développement Web du Wagon 💪 👏
Profite du bootcamp, tu vas assurer 🚀