Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Step by Step, process de mise en place et documentation #3

Closed
Tommy-Sirius opened this issue Mar 4, 2024 · 25 comments
Closed

Step by Step, process de mise en place et documentation #3

Tommy-Sirius opened this issue Mar 4, 2024 · 25 comments

Comments

@Tommy-Sirius
Copy link

Tommy-Sirius commented Mar 4, 2024

Cette issue aura pour but de voir étapes par étapes le bon process pour la mise en place du nouveau téléporteur sur chaque plateforme

Ce post sera édité au fur et a mesure de l'avancée du projet pour un résultat final a transformer sur Stonly.

Windows

Installation de Docker

Ignorer cette partie la pour l'instant et attaquer au 8

  1. Lancer un invite de commande en mode administrateur
  2. Saisir : wsl -install
  3. Redémarrer le PC
  4. Un terminal Ubuntu s'ouvre au lancement, créer un user et un mot de passe
  5. sudo apt update
  6. sudo apt upgrade
  7. Fermer le terminal
  1. Télécharger Docker et lancer l'installer :
  2. Tout laisser coché par défaut et lancer l'installation
  3. Redémarrer le PC
  4. patcher Docker sur la derniere version ( en bas a droite de la fenêtre il proposera de la télécharger et l'installer)
  5. redemarrer le PC

Mise en place du Téléporteur

  1. Lancer Docker
  2. Télécharger l'archive teleporteur-compose-x.x.zip
  3. Extraire l'archive
  4. désactiver tout antivirus temporairement
  5. Lancer Start Teleporter - Windows.bat
  6. Smart Screen peut apparaitre, cliquer sur Informations complémentaires et Exécuter quand même
  7. Lors du build une fenêtre d'autorisation de réseau public et privé apparait, cliquer sur autoriser.
  8. Le build est terminé des que [ls.io-init] done. apparait dans les lignes de commandes
  9. Ne surtout pas fermer la fenêtre d'invite de commande à la fin de l'installation
  10. Lancer le navigateur internet et taper dans la barre d'adresse localhost

MacOS

Installation de Docker

  1. Télécharger Docker et lancer l'installer :
  2. Tout laisser coché par défaut et lancer l'installation
  3. patcher Docker sur la derniere version ( en bas a droite de la fenêtre il proposera de la télécharger et l'installer)

Mise en place du Téléporteur

  1. Lancer Docker
  2. Télécharger l'archive teleporteur-compose-x.x.zip
  3. Extraire l'archive
  4. désactiver tout antivirus temporairement
  5. Ouvrir un terminal
  6. se déplacer dans le dossier de téléchargement avec cd ~/downloads/teleporteur-compose-x.x (remplacer x.x par la version actuelle téléchargée)
  7. autoriser le lancement de script avec chmod +x start-teleporter.sh
  8. lancer le script avec sh start-teleporter.sh

Linux (ubuntu)

  1. Lancer un terminal
  2. executer sudo usermod -aG kvm $USER
  3. in progress...
@Tommy-Sirius
Copy link
Author

@HommeDeGout

Sur l'étape 9 de la mise en place, une fois localhost rentré dans chrome j'ai rien du tout 😂

il doit manquer une étape 🤔

@HommeDeGout
Copy link
Contributor

HommeDeGout commented Mar 4, 2024

Ah ! Effectivement la petite invite de commande doit être ouverte, le Téléporteur est lancé à l'intérieur et ça permet de suivre les logs

Pour l'installation, Docker Desktop ne propose pas de lui-même d'activer WSL si ça n'est pas installé ? Ca aurait été cool 😩

@Tommy-Sirius
Copy link
Author

Ah ! Effectivement la petite invite de commande doit être ouverte, le Téléporteur est lancé à l'intérieur et ça permet de suivre les logs

celui de Ubuntu via wsl ?

ou celle de l'etape 8 que j'ai fermée ?

@HommeDeGout
Copy link
Contributor

Celle de l'étape 8 qui devrait avoir à peu près cette tête-là :

image

Je vais voir si y'a pas moyen de changer le fichier .bat pour afficher un nom précis en haut de la fenêtre pour plus de clarté

@Tommy-Sirius
Copy link
Author

ha noooon je dois relancer le bat ? 😱 ca a pris pas loins de 5 minutes a deploy 🙈

@Tommy-Sirius
Copy link
Author

ha c'est beaucoup moins long a relancer apres coup ouf !

@Tommy-Sirius
Copy link
Author

et bien ma foi, tout a l'air de fonctionner, (sauf le VPN comme c'etait prévu) nice work ;)

@Tommy-Sirius
Copy link
Author

Okay point interessant, j'ai voulu simplement lancer le batch de la v0.2 sans rien faire pour voir, résultat, le prompt plante au bout de 2 minutes et se ferme tout seul.

coté docker la maj ne semble pas avoir eu lieu et j'ai toujours la vielle version du téléporteur

j'ai donc du supprimer le container sur docker pour la v0.1 avant de lancer le batch de la v0.2

c'est maintenant fonctionnel.

@profy12
Copy link
Contributor

profy12 commented Mar 11, 2024

Oui @Tommy-Sirius la subtilité c'est qu'il n'y a pas besoin d'installer ni WSL, ni la vm, ni Docker, installer Docker Desktop s'occupe de tout (WSL2 + création d'une vm linux de façon transparente + installation du docker engine dans cette vm toujours de façon transparente), une fois Docker Desktop installé, le cli docker est disponible directement dans powershell, gitbash ou autre, ce qui te permet de lancer directement le script bat.

@Tommy-Sirius
Copy link
Author

la subtilité c'est qu'il n'y a pas besoin d'installer WSL

J'ai suivi la doc de docker directement pour l'install de WSL2, mais ok j'essaierai sans sur une install vierge pour voir si il s'occupe vraiment de tout.

par contre de quelle VM tu parle ?

pour docker, je ne l'ai pas installé dans le WSL si c'etait le point soulevé.

j'ai juste installé WSL et son ubuntu associé et docker desktop, le reste s'est fait tout seul

@profy12
Copy link
Contributor

profy12 commented Mar 11, 2024

C'est l'installation de Docker Desktop directement sur Windows qui doit tout installer, c'est la seule chose à installer. Pas besoin de faire un vm ubuntu de ton côté. cf https://docs.docker.com/desktop/install/windows-install/#install-docker-desktop-on-windows

Il faut au préalable éventuellement installer WSL2, mais je crois que c'est géré par le setup d'install graphique de Docker Desktop.

@Tommy-Sirius
Copy link
Author

une instalation de WSL2 implique forcement un linux, c'est pas un ubuntu en plus, c'est le ubuntu du WSL lui meme :D

j'ai suivi cette doc : https://docs.docker.com/desktop/install/windows-install/

et la partie : System requirements indiquant WSL version 1.1.3.0 or later. m'a poussé a installer WSL avant le docker desktop.

mais je vais faire le menage pour tout virer et tenter de me rapprocher le plus possible d'un windows vierge, puis je lancerai directement docker desktop pour voir

@HommeDeGout
Copy link
Contributor

On a testé rapidos avec Louise ce matin, ça nous a permis de voir un soucis potentiel qu'auront peut-être nos étudiants, en particulier ceux qui utilisent un PC du boulot genre en alternance :

image

@Tommy-Sirius
Copy link
Author

damn, moi c'etait windows qui aimait pas du tout le batch et qui voulait le bloquer.

il va falloir indiquer dans le guide qu'il faut couper e jus aux antivirus

@HommeDeGout
Copy link
Contributor

La bonne nouvelle c'est que l'installateur de Docker Desktop semble activer WSL2 tout seul sous Windows, mais je ne sais pas si ça sera le cas avec toute les versions de Windows

@Tommy-Sirius
Copy link
Author

oui je viens de voir ca (j'ai fais une clean install ce matin, effectivement comme vous l'aviez presentit toi et aurélien, pas besoin de tout le flan avec WSL.

c'est bien ca fait des étapes en moins. faudrais que je formate le PC en windows 10 famille pour voir mais j'ai la flemme de payer une clé de licence :trollface: je vais chercher un autre cobaye.

meme si en vrai je pense pas que ce sera différent de w11 pro

@Tommy-Sirius
Copy link
Author

j'ai update la methodo, impossible pour moi d'installer le téléporteur sans être sur la dernière version de docker, et sans avoir reboot apres avoir patché.

je lance le test sur Mac maintenant

@Tommy-Sirius
Copy link
Author

@HommeDeGout bon coté mac, le script ne donne rien, je le lance, et .... rien du tout aucune réaction dans le terminal il me renvoi juste a la ligne et ... pas plus

je vais tester sur linux pour voir si il passe correctement

@HommeDeGout
Copy link
Contributor

Je sens que je vais devoir faire un script exprès pour les mac 💀

@Tommy-Sirius
Copy link
Author

omg l'usine a gaz coté linux 😱

https://docs.docker.com/desktop/install/ubuntu/
https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository

j'ai mal au crane et ca ne donne rien de concret pour le moment :trollface:

@HommeDeGout
Copy link
Contributor

Effectivement c'est limite plus relou à installer sous Linux que sous Windows même si la manip est assez classique.

On peut peut-être en faire un script aussi, d'ailleurs !

@Tommy-Sirius
Copy link
Author

ca serait chouette ouais, plus il y a de manipulations plus ca risque de casser avec les apprenants.

de ton coté tu as scrupuleusement suivi la doc rien de plus ? j'avoue pas mal galerer et pour une fois les commandes données en doc ne collent pas avec la réalité de mon terminal :trollface:

@Tommy-Sirius
Copy link
Author

Quand tu pourras @HommeDeGout je veux bien un micro process de déploiement pour linux car avec seulement la doc je coince un peu, et comme j'ai pas trop envie de multiplier les sources d"infos en mode stack overflow etc, pour pas ruiner tout, je m'en remet a toi car tu tourne sous linux me semble il

@HommeDeGout
Copy link
Contributor

Salut ! Je vais essayer de faire ça aujourd'hui maintenant que j'ai terminé avec keyring 🙌

@HommeDeGout
Copy link
Contributor

Ok, je vais noter au fur et à mesure ce que je fais.
Je pars d'un Ubuntu 22 neuf, installé dans Virtualbox (N'utilisez jamais l'installation automatique que Virtualbox propose, l'utilisateur qu'il vous crée n'est pas dans le groupe sudo par défaut 🤡 et y'a des problèmes avec la langue de l'OS et du clavier, ça n'arrivera pas sur un vrai PC)

On commence par aller ici: https://docs.docker.com/desktop/install/ubuntu/ et il nous dit de commencer par aller ici https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository pour faire l'étape 1 qui est un prérequis pour l'installation de Docker Desktop. Ils sont bien relous dès le départ 😁

Au début y'a une suite de commande sudo à entrer une à une, pas de soucis à signaler.
Ensuite on a une commande de 8 bornes de long avec des \ pour revenir à la ligne et rendre le tout plus lisible, mais c'est une seule et unique commande.

Il faudra le préciser sur la doc parce que ça peut piéger si on a pas l'habitude de cette syntaxe et qu'on entre les lignes une par une.

On copie-colle le tout d'un coup dans le terminal, on appuie sur entrée, ça a l'air de fonctionner.

On fait un sudo apt-get update pour finir, on voit qu'il chope des paquets chez https://download.docker.com , c'est bon signe.

La première étape est terminée. Ensuite il nous demande de télécharger le package de Docker Desktop, à l'adresse
https://desktop.docker.com/linux/main/amd64/139021/docker-desktop-4.28.0-amd64.deb?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64

au moment où j'écris ces lignes. Je télécharge le .deb, il me le colle dans le dossier Téléchargements.

cd /home/hdg/Téléchargements
sudo apt-get install ./docker-desktop-4.28.0-amd64.deb
Il veut installer plein de trucs, je répond "Oui"

A la fin, il est pas content et me met une erreur, la doc prévient que ça va arriver et qu'il ne faut pas s'inquiéter.
Ok, je leur fait confiance.

Je vais dans la liste des applications en appuyant sur le raccourci Windows de mon clavier, je cherche Docker Desktop, je le lance, il se plaint parce que je fais le zouave sous Windows et que ma virtualisation est déjà prise par autre chose, mais sur une vraie machine ça devrait fonctionner.

Je ne sais pas si cette manière de présenter les choses t'aide, n'hésite pas si tu as des questions ou s'il y a des points sur lesquels je suis passé vite 🙏

@profy12 profy12 closed this as completed Jun 12, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: Done
Development

No branches or pull requests

3 participants