Français ▾ Topics ▾ Latest version ▾ git-upload-archive last updated in 2.39.0

NOM

git-upload-archive - Renvoyer l’archive à git-archive

SYNOPSIS

git upload-archive <dépôt>

DESCRIPTION

Invoqué par git archive --remote et envoie une archive générée à l’autre extrémité via le protocole Git.

Cette commande n’est généralement pas invoquée directement par l’utilisateur final. L’interface utilisateur pour le protocole est du côté de git archive, et la paire de programmes est destinée à être utilisée pour obtenir une archive depuis un dépôt distant.

SÉCURITÉ

Afin de protéger la confidentialité des objets qui ont été supprimés de l’historique mais qui n’ont peut-être pas encore été purgés, git-upload-archive évite de servir des archives pour les commits et les arbres qui ne sont pas atteignables depuis les références du dépôt. Cependant, car le calcul de l’accessibilité des objets est coûteux en calcul, git-upload-archive implémente un ensemble de règles plus strict mais plus facile à vérifier :

  1. Les clients peuvent demander un commit ou un arbre qui est directement pointé par une référence. Par ex., git archive --remote=origin v1.0.

  2. Les clients peuvent demander un sous-arbre dans un commit ou un arbre en utilisant la syntaxe référence:chemin. Par ex., git archive --remote=origin v1.0:Documentation.

  3. Les clients ne doivent pas utiliser d’autres expressions sha1, même si le résultat final est atteignable. Par ex., ni un commit relatif comme master^ ni un sha1 littéral comme abcd1234 n’est autorisé, même si le résultat est atteignable depuis les références.

Notez que la règle 3 interdit de nombreux cas qui n’ont aucune implication sur la confidentialité. Ces règles sont susceptibles de changer dans les futures versions de git, et le serveur accédé par git archive --remote peut ou non suivre ces règles exactes.

Si l’option de configuration uploadArchive.allowUnreachable est vraie, ces règles sont ignorées, et les clients peuvent utiliser des expressions sha1 arbitraires. C’est utile si vous ne vous souciez pas de la confidentialité des objets inatteignables, ou si votre base de données d’objets est déjà disponible publiquement pour un accès via non-smart-http.

OPTIONS

<dépôt>

Le dépôt depuis lequel obtenir une archive tar.

GIT

Fait partie de la suite git[1]

TRADUCTION

Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site https://github.com/jnavila/git-manpages-l10n .