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

la documentation du script d'install semble fausse/périmée ? #5081

Closed
gasche opened this issue Oct 13, 2018 · 19 comments · Fixed by #5122
Closed

la documentation du script d'install semble fausse/périmée ? #5081

gasche opened this issue Oct 13, 2018 · 19 comments · Fixed by #5122
Assignees
Labels
C-DevelopmentEnv Amélioration de l'environnement de dev C-Docs Concerne la documentation S-BUG Corrige un problème

Comments

@gasche
Copy link
Contributor

gasche commented Oct 13, 2018

make fournit l'aide suivante:

Please use `make <target>' where <target> is one of
  [...]
  install-back      to install backend dependencies
  install-front     to install frontend dependencies
  install-debian    to install debian dependencies
  install-ubuntu    to install ubuntu dependencies
  install-fedora    to install fedora dependencies
  install-archlinux to install archlinux dependencies
  install-macos       to install os x dependencies
  [...]

Mais j'observe le comportement suivant sur ma machine:

$ make install-fedora
make: *** No rule to make target 'install-fedora'.  Stop.
@pierre-24
Copy link
Member

Comme je disais par ailleurs, mea culpa, j'ai oublié de mette a jour le Makefile. Ceci dit, "make install-linux" devrait faire le café (https://docs.zestedesavoir.com/install/install-linux.html).

@pierre-24
Copy link
Member

Question, tient: qu'est ce qui ne fonctionne pas chez toi, @gasche ? J'avais testé sur un live-usb de Fédora de la dernière version en date, mais j'ai pas poussé le vice jusqu'à lancer les tests.

@gasche
Copy link
Contributor Author

gasche commented Oct 15, 2018

La trace est la suivante:

$ make test-back
find . -name '*.pyc' -exec rm {} \;
cd zmd/node_modules/zmarkdown && npm run server
module.js:549
    throw err;
    ^

Error: Cannot find module '../lib/utils/unsupported.js'
    at Function.Module._resolveFilename (module.js:547:15)
    at Function.Module._load (module.js:474:25)
    at Module.require (module.js:596:17)
    at require (internal/module.js:11:18)
    at /usr/lib/node_modules/npm/bin/npm-cli.js:19:21
    at Object.<anonymous> (/usr/lib/node_modules/npm/bin/npm-cli.js:86:3)
    at Module._compile (module.js:652:30)
    at Object.Module._extensions..js (module.js:663:10)
    at Module.load (module.js:565:32)
    at tryModuleLoad (module.js:505:12)
make: *** [Makefile:70: zmd-start] Error 1

Donc j'imagine que soit les paquets npm soit zmd ne se sont pas installés correctement, mais je n'ai pas cherché plus loin. Certains des tests marchent quand même quand je les lance directement avec python3 manage.py test ..., et je me contente de ça (plus la CI) pour le moment.

@gasche
Copy link
Contributor Author

gasche commented Oct 15, 2018

P.S.: Si j'avais une petite requête pour install-linux, ce serait de ne pas demander les droits administrateurs au milieu. Je préférerais qu'une cible (celle-ci ou une cible detect-deps séparée) affiche "Now please run sudo dnf install ..." en utilisant la même logique de détection de la distribution et des paquets nécessaires. Donner les droits d'aministrateurs à un script opaque, ce n'est pas très agréable, et la grande majorité des trucs se fait en fait dans un environnement local qui n'en a pas besoin.

@pierre-24
Copy link
Member

Probablement. Quand t'a 5 minutes, si tu savais donner le résultat de make install-front et make install-zmd, ça aidera surement :)

(à priori, npm est bon)

@gasche
Copy link
Contributor Author

gasche commented Oct 15, 2018

P.P.S.: Un jour si j'ai le temps je regarderai à écrire une "recipe" Docker pour ZDS. Autant une image virtuelle est un gros bousin que je n'aurais pas si envie de télécharger, autant une "recipe" (qui décrit comment construire une image) est légère et pas si chiante à écrire ou utiliser. Ceci-dit, installer Docker peut être un obstacle (chez moi j'ai du tripoter SELinux à la main, etc.), et une image ne force pas à garder des dépendances un minimum à jour, donc c'est bien d'avoir et de pousser aussi une méthode manuelle propre.

@pierre-24
Copy link
Member

P.S.: Si j'avais une petite requête pour install-linux, ce serait de ne pas demander les droits administrateurs au milieu. Je préférerais qu'une cible (celle-ci ou une cible detect-deps séparée) affiche "Now please run (sudo dnf install ...)" en utilisant la même logique de détection de la distribution et des paquets nécessaires. Donner les droits d'aministrateurs à un script opaque, ce n'est pas très agréable, et la grande majorité des trucs se fait en fait dans un environnement local qui n'en a pas besoin.

Agreed, d'autant que le script ne fait pas grand chose en root (en fait, il ne fait que l'installation des paquets, le reste se fait sans), même si c'est "logique" de donner les droits roots à un script d'installation

P.P.S.: Un jour si j'ai le temps je regarderai à écrire une "recipe" Docker pour ZDS. Autant une image virtuelle est un gros bousin que je n'aurais pas si envie de télécharger, autant une "recipe" (qui décrit comment construire une image) est légère et pas si chiante à écrire ou utiliser. Ceci-dit, installer Docker peut être un obstacle (chez moi j'ai du tripoter SELinux à la main, etc.), et une image ne force pas à garder des dépendances un minimum à jour, donc c'est bien d'avoir et de pousser aussi une méthode manuelle propre.

Y'a #5012, si tu veux faire des suggestions :)

@A-312
Copy link
Contributor

A-312 commented Oct 16, 2018

J'ai essayé de faire make install-linux :

$ make install-linux
./scripts/install_zds.sh +base
* [+packages] installing packages (require sudo)
!! I did not detect your linux version
!! Please manually install the packages and run again with `-packages`
Makefile:8: recipe for target 'install-linux' failed
make: *** [install-linux] Error 1

Il faut lancer en sudo ? Peut etre l'indiquer dans la doc si oui.

@pierre-24
Copy link
Member

pierre-24 commented Oct 16, 2018

Non, comme l'a fait remarqué @gasche, le script fait un sudo à un moment, donc il va utiliser sudo. Faut surtout pas lancer le script entier en super utilisateur, ou le site va être compliqué à lancer par après ^^

Mais par contre ... Quelle est ta version de linux ?

@A-312
Copy link
Contributor

A-312 commented Oct 16, 2018

Debian 8

@pierre-24
Copy link
Member

Ok, pas normal. Euuuh ... ça donne quoi cat /proc/version chez toi ?

@A-312
Copy link
Contributor

A-312 commented Oct 16, 2018

$ sudo cat /etc/issue
Debian GNU/Linux 8 \n \l
$ sudo cat /proc/version
Linux version 2.6.32-042stab127.2 ([email protected]) (gcc version 4.4.6 20120305 (Red Hat 4.4.6-4) (GCC) ) #1 SMP Thu Jan 4 16:41:44 MSK 2018

@pierre-24
Copy link
Member

Mouais. Comme tu le vois, le script est pas très futé pour détecter la version de linux (en même temps, en fonction de la distribution, ça change --"). Du coup, ce que fait cette ligne là devrais le faire (je suis pas certain d'avoir testé sur Debian 8, donc à confirmer).

Puis ensuite, ./scripts/install_zds.sh +base -packages devrait normalement le faire :)

@A-312
Copy link
Contributor

A-312 commented Oct 16, 2018

Il n'y a pas debian dans /proc/version :(

@pierre-24
Copy link
Member

J'ai constaté :(

@A-312
Copy link
Contributor

A-312 commented Dec 8, 2018

Lorsque la commande make install-linux rencontre une erreur elle ne s'arrête pas ce qui est TRÈS problématique si on ne reste pas devant. Le script sh continue a dérouler toutes les commandes.

@artragis artragis added S-BUG Corrige un problème C-Docs Concerne la documentation C-DevelopmentEnv Amélioration de l'environnement de dev labels Dec 21, 2018
@artragis artragis self-assigned this Dec 21, 2018
@artragis
Copy link
Member

je m'assigne, il y a beaucoup de taf à faire sur la doc

@A-312
Copy link
Contributor

A-312 commented Dec 28, 2018

Cette issue est complètement corrigé ?

@Situphen
Copy link
Member

Elle concernait les commandes du Makefile donc oui c'est corrigé :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
C-DevelopmentEnv Amélioration de l'environnement de dev C-Docs Concerne la documentation S-BUG Corrige un problème
Projects
None yet
Development

Successfully merging a pull request may close this issue.

5 participants