WikiBR - Contributions [fr]

Cloud computing

2026-01-24T16:42:24Z

Jean-nicolas.strauss : update des consignes

Un projet ? Un PSC ? Beaucoup de calcul ?

Les ordis de salle info c'est pratique mais tous les jours à 6h il est interrompu, je ne peux pas m'en servir pendant les heures de cours, je n'arrive pas à installer les logiciels dont j'ai besoin et mon code n'est pas optimisé pour tourner sur GPU... Le BR te propose une solution : son cluster de cloud computing.

{{Attention|le BR n'a que des CPU sur son cluster, pas de GPU. Si vous voulez utiliser des GPU il faut utiliser les ordinateurs des [[Acc%C3%A8s_%C3%A0_distance_aux_machines_des_salles_info|salles de TP d'informatique]]. Mais si vous voulez des CPU on sera ravi de vous aider.}}

== Comment ça marche ? ==

En faisant un ticket PaniX le BR peut te créer une machine avec jusqu'à 24 coeurs et 72 Go de RAM.

Dans ton ticket, indique
* pour quelles raisons tu as besoin d'une machine,
* pour quelle durée,
* ta clef publique ssh (ed25519 de préférence ou RSA d'au moins 4096 bits (voir [[SSH]] pour plus d'informations))

ssh-keygen -t ed25519 -a 32

== Détails techniques ==

Tu auras grâce à ta clef un accès en ssh à la machine. On te transmettra le mot de passe du compte pour avoir les accès sudo. La machine tourne sous Debian. Il y a un redémarrage une fois par semaine le dimanche soir pour mise à jour.

Accès à distance aux machines des salles info

2026-01-05T16:35:55Z

Jean-nicolas.strauss : add uv

<blockquote>
La procédure indiquée sur l'[https://wikix.polytechnique.org/Acc%C3%A8s_%C3%A0_distance_aux_machines_des_salles_info article WikiX] dédié fonctionne aussi. Il faudra vérifier qu'elle est à jour (typiquement sur Windows ssh est maintenant incorporé au cmd et à powershell), et les articles WikiX concernant SSH seront réorganisées pour clarifier.
</blockquote>

Pour accéder à vos fichiers sur les machines des salles info, il faut utiliser le protocole [[SSH]].

== Setup votre machine pour pouvoir se connecter en SSH ==

Suivre l'article concernant [[SSH]]. Par rapport à ce qui est décrit, '''il n'est pas nécessaire d'avoir créé une identité SSH'''. En effet vous utiliserez directement vos [[identifiants]] DSI pour s'authentifier auprès de la machine distante. Mais il est conseillé de créer une clef SSH et de la copier sur la machine quand même (voir le guide), c'est plus sécurisé et c'est plus pratique.

=== La commande <code>ssh</code> ===

Dans une console, la commande suivante te permettra de te connecter au système de fichiers des salles info :

<code>ssh prenom.nom@nomdelamachine.polytechnique.fr</code>

"<code>nomdelamachine</code>" est bien sûr à remplacer par le [https://wikix.polytechnique.org/Ordis_de_salle_info nom d'une des machines] ([https://portail.polytechnique.edu/dsi/explorez-les-services/salles-informatiques/liste-des-ordinateurs-dans-les-salles-informatiques aussi accessible sur la page du DSI]), par exemple <code>clavicule</code> ou <code>mouette</code>.

Selon la console utilisée, il est possible, si c'est la première fois que tu te connectes à une machine des salles info, que tu aies un avertissement comme quoi la clé d'authentification de la machine n'est pas connue. C'est normal, entre <code>yes</code> pour l'ajouter à la liste des machines connues.

Une fois connecté par SSH à votre compte, tu pourras manipuler le système de fichiers distant grâce aux mêmes commandes Unix (<code>cd</code>, <code>mkdir</code>, <code>mv</code>...) que lorsque tu es en salle info.

=== La commande <code>scp</code> ===

SCP, pour Secure Copy Protocol, est un protocole se basant sur le protocole SSH. Il sert à copier des fichiers entre machines distantes.

Toujours dans la console, la commande suivante te permettra de copier un fichier depuis les ordis des salles infos :

<code>scp prenom.nom@nomdelamachine.polytechnique.fr:fichier/a/copier fichier/de/destination</code>

<code>fichier/a/copier</code> designe le path du fichier dans le système de fichiers distant, et <code>fichier/de/destination</code> est le path du dossier, sur votre machine, ou tu veux le copier.

Pour copier des dossiers, c'est la même option que pour <code>cp</code> :

<code>scp -r prenom.nom@nomdelamachine.polytechnique.fr:dossier/a/copier dossier/de/destination</code>

Tu peux aussi utiliser un client graphique comme [https://filezilla-project.org/ Filezilla] ou [https://winscp.net/eng/download.php WinSCP].

== Liens utiles ==
* Liste des logiciels installés dans les PC de salle info et comment les utiliser : [https://www.enseignement.polytechnique.fr/software-si/ cliquer ici]
* Créer un serveur Apache / PHP/ MySQL : [http://www.enseignement.polytechnique.fr/amp/ aide de l'école]
* [[Setup_uv_TD_info|Comment setup uv]] pour gérer avec un seul outil ses
** versions de python différentes
** versions de packets différents
** environnement virtuels

Cloud computing

2026-01-05T16:30:00Z

Jean-nicolas.strauss : arrrretez de nous demander des gpu

Un projet ? Un PSC ? Beaucoup de calcul ?

Les ordis de salle info c'est pratique mais tous les jours à 6h il est interrompu, je ne peux pas m'en servir pendant les heures de cours, je n'arrive pas à installer les logiciels dont j'ai besoin et mon code n'est pas optimisé pour tourner sur GPU... Le BR te propose une solution : son cluster de cloud computing.

{{Attention|le BR n'a que des CPU sur son cluster, pas de GPU. Si vous voulez utiliser des GPU il faut utiliser les ordinateurs des [[Acc%C3%A8s_%C3%A0_distance_aux_machines_des_salles_info|salles de TP d'informatique]]. Mais si vous voulez des CPU on sera ravi de vous aider.}}

== Comment ça marche ? ==

En faisant un ticket PaniX le BR peut te créer une machine avec jusqu'à 24 coeurs et 72 Go de RAM.

Dans ton ticket, indique pour quelles raisons tu as besoin d'une machine, pour quelle durée et ta clef publique ssh RSA d'au moins 4096 bits (voir [[SSH]] pour plus d'informations) :

ssh-keygen -t ed25519 -a 32

== Détails techniques ==

Tu auras grâce à ta clef un accès en ssh à la machine. On te transmettra le mot de passe du compte pour avoir les accès sudo. La machine tourne sous Debian. Il y a un redémarrage une fois par semaine le dimanche soir pour mise à jour.

Cloud computing

2026-01-05T16:29:37Z

Jean-nicolas.strauss : arrrretez de nous demander des gpu

Un projet ? Un PSC ? Beaucoup de calcul ?

Les ordis de salle info c'est pratique mais tous les jours à 6h il est interrompu, je ne peux pas m'en servir pendant les heures de cours, je n'arrive pas à installer les logiciels dont j'ai besoin et mon code n'est pas optimisé pour tourner sur GPU... Le BR te propose une solution : son cluster de cloud computing.

{{Attention|le BR n'a que des CPU sur son cluster, pas de GPU. Si vous voulez utiliser des GPU il faut utiliser les ordinateurs des [[Acc%C3%A8s_%C3%A0_distance_aux_machines_des_salles_info|salles de TP d'informatique]]}}. Mais si vous voulez des CPU on sera ravi de vous aider.

== Comment ça marche ? ==

En faisant un ticket PaniX le BR peut te créer une machine avec jusqu'à 24 coeurs et 72 Go de RAM.

Dans ton ticket, indique pour quelles raisons tu as besoin d'une machine, pour quelle durée et ta clef publique ssh RSA d'au moins 4096 bits (voir [[SSH]] pour plus d'informations) :

ssh-keygen -t ed25519 -a 32

== Détails techniques ==

Tu auras grâce à ta clef un accès en ssh à la machine. On te transmettra le mot de passe du compte pour avoir les accès sudo. La machine tourne sous Debian. Il y a un redémarrage une fois par semaine le dimanche soir pour mise à jour.

Setup uv TD info

2025-02-21T16:05:49Z

Jean-nicolas.strauss : tanche -> thon

= Gérer son stockage sur les ordis des labos =

C'est un des problèmes les plus communs de l'X que de se retrouver avec une erreur du genre {{c|Disk quota exceeded (os error 122)}}.
Ce qu'il se passe c'est qu'il y a 30Go partagés par tous les ordis des salles de TP, donc si vous mettez un fichier dans {{c|~/foo/bar}} vous allez le retrouver dans tous les autres ordis, c'est notamment le cas du dossier {{c|.ssh}} et le dossier {{c|.config}}. Cependant sur chaque ordi est présent un {{c|/Data}} de très grande taille ou tout le monde peut travailler.

Pour résoudre le problème de manque de place plusieurs étapes

== Identifier ce qui prend de la place ==

du -hc ~/ 2>/dev/null | grep -E 'f^([0-9]|,|\.)+G'

Cette commande permet de savoir ce qui fait au moins un giga dans ses dossiers.

Si c'est pip qui prend trop de place on peut exécuter
pip cache purge
pour nettoyer un peu tout ces vieux paquets dont on ne se sert plus.

Mais plus puissant que pip est {{c|uv}}.
= uv =
== Introduction ==

[https://docs.astral.sh/uv/ uv] est un "extremely fast Python package and project manager, written in Rust." (source leur doc)
Il permet de gérer plusieurs versions de python, plusieurs versions des paquets, des environnements de dev, de prod, le tout en étant incomparablement plus rapide que vanilla pip ou que poetry... Bref je [l'auteur de ce tuto, ndlr] suis fan.

== Installation de uv ==

Pour installer UV :
curl -LsSf https://astral.sh/uv/install.sh | sh
C'est tout

== Initialisation d'un projet avec uv ==

Pour initialiser un nouveau projet avec uv, suivez ces étapes :

mkdir projet-de-ouf
cd projet-de-ouf
uv init

uv s'occupe des conflits de dépendances, de l'installation des paquets, de la gestion du venv, le tout avec le {{c|pyproject.toml}} qui est son fichier de configuration, qu'il gère automatiquement.

=== Ajout d'un paquet au venv ===

Oubliez pip install faites place à {{c|uv add}}, par exemple pour ajouter PyTorch
uv add torch
Pour vérifier qu'il a bien été ajouté au projet vous pouvez consulter le {{c|pyproject.toml}} et voir que le paquet à bien été ajouté avec la bonne version.
Attention : le venv n'est pas créé jusqu'à ce que vous demandiez à uv d'exécuter quelque chose comme le hello.py qu'il crée automatiquement ou juste python
uv run python
uv run python hello.py
Mais pas besoin de créer le venv pour configurer tous les paquets

=== Changement de la version de python ===
uv créé automatiquement un {{c|.python-version}} dans lequel il suppose la version de python qui vous intéresse, si vous voulez la changer, vous pouvez le faire dans ce fichier. Attention cependant à modifier conjointement le {{c|pyproject.toml}} pour les dépendances et bien préciser que les versions des paquets doivent être compatibles avec toutes les versions de python à partir de 3.8 si vous voulez, même si la version de python est 3.12.

=== Execution d'un programme ===
Pour exécuter un programme qui s'appelle {{c|hello.py}} par exemple
uv run python hello.py

Si le venv n'a pas été créé avant c'est maintenant que uv va le créer et installer les paquets avec les versions spécifiées dans le {{c|pyproject.toml}}

=== Attention ===
La commande {{c|uv pip install}} existe encore mais ne rajoute pas le paquet au venv elle va l'installer, mais vous ne saurez pas quelle version, cette commande est donc à remplacer par {{c|uv add}}

== Gestion du cache ==

Un des atouts de uv est qu'il a une très bonne gestion du cache, pour que l'installation de paquets donc vous avez souvent besoin soit plus rapide. Seul bémol cela peut remplir votre {{c|~/.cache}}. Si vous voulez nettoyer le cache vous pouvez exécuter {{c|uv cache purge}} ce qui est un peu agressif, ou lire [https://docs.astral.sh/uv/concepts/cache/ la documentation de uv sur le cache].
Vous pouvez aussi installer un paquet sans le 'cacher' avec
uv add torch --no-cache
Voire même en lui spécifiant le dossier de cache que vous voulez utiliser (cf la doc de uv)

== Utilisation du venv dans vscode ==
Une fois que uv a créé le venv vous pouvez l'utiliser comme un venv normal avec vscode en précisant le chemin de votre venv s'il n'est pas dans votre dossier de travail.

== uv et git ==

Quand on exécute la commande {{c|uv init}} il crée aussi un repo git. Profitez-en !! Apprenez à utiliser [[git]] pour ne pas perdre votre travail, à chaque itération et comparer ce que vous avez fait à chaque modification.

== Lancement de jupyter avec uv - execution de code à distance ==
Pour les personnes qui ont tellement streamliné leur processus de développement avec un environement de dev sur leur machine mais un serveur jupyter distant pour exécuter le code.
ssh -L localhost:8888:localhost:8888 prenom.nom@thon.polytechnique.fr
cd foo/bar
uv init
uv add jupyter
uv run jupyter notebook --no-browser --port=8888 &
disown %1
<ref>une variante est de rajouter -fN à la fin de la commande ssh pour avoir le tunnel ssh en arrière plan et se connecter en ssh simplement après, mais si ce commentaire vous semble du charabia oubliez le</ref>
Copier la ligne du genre http://localhost:8888/tree?token=36b32207109218c28fec0772a8471b320ec2177a27443e2f qui vient d'apparaître et dans vscode cliquer sur {{c|Select kernel -> Existing jupyter server}} coller ce que vous venez de copier, dans la prochaine case nommez votre serveur (par exemple "thon v1"), et sélectionner kernel python. Le tour est joué, votre code est sauvé sur votre machine mais exécuté à distance sur thon. Si la dsi éteint l'ordi pendant les vacances alors vous aurez encore tout votre code.

Pour tuer le serveur vous pouvez récupérer le PID de votre processus et le tuer avec
kill $(jobs -l | cut -d ' ' -f 2)
ou alors le tuer avec {{c|pkill uv}} mais vous allez aussi tuer les processus des autres ce qui est pas cool, donc évitez svp

Attention : pensez à régulièrement synchroniser votre pyproject.toml (avec git par exemple) pour que les versions que vous ajoutez sur votre dossier local (sur votre ordinateur) soit les mêmes que celles que fait tourner uv sur l'ordi du labo.

Setup uv TD info

2025-02-21T16:02:15Z

Jean-nicolas.strauss : ssh commet

= Gérer son stockage sur les ordis des labos =

C'est un des problèmes les plus communs de l'X que de se retrouver avec une erreur du genre {{c|Disk quota exceeded (os error 122)}}.
Ce qu'il se passe c'est qu'il y a 30Go partagés par tous les ordis des salles de TP, donc si vous mettez un fichier dans {{c|~/foo/bar}} vous allez le retrouver dans tous les autres ordis, c'est notamment le cas du dossier {{c|.ssh}} et le dossier {{c|.config}}. Cependant sur chaque ordi est présent un {{c|/Data}} de très grande taille ou tout le monde peut travailler.

Pour résoudre le problème de manque de place plusieurs étapes

== Identifier ce qui prend de la place ==

du -hc ~/ 2>/dev/null | grep -E 'f^([0-9]|,|\.)+G'

Cette commande permet de savoir ce qui fait au moins un giga dans ses dossiers.

Si c'est pip qui prend trop de place on peut exécuter
pip cache purge
pour nettoyer un peu tout ces vieux paquets dont on ne se sert plus.

Mais plus puissant que pip est {{c|uv}}.
= uv =
== Introduction ==

[https://docs.astral.sh/uv/ uv] est un "extremely fast Python package and project manager, written in Rust." (source leur doc)
Il permet de gérer plusieurs versions de python, plusieurs versions des paquets, des environnements de dev, de prod, le tout en étant incomparablement plus rapide que vanilla pip ou que poetry... Bref je [l'auteur de ce tuto, ndlr] suis fan.

== Installation de uv ==

Pour installer UV :
curl -LsSf https://astral.sh/uv/install.sh | sh
C'est tout

== Initialisation d'un projet avec uv ==

Pour initialiser un nouveau projet avec uv, suivez ces étapes :

mkdir projet-de-ouf
cd projet-de-ouf
uv init

uv s'occupe des conflits de dépendances, de l'installation des paquets, de la gestion du venv, le tout avec le {{c|pyproject.toml}} qui est son fichier de configuration, qu'il gère automatiquement.

=== Ajout d'un paquet au venv ===

Oubliez pip install faites place à {{c|uv add}}, par exemple pour ajouter PyTorch
uv add torch
Pour vérifier qu'il a bien été ajouté au projet vous pouvez consulter le {{c|pyproject.toml}} et voir que le paquet à bien été ajouté avec la bonne version.
Attention : le venv n'est pas créé jusqu'à ce que vous demandiez à uv d'exécuter quelque chose comme le hello.py qu'il crée automatiquement ou juste python
uv run python
uv run python hello.py
Mais pas besoin de créer le venv pour configurer tous les paquets

=== Changement de la version de python ===
uv créé automatiquement un {{c|.python-version}} dans lequel il suppose la version de python qui vous intéresse, si vous voulez la changer, vous pouvez le faire dans ce fichier. Attention cependant à modifier conjointement le {{c|pyproject.toml}} pour les dépendances et bien préciser que les versions des paquets doivent être compatibles avec toutes les versions de python à partir de 3.8 si vous voulez, même si la version de python est 3.12.

=== Execution d'un programme ===
Pour exécuter un programme qui s'appelle {{c|hello.py}} par exemple
uv run python hello.py

Si le venv n'a pas été créé avant c'est maintenant que uv va le créer et installer les paquets avec les versions spécifiées dans le {{c|pyproject.toml}}

=== Attention ===
La commande {{c|uv pip install}} existe encore mais ne rajoute pas le paquet au venv elle va l'installer, mais vous ne saurez pas quelle version, cette commande est donc à remplacer par {{c|uv add}}

== Gestion du cache ==

Un des atouts de uv est qu'il a une très bonne gestion du cache, pour que l'installation de paquets donc vous avez souvent besoin soit plus rapide. Seul bémol cela peut remplir votre {{c|~/.cache}}. Si vous voulez nettoyer le cache vous pouvez exécuter {{c|uv cache purge}} ce qui est un peu agressif, ou lire [https://docs.astral.sh/uv/concepts/cache/ la documentation de uv sur le cache].
Vous pouvez aussi installer un paquet sans le 'cacher' avec
uv add torch --no-cache
Voire même en lui spécifiant le dossier de cache que vous voulez utiliser (cf la doc de uv)

== Utilisation du venv dans vscode ==
Une fois que uv a créé le venv vous pouvez l'utiliser comme un venv normal avec vscode en précisant le chemin de votre venv s'il n'est pas dans votre dossier de travail.

== uv et git ==

Quand on exécute la commande {{c|uv init}} il crée aussi un repo git. Profitez-en !! Apprenez à utiliser [[git]] pour ne pas perdre votre travail, à chaque itération et comparer ce que vous avez fait à chaque modification.

== Lancement de jupyter avec uv - execution de code à distance ==
Pour les personnes qui ont tellement streamliné leur processus de développement avec un environement de dev sur leur machine mais un serveur jupyter distant pour exécuter le code.
ssh -L localhost:8888:localhost:8888 prenom.nom@thon.polytechnique.fr
cd foo/bar
uv init
uv add jupyter
uv run jupyter notebook --no-browser --port=8888 &
disown %1
<ref>une variante est de rajouter -fN à la fin de la commande ssh pour avoir le tunnel ssh en arrière plan et se connecter en ssh simplement après, mais si ce commentaire vous semble du charabia oubliez le</ref>
Copier la ligne du genre http://localhost:8888/tree?token=36b32207109218c28fec0772a8471b320ec2177a27443e2f qui vient d'apparaître et dans vscode cliquer sur {{c|Select kernel -> Existing jupyter server}} coller ce que vous venez de copier, dans la prochaine case nommez votre serveur (par exemple "thon v1"), et sélectionner kernel python. Le tour est joué, votre code est sauvé sur votre machine mais exécuté à distance sur tanche. Si la dsi éteint l'ordi pendant les vacances alors vous aurez encore tout votre code.

Pour tuer le serveur vous pouvez récupérer le PID de votre processus et le tuer avec
kill $(jobs -l | cut -d ' ' -f 2)
ou alors le tuer avec {{c|pkill uv}} mais vous allez aussi tuer les processus des autres ce qui est pas cool, donc évitez svp

Attention : pensez à régulièrement synchroniser votre pyproject.toml (avec git par exemple) pour que les versions que vous ajoutez sur votre dossier local (sur votre ordinateur) soit les mêmes que celles que fait tourner uv sur l'ordi du labo.

Setup uv TD info

2025-02-21T15:59:03Z

Jean-nicolas.strauss : relecture

= Gérer son stockage sur les ordis des labos =

C'est un des problèmes les plus communs de l'X que de se retrouver avec une erreur du genre {{c|Disk quota exceeded (os error 122)}}.
Ce qu'il se passe c'est qu'il y a 30Go partagés par tous les ordis des salles de TP, donc si vous mettez un fichier dans {{c|~/foo/bar}} vous allez le retrouver dans tous les autres ordis, c'est notamment le cas du dossier {{c|.ssh}} et le dossier {{c|.config}}. Cependant sur chaque ordi est présent un {{c|/Data}} de très grande taille ou tout le monde peut travailler.

Pour résoudre le problème de manque de place plusieurs étapes

== Identifier ce qui prend de la place ==

du -hc ~/ 2>/dev/null | grep -E 'f^([0-9]|,|\.)+G'

Cette commande permet de savoir ce qui fait au moins un giga dans ses dossiers.

Si c'est pip qui prend trop de place on peut exécuter
pip cache purge
pour nettoyer un peu tout ces vieux paquets dont on ne se sert plus.

Mais plus puissant que pip est {{c|uv}}.
= uv =
== Introduction ==

[https://docs.astral.sh/uv/ uv] est un "extremely fast Python package and project manager, written in Rust." (source leur doc)
Il permet de gérer plusieurs versions de python, plusieurs versions des paquets, des environnements de dev, de prod, le tout en étant incomparablement plus rapide que vanilla pip ou que poetry... Bref je [l'auteur de ce tuto, ndlr] suis fan.

== Installation de uv ==

Pour installer UV :
curl -LsSf https://astral.sh/uv/install.sh | sh
C'est tout

== Initialisation d'un projet avec uv ==

Pour initialiser un nouveau projet avec uv, suivez ces étapes :

mkdir projet-de-ouf
cd projet-de-ouf
uv init

uv s'occupe des conflits de dépendances, de l'installation des paquets, de la gestion du venv, le tout avec le {{c|pyproject.toml}} qui est son fichier de configuration, qu'il gère automatiquement.

=== Ajout d'un paquet au venv ===

Oubliez pip install faites place à {{c|uv add}}, par exemple pour ajouter PyTorch
uv add torch
Pour vérifier qu'il a bien été ajouté au projet vous pouvez consulter le {{c|pyproject.toml}} et voir que le paquet à bien été ajouté avec la bonne version.
Attention : le venv n'est pas créé jusqu'à ce que vous demandiez à uv d'exécuter quelque chose comme le hello.py qu'il crée automatiquement ou juste python
uv run python
uv run python hello.py
Mais pas besoin de créer le venv pour configurer tous les paquets

=== Changement de la version de python ===
uv créé automatiquement un {{c|.python-version}} dans lequel il suppose la version de python qui vous intéresse, si vous voulez la changer, vous pouvez le faire dans ce fichier. Attention cependant à modifier conjointement le {{c|pyproject.toml}} pour les dépendances et bien préciser que les versions des paquets doivent être compatibles avec toutes les versions de python à partir de 3.8 si vous voulez, même si la version de python est 3.12.

=== Execution d'un programme ===
Pour exécuter un programme qui s'appelle {{c|hello.py}} par exemple
uv run python hello.py

Si le venv n'a pas été créé avant c'est maintenant que uv va le créer et installer les paquets avec les versions spécifiées dans le {{c|pyproject.toml}}

=== Attention ===
La commande {{c|uv pip install}} existe encore mais ne rajoute pas le paquet au venv elle va l'installer, mais vous ne saurez pas quelle version, cette commande est donc à remplacer par {{c|uv add}}

== Gestion du cache ==

Un des atouts de uv est qu'il a une très bonne gestion du cache, pour que l'installation de paquets donc vous avez souvent besoin soit plus rapide. Seul bémol cela peut remplir votre {{c|~/.cache}}. Si vous voulez nettoyer le cache vous pouvez exécuter {{c|uv cache purge}} ce qui est un peu agressif, ou lire [https://docs.astral.sh/uv/concepts/cache/ la documentation de uv sur le cache].
Vous pouvez aussi installer un paquet sans le 'cacher' avec
uv add torch --no-cache
Voire même en lui spécifiant le dossier de cache que vous voulez utiliser (cf la doc de uv)

== Utilisation du venv dans vscode ==
Une fois que uv a créé le venv vous pouvez l'utiliser comme un venv normal avec vscode en précisant le chemin de votre venv s'il n'est pas dans votre dossier de travail.

== uv et git ==

Quand on exécute la commande {{c|uv init}} il crée aussi un repo git. Profitez-en !! Apprenez à utiliser [[git]] pour ne pas perdre votre travail, à chaque itération et comparer ce que vous avez fait à chaque modification.

== Lancement de jupyter avec uv - execution de code à distance ==
Pour les personnes qui ont tellement streamliné leur processus de développement avec un environement de dev sur leur machine mais un serveur jupyter distant pour exécuter le code.
ssh -L localhost:8888:localhost:8888 prenom.nom@thon.polytechnique.fr
cd foo/bar
uv init
uv add jupyter
uv run jupyter notebook --no-browser --port=8888 &
disown %1
Copier la ligne du genre http://localhost:8888/tree?token=36b32207109218c28fec0772a8471b320ec2177a27443e2f qui vient d'apparaître et dans vscode cliquer sur {{c|Select kernel -> Existing jupyter server}} coller ce que vous venez de copier, dans la prochaine case nommez votre serveur (par exemple "thon v1"), et sélectionner kernel python. Le tour est joué, votre code est sauvé sur votre machine mais exécuté à distance sur tanche. Si la dsi éteint l'ordi pendant les vacances alors vous aurez encore tout votre code.

Pour tuer le serveur vous pouvez récupérer le PID de votre processus et le tuer avec
kill $(jobs -l | cut -d ' ' -f 2)
ou alors le tuer avec {{c|pkill uv}} mais vous allez aussi tuer les processus des autres ce qui est pas cool, donc évitez svp

Attention : pensez à régulièrement synchroniser votre pyproject.toml (avec git par exemple) pour que les versions que vous ajoutez sur votre dossier local (sur votre ordinateur) soit les mêmes que celles que fait tourner uv sur l'ordi du labo.

Setup uv TD info

2025-02-21T15:46:27Z

Jean-nicolas.strauss :

= Gérer son stockage sur les ordis des labos =

C'est un des problèmes les plus communs de l'X que de se retrouver avec une erreur du genre {{c|Disk quota exceeded (os error 122)}}.
Ce qu'il se passe c'est qu'il y a 30Go partagés par tous les ordis des salles de TP, donc si vous mettez un fichier dans {{c|~/foo/bar}} vous allez le retrouver dans tous les autres ordis, c'est notamment le cas du dossier {{c|.ssh}} et le dossier {{c|.config}}. Cependant sur chaque ordi est présent un {{c|/Data}} de très grande taille ou tout le monde peut travailler.

Pour résoudre le problème de manque de place plusieurs étapes

== Identifier ce qui prend de la place ==

du -hc ~/ 2>/dev/null | grep -E '^([0-9]|,|\.)+G'

Cette commande permet de savoir ce qui fait au moins un giga dans ses dossiers.

Si c'est pip qui prend trop de place on peut exécuter
pip cache purge
pour nettoyer un peu tout ces vieux paquets dont on ne se sert plus.

Mais plus puissant que pip est {{c|uv}}.
= uv =
== Introduction ==

[https://docs.astral.sh/uv/ uv] est un "An extremely fast Python package and project manager, written in Rust."
Il permet de gérer plusieurs versions de python, plusieurs versions des paquets, des environnements de dev, de prod, le tout en étant incomparablement plus rapide que vanilla pip ou que poetry... Bref je [l'auteur de ce tuto, ndlr] suis fan.

== Installation de uv ==

Pour installer UV :
curl -LsSf https://astral.sh/uv/install.sh | sh
C'est tout

== Initialisation d'un projet avec uv ==

Pour initialiser un nouveau projet avec uv, suivez ces étapes :

mkdir projet-de-ouf
cd projet-de-ouf
uv init

uv s'occupe des conflits de dépendances, de l'installation des paquets, de la gestion du venv, le tout avec le {{c|pyproject.toml}} qui est son fichier de configuration, qu'il gère automatiquement.

=== Ajout d'un paquet au venv ===

Oubliez pip install faites place à {{c|uv add}}, par expemple pour ajouter pytorch
uv add torch
Pour vérifier qu'il a bien été ajouté au projet vous pouvez consulter le {{c|pyproject.toml}} et voir que le paquet à bien été ajouté avec la bonne version.
Attention : le venv n'est pas créé jusqu'à ce que vous demandiez à uv d'exécuter quelque chose comme le hello.py qu'il crée automatiquement ou juste python
uv run python
uv run python hello.py
Mais pas besoin de créer le venv pour configurer tous les paquets

=== Changement de la version de python ===
uv créé automatiquement un {{c|.python-version}} dans lequel il suppose la version de python qui vous intéresse, si vous voulez la changer, vous pouvez le faire dans ce fichier. Attention cependant à modifier conjointement le {{c|pyproject.toml}} pour les dépendances et bien préciser que les versions des paquets doivent être compatibles avec toutes les versions de python à partir de 3.8 si vous voulez, même si la version de python est 3.12.

=== Execution d'un programme ===
Pour exécuter un programme qui s'appelle {{c|hello.py}} par exemple
uv run python hello.py

Si le venv n'a pas été créé avant c'est maintenant que uv va le créer et installer les paquets avec les versions spécifiées dans le {{c|pyproject.toml}}

=== Attention ===
La commande {{c|uv pip install}} existe encore mais ne rajoute pas le paquet au venv elle va l'installer, mais vous ne saurez pas quelle version, cette commande est donc à remplacer par {{c|uv add}}

== Gestion du cache ==

Un des atouts de uv est qu'il a une très bonne gestion du cache, pour que l'installation de paquets donc vous avez souvent besoin soit plus rapide. Seul bémol cela peut remplir votre {{c|~/.cache}}. Si vous voulez nettoyer le cache vous pouvez exécuter {{c|uv cache purge}} ce qui est un peu agressif, ou lire [https://docs.astral.sh/uv/concepts/cache/ la documentation de uv sur le cache].
Vous pouvez aussi installer un paquet sans le 'cacher' avec
uv add torch --no-cache
Voire même en lui spécifiant le dossier de cache que vous voulez utiliser (cf la doc de uv)

== Utilisation du venv dans vscode ==
Une fois que uv a créé le venv vous pouvez l'utiliser comme un venv normal avec vscode en précisant le chemin de votre venv s'il n'est pas dans votre dossier de travail.

== uv et git ==

quand on exécute la commande {{c|uv init}} il crée aussi un repo git. Profitez-en !! Apprenez à utiliser [[git]] pour ne pas perdre votre travail, à chaque itération et comparer ce que vous avez fait à chaque modification.

== Lancement de jupyter avec uv - execution de code à distance ==
Pour les personnes qui ont tellement streamliné leur processus de développement avec un environement de dev sur leur machine mais un serveur jupyter distant pour exécuter le code.
ssh -L localhost:8888:localhost:8888 prenom.nom@thon.polytechnique.fr
cd foo/bar
uv init
uv add jupyter
uv run jupyter notebook --no-browser --port=8888 &
disown %1
Copier la ligne du genre http://localhost:8888/tree?token=36b32207109218c28fec0772a8471b320ec2177a27443e2f qui vient d'apparaître et dans vscode cliquer sur {{c|Select kernel -> Existing jupyter server}} coller ce que vous venez de copier, dans la prochaine case nommez votre serveur (par exemple "thon v1"), et sélectionner kernel python. Le tour est joué, votre code est sauvé sur votre machine mais exécuté à distance sur tanche. Si la dsi éteint l'ordi pendant les vacances alors vous aurez encore tout votre code.

Pour tuer le serveur vous pouvez récupérer le PID de votre processus et le tuer avec
kill $(jobs -l | cut -d ' ' -f 2)
ou alors le tuer avec {{c|pkill uv}} mais vous allez aussi tuer les processus des autres ce qui est pas cool, donc évitez svp

Attention : pensez à régulièrement synchroniser votre pyproject.toml (avec git par exemple) pour que les versions que vous ajoutez sur votre dossier local (sur votre ordinateur) soit les mêmes que celles que fait tourner uv sur l'ordi du labo.

Setup uv TD info

2025-02-21T15:44:59Z

Jean-nicolas.strauss :

= Gérer son stockage sur les ordis des labos =

C'est un des problèmes les plus communs de l'X que de se retrouver avec une erreur du genre {{c|Disk quota exceeded (os error 122)}}.
Ce qu'il se passe c'est qu'il y a 30Go partagés par tous les ordis des salles de TP, donc si vous mettez un fichier dans {{c|~/foo/bar}} vous allez le retrouver dans tous les autres ordis, c'est notamment le cas du dossier {{c|.ssh}} et le dossier {{c|.config}}. Cependant sur chaque ordi est présent un {{c|/Data}} de très grande taille ou tout le monde peut travailler.

Pour résoudre le problème de manque de place plusieurs étapes

== Identifier ce qui prend de la place ==

du -hc ~/ 2>/dev/null | grep -E '^([0-9]|,|\.)+G'

Cette commande permet de savoir ce qui fait au moins un giga dans ses dossiers.

Si c'est pip qui prend trop de place on peut exécuter
pip cache purge
pour nettoyer un peu tout ces vieux paquets dont on ne se sert plus.

Mais plus puissant que pip est {{c|uv}}.
= uv =
== Introduction ==

[https://docs.astral.sh/uv/ uv] est un "An extremely fast Python package and project manager, written in Rust."
Il permet de gérer plusieurs versions de python, plusieurs versions des paquets, des environnements de dev, de prod, le tout en étant incomparablement plus rapide que vanilla pip ou que poetry... Bref je [l'auteur de ce tuto, ndlr] suis fan.

== Installation de uv ==

Pour installer UV :
curl -LsSf https://astral.sh/uv/install.sh | sh
C'est tout

== Initialisation d'un Projet avec uv ==

Pour initialiser un nouveau projet avec uv, suivez ces étapes :

mkdir projet-de-ouf
cd projet-de-ouf
uv init

uv s'occupe des conflits de dépendances, de l'installation des paquets, de la gestion du venv, le tout avec le {{c|pyproject.toml}} qui est son fichier de configuration, qu'il gère automatiquement.

=== Ajout d'un paquet au venv ===

Oubliez pip install faites place à {{c|uv add}}, par expemple pour ajouter pytorch
uv add torch
Pour vérifier qu'il a bien été ajouté au projet vous pouvez consulter le {{c|pyproject.toml}} et voir que le paquet à bien été ajouté avec la bonne version.
Attention : le venv n'est pas créé jusqu'à ce que vous demandiez à uv d'exécuter quelque chose comme le hello.py qu'il crée automatiquement ou juste python
uv run python
uv run python hello.py
Mais pas besoin de créer le venv pour configurer tous les paquets

=== Changement de la version de python ===
uv créé automatiquement un {{c|.python-version}} dans lequel il suppose la version de python qui vous intéresse, si vous voulez la changer, vous pouvez le faire dans ce fichier. Attention cependant à modifier conjointement le {{c|pyproject.toml}} pour les dépendances et bien préciser que les versions des paquets doivent être compatibles avec toutes les versions de python à partir de 3.8 si vous voulez, même si la version de python est 3.12.

=== Execution d'un programme ===
Pour exécuter un programme qui s'appelle {{c|hello.py}} par exemple
uv run python hello.py

Si le venv n'a pas été créé avant c'est maintenant que uv va le créer et installer les paquets avec les versions spécifiées dans le {{c|pyproject.toml}}

=== Attention ===
La commande {{c|uv pip install}} existe encore mais ne rajoute pas le paquet au venv elle va l'installer, mais vous ne saurez pas quelle version, cette commande est donc à remplacer par {{c|uv add}}

== Gestion du cache ==

Un des atouts de uv est qu'il a une très bonne gestion du cache, pour que l'installation de paquets donc vous avez souvent besoin soit plus rapide. Seul bémol cela peut remplir votre {{c|~/.cache}}. Si vous voulez nettoyer le cache vous pouvez exécuter {{c|uv cache purge}} ce qui est un peu agressif, ou lire [https://docs.astral.sh/uv/concepts/cache/ la documentation de uv sur le cache].
Vous pouvez aussi installer un paquet sans le 'cacher' avec
uv add torch --no-cache
Voire même en lui spécifiant le dossier de cache que vous voulez utiliser (cf la doc de uv)

== Utilisation du venv dans vscode ==
Une fois que uv a créé le venv vous pouvez l'utiliser comme un venv normal avec vscode en précisant le chemin de votre venv s'il n'est pas dans votre dossier de travail.

== uv et git ==

quand on exécute la commande {{c|uv init}} il crée aussi un repo git. Profitez-en !! Apprenez à utiliser [[git]] pour ne pas perdre votre travail, à chaque itération et comparer ce que vous avez fait à chaque modification.

== Lancement de jupyter avec uv - execution de code à distance ==
Pour les personnes qui ont tellement streamliné leur processus de développement avec un environement de dev sur leur machine mais un serveur jupyter distant pour exécuter le code.
ssh -L localhost:8888:localhost:8888 prenom.nom@thon.polytechnique.fr
cd foo/bar
uv init
uv add jupyter
uv run jupyter notebook --no-browser --port=8888 &
disown %1
Copier la ligne du genre http://localhost:8888/tree?token=36b32207109218c28fec0772a8471b320ec2177a27443e2f qui vient d'apparaître et dans vscode cliquer sur {{c|Select kernel -> Existing jupyter server}} coller ce que vous venez de copier, dans la prochaine case nommez votre serveur (par exemple "thon v1"), et sélectionner kernel python. Le tour est joué, votre code est sauvé sur votre machine mais exécuté à distance sur tanche. Si la dsi éteint l'ordi pendant les vacances alors vous aurez encore tout votre code.

Pour tuer le serveur vous pouvez récupérer le PID de votre processus et le tuer avec
kill $(jobs -l | cut -d ' ' -f 2)
ou alors le tuer avec {{c|pkill uv}} mais vous allez aussi tuer les processus des autres ce qui est pas cool, donc évitez svp

Attention : pensez à régulièrement synchroniser votre pyproject.toml (avec git par exemple) pour que les versions que vous ajoutez sur votre dossier local (sur votre ordinateur) soit les mêmes que celles que fait tourner uv sur l'ordi du labo.

Setup uv TD info

2025-02-21T15:44:38Z

Jean-nicolas.strauss : changement de l'arborescence

= Gérer son stockage sur les ordis des labos =

C'est un des problèmes les plus communs de l'X que de se retrouver avec une erreur du genre {{c|Disk quota exceeded (os error 122)}}.
Ce qu'il se passe c'est qu'il y a 30Go partagés par tous les ordis des salles de TP, donc si vous mettez un fichier dans {{c|~/foo/bar}} vous allez le retrouver dans tous les autres ordis, c'est notamment le cas du dossier {{c|.ssh}} et le dossier {{c|.config}}. Cependant sur chaque ordi est présent un {{c|/Data}} de très grande taille ou tout le monde peut travailler.

Pour résoudre le problème de manque de place plusieurs étapes

== Identifier ce qui prend de la place ==

du -hc ~/ 2>/dev/null | grep -E '^([0-9]|,|\.)+G'

Cette commande permet de savoir ce qui fait au moins un giga dans ses dossiers.

Si c'est pip qui prend trop de place on peut exécuter
pip cache purge
pour nettoyer un peu tout ces vieux paquets dont on ne se sert plus.

Mais plus puissant que pip est {{c|uv}}.

= Introduction =

[https://docs.astral.sh/uv/ uv] est un "An extremely fast Python package and project manager, written in Rust."
Il permet de gérer plusieurs versions de python, plusieurs versions des paquets, des environnements de dev, de prod, le tout en étant incomparablement plus rapide que vanilla pip ou que poetry... Bref je [l'auteur de ce tuto, ndlr] suis fan.

== Installation de uv ==

Pour installer UV :
curl -LsSf https://astral.sh/uv/install.sh | sh
C'est tout

== Initialisation d'un Projet avec uv ==

Pour initialiser un nouveau projet avec uv, suivez ces étapes :

mkdir projet-de-ouf
cd projet-de-ouf
uv init

uv s'occupe des conflits de dépendances, de l'installation des paquets, de la gestion du venv, le tout avec le {{c|pyproject.toml}} qui est son fichier de configuration, qu'il gère automatiquement.

=== Ajout d'un paquet au venv ===

Oubliez pip install faites place à {{c|uv add}}, par expemple pour ajouter pytorch
uv add torch
Pour vérifier qu'il a bien été ajouté au projet vous pouvez consulter le {{c|pyproject.toml}} et voir que le paquet à bien été ajouté avec la bonne version.
Attention : le venv n'est pas créé jusqu'à ce que vous demandiez à uv d'exécuter quelque chose comme le hello.py qu'il crée automatiquement ou juste python
uv run python
uv run python hello.py
Mais pas besoin de créer le venv pour configurer tous les paquets

=== Changement de la version de python ===
uv créé automatiquement un {{c|.python-version}} dans lequel il suppose la version de python qui vous intéresse, si vous voulez la changer, vous pouvez le faire dans ce fichier. Attention cependant à modifier conjointement le {{c|pyproject.toml}} pour les dépendances et bien préciser que les versions des paquets doivent être compatibles avec toutes les versions de python à partir de 3.8 si vous voulez, même si la version de python est 3.12.

=== Execution d'un programme ===
Pour exécuter un programme qui s'appelle {{c|hello.py}} par exemple
uv run python hello.py

Si le venv n'a pas été créé avant c'est maintenant que uv va le créer et installer les paquets avec les versions spécifiées dans le {{c|pyproject.toml}}

=== Attention ===
La commande {{c|uv pip install}} existe encore mais ne rajoute pas le paquet au venv elle va l'installer, mais vous ne saurez pas quelle version, cette commande est donc à remplacer par {{c|uv add}}

== Gestion du cache ==

Un des atouts de uv est qu'il a une très bonne gestion du cache, pour que l'installation de paquets donc vous avez souvent besoin soit plus rapide. Seul bémol cela peut remplir votre {{c|~/.cache}}. Si vous voulez nettoyer le cache vous pouvez exécuter {{c|uv cache purge}} ce qui est un peu agressif, ou lire [https://docs.astral.sh/uv/concepts/cache/ la documentation de uv sur le cache].
Vous pouvez aussi installer un paquet sans le 'cacher' avec
uv add torch --no-cache
Voire même en lui spécifiant le dossier de cache que vous voulez utiliser (cf la doc de uv)

== Utilisation du venv dans vscode ==
Une fois que uv a créé le venv vous pouvez l'utiliser comme un venv normal avec vscode en précisant le chemin de votre venv s'il n'est pas dans votre dossier de travail.

== uv et git ==

quand on exécute la commande {{c|uv init}} il crée aussi un repo git. Profitez-en !! Apprenez à utiliser [[git]] pour ne pas perdre votre travail, à chaque itération et comparer ce que vous avez fait à chaque modification.

== Lancement de jupyter avec uv - execution de code à distance ==
Pour les personnes qui ont tellement streamliné leur processus de développement avec un environement de dev sur leur machine mais un serveur jupyter distant pour exécuter le code.
ssh -L localhost:8888:localhost:8888 prenom.nom@thon.polytechnique.fr
cd foo/bar
uv init
uv add jupyter
uv run jupyter notebook --no-browser --port=8888 &
disown %1
Copier la ligne du genre http://localhost:8888/tree?token=36b32207109218c28fec0772a8471b320ec2177a27443e2f qui vient d'apparaître et dans vscode cliquer sur {{c|Select kernel -> Existing jupyter server}} coller ce que vous venez de copier, dans la prochaine case nommez votre serveur (par exemple "thon v1"), et sélectionner kernel python. Le tour est joué, votre code est sauvé sur votre machine mais exécuté à distance sur tanche. Si la dsi éteint l'ordi pendant les vacances alors vous aurez encore tout votre code.

Pour tuer le serveur vous pouvez récupérer le PID de votre processus et le tuer avec
kill $(jobs -l | cut -d ' ' -f 2)
ou alors le tuer avec {{c|pkill uv}} mais vous allez aussi tuer les processus des autres ce qui est pas cool, donc évitez svp

Attention : pensez à régulièrement synchroniser votre pyproject.toml (avec git par exemple) pour que les versions que vous ajoutez sur votre dossier local (sur votre ordinateur) soit les mêmes que celles que fait tourner uv sur l'ordi du labo.

Setup uv TD info

2025-02-21T15:43:24Z

Jean-nicolas.strauss : tanche -> thon

= Gérer son stockage sur les ordis des labos =

C'est un des problèmes les plus communs de l'X que de se retrouver avec une erreur du genre {{c|Disk quota exceeded (os error 122)}}.
Ce qu'il se passe c'est qu'il y a 30Go partagés par tous les ordis des salles de TP, donc si vous mettez un fichier dans {{c|~/foo/bar}} vous allez le retrouver dans tous les autres ordis, c'est notamment le cas du dossier {{c|.ssh}} et le dossier {{c|.config}}. Cependant sur chaque ordi est présent un {{c|/Data}} de très grande taille ou tout le monde peut travailler.

Pour résoudre le problème de manque de place plusieurs étapes

== Identifier ce qui prend de la place ==

du -hc ~/ 2>/dev/null | grep -E '^([0-9]|,|\.)+G'

Cette commande permet de savoir ce qui fait au moins un giga dans ses dossiers.

Si c'est pip qui prend trop de place on peut exécuter
pip cache purge
pour nettoyer un peu tout ces vieux paquets dont on ne se sert plus.

Mais plus puissant que pip est {{c|uv}}.

== Introduction ==

[https://docs.astral.sh/uv/ uv] est un "An extremely fast Python package and project manager, written in Rust."
Il permet de gérer plusieurs versions de python, plusieurs versions des paquets, des environnements de dev, de prod, le tout en étant incomparablement plus rapide que vanilla pip ou que poetry... Bref je [l'auteur de ce tuto, ndlr] suis fan.

== Installation de uv ==

Pour installer UV :
curl -LsSf https://astral.sh/uv/install.sh | sh
C'est tout

== Initialisation d'un Projet avec uv ==

Pour initialiser un nouveau projet avec uv, suivez ces étapes :

mkdir projet-de-ouf
cd projet-de-ouf
uv init

uv s'occupe des conflits de dépendances, de l'installation des paquets, de la gestion du venv, le tout avec le {{c|pyproject.toml}} qui est son fichier de configuration, qu'il gère automatiquement.

=== Ajout d'un paquet au venv ===

Oubliez pip install faites place à {{c|uv add}}, par expemple pour ajouter pytorch
uv add torch
Pour vérifier qu'il a bien été ajouté au projet vous pouvez consulter le {{c|pyproject.toml}} et voir que le paquet à bien été ajouté avec la bonne version.
Attention : le venv n'est pas créé jusqu'à ce que vous demandiez à uv d'exécuter quelque chose comme le hello.py qu'il crée automatiquement ou juste python
uv run python
uv run python hello.py
Mais pas besoin de créer le venv pour configurer tous les paquets

=== Changement de la version de python ===
uv créé automatiquement un {{c|.python-version}} dans lequel il suppose la version de python qui vous intéresse, si vous voulez la changer, vous pouvez le faire dans ce fichier. Attention cependant à modifier conjointement le {{c|pyproject.toml}} pour les dépendances et bien préciser que les versions des paquets doivent être compatibles avec toutes les versions de python à partir de 3.8 si vous voulez, même si la version de python est 3.12.

=== Execution d'un programme ===
Pour exécuter un programme qui s'appelle {{c|hello.py}} par exemple
uv run python hello.py

Si le venv n'a pas été créé avant c'est maintenant que uv va le créer et installer les paquets avec les versions spécifiées dans le {{c|pyproject.toml}}

=== Attention ===
La commande {{c|uv pip install}} existe encore mais ne rajoute pas le paquet au venv elle va l'installer, mais vous ne saurez pas quelle version, cette commande est donc à remplacer par {{c|uv add}}

== Gestion du cache ==

Un des atouts de uv est qu'il a une très bonne gestion du cache, pour que l'installation de paquets donc vous avez souvent besoin soit plus rapide. Seul bémol cela peut remplir votre {{c|~/.cache}}. Si vous voulez nettoyer le cache vous pouvez exécuter {{c|uv cache purge}} ce qui est un peu agressif, ou lire [https://docs.astral.sh/uv/concepts/cache/ la documentation de uv sur le cache].
Vous pouvez aussi installer un paquet sans le 'cacher' avec
uv add torch --no-cache
Voire même en lui spécifiant le dossier de cache que vous voulez utiliser (cf la doc de uv)

== Utilisation du venv dans vscode ==
Une fois que uv a créé le venv vous pouvez l'utiliser comme un venv normal avec vscode en précisant le chemin de votre venv s'il n'est pas dans votre dossier de travail.

== uv et git ==

quand on exécute la commande {{c|uv init}} il crée aussi un repo git. Profitez-en !! Apprenez à utiliser [[git]] pour ne pas perdre votre travail, à chaque itération et comparer ce que vous avez fait à chaque modification.

== Lancement de jupyter avec uv - execution de code à distance ==
Pour les personnes qui ont tellement streamliné leur processus de développement avec un environement de dev sur leur machine mais un serveur jupyter distant pour exécuter le code.
ssh -L localhost:8888:localhost:8888 prenom.nom@thon.polytechnique.fr
cd foo/bar
uv init
uv add jupyter
uv run jupyter notebook --no-browser --port=8888 &
disown %1
Copier la ligne du genre http://localhost:8888/tree?token=36b32207109218c28fec0772a8471b320ec2177a27443e2f qui vient d'apparaître et dans vscode cliquer sur {{c|Select kernel -> Existing jupyter server}} coller ce que vous venez de copier, dans la prochaine case nommez votre serveur (par exemple "thon v1"), et sélectionner kernel python. Le tour est joué, votre code est sauvé sur votre machine mais exécuté à distance sur tanche. Si la dsi éteint l'ordi pendant les vacances alors vous aurez encore tout votre code.

Pour tuer le serveur vous pouvez récupérer le PID de votre processus et le tuer avec
kill $(jobs -l | cut -d ' ' -f 2)
ou alors le tuer avec {{c|pkill uv}} mais vous allez aussi tuer les processus des autres ce qui est pas cool, donc évitez svp

Attention : pensez à régulièrement synchroniser votre pyproject.toml (avec git par exemple) pour que les versions que vous ajoutez sur votre dossier local (sur votre ordinateur) soit les mêmes que celles que fait tourner uv sur l'ordi du labo.

Setup uv TD info

2025-02-21T15:42:10Z

Jean-nicolas.strauss : /* Lancement de jupyter avec uv - execution de code à distance */

= Gérer son stockage sur les ordis des labos =

C'est un des problèmes les plus communs de l'X que de se retrouver avec une erreur du genre {{c|Disk quota exceeded (os error 122)}}.
Ce qu'il se passe c'est qu'il y a 30Go partagés par tous les ordis des salles de TP, donc si vous mettez un fichier dans {{c|~/foo/bar}} vous allez le retrouver dans tous les autres ordis, c'est notamment le cas du dossier {{c|.ssh}} et le dossier {{c|.config}}. Cependant sur chaque ordi est présent un {{c|/Data}} de très grande taille ou tout le monde peut travailler.

Pour résoudre le problème de manque de place plusieurs étapes

== Identifier ce qui prend de la place ==

du -hc ~/ 2>/dev/null | grep -E '^([0-9]|,|\.)+G'

Cette commande permet de savoir ce qui fait au moins un giga dans ses dossiers.

Si c'est pip qui prend trop de place on peut exécuter
pip cache purge
pour nettoyer un peu tout ces vieux paquets dont on ne se sert plus.

Mais plus puissant que pip est {{c|uv}}.

== Introduction ==

[https://docs.astral.sh/uv/ uv] est un "An extremely fast Python package and project manager, written in Rust."
Il permet de gérer plusieurs versions de python, plusieurs versions des paquets, des environnements de dev, de prod, le tout en étant incomparablement plus rapide que vanilla pip ou que poetry... Bref je [l'auteur de ce tuto, ndlr] suis fan.

== Installation de uv ==

Pour installer UV :
curl -LsSf https://astral.sh/uv/install.sh | sh
C'est tout

== Initialisation d'un Projet avec uv ==

Pour initialiser un nouveau projet avec uv, suivez ces étapes :

mkdir projet-de-ouf
cd projet-de-ouf
uv init

uv s'occupe des conflits de dépendances, de l'installation des paquets, de la gestion du venv, le tout avec le {{c|pyproject.toml}} qui est son fichier de configuration, qu'il gère automatiquement.

=== Ajout d'un paquet au venv ===

Oubliez pip install faites place à {{c|uv add}}, par expemple pour ajouter pytorch
uv add torch
Pour vérifier qu'il a bien été ajouté au projet vous pouvez consulter le {{c|pyproject.toml}} et voir que le paquet à bien été ajouté avec la bonne version.
Attention : le venv n'est pas créé jusqu'à ce que vous demandiez à uv d'exécuter quelque chose comme le hello.py qu'il crée automatiquement ou juste python
uv run python
uv run python hello.py
Mais pas besoin de créer le venv pour configurer tous les paquets

=== Changement de la version de python ===
uv créé automatiquement un {{c|.python-version}} dans lequel il suppose la version de python qui vous intéresse, si vous voulez la changer, vous pouvez le faire dans ce fichier. Attention cependant à modifier conjointement le {{c|pyproject.toml}} pour les dépendances et bien préciser que les versions des paquets doivent être compatibles avec toutes les versions de python à partir de 3.8 si vous voulez, même si la version de python est 3.12.

=== Execution d'un programme ===
Pour exécuter un programme qui s'appelle {{c|hello.py}} par exemple
uv run python hello.py

Si le venv n'a pas été créé avant c'est maintenant que uv va le créer et installer les paquets avec les versions spécifiées dans le {{c|pyproject.toml}}

=== Attention ===
La commande {{c|uv pip install}} existe encore mais ne rajoute pas le paquet au venv elle va l'installer, mais vous ne saurez pas quelle version, cette commande est donc à remplacer par {{c|uv add}}

== Gestion du cache ==

Un des atouts de uv est qu'il a une très bonne gestion du cache, pour que l'installation de paquets donc vous avez souvent besoin soit plus rapide. Seul bémol cela peut remplir votre {{c|~/.cache}}. Si vous voulez nettoyer le cache vous pouvez exécuter {{c|uv cache purge}} ce qui est un peu agressif, ou lire [https://docs.astral.sh/uv/concepts/cache/ la documentation de uv sur le cache].
Vous pouvez aussi installer un paquet sans le 'cacher' avec
uv add torch --no-cache
Voire même en lui spécifiant le dossier de cache que vous voulez utiliser (cf la doc de uv)

== Utilisation du venv dans vscode ==
Une fois que uv a créé le venv vous pouvez l'utiliser comme un venv normal avec vscode en précisant le chemin de votre venv s'il n'est pas dans votre dossier de travail.

== uv et git ==

quand on exécute la commande {{c|uv init}} il crée aussi un repo git. Profitez-en !! Apprenez à utiliser [[git]] pour ne pas perdre votre travail, à chaque itération et comparer ce que vous avez fait à chaque modification.

== Lancement de jupyter avec uv - execution de code à distance ==
Pour les personnes qui ont tellement streamliné leur processus de développement avec un environement de dev sur leur machine mais un serveur jupyter distant pour exécuter le code.
ssh -L localhost:8888:localhost:8888 prenom.nom@tanche.polytechnique.fr
cd foo/bar
uv init
uv add jupyter
uv run jupyter notebook --no-browser --port=8888 &
disown %1
Copier la ligne du genre http://localhost:8888/tree?token=36b32207109218c28fec0772a8471b320ec2177a27443e2f qui vient d'apparaître et dans vscode cliquer sur {{c|Select kernel -> Existing jupyter server}} coller ce que vous venez de copier, dans la prochaine case nommez votre serveur (par exemple "tanche v1"), et sélectionner kernel python. Le tour est joué, votre code est sauvé sur votre machine mais exécuté à distance sur tanche. Si la dsi éteint l'ordi pendant les vacances alors vous aurez encore tout votre code.

Pour tuer le serveur vous pouvez récupérer le PID de votre processus et le tuer avec
kill $(jobs -l | cut -d ' ' -f 2)
ou alors le tuer avec {{c|pkill uv}} mais vous allez aussi tuer les processus des autres ce qui est pas cool, donc évitez svp

Attention : pensez à régulièrement synchroniser votre pyproject.toml (avec git par exemple) pour que les versions que vous ajoutez sur votre dossier local (sur votre ordinateur) soit les mêmes que celles que fait tourner uv sur l'ordi du labo.

Setup uv TD info

2025-02-21T15:35:58Z

Jean-nicolas.strauss : Ajout du dev à distance

= Gérer son stockage sur les ordis des labos =

C'est un des problèmes les plus communs de l'X que de se retrouver avec une erreur du genre {{c|Disk quota exceeded (os error 122)}}.
Ce qu'il se passe c'est qu'il y a 30Go partagés par tous les ordis des salles de TP, donc si vous mettez un fichier dans {{c|~/foo/bar}} vous allez le retrouver dans tous les autres ordis, c'est notamment le cas du dossier {{c|.ssh}} et le dossier {{c|.config}}. Cependant sur chaque ordi est présent un {{c|/Data}} de très grande taille ou tout le monde peut travailler.

Pour résoudre le problème de manque de place plusieurs étapes

== Identifier ce qui prend de la place ==

du -hc ~/ 2>/dev/null | grep -E '^([0-9]|,|\.)+G'

Cette commande permet de savoir ce qui fait au moins un giga dans ses dossiers.

Si c'est pip qui prend trop de place on peut exécuter
pip cache purge
pour nettoyer un peu tout ces vieux paquets dont on ne se sert plus.

Mais plus puissant que pip est {{c|uv}}.

== Introduction ==

[https://docs.astral.sh/uv/ uv] est un "An extremely fast Python package and project manager, written in Rust."
Il permet de gérer plusieurs versions de python, plusieurs versions des paquets, des environnements de dev, de prod, le tout en étant incomparablement plus rapide que vanilla pip ou que poetry... Bref je [l'auteur de ce tuto, ndlr] suis fan.

== Installation de uv ==

Pour installer UV :
curl -LsSf https://astral.sh/uv/install.sh | sh
C'est tout

== Initialisation d'un Projet avec uv ==

Pour initialiser un nouveau projet avec uv, suivez ces étapes :

mkdir projet-de-ouf
cd projet-de-ouf
uv init

uv s'occupe des conflits de dépendances, de l'installation des paquets, de la gestion du venv, le tout avec le {{c|pyproject.toml}} qui est son fichier de configuration, qu'il gère automatiquement.

=== Ajout d'un paquet au venv ===

Oubliez pip install faites place à {{c|uv add}}, par expemple pour ajouter pytorch
uv add torch
Pour vérifier qu'il a bien été ajouté au projet vous pouvez consulter le {{c|pyproject.toml}} et voir que le paquet à bien été ajouté avec la bonne version.
Attention : le venv n'est pas créé jusqu'à ce que vous demandiez à uv d'exécuter quelque chose comme le hello.py qu'il crée automatiquement ou juste python
uv run python
uv run python hello.py
Mais pas besoin de créer le venv pour configurer tous les paquets

=== Changement de la version de python ===
uv créé automatiquement un {{c|.python-version}} dans lequel il suppose la version de python qui vous intéresse, si vous voulez la changer, vous pouvez le faire dans ce fichier. Attention cependant à modifier conjointement le {{c|pyproject.toml}} pour les dépendances et bien préciser que les versions des paquets doivent être compatibles avec toutes les versions de python à partir de 3.8 si vous voulez, même si la version de python est 3.12.

=== Execution d'un programme ===
Pour exécuter un programme qui s'appelle {{c|hello.py}} par exemple
uv run python hello.py

Si le venv n'a pas été créé avant c'est maintenant que uv va le créer et installer les paquets avec les versions spécifiées dans le {{c|pyproject.toml}}

=== Attention ===
La commande {{c|uv pip install}} existe encore mais ne rajoute pas le paquet au venv elle va l'installer, mais vous ne saurez pas quelle version, cette commande est donc à remplacer par {{c|uv add}}

== Gestion du cache ==

Un des atouts de uv est qu'il a une très bonne gestion du cache, pour que l'installation de paquets donc vous avez souvent besoin soit plus rapide. Seul bémol cela peut remplir votre {{c|~/.cache}}. Si vous voulez nettoyer le cache vous pouvez exécuter {{c|uv cache purge}} ce qui est un peu agressif, ou lire [https://docs.astral.sh/uv/concepts/cache/ la documentation de uv sur le cache].
Vous pouvez aussi installer un paquet sans le 'cacher' avec
uv add torch --no-cache
Voire même en lui spécifiant le dossier de cache que vous voulez utiliser (cf la doc de uv)

== Utilisation du venv dans vscode ==
Une fois que uv a créé le venv vous pouvez l'utiliser comme un venv normal avec vscode en précisant le chemin de votre venv s'il n'est pas dans votre dossier de travail.

== uv et git ==

quand on exécute la commande {{c|uv init}} il crée aussi un repo git. Profitez-en !! Apprenez à utiliser [[git]] pour ne pas perdre votre travail, à chaque itération et comparer ce que vous avez fait à chaque modification.

== Lancement de jupyter avec uv - execution de code à distance ==
Pour les personnes qui ont tellement streamliné leur processus de développement avec un environement de dev sur leur machine mais un serveur jupyter distant pour exécuter le code.
ssh -L localhost:8888:localhost:8888 prenom.nom@tanche.polytechnique.fr
cd foo/bar
uv init
uv add jupyter
uv run jupyter notebook --no-browser --port=8888 &
disown %1
Copier la ligne du genre http://localhost:8888/tree?token=36b32207109218c28fec0772a8471b320ec2177a27443e2f qui vient d'apparaître et dans vscode cliquer sur {{c|Select kernel -> Existing jupyter server}} coller ce que vous venez de copier, dans la prochaine case nommez votre serveur (par exemple "tanche v1"), et sélectionner kernel python. Le tour est joué, votre code est sauvé sur votre machine mais exécuté à distance sur tanche. Si la dsi éteint l'ordi pendant les vacances alors vous aurez encore tout votre code.

Attention : pensez à régulièrement synchroniser votre pyproject.toml (avec git par exemple) pour que les versions que vous ajoutez sur votre dossier local (sur votre ordinateur) soit les mêmes que celles que fait tourner uv sur l'ordi du labo.

Setup uv TD info

2025-02-21T15:23:47Z

Jean-nicolas.strauss : Création page stockage salles de TP et installation uv

Hébergement des sites des binets

2024-09-09T01:44:21Z

Jean-nicolas.strauss : typo

{{menu services}}
[[Catégorie:Services]]

Le BR propose aux binets qui le désirent d'héberger gratuitement leur site web.

Cet hébergement s'organise selon deux formules, avec ou sans la possibilité d'accéder au site de l'extérieur du Plâtal.

Pour demander l'hébergement de ton site, [https://panix.binets.fr ouvre une tâche Panix] en précisant l'identifiant du groupe/binet au nom duquel tu fais la demande (si tu ne le connais pas, donne le lien vers le groupe/binet sur Sigma).

'''Réfléchis bien a quel va être le cahier des charges de ton site avant de te lancer.''' S'il n'est qu'un blog n'hésite pas à chercher des solutions permettant de t'éviter de développer un site ''from scratch'' en php ou avec django, et penche toi du côté de solutions telles que jekyll, hugo avec forestry, nextjs avec vercel et plein d'autres. Si ton site aura besoin d'un vrai backend dans ce cas poursuis ta lecture.

Tu peux également demander à mettre une [[authentification CAS]], [[openID]], ou encore protéger ton site par un portail d'authentification global si ton site est déployé sous docker (i.e. tu peux considérer que l'utilisateur est déjà connecté une fois sur le site).

En fonction des technologies utilisées, on a différents tuto à te proposer:
* un [[Tuto pour le déploiement des sites Django]] des sites binets codés en django/flask/(tout ce qui supporte uwsgi).
* un [[Tuto pour le déploiement des sites avec Docker]] pour n'importe quel site.
Et sinon n'hésite pas à aller voir vers d'autres langages et frameworks, il en existe pléthores, et pour des tonnes de langages, que ce soit du js jusqu'au haskell en passant par le python, le go, le rust et tant d'autres.

Les sites internes en php sont hébergés sur [[Admin:Ostizan | Ostizan]] mais devraient être migrés.

{{Attention|Nous n'acceptons plus de demandes d'hébergement sur [[Admin:Ostizan | Ostizan]]. Si votre site est actuellement hébergé dessus n'hésitez pas à entrer en contact avec le [[BR]] (cf [[Accueil]]) pour le migrer sur [[Admin:Endalcher|Endalcher]] avec le [[Tuto pour le déploiement des sites avec Docker]]}}
== Modalités techniques de l'hébergement sur Ostizan==
L'hébergement classique offert par le BR présente les caractéristiques suivantes :
* Capacité de stockage limitée à 200Mo par défaut. Il est possible d'obtenir plus sur demande.
* Serveur apache avec PHP 7
* Base de données MySQL
* Accès en HTTPS/HTTP
* Hébergement Django/Flask avec uWSGI

Si vous avez des besoins plus spécifiques, n'hésitez pas à nous en parler.

== Accès au site ==

L'administration du site se fait par [[SSH]]. Il est ouvert à tous les administrateurs du binet considéré, et à eux seuls. Pour cela, utilisez vos identifiants Sigma. Exemple de commande à utiliser : <code>ssh prenom.nom@id_sigma.binets.fr</code>, puis rentrez votre mot de passe lorsque celui vous est demandé.

L'écriture du site est bien entendu à la charge du webmaster du binet ; en cas de nécessité et pour une raison valable, un BRman pourra cependant proposer son aide.

L'adresse du site est alors mon_binet.binets.fr ou mon_binet.binets.eleves.polytechnique.fr ;

La base de données MySQL est accessible par un PhpMyAdmin : [http://phpmyadmin.binets.fr/ http://phpmyadmin.binets.fr/]. Le nom d'utilisateur correspond au nom du binet tel qu'il apparaît dans le nom de domaine. Le mot de passe a été donné au binet à la création de la base SQL ; le BR ne le possède pas et vous devez le passer à vos successeurs pour éviter de le perdre à tout jamais.

=== Modification des fichiers du site ===

Les fichiers se situent sur le serveur ostizan, dans le répertoire

<pre lang="sh">/hosting/www/nom_binet/</pre>

==== Avec Git (recommandé) ====

ostizan dispose d’une installation [[Git]].

Avec Git, vous pouvez garder un historique des versions successives de votre site, travailler à plusieurs, revenir en arrière quand vous avez cassé quelque chose, savoir qui a modifié quoi, quand … C’est un outil très puissant.

'''Prérequis :''' ''avoir une clef [[SSH]] activée sur votre compte sur ostizan''

Pour savoir comment configurer et construire un projet avec Git, référez-vous à la documentation. Vous pouvez héberger votre code chez nous sur [https://gitlab.binets.fr GitLab].

Naviguez au dossier où vous voulez mettre votre site, par exemple <code>htdocs</code>:

<pre lang="sh">cd /hosting/www/nom_binet/htdocs</pre>
et initialisez un dépôt Git

<pre lang="sh">git init</pre>
Si cela a fonctionné, le terminal répondra

<pre>Initialized empty Git repository in /hosting/www/nom_binet/htdocs/.git</pre>
Ajoutez maintenant une ''remote'' qui pointera vers là où vous hébergez votre code, par exemple

<pre lang="sh">git remote add origin git@gitlab.binets.fr:domaine/site.git</pre>
pour un site dont le code est hébergé sur le GitLab, ou

Ensuite, faites

<pre lang="sh">git pull origin master</pre>
pour cloner le dépôt (si la ''remote'' que vous avez ajouté s’appelle <code>origin</code> et que votre code est sur la branche <code>master</code>).

==== En SFTP ====

Pour accéder aux fichiers, on peut utiliser un client sftp (comme [https://filezilla-project.org/download.php?type=client FileZilla] ou [https://winscp.net/eng/index.php WinSCP]) et accéder au serveur <code>sftp://id_sigma.binets.fr</code> sur le port 22.

Le serveur SFTP demande un login / mot de passe qui correspondent exactement à ceux du compte Sigma. Le dossier <code>sftp://id_sigma.binets.fr/www/id_sigma/htdocs/</code> correspond au site <code>http://id_sigma.binets.fr/</code>. Les fichiers qui ne sont pas dans htdocs ne sont pas accessibles directement par un navigateur, mais un script php peut y accéder.

=== Avec visibilité extérieure ===

Le BR a un partenariat avec la DSI qui lui permet d'exposer certains sites à l'extérieur. Ils feront l'objet d'[[un audit de sécurité]] par le BR et la DSI. Pour le passer, il faut respecter les dernières recommandations de sécurité, notamment pour tout ce qui est authentification, contenu dynamique. Notons cependant que cela ne devrait pas poser de problèmes pour les sites statiques.

Les sites souhaitant un site avec visibilité depuis l'extérieur doivent dorénavant respecter la charte suivante :

*Aucune information ne doit être diffusée qui pourrait nuire à l'image de l’École. (photos, vidéos, etc.)
*Le site doit avoir une qualité visuelle, si ce n'est professionnelle, du moins très correcte.
*Le site ne doit pas héberger de vidéos ou diffuser un flux vidéo (streaming). Toutes les vidéos du sites doivent être hébergées à l'extérieur. (Dalymotion, YouTube, etc.)
*Les images présentes sur le site ne doivent avoir une résolution suffisamment faible afin de ne pas saturer la bande passante vers l'extérieur.

{{Attention|Si le site concerne un événement extérieur avec un public de plus de 50 personnes, la DSI demande à ce que la DIRCOM soit prévenue.}}

== Quotas ==

Attention ! L'espace réservé à chaque binet est limité. Il faut se méfier quand on fait une copie, notamment a l'environnement virtuel. D'abord il pèse lourd, en plus il faudra que vous le remplaciez de toute façon. Autant ne pas le copier dès le départ...
Pour savoir si vous avez dépassé votre quota :
quota -sg
Cette commande affiche, pour chaque binet, l'espace utilisé, une «soft limit» et la vraie («hard») limit.

Hébergement des sites des binets

2024-09-09T01:43:43Z

Jean-nicolas.strauss : Conseille les binets de ne pas réinventer la roue

{{menu services}}
[[Catégorie:Services]]

Le BR propose aux binets qui le désirent d'héberger gratuitement leur site web.

Cet hébergement s'organise selon deux formules, avec ou sans la possibilité d'accéder au site de l'extérieur du Plâtal.

Pour demander l'hébergement de ton site, [https://panix.binets.fr ouvre une tâche Panix] en précisant l'identifiant du groupe/binet au nom duquel tu fais la demande (si tu ne le connais pas, donne le lien vers le groupe/binet sur Sigma).

'''Réfléchis bien a quel va être le cahier des charges de ton site avant de te lancer.''' S'il n'est qu'un blog n'hésite pas à chercher des solutions permettant de t'éviter de développer un site ''from scratch'' en php ou avec django, et penche toi du côté de solutions telles que jekyll, hugo avec forestry, nextjs avec vercel et plein d'autres. Si ton site aura besoin d'un vrai backend dans ce cas poursuis ta lecture.

Tu peux également demander à mettre une [[authentification CAS]], [[openID]], ou encore protéger ton site par un portail d'authentification global si ton site est déployé sous docker (i.e. tu peux considérer que l'utilisateur est déjà connecté une fois sur le site).

En fonction des technologies utilisées, on a différents tuto à te proposer:
* un [[Tuto pour le déploiement des sites Django]] des sites binets codés en django/flask/(tout ce qui supporte uwsgi).
* un [[Tuto pour le déploiement des sites avec Docker]] pour n'importe quel site.
Et sinon n'hésite pas à aller voir vers d'autres langages et frameworks, il en existe pléthores, et pour des tonnes de langages, que ce soit du python jusqu'au haskell en passant par le js, le go, le rust et tant d'autres.

Les sites internes en php sont hébergés sur [[Admin:Ostizan | Ostizan]] mais devraient être migrés.

{{Attention|Nous n'acceptons plus de demandes d'hébergement sur [[Admin:Ostizan | Ostizan]]. Si votre site est actuellement hébergé dessus n'hésitez pas à entrer en contact avec le [[BR]] (cf [[Accueil]]) pour le migrer sur [[Admin:Endalcher|Endalcher]] avec le [[Tuto pour le déploiement des sites avec Docker]]}}
== Modalités techniques de l'hébergement sur Ostizan==
L'hébergement classique offert par le BR présente les caractéristiques suivantes :
* Capacité de stockage limitée à 200Mo par défaut. Il est possible d'obtenir plus sur demande.
* Serveur apache avec PHP 7
* Base de données MySQL
* Accès en HTTPS/HTTP
* Hébergement Django/Flask avec uWSGI

Si vous avez des besoins plus spécifiques, n'hésitez pas à nous en parler.

== Accès au site ==

L'administration du site se fait par [[SSH]]. Il est ouvert à tous les administrateurs du binet considéré, et à eux seuls. Pour cela, utilisez vos identifiants Sigma. Exemple de commande à utiliser : <code>ssh prenom.nom@id_sigma.binets.fr</code>, puis rentrez votre mot de passe lorsque celui vous est demandé.

L'écriture du site est bien entendu à la charge du webmaster du binet ; en cas de nécessité et pour une raison valable, un BRman pourra cependant proposer son aide.

L'adresse du site est alors mon_binet.binets.fr ou mon_binet.binets.eleves.polytechnique.fr ;

La base de données MySQL est accessible par un PhpMyAdmin : [http://phpmyadmin.binets.fr/ http://phpmyadmin.binets.fr/]. Le nom d'utilisateur correspond au nom du binet tel qu'il apparaît dans le nom de domaine. Le mot de passe a été donné au binet à la création de la base SQL ; le BR ne le possède pas et vous devez le passer à vos successeurs pour éviter de le perdre à tout jamais.

=== Modification des fichiers du site ===

Les fichiers se situent sur le serveur ostizan, dans le répertoire

<pre lang="sh">/hosting/www/nom_binet/</pre>

==== Avec Git (recommandé) ====

ostizan dispose d’une installation [[Git]].

Avec Git, vous pouvez garder un historique des versions successives de votre site, travailler à plusieurs, revenir en arrière quand vous avez cassé quelque chose, savoir qui a modifié quoi, quand … C’est un outil très puissant.

'''Prérequis :''' ''avoir une clef [[SSH]] activée sur votre compte sur ostizan''

Pour savoir comment configurer et construire un projet avec Git, référez-vous à la documentation. Vous pouvez héberger votre code chez nous sur [https://gitlab.binets.fr GitLab].

Naviguez au dossier où vous voulez mettre votre site, par exemple <code>htdocs</code>:

<pre lang="sh">cd /hosting/www/nom_binet/htdocs</pre>
et initialisez un dépôt Git

<pre lang="sh">git init</pre>
Si cela a fonctionné, le terminal répondra

<pre>Initialized empty Git repository in /hosting/www/nom_binet/htdocs/.git</pre>
Ajoutez maintenant une ''remote'' qui pointera vers là où vous hébergez votre code, par exemple

<pre lang="sh">git remote add origin git@gitlab.binets.fr:domaine/site.git</pre>
pour un site dont le code est hébergé sur le GitLab, ou

Ensuite, faites

<pre lang="sh">git pull origin master</pre>
pour cloner le dépôt (si la ''remote'' que vous avez ajouté s’appelle <code>origin</code> et que votre code est sur la branche <code>master</code>).

==== En SFTP ====

Pour accéder aux fichiers, on peut utiliser un client sftp (comme [https://filezilla-project.org/download.php?type=client FileZilla] ou [https://winscp.net/eng/index.php WinSCP]) et accéder au serveur <code>sftp://id_sigma.binets.fr</code> sur le port 22.

Le serveur SFTP demande un login / mot de passe qui correspondent exactement à ceux du compte Sigma. Le dossier <code>sftp://id_sigma.binets.fr/www/id_sigma/htdocs/</code> correspond au site <code>http://id_sigma.binets.fr/</code>. Les fichiers qui ne sont pas dans htdocs ne sont pas accessibles directement par un navigateur, mais un script php peut y accéder.

=== Avec visibilité extérieure ===

Le BR a un partenariat avec la DSI qui lui permet d'exposer certains sites à l'extérieur. Ils feront l'objet d'[[un audit de sécurité]] par le BR et la DSI. Pour le passer, il faut respecter les dernières recommandations de sécurité, notamment pour tout ce qui est authentification, contenu dynamique. Notons cependant que cela ne devrait pas poser de problèmes pour les sites statiques.

Les sites souhaitant un site avec visibilité depuis l'extérieur doivent dorénavant respecter la charte suivante :

*Aucune information ne doit être diffusée qui pourrait nuire à l'image de l’École. (photos, vidéos, etc.)
*Le site doit avoir une qualité visuelle, si ce n'est professionnelle, du moins très correcte.
*Le site ne doit pas héberger de vidéos ou diffuser un flux vidéo (streaming). Toutes les vidéos du sites doivent être hébergées à l'extérieur. (Dalymotion, YouTube, etc.)
*Les images présentes sur le site ne doivent avoir une résolution suffisamment faible afin de ne pas saturer la bande passante vers l'extérieur.

{{Attention|Si le site concerne un événement extérieur avec un public de plus de 50 personnes, la DSI demande à ce que la DIRCOM soit prévenue.}}

== Quotas ==

Attention ! L'espace réservé à chaque binet est limité. Il faut se méfier quand on fait une copie, notamment a l'environnement virtuel. D'abord il pèse lourd, en plus il faudra que vous le remplaciez de toute façon. Autant ne pas le copier dès le départ...
Pour savoir si vous avez dépassé votre quota :
quota -sg
Cette commande affiche, pour chaque binet, l'espace utilisé, une «soft limit» et la vraie («hard») limit.

Gpg

2024-06-24T00:21:12Z

Jean-nicolas.strauss : creation redirection

#REDIRECTION [[GPG]]

GPG

2024-06-22T15:26:52Z

Jean-nicolas.strauss : Création de gpg

=Intérêt de GPG=
Si vous signez vos commits git on peut être sûr que c'est bien vous qui l'avez commit. Cela rajoute de la sécurité.

=Création d'une clef GPG=
[https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key Création d'une clef GPG]. Suivez la procédure et rajoutez la clef a votre compte gitlab. Puis ajoutez la a votre configuration par défaut.

git config --global user.signingkey 3AA5C34371567BD2
git config --global commit.gpgsign true

Hébergement des sites des binets

2024-06-18T11:42:35Z

Jean-nicolas.strauss : ostizan deprecated

{{menu services}}
[[Catégorie:Services]]

Le BR propose aux binets qui le désirent d'héberger gratuitement leur site web.

Cet hébergement s'organise selon deux formules, avec ou sans la possibilité d'accéder au site de l'extérieur du Plâtal.

Pour demander l'hébergement de ton site, [https://panix.binets.fr ouvre une tâche Panix] en précisant l'identifiant du groupe/binet au nom duquel tu fais la demande (si tu ne le connais pas, donne le lien vers le groupe/binet sur Sigma).

Tu peux également demander à mettre une [[authentification CAS]], [[openID]], ou encore protéger ton site par un portail d'authentification global si ton site est déployé sous docker (i.e. tu peux considérer que l'utilisateur est déjà connecté une fois sur le site).

En fonction des technologies utilisées, on a différents tuto à te proposer:
* un [[Tuto pour le déploiement des sites Django]] des sites binets codés en django/flask/(tout ce qui supporte uwsgi).
* un [[Tuto pour le déploiement des sites avec Docker]] pour n'importe quel site.

Les sites internes en php sont hébergés sur [[Admin:Ostizan | Ostizan]] mais devraient être migrés.

{{Attention|Nous n'acceptons plus de demandes d'hébergement sur [[Admin:Ostizan | Ostizan]]. Si votre site est actuellement hébergé dessus n'hésitez pas à entrer en contact avec le [[BR]] (cf [[Accueil]]) pour le migrer sur [[Admin:Endalcher|Endalcher]] avec le [[Tuto pour le déploiement des sites avec Docker]]}}
== Modalités techniques de l'hébergement sur Ostizan==
L'hébergement classique offert par le BR présente les caractéristiques suivantes :
* Capacité de stockage limitée à 200Mo par défaut. Il est possible d'obtenir plus sur demande.
* Serveur apache avec PHP 7
* Base de données MySQL
* Accès en HTTPS/HTTP
* Hébergement Django/Flask avec uWSGI

Si vous avez des besoins plus spécifiques, n'hésitez pas à nous en parler.

== Accès au site ==

L'administration du site se fait par [[SSH]]. Il est ouvert à tous les administrateurs du binet considéré, et à eux seuls. Pour cela, utilisez vos identifiants Sigma. Exemple de commande à utiliser : <code>ssh prenom.nom@id_sigma.binets.fr</code>, puis rentrez votre mot de passe lorsque celui vous est demandé.

L'écriture du site est bien entendu à la charge du webmaster du binet ; en cas de nécessité et pour une raison valable, un BRman pourra cependant proposer son aide.

L'adresse du site est alors mon_binet.binets.fr ou mon_binet.binets.eleves.polytechnique.fr ;

La base de données MySQL est accessible par un PhpMyAdmin : [http://phpmyadmin.binets.fr/ http://phpmyadmin.binets.fr/]. Le nom d'utilisateur correspond au nom du binet tel qu'il apparaît dans le nom de domaine. Le mot de passe a été donné au binet à la création de la base SQL ; le BR ne le possède pas et vous devez le passer à vos successeurs pour éviter de le perdre à tout jamais.

=== Modification des fichiers du site ===

Les fichiers se situent sur le serveur ostizan, dans le répertoire

<pre lang="sh">/hosting/www/nom_binet/</pre>

==== Avec Git (recommandé) ====

ostizan dispose d’une installation [[Git]].

Avec Git, vous pouvez garder un historique des versions successives de votre site, travailler à plusieurs, revenir en arrière quand vous avez cassé quelque chose, savoir qui a modifié quoi, quand … C’est un outil très puissant.

'''Prérequis :''' ''avoir une clef [[SSH]] activée sur votre compte sur ostizan''

Pour savoir comment configurer et construire un projet avec Git, référez-vous à la documentation. Vous pouvez héberger votre code chez nous sur [https://gitlab.binets.fr GitLab].

Naviguez au dossier où vous voulez mettre votre site, par exemple <code>htdocs</code>:

<pre lang="sh">cd /hosting/www/nom_binet/htdocs</pre>
et initialisez un dépôt Git

<pre lang="sh">git init</pre>
Si cela a fonctionné, le terminal répondra

<pre>Initialized empty Git repository in /hosting/www/nom_binet/htdocs/.git</pre>
Ajoutez maintenant une ''remote'' qui pointera vers là où vous hébergez votre code, par exemple

<pre lang="sh">git remote add origin git@gitlab.binets.fr:domaine/site.git</pre>
pour un site dont le code est hébergé sur le GitLab, ou

Ensuite, faites

<pre lang="sh">git pull origin master</pre>
pour cloner le dépôt (si la ''remote'' que vous avez ajouté s’appelle <code>origin</code> et que votre code est sur la branche <code>master</code>).

==== En SFTP ====

Pour accéder aux fichiers, on peut utiliser un client sftp (comme [https://filezilla-project.org/download.php?type=client FileZilla] ou [https://winscp.net/eng/index.php WinSCP]) et accéder au serveur <code>sftp://id_sigma.binets.fr</code> sur le port 22.

Le serveur SFTP demande un login / mot de passe qui correspondent exactement à ceux du compte Sigma. Le dossier <code>sftp://id_sigma.binets.fr/www/id_sigma/htdocs/</code> correspond au site <code>http://id_sigma.binets.fr/</code>. Les fichiers qui ne sont pas dans htdocs ne sont pas accessibles directement par un navigateur, mais un script php peut y accéder.

=== Avec visibilité extérieure ===

Le BR a un partenariat avec la DSI qui lui permet d'exposer certains sites à l'extérieur. Ils feront l'objet d'[[un audit de sécurité]] par le BR et la DSI. Pour le passer, il faut respecter les dernières recommandations de sécurité, notamment pour tout ce qui est authentification, contenu dynamique. Notons cependant que cela ne devrait pas poser de problèmes pour les sites statiques.

Les sites souhaitant un site avec visibilité depuis l'extérieur doivent dorénavant respecter la charte suivante :

*Aucune information ne doit être diffusée qui pourrait nuire à l'image de l’École. (photos, vidéos, etc.)
*Le site doit avoir une qualité visuelle, si ce n'est professionnelle, du moins très correcte.
*Le site ne doit pas héberger de vidéos ou diffuser un flux vidéo (streaming). Toutes les vidéos du sites doivent être hébergées à l'extérieur. (Dalymotion, YouTube, etc.)
*Les images présentes sur le site ne doivent avoir une résolution suffisamment faible afin de ne pas saturer la bande passante vers l'extérieur.

{{Attention|Si le site concerne un événement extérieur avec un public de plus de 50 personnes, la DSI demande à ce que la DIRCOM soit prévenue.}}

== Quotas ==

Attention ! L'espace réservé à chaque binet est limité. Il faut se méfier quand on fait une copie, notamment a l'environnement virtuel. D'abord il pèse lourd, en plus il faudra que vous le remplaciez de toute façon. Autant ne pas le copier dès le départ...
Pour savoir si vous avez dépassé votre quota :
quota -sg
Cette commande affiche, pour chaque binet, l'espace utilisé, une «soft limit» et la vraie («hard») limit.

BR

2024-06-18T11:39:15Z

Jean-nicolas.strauss : Création de la page de redirection vers le BR actuel

#REDIRECT [[BR2022]]