Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] sitecopy - Maintient à jour des copies distantes de sites web [size=18] [b]Résumé[/b] [/size] [b]sitecopy [options] [mode opératoire] [/b] [i]nomdusite[/i] [b]...[/b] [size=18] [b]Description[/b] [/size] [i]sitecopy[/i] sert à copier des sites web stockés localement vers des serveurs web distants. Une simple commande va mettre à jour sur le serveur les fichiers modifiés localement, et supprimer du serveur les fichiers supprimés localement, maintenant ainsi le site distant à jour avec le site local. L'objectif est de supprimer l'étape très pénible de mise à jour et de suppression de fichiers individuels avec un client FTP. [b]sitecopy[/b] peut également repérer les fichiers que vous avez déplacés localement pour les déplacer sur le site distant. FTP, WebDAV et autres serveurs de publication basés sur HTTP (comme par exemple AOLserver et Netscape Enterprise) sont également gérés. [size=18] [b]Pour commencer[/b] [/size] Cette section explique comment mettre en place la maintenance d'un site web à l'aide de [b]sitecopy[/b]. Après avoir présenté les rudiments, on examinera deux situations : d'abord celle où vous avez déjà placé votre site sur le serveur distant, puis celle où vous ne l'avez pas encore fait. [b]Rudiments[/b] Si vous ne l'avez pas déjà fait, il vous faut créer un fichier de configuration qui contiendra les informations relatives aux sites que vous désirer administrer. Vous devez également créer un répertoire dans lequel [b]sitecopy[/b] stockera l'état des fichiers de chacun des sites distants. Le fichier de configuration ainsi que le répertoire de stockage de l'état des fichiers doivent n'être accessibles que par vous-même -- sans quoi [b]sitecopy[/b] refusera de démarrer. Pour créer le répertoire de stockage avec les permissions adéquates, utilisez la commande [b][/b] [b] mkdir -m 700 .sitecopy[/b] [b][/b] depuis votre répertoire personnel. Pour créer le fichier de configuration, utilisez les commandes [b][/b] [b] touch .sitecopyrc[/b] [b][/b] [b] chmod 600 .sitecopyrc[/b] [b][/b] depuis votre répertoire personnel. Ceci fait, éditez le fichier de configuration pour ajouter les détails relatifs à votre site comme indiqué à la section CONFIGURATION. [b]Si le site distant existe déjà[/b] Si vous aviez déjà placé votre site sur le serveur distant, assurez-vous que vos fichiers locaux soient synchronisés avec les fichiers distants. Ensuite, lancez [b][/b] [b] sitecopy --catchup nomdusite[/b] [b][/b] où nomdusite est le nom du site que vous avez indiqué après le mot-clé [b]site[/b] dans le fichier de configuration. Si vous n'avez pas de copie locale du site distant, vous pouvez utiliser le [b]mode récupération[/b] pour découvrir le contenu du site distant, et le [b]mode synchronisation[/b] pour le télécharger. Le mode récupération marche bien avec les serveurs WebDAV, et peut marcher avec les serveurs FTP. Tapez [b][/b] [b] sitecopy --fetch nomdusite[/b] [b][/b] pour récupérer les informations sur les fichiers du site ; en cas de succès, tapez [b][/b] [b] sitecopy --synch nomdusite[/b] [b][/b] pour télécharger une copie locale. N'effectuez PAS ces opérations si vous avez déjà une copie locale de votre site. [b]Si le site distant nexiste pas encore[/b] Assurez-vous que l'administrateur ait bien créé la racine du site distant. Tapez [b][/b] [b] sitecopy --init nomdusite[/b] [b][/b] où nomdusite est le nom du site que vous avez indiqué après le mot-clé [b]site[/b] dans le fichier de configuration. [b]Maintenance du site[/b] Après avoir mis en place le site comme décrit dans une des deux sections ci-dessus, vous pouvez commencer à éditer vos fichiers locaux normalement. Lorsque vous en avez fini avec un ensemble de changements, et que vous voulez mettre à jour la copie distante de votre site, tapez [b][/b] [b] sitecopy --update nomdusite[/b] [b][/b] et tous les fichiers modifiés seront remontés sur serveur. Tout fichier localement supprimé sera également suppprimé sur le serveur, à moins que l'option [b]nodelete [/b] n'ait été spécifiée dans le fichier de configuration. Si vous déplacez un ou plusieurs fichiers entre deux répertoires, leurs copies distantes seront supprimées du serveur, puis remontées à nouveau, à moins que l'option [b]checkmoved[/b] n'ait été spécifiée dans le fichier de configuration. À tout moment, si vous désirez voir la liste des changements effectués au site local depuis la dernière mise à jour, pour pouvez lancer [b][/b] [b] sitecopy nomdusite[/b] [b][/b] qui affichera la liste des différences. [b]Problèmes de synchronisation[/b] Dans certaines circonstances, les fichiers qui constituent réellement le site distant diffèrent de ce que [b]sitecopy[/b] [i]pense[/i] qu'il y a sur le site. Cela peut arriver, par exemple, si la connexion au serveur est interrompue durant une mise à jour. Dans cette situation, vous devriez utiliser le [b]mode récupération[/b] pour retrouver du serveur distant la liste des fichier qui constitue le site. [size=18] [b]Invocation[/b] [/size] Pour une opération normale, spécifiez un [i]simple[/i] mode opératoire, suivi par les options que vous avez choisies, puis un ou plusieurs nom de sites. Par exemple, [b][/b] [b] sitecopy --update --quiet siteprincipal autresite[/b] [b][/b] mettra à jour silencieusement les sites appelés « siteprincipal » et « autresite ». [size=18] [b]Modes opÉratoires[/b] [/size] "-l, --list" [b]Mode Liste[/b] [table][row][col]    [/col][col]- produit une liste de toutes les différences entre les fichiers locaux et leur copie distante pour les sites spécifiés.[/col][/row][/table] "-ll, --flatlist" [b]Mode Liste plate[/b] [table][row][col]    [/col][col]- similaire au mode liste, mais la sortie produite convient à une analyse ultérieure par un script externe ou un programme. Le script AWK fourni, [b]changes.awk.[/b] produit par exemple une page HTML depuis une sortie produite par ce mode.[/col][/row][/table] "-u, --update" [b]Mode Mise à jour[/b] [table][row][col]    [/col][col]- Met à jour la copie distante des sites spécifiés.[/col][/row][/table] "-f, --fetch" [b]Mode Récupération[/b] [table][row][col]    [/col][col]- Récupère la liste des fichiers du serveur distant. Notez qu'en FTP le support de ce mode est limité -- le serveur doit accepter la commande [b]MDTM[/b] , et utiliser un programme « ls » de type Unix comme implémentation de la commande LIST.[/col][/row][/table] "-s, --synchronize" [b]Mode Synchronisation[/b] [table][row][col]    [/col][col]- Met à jour la copie [i]locale[/i] du site à partir de la copie distante. [b]AVERTISSEMENT :[/b] Ce mode écrase les fichiers locaux. À utiliser avec précaution.[/col][/row][/table] "-i, --initialize" [b]Mode Initialisation[/b] [table][row][col]    [/col][col]- initialise les sites spécifiés, [b]sitecopy[/b] pensant alors qu'il n'y a AUCUN fichier sur le serveur distant. [/col][/row][/table] "-c, --catchup" [b]Mode Rendre identique[/b] [table][row][col]    [/col][col]- amène [b]sitecopy[/b] à penser que les copies locale et distante du site sont identiques.[/col][/row][/table] "-v, --view" [b]Mode Voir configuration[/b] [table][row][col]    [/col][col]- Affiche toutes les définitions de sites du fichier de configuration.[/col][/row][/table] "-h, --help" [table][row][col]    [/col][col]Affiche un message d'aide.[/col][/row][/table] "-V, --version" [table][row][col]    [/col][col]Affiche le numéro de version.[/col][/row][/table] [size=18] [b]Options[/b] [/size] "-y, --prompting" [table][row][col]    [/col][col]Valable seulement pour le [b]Mode Mise à jour[/b] , demande à l'utilisateur de confirmer chaque mise à jour (i.e., création d'un répertoire, remontée d'un fichier sur le site distant, etc.).[/col][/row][/table] "-r FICHIER, --rcfile=FICHIER" [table][row][col]    [/col][col]Spécifie un fichier de configuration alternatif pour l'exécution en cours.[/col][/row][/table] "-p RÉPERTOIRE, --storepath=RÉPERTOIRE" [table][row][col]    [/col][col]Spécifie un chemin d'accès alternatif au répertoire contenant les informations sur les fichiers du site distant, pour l'exécution en cours.[/col][/row][/table] "-q, --quiet" [table][row][col]    [/col][col]Sortie discrète - n'affiche que le nom du fichier pour chaque mise à jour effectuée.[/col][/row][/table] "-qq, --silent" [table][row][col]    [/col][col]Sortie silencieuse - n'affiche aucune information lors des mises à jour.[/col][/row][/table] "-o, --show-progress" [table][row][col]    [/col][col]Valable seulement pour le [b]Mode Mise à jour[/b] , affiche la progression (sous forme de pourcentage effectué) du transfert de données.[/col][/row][/table] "-k, --keep-going" [table][row][col]    [/col][col]Passe outre les erreurs en [b]Mode Mise à jour[/b] ou en [b]Mode Synchronisation[/b] [/col][/row][/table] "-a, --allsites" [table][row][col]    [/col][col]Exécute l'opération donnée pour tous les sites - valable pour tous les modes, sauf le [b]Mode Voir configuration[/b] , pour lequel cette option est sans effet.[/col][/row][/table] "-d MASQUE, --debug=CLÉ[,CLÉ...]" [table][row][col]    [/col][col]Affiche des informations de débogage. Vous devez donner une liste de mots-clés séparés par une virgule. Chaque mot-clé peut être, au choix : [b][/b] socket Manipulation des sockets [b][/b] files Manipulation des fichiers [b][/b] rcfile Analyseur du fichier de configuration [b][/b] http Pilote HTTP [b][/b] httpbody Affiche le corps des réponses HTTP [b][/b] ftp Pilote FTP [b][/b] xml Informations d'analyse syntaxique XML [b][/b] xmlparse Informations d'analyse syntaxique XML de bas niveau [b][/b] httpauth Informations d'authentification HTTP [b][/b] cleartext Affiche les mots de passe en clair Les mots de passe seront masqués dans l'affichage de débogage, à moins que le mot-clé cleartext ne soit utilisé. Un exemple de l'utilisation des informations de débogage est de déboguer le mode récupération FTP : [b][/b] [b] sitecopy --debug=ftp,socket --fetch nomdusite[/b] [b][/b] [/col][/row][/table] [size=18] [b]Concepts[/b] [/size] L' [b]état stocké[/b] d'un site est un instantané de l'état du site, conservé dans le répertoire de stockage (~/.sitecopy/). Le [b]fichier de stockage[/b] sert à conserver cet état entre deux invocations du programme. En mode mise à jour, [b]sitecopy[/b] construit une [b]liste de fichiers[/b] pour chaque site en parcourant le répertoire local, prend connaissance de l'état stocké et, en comparant les deux, détermine quels fichiers ont changé, lesquels ont été déplacés, et ainsi de suite. [size=18] [b]Configuration[/b] [/size] La configuration est assurée par le fichier de configuration (fc). Ce fichier contient une ou plusieurs définitions de sites. Un nom unique est attribué à chaque définition de site ; c'est par ce nom qu'on se réfère à un site en ligne de commande. Chaque définition de site contient les détails du serveur sur lequel est stocké le site, la manière dont on peut accéder à ce serveur, l'emplacement local et distant du site, ainsi que des options pour ce site si nécessaire. [b]Définition dun site[/b] La définition d'un site est constituée d'une série de lignes : [b]site nom-du-site[/b] [b][/b] [b] server nom-du-serveur[/b] [b][/b] [b] remote répertoire-racine-distant[/b] [b][/b] [b] local répertoire-racine-local[/b] [b][/b] [b][/b] [ [b]port numéro-de-port ][/b] [b][/b] [ [b]username utilisateur ][/b] [b][/b] [ [b]password mot-de-passse ][/b] [ [b]proxy-server nom-du-proxy[/b] [b][/b] [b] proxy-port numero-port-proxy ][/b] [ [b]url URL-du-site ][/b] [b][/b] [ [b]protocol { ftp \| webdav } ][/b] [b][/b] [ [b]ftp nopasv ][/b] [b][/b] [ [b]ftp showquit ][/b] [b][/b] [ [b]ftp { usecwd \| nousecwd } ][/b] [b][/b] [ [b]http expect ][/b] [b][/b] [ [b]http secure ][/b] [ [b]safe ][/b] [b][/b] [ [b]state { checksum \| timesize } ][/b] [ [b]permissions { ignore \| exec \| all } ][/b] [ [b]symlinks { ignore \| follow \| maintain } ][/b] [ [b]nodelete ][/b] [ [b]nooverwrite ][/b] [ [b]checkmoved [renames] ][/b] [ [b]tempupload ][/b] [ [b]exclude motif ]...[/b] [ [b]ignore motif ]...[/b] [ [b]ascii motif ]...[/b] Tout ce qui suit le caractère # sur une ligne est considéré comme un commentaire et est ignoré. Les valeurs peuvent être entourées par des guillemets, et les caractères peuvent être échappés par une contre-oblique (). Par exemple, pour utiliser le motif d' [b]exclusion[/b] #, utilisez la ligne suivante: [b][/b] [b] exclude #[/b] [b]Options pour le serveur distant[/b] La clé [b]server[/b] est utilisée pour spécifier le serveur distant sur lequel est stocké le site distant. Cela peut être un nom DNS ou une adresse IP. La connexion au serveur se fera sur le port par défaut pour le protocole utilisé, ou bien par le numéro indiqué par le mot-clé [b]port.[/b] [b]sitecopy[/b] gère les protocoles WebDAV ou FTP -- le mot-clé [b]protocol[/b] spécifie lequel utiliser, en prenant comme valeur [b]webdav[/b] ou [b]ftp[/b] respectivement. Le protocole par défaut est FTP. Les mots-clés [b]proxy-server[/b] et [b]proxy-port[/b] peuvent être utilisés pour spécifier un serveur de proxy. Les serveurs de proxy ne sont gérés qu'avec le protocole webDAV. Si le serveur FTP ne gère pas le mode passif (PASV), utilisez l'option [b]ftp nopasv.[/b] Pour afficher le message retourné par le serveur à la fermeture de la connexion, utilisez l'option [b]ftp showquit.[/b] Si le serveur ne permet la remontée des fichiers que dans le répertoire courant, utilisez le mot-clé [b]ftp usecwd[/b] (un symptôme possible est le message : "overwrite permission denied"). Notez que le répertoire racine distant (mot-clé [b]remote)[/b] doit être un chemin absolu (qui commence par '/'), sans quoi [b]usecwd[/b] sera ignoré. Si le serveur WebDAV utilise correctement le message d'attente 100-continue, comme par exemple Apache version 1.3.9 et supérieure, utilisez le mot-clé [b]http expect.[/b] Cela peut économiser de la bande passante ainsi que réduire le temps nécessaire à une mise à jour. Pour authentifier l'utilisateur sur le serveur, utilisez les mots-clés [b]username[/b] et [b]password. [/b] Si le mot de passe n'est pas spécifié, il sera recherché dans le fichier [b]~/.netrc[/b] s'il existe. Voyez ftp(1) pour la syntaxe de ce fichier. Pour le protocole WebDAV, l'authentification basique et par condensé (digest authentication) sont gérées. Notez que vous ne devriez pas utiliser l'authentification basique, à moins que vous ne considériez la connexion au serveur comme digne de confiance. Vous pouvez spécifier l'URL complète pour accéder au site avec le mot-clé [b]url.[/b] Elle n'est utilisée qu'en mode liste plate, afin qu'elle puisse figurer dans les pages« Changements récents ». L'URL ne doit [i]pas[/i] se terminer par une barre oblique (/) ; un exemple valide est [b][/b] [b] url http://www.site.com/monsite[/b] Si vous spécifiez l'option [b]tempupload,[/b] les fichiers modifiés sont transmis au serveur distant avec un préfixe « .in. », puis renommés (par déplacement) en leur nom d'origine une fois remontés complètement. [b]État des fichiers[/b] L'état d'un fichier est conservé dans le fichier de stockage associé (dans ~/.sitecopy/), et sert à déterminer quand le fichier a été modifié. Il y a deux méthodes possibles, qui peuvent être choisies via le mot-clé [b]state[/b] , avec comme paramètre [b]timesize[/b] (par défaut), ou [b]checksum.[/b] [b]timesize[/b] utilise la date de dernière modification et la taille du fichier pour détecter s'il a changé. [b]checksum[/b] utilise une somme de contrôle MD5 pour détecter toute modification dans le contenu du fichier. Notez que calculer une somme de contrôle implique de lire le contenu entier du fichier ; et est plus lent que d'utiliser simplement la date de dernière modification et la taille. Cela peut être utile par exemple si vous utilisez un système de gestion de versions qui change la date de dernière modification des fichiers à chaque extraction d'une copie de travail (« checkout »), alors que le contenu des fichiers n'est en réalité pas modifié. [b]Mode sécurisé[/b] Vous pouvez passer en [b]Mode Sécurisé[/b] grâce au mot-clé [b]safe.[/b] Dans ce mode, chaque fois qu'un fichier est remonté sur le serveur, la date de modification du fichier [b]telle qu'elle apparaît sur le serveur[/b] est conservée. Par la suite, lorsque le fichier a été changé localement et doit être à nouveau remonté sur le serveur, la date de modification actuellement conservée côté serveur est récupérée puis comparée avec la date locale. En cas de différence, cela signifie que la copie sur le serveur a été changée par une tierce partie ; un message d'avertissement est produit, et votre copie locale n'écrasera pas la copie distante, prévenant ainsi la suppression de toute modification. Le mode sécurisé peut être utilisé avec des serveurs FTP ou WebDAV, mais si Apache/mod_dav est utilisé, il faut une version de mod_dav au moins égale à 0.9.11. [b]Note[/b] Le mode sécurisé ne peut être utilisé conjointement avec l'option [b]nooverwrite[/b] (voir plus bas). [b]Emplacements de stockage des fichiers du site[/b] Le mot-clé [b]remote[/b] spécifie le répertoire racine de la copie distante du site. Vous pouvez le donner sous la forme d'un chemin absolu, comme : [b][/b] [b] remote /www/monsite/[/b] [b][/b] Si vous utilisez le protocole FTP, vous pouvez également spécifier le répertoire sous la forme d'un chemin relatif au répertoire de connexion ; il doit être dans ce cas préfixé par « ~/ », comme par exemple : [b][/b] [b] remote ~/public_html/[/b] Le mot-clé [b]local[/b] spécifie le répertoire qui sert localement de stockage aux fichiers du site. Cela peut être un chemin absolu ou relatif à votre répertoire personnel (donné par la variable d'environnement $HOME), encore une fois en usant du préfixe « ~/ ». [b][/b] [b] local ~/html/lesite/[/b] [b][/b] [b] local /home/fred/html/lesite/[/b] [b][/b] sont équivalents, si $HOME est fixé à « /home/fred ». Pour les deux mots-clés local et remote, le chemin spécifié peut se terminer par une barre oblique, mais ça n'est pas obligatoire. [b]Traitement des permissions des fichiers[/b] Le traitement des permissions des fichiers est contrôlé par le mot-clé [b]permissions[/b] , qui peut prendre une de ces trois valeurs : [b]ignore[/b] [table][row][col]    [/col][col]pour ignorer complètement les permissions des fichiers,[/col][/row][/table] [b]exec[/b] [table][row][col]    [/col][col]pour propager les permissions des fichiers exécutables uniquement,[/col][/row][/table] [b]all[/b] [table][row][col]    [/col][col]pour propager les permissions de tous les fichiers.[/col][/row][/table] Vous pouvez utiliser ce mot-clé par exemple pour vous assurer que les permissions de vos scripts CGI soient correctes. Cette option est pour le moment ignorée des serveurs WebDAV. Avec les serveurs FTP, un [b]chmod[/b] est exécuté côté serveur pour modifier les permissions. [b]Traitement des liens symboliques[/b] Les liens symboliques trouvés sur le site local peuvent être au choix ignorés, suivis ou maintenus. En mode « follow », le fichier référencé par un lien symbolique sera remonté à l'emplacement du lien sur le site distant. En mode « maintain », le lien sera aussi créé sur le site distant (voir ci-dessous). Le mode utilisé pour chaque site est spécifié par le mot-clé [b]symlinks[/b] , qui peut prendre la valeur [b]ignore,[/b] [b]follow[/b] ou [b]maintain.[/b] Le mode par défaut est [b]ignore,[/b] i.e. les liens symboliques trouvés sur la copie locale du site sont ignorés. [b]Maintenance des liens symboliques[/b] Ce mode est n'actuellement supporté que par les serveurs WebDAV implémentant WebDAV Advanced Collections, qui est en cours de développement. Dans ce mode, la cible du lien sur le serveur est littéralement copié à partir de la cible du lien symbolique. Astuce : vous pouvez utiliser des URL si vous le désirez : [b][/b] [b] ln -s http://www.quelquepart.org/ quelquepart[/b] De cette façon , un ordre "302 Redirect" peut être facilement mis en place depuis le client, sans altérer la configuration du serveur. [b]Suppression et déplacememnt des fichiers distants[/b] Vous pouvez utiliser l'option [b]nodelete[/b] pour empêcher les fichiers distants d'être jamais supprimés. Cela peut être utile si vous conservez de grosses quantités de données sur le serveur, dont vous ne voudriez pas pour autant conserver de copie locale. Si votre serveur ne permet pas l'écrasement de fichiers existants par ceux que vous remontez, utilisez l'option [b]nooverwrite.[/b] Dans ce cas, avant de remonter un fichier, [b]sitecopy[/b] supprimera au préalable la copie distante. Si vous utilisez l'option [b]checkmoved,[/b] [b]sitecopy[/b] cherchera si des fichiers ont été déplacés localement. Si c'est le cas, lors de la mise à jour du site, ces fichiers seront aussi déplacés sur le site distant. Avec l'option [b]checkmoved renames,[/b] [b]sitecopy[/b] cherchera si des fichiers ont été localement déplacés ou renommés. Cette option n'est utilisable qu'en conjonction avec l'option [b]state checksum.[/b] [b]AVERTISSEMENT[/b] Si vous n'utilisez pas de somme de contrôle MD5 pour déterminer l'état des fichiers (i.e. avec l'option [b]state checksum[/b] ) N'UTILISEZ PAS non plus l'option [b]checkmoved[/b] si vous avez tendance à mettre dans des répertoires différents des fichiers de même nom, taille et date de modification. Le risque d'écrasement est improbable, mais ne dites pas que vous n'aviez pas été prévenu. [b]Exclure des fichiers[/b] Certains fichiers peuvent être ignorés de [b]sitecopy[/b] par l'emploi du mot-clé [b]exclude,[/b] qui accepte des motifs d'expressions rationnelles à la manière du shell. Par exemple, utilisez [b][/b] [b] exclude .bak[/b] [b][/b] [b] exclude ~[/b] [b][/b] [b] exclude ##[/b] [b][/b] pour exclure tous les fichiers qui portent l'extension .bak, se terminent par un tilde (~) ou qui commencent et se terminent par un dièse. N'oubliez pas d'échapper ou d'entourer de guillemets le motif s'il inclut un dièse ! Pour exclure des fichiers d'un répertoire particulier, préfixez simplement le motif par le nom du répertoire -- en commençant par une barre oblique. Par exemple, [b][/b] [b] exclude /docs/.m4[/b] [b][/b] [b] exclude /files/.gz[/b] [b][/b] excluera tous les fichiers à l'extension .m4 dans le sous-répertoire « docs », et tous les fichiers à l'extension .gz dans le sous-répertoire « files ». Un répertoire entier peut également être exclu -- en omettant la barre oblique à la fin du nom du répertoire. Par exemple, [b][/b] [b] exclude /quelque/part[/b] [b][/b] [b] exclude /autre/part[/b] [b][/b] excluera les sous-répertoires du site « quelque/part » et « autre/part ». Les motifs d'exclusion sont examinés lorsque [b]sitecopy[/b] parcourt le répertoire local. Un fichier qui correspond à n'importe lequel des motifs ne sera pas ajouté à la liste des fichiers. Cela signifie qu'un fichier déjà remonté sur le serveur qui correspond à un motif d'exclusion sera supprimé du serveur. [b]Ignorer les changements des fichiers locaux[/b] Utilisez l'option [b]ignore[/b] pour indiquer à [b]sitecopy[/b] qu'il doit ignorer les modifications locales apportées aux fichiers du site. Si un changement est fait au contenu d'un fichier ignoré, le fichier ne sera [b]pas[/b] remonté sur le serveur en mode mise à jour. Les fichiers ignorés seront toutefois créés, déplacés et supprimés comme en temps normal. L'option [b]ignore[/b] s'utilise de la même manière que l'option [b]exclude.[/b] Notez que le mode synchronisation [b]écrasera[/b] les changements apportés aux fichiers ignorés. [b]Mode de transfert par ftp[/b] Pour spécifier le mode de transfert des fichiers par FTP, utilisez le mot-clé [b]ascii.[/b] Tout fichier transféré en utilisant le mode ASCII verra ses caractères de fin de ligne (CRLF/LF) interprétés de façon appropriée. Par exemple, utilisez [b][/b] [b] ascii .pl[/b] [b][/b] pour remonter tous les fichiers à l'extension .pl comme des fichiers texte ASCII. Ce mot-clé est actuellement sans effet avec les serveurs WebDAV. [size=18] [b]Valeurs de retour[/b] [/size] Les valeurs de retour possibles dépendent du mode opératoire. Si plusieurs sites sont spécifiés en ligne de commande, la valeur de retour correspondra aux opérations effectuées pour le dernier des sites spécifiés. [b]Pour le mode mise à jour[/b] -1 ... la mise à jour n'a pas pu démarrer - problème de configuration 0 ... la mise à jour s'est parfaitement effectuée. 1 ... il y a eu un problème pendant la mise à jour 2 ... impossible de se connecter ou s'authentifier auprès du serveur [b]Pour le mode liste (mode par défaut)[/b] -1 ... impossible de former la liste - problème de configuration 0 ... le site distant n'a pas besoin de mise à jour 1 ... le site distant nécessite une mise à jour [size=18] [b]Contenu du fichier de configuration dexemple[/b] [/size] [b]Serveur ftp, usage simple[/b] Le site de Fred est remonté sur un serveur FTP nommé « my.server.com » et maintenu dans le répertoire « public_html » situé dans le répertoire de connexion. Le site est conservé en local dans le répertoire /home/fred/html. site mysite server my.server.com url http://www.server.com/fred username fred password juniper local /home/fred/html/ remote ~/public_html/ [b]Serveur ftp, usage avancé[/b] Ici, le site de Freda est remonté sur un serveur FTP nommé « ftp.elsewhere.com » et maintenu dans le répertoire /www/freda. Le site est conservé en local dans le répertoire /home/freda/sites/elsewhere/ site anothersite server ftp.elsewhere.com username freda password blahblahblah local /home/freda/sites/elsewhere/ remote /www/freda/ # Freda veut ignorer les fichiers à l'extension .bak ou # se terminant par un ~: exclude .bak exclude *~ [b]Serveur webdav, usage simple[/b] Cet exemple montre comment définir un site avec un serveur WebDAV. site supersite server dav.wow.com protocol webdav username pow password zap local /home/joe/www/super/ remote / [size=18] [b]Fichiers[/b] [/size] [i]~/.sitecopyrc[/i] Emplacement par défaut du fichier de configuration. [b][/b] [i]~/.sitecopy/[/i] Répertoire de stockage des informations sur les fichiers du site distant. [b][/b] [i]~/.netrc[/i] Informations relatives aux comptes sur des serveurs distants. [b][/b] [size=18] [b]Bugs[/b] [/size] Problèmes connus : Les modes récupération et synchronisation ne sont PAS fiables avec le protocole FTP. Si vous avez besoin d'opérations atomiques de récupération d'informations et de synchronisation de fichiers, n'utilisez pas sitecopy ; essayez plutôt rsync. Veuillez envoyer vos rapports d'anomalies et demandes d'améliorations à <sitecopy@lyra.org> plutôt qu'à l'auteur lui-même, puisque la liste de diffusion archive ses messages et les vôtres pourraient être utiles à d'autres utilisateurs. [size=18] [b]Voir aussi[/b] [/size] rsync(1), ftp(1), mirror(1) [size=18] [b]Standards[/b] [/size] [Cités seulement pour référence, l'auteur ne revendique aucune conformité à aucun de ces standards.] [b]RFC 959 - File Transfer Protocol (FTP)[/b] [b][/b] [b]RFC 1521 - Multipurpose Internet Mail Extensions Part One[/b] [b][/b] [b]RFC 1945 - Hypertext Transfer Protocol -- HTTP/1.0[/b] [b][/b] [b]RFC 2396 - Uniform Resource Identifiers: Generic Syntax[/b] [b][/b] [b]RFC 2518 - HTTP Extensions for Distributed Authoring -- WEBDAV[/b] [b][/b] [b]RFC 2616 - Hypertext Transfer Protocol -- HTTP/1.1[/b] [b][/b] [b]RFC 2617 - HTTP Authentication[/b] [b][/b] [b]REC-XML - Extensible Markup Language (XML) 1.0[/b] [b][/b] [b]REC-XML-NAMES - Namespaces in XML[/b] [size=18] [b]Ébauches de standards[/b] [/size] [b]draft-ietf-ftpext-mlst-05.txt - Extensions to FTP[/b] [b][/b] [b]draft-ietf-webdav-collections-protocol-03.txt - WebDAV Advanced Collections Protocol[/b] [size=18] [b]Auteurs[/b] [/size] Joe Orton et d'autres. [b][/b] e-mail: sitecopy@lyra.org [b][/b] www: http://www.lyra.org/sitecopy/ [size=18] [b]Traduction[/b] [/size] Nicolas Girard <[i]girard_nicolas[/i] at yahoo.fr>, 2004. [size=18] [b]Traduction[/b] [/size] Il est possible que cette traduction soit imparfaite ou périmée. En cas de doute, veuillez vous reporter au document original en langue anglaise fourni avec le programme.
Fichier