English ▾ Themen ▾ Neueste Version ▾ git-upload-archive zuletzt aktualisiert in 2.39.0

NAME

git-upload-archive - Archiv an git-archive senden

SYNOPSIS

git upload-archive <repository>

BESCHREIBUNG

Wird von git archive --remote aufgerufen und sendet ein generiertes Archiv über das Git-Protokoll an das andere Ende.

Dieser Befehl wird normalerweise nicht direkt vom Endbenutzer aufgerufen. Die Benutzeroberfläche für das Protokoll liegt auf der Seite von git archive, und das Programmpaar soll verwendet werden, um ein Archiv aus einem entfernten Repository zu erhalten.

SICHERHEIT

Um die Privatsphäre von Objekten zu schützen, die aus der Historie entfernt wurden, aber möglicherweise noch nicht bereinigt wurden, vermeidet git-upload-archive das Ausliefern von Archiven für Commits und Bäume, die nicht von den Refs des Repositories erreichbar sind. Da die Berechnung der Objekt-Erreichbarkeit jedoch rechenintensiv ist, implementiert git-upload-archive einen strengeren, aber einfacher zu überprüfenden Regelsatz.

  1. Clients können einen Commit oder Baum anfordern, auf den direkt von einem Ref verwiesen wird. Z.B. git archive --remote=origin v1.0.

  2. Clients können einen Unterbaum innerhalb eines Commits oder Baums mithilfe der ref:path Syntax anfordern. Z.B. git archive --remote=origin v1.0:Dokumentation.

  3. Clients dürfen keine anderen SHA1-Ausdrücke verwenden, auch wenn das Endergebnis erreichbar ist. Z.B. weder ein relativer Commit wie master^ noch ein wörtlicher SHA1 wie abcd1234 ist erlaubt, auch wenn das Ergebnis von den Refs erreichbar ist.

Beachten Sie, dass Regel 3 viele Fälle verbietet, die keine Auswirkungen auf die Privatsphäre haben. Diese Regeln können sich in zukünftigen Git-Versionen ändern, und der vom git archive --remote-Befehl angesprochene Server befolgt diese genauen Regeln möglicherweise nicht.

Wenn die Konfigurationsoption uploadArchive.allowUnreachable auf true gesetzt ist, werden diese Regeln ignoriert, und Clients können beliebige SHA1-Ausdrücke verwenden. Dies ist nützlich, wenn Sie sich nicht um die Privatsphäre von nicht erreichbaren Objekten kümmern oder wenn Ihre Objektdatenbank bereits öffentlich über nicht-smart-http zugänglich ist.

OPTIONEN

<repository>

Das Repository, aus dem ein Tar-Archiv abgerufen werden soll.

GIT

Teil der git[1] Suite