Downloads/Fr

From TuxFamilyFAQ
Jump to navigationJump to search

Espaces de Downloads



Description

Les dépôts (repositories) permettent le stockage de gros fichiers pour téléchargement :

  • fichiers ISO ;
  • dépôts de paquets (.deb, .rpm, ...).

Le quota par défaut est de 1024 Mo mais il peut être augmenté sur simple demande. Les fichiers pourront alors être téléchargés en utilisant les protocoles ftp, http et rsync.

Dépendances

Création

Vous pouvez demander la création de votre espace de téléchargement via le panel d'administration de votre groupe projet (tout en bas du panel).

Conseils de création

  • Comme d'habitude, mettez une description claire avec la licence, cela fera gagner du temps à tout le monde, particulièrement à vous ;-)

Modération

La création de cet espace de téléchargement est soumise à modération. Voir ici.

Comment l'administrer (panel)

Il n'y a aucune option sur le panel.

Configuration

Rien à configurer :)

Comment gérer les droits de mon groupe ?

Cet objet peut être partagé avec votre groupe en utilisant les ACL.

Comment le détruire ?

Euh... D'abord, faites tourner vos neurones 7 fois dans votre cerveau car la destruction est irréversible !

  • Connectez-vous sur le panel ;
  • cliquez sur le groupe de votre projet ;
  • cliquez sur votre repository ;
  • cliquez sur « détruire ».

Et ne venez pas pleurer ;-)

Comment l'utiliser

Consultation

Les URL de consultation sont :

Pour des fichiers ISO de DVD qui feraient donc probablement plus de 2 Go, conseillez à vos utilisateurs d'utiliser ftp ou rsync, apache ayant un bogue « historique » à 2 Go empêchant de récupérer l'intégralité du fichier (c'est ballot).

Remplissage

Utilisez tout simplement votre client ftp sur ftp.tuxfamily.org avec classiquement votre login (celui du panel). Les fichiers appartiennent à votre groupe et sont donc remplaçables par vos comparses sur votre projet.

Pensez à ajouter un fichier README précisant :

  • le contenu du dépôt ainsi que son organisation ;
  • la licence retenue pour les fichiers mis à disposition en téléchargement (voir LicenceLibre) : ajouter un fichier LICENSE pendant que vous y êtes voire COPYRIGHT (à la debian) ;
  • la façon d'utiliser ce dépôt ;
  • vous pouvez nommer ce fichier MANIFEST (ou _README ou .README ? pour qu'il apparaisse en premier de la liste) => vérifiez ensuite ce qui est affiché lors de la connexion par ftp.

Si vous ne voulez pas que le mot de passe de votre compte utilisateur (celui qui vous permet entre autre de gérer votre compte sur le panel...) transiste en clair sur le réseau en utilisant ftp (ça peut se comprendre ;-)), utilisez sftp, un protocole sécurisé par ssh.

Pour les besoins de l'exemple, nous supposerons que :

  • « utilisateur » est votre nom de connexion sur le panel vhffs de TuxFamily ;
  • « mon_projet » est le nom de votre projet concerné par l'espace de téléchargement, sachant que vous pouvez en avoir plusieurs ;
  • « local_user » est votre nom de connexion votre machine .

Dans une console, tapez la commande suivante :

sftp utilisateur@ftp.tuxfamily.org

Si vous ne vous êtes jamais connecté de cette manière, la première fois, vous recevrez dans la console un message du style :

Connecting to ftp.tuxfamily.org...

The authenticity of host 'ftp.tuxfamily.org (212.85.158.7)' can't be established.

RSA key fingerprint is ef:3b:cd:b3:a0:66:bc:fb:f7:3a:98:1f:32:45:8c:24.

Are you sure you want to continue connecting (yes/no)?

Évidemment, vous répondrez oui. Enfin... yes ;-)

Vous verrez alors apparaître l'avertissement suivant :

Warning: Permanently added 'ftp.tuxfamily.org,212.85.158.7' (RSA) to the list of known hosts.

indiquant donc que le ftp de Tuxfamily est ajouté à la liste des hôtes connus par ssh sur la machine avec laquelle vous vous connectez.

Ensuite, dans le cas où vous n'auriez pas « sécurisé » la console (ajouter lien interne vers documentation svn et ssh, par exemple), ssh vous demande de fournir votre phrase de passe :

Enter passphrase for key '/home/local_user/.ssh/id_dsa':

ou peut-être :

Enter passphrase for key '/home/local_user/.ssh/id_rsa':

suivant le type de clé ssh que vous avez créé.

Si vous ne vous êtes pas trompé dans votre phrase de passe, l'invite de votre console devient :

sftp>

Un petit « ls » vous permet d'afficher l'ensemble des projets que vous avez créé chez TuxFamily, dont « mon_projet », plus le répertoire « ssh_keys ».

Allez dans le répertoire « mon_projet » et relancez « ls ». [1]

sftp> cd mon_projet sftp> ls mon_projet-repository mon_projet.tuxfamily.org-web sftp>

C'est peut-être un peu ambigü, mais il se trouve que le répertoire « mon_projet-repository » est équivalent à votre espace de téléchargement auquel les internautes accèderont par le lien http://download.tuxfamily.org/mon_projet

Alors, un petit « cd » supplémentaire, et vous pourrez installer dans le répertoire tous les fichiers que vous destinez au téléchargement.

sftp> cd mon_projet-repository


Vous pouvez aussi en profiter pour mettre à jour ou installer votre site web en utilisant sftp.

Rappelez-vous. Si vous êtes dans le répertoire distant « mon_projet », la commande « ls » renvoie :

sftp> ls mon_projet-repository mon_projet.tuxfamily.org-web

Entrez dans « mon_projet.tuxfamily.org-web » et affichez-en le contenu :

sftp> cd mon_projet.tuxfamily.org-web sftp> ls awstats htdocs logs php-include tmp

La racine de votre site web est « htdocs ».

sftp> cd htdocs

Vous êtes donc à présent à l'endroit qui peut être visualisé de l'extérieur avec l'URL « http://mon_projet.tuxfamily.org ».

Pour plus d'informations sur la copie de vos fichiers locaux sur votre espace de téléchargement TuxFamily ou votre espace web, vous n'êtes nullement dispensé de la lecture de la page de manuel de sftp ;-). En plus, il y a une version française...

Si vous pensez qu'elle n'est pas à jour, il vous reste la version originale accessible par la commande suivante :

LANG=C man sftp

Voilà pour le moment !

Nous tâcherons d'améliorer cette section dès que nous saurons faire un peu de formatage sur le wiki afin de la rendre plus agréable et plus évidente à lire !


[1] Petit rappel : l'autocomplémentation, l'historique clavier, le déplacement avec la flèche gauche ne fonctionnent pas dans une connexion sécurisée ! Donc, usez et abusez des commandes « ls », « cd » et « pwd » ! Judicieusement utilisées avec la sélection de texte avec la souris, vous vous faciliterez grandement la vie !

Statistiques

Les statistiques concernant votre dépot sont disponibles sur http://stats.download.tuxfamily.org/VOTREGROUPE/ , par exemple : http://stats.download.tuxfamily.org/vhffs4/

Remarques diverses

  • Voir http://download.tuxfamily.org/vhffs4/ pour un exemple de dépôt de paquets debian.
  • N'hésitez pas à mettre un fichier README par répertoire afin que l'utilisateur sache ce qu'il peut trouver dans l'arborescence.
  • Pour les fichiersISO, pensez à mettre un fichier de description donnant les md5sum ou sha1 (cela permet de vérifier que le téléchargement s'est correctement déroulé).
  • Essayez d'organiser un minimum les répertoires (mieux que votre chambre de geek, hein ?) pour prévoir les versions ultérieures, les paquets de vos logiciels, plutôt qu'un vaste foutoir innommable qui vous ferait honte par la suite...

Liens utiles