Downloads/Fr

From TuxFamilyFAQ
Revision as of 18:01, 10 December 2007 by CraftY (talk | contribs) (conneXions ! :))
Jump to navigationJump to search

Espaces de téléchargement



Description

Les dépôts (repositories) permettent le stockage de gros fichiers que vous souhaitez rendre disponibles au téléchargement :

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

Le quota par défaut est de 1024 Mo, mais il peut être augmenté sur simple demande. Dans certains cas, la corruption des administrateurs devant un comptoir peut s'avérer nécessaire... Les fichiers pourront alors être téléchargés en utilisant les protocoles ftp, http et rsync.

À noter : choisissez avec soin le nom de votre projet, car l'URL de consultation de votre dépôt sera de la forme http://download.tuxfamily.org/PROJET/

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://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 (voir l'exemple d'un shell sécurisé), 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 !

Si vous pensez que cette page est incomplète, n'hésitez à apporter votre contribution.


  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 sftp ! 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/

Espaces de téléchargement et civisme...

Comme sur toute architecture mutualisée, Les ressources pour le service de téléchargement sont réparties entre tous les hébergés. Nous vous demandons donc de respecter ces règles fort simples et qui à mon avis ne sont que du bon sens...

  • Ne pas gaspiller l'espace disque. Il vous faut nettoyer régulièrement vos espaces de téléchargement et supprimer les fichiers caducs.
  • Nous prévenir avant de release des gros fichiers (des ISO d'une distribution par exemple)
  • Pour ceux qui auraient envie de figurer sur des sites du genre de http://distrowatch.com idem, nous faire signe AVANT nous permet de prévenir nos fournisseurs de Bande passante qu'il risque d'y avoir un pic de consommation...
  • De plus, nous encourageons vivement les personnes qui font des paquets pour une certaine distribution commençant par 'U' et finissant par 'buntu' à se mettre en relation avec les dépots officiels pour y intégrer leur paquets au lieu de créer un nième dépot sur TuxFamily...
  • Merci aussi d'encourager vos utilisateurs à ne pas utiliser ces #@!$#@!$#@$! de logiciels qui ouvrent 20000 connexions sur le serveur pour télécharger 1 fichier... En effet, ils ne permettent pas de gagner en vitesse de téléchargement mais surchargent inutilement nos serveurs.

La politique de TuxFamily a toujours été de brider les services au minimum et d'être peu regardants sur les ressources consommées cependant, en cas d'abus, nous ne laisserons pas un utilisateur dégrader le service (et donc nuire à tous les autres projets) et l'indélicat sera mis à la porte sans ménagement.

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 fichiers ISO, 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

Euh... Rien pour le moment.

Si vous en connaissez qui devraient se trouver ici, n'hésitez à éditer, ou au moins le signaler, par exemple sur IRC.