gitremote-helpers – En ligne dans le Cloud

PROGRAMME:

Nom

gitremote-helpers - Programmes d'assistance pour interagir avec les dépôts distants

SYNOPSIS

jet à distance- [ ]

DESCRIPTION

Les programmes d'assistance à distance ne sont généralement pas utilisés directement par les utilisateurs finaux, mais ils sont invoqués
par Git lorsqu'il doit interagir avec des dépôts distants. Git ne prend pas en charge nativement.
L'assistant fourni implémentera un sous-ensemble des fonctionnalités documentées ici. Lorsque Git en aura besoin,
pour interagir avec un référentiel à l'aide d'un assistant distant, il génère l'assistant en tant que
processus indépendant, envoie des commandes à l'entrée standard de l'assistant et attend des résultats
depuis la sortie standard de l'assistant. Un assistant distant s'exécute comme un processus indépendant.
à partir de Git, il n'est pas nécessaire de relier Git pour ajouter un nouvel assistant, ni de lier le
assistant à l'implémentation de Git.

Chaque assistant doit prendre en charge la commande « capacités », que Git utilise pour déterminer ce qui
d'autres commandes que l'assistant acceptera. Ces autres commandes peuvent être utilisées pour découvrir et
mettre à jour les références distantes, transporter les objets entre la base de données d'objets et la base de données distante
référentiel et mettre à jour le magasin d'objets local.

Git est livré avec une famille « curl » d'assistants distants, qui gèrent divers protocoles de transport,
tel que git-remote-http, git-remote-https, git-ftp à distance et git-remote-ftps. Ces palmes
mettre en œuvre les capacités rapporter, optionet pousser.

INVOCATION

Les programmes d'assistance à distance sont invoqués avec un ou (éventuellement) deux arguments. Le premier
L'argument spécifie un référentiel distant comme dans Git ; il s'agit soit du nom d'un référentiel configuré
distant ou une URL. Le deuxième argument spécifie une URL ; elle est généralement de la forme
://, mais n'importe quelle chaîne arbitraire est possible. GIT_DIR convivial
la variable est configurée pour l'assistant distant et peut être utilisée pour déterminer où stocker
données supplémentaires ou à partir de quel répertoire appeler les commandes Git auxiliaires.

Lorsque Git rencontre une URL du formulaire ://, Où est une
protocole qu'il ne peut pas gérer nativement, il invoque automatiquement jet à distance-
avec l'URL complète comme second argument. Si une telle URL est rencontrée directement sur le
ligne de commande, le premier argument est le même que le second, et s'il est rencontré dans un
télécommande configurée, le premier argument est le nom de cette télécommande.

Une URL du formulaire :: demande explicitement à Git d'invoquer jet
à distance- avec comme deuxième argument. Si une telle URL est rencontrée,
directement sur la ligne de commande, le premier argument est , et si elle est rencontrée dans
une télécommande configurée, le premier argument est le nom de cette télécommande.

De plus, lorsqu'une télécommande configurée a télécommande. .vcs ajuster à , Gite
invoque explicitement jet à distance- avec comme premier argument. Si défini, le
le deuxième argument est télécommande. .url; sinon, le deuxième argument est omis.

CONTRIBUTION Format

Git envoie à l'assistant distant une liste de commandes sur l'entrée standard, une par ligne. La première
la commande est toujours la capacités commande, en réponse à laquelle l'assistant distant doit
imprimez une liste des fonctionnalités prises en charge (voir ci-dessous) suivie d'une ligne vide.
La réponse à la commande capabilities détermine les commandes que Git utilise dans le reste de
le flux de commandes.

Le flux de commandes se termine par une ligne vide. Dans certains cas (indiqués dans le
documentation des commandes concernées), cette ligne vide est suivie d'une charge utile dans certains
un autre protocole (par exemple, le protocole pack), tandis que dans d'autres, il indique la fin de l'entrée.

Solutions
Chaque assistant distant est censé prendre en charge uniquement un sous-ensemble de commandes. Les opérations
Les supports d'assistance sont déclarés à Git dans la réponse à la commande capabilities (voir
COMMANDES, ci-dessous).

Dans ce qui suit, nous listons toutes les capacités définies et pour chacune d'elles, nous listons les commandes
l'assistant doté de cette capacité doit fournir.

Solutions pour Poussant
Contact
Peut tenter de se connecter à jet recevoir-pack (pour pousser), jet télécharger-pack, etc. pour
communication utilisant le protocole packfile natif de Git. Cela nécessite une connexion bidirectionnelle,
connexion full-duplex.

Commandes prises en charge : Contact.

pousser
Peut découvrir des références distantes et envoyer des commits locaux et l'historique qui y a conduit
aux références distantes nouvelles ou existantes.

Commandes prises en charge : liste pour-pousser, pousser.

Exporter
Peut découvrir des références distantes et pousser des objets spécifiés à partir d'un flux d'importation rapide vers
références à distance.

Commandes prises en charge : liste pour-pousser, Exporter.

Si un assistant fait de la publicité Contact, Git l'utilisera si possible et reviendra à un autre
capacité si l'assistant le demande lors de la connexion (voir le Contact commande sous
COMMANDES). Lors du choix entre pousser et Exporter, Git préfère pousser. Autres interfaces
peut avoir un autre ordre de préférence.

pas de mise à jour privée
Lorsque vous utilisez le spécification de référence capacité, git met normalement à jour la référence privée sur
poussée réussie. Cette mise à jour est désactivée lorsque l'assistant distant déclare
aptitude pas de mise à jour privée.

Solutions pour Aller chercher
Contact
Peut essayer de se connecter à jet télécharger-pack (pour aller chercher), jet recevoir-pack, etc. pour
communication utilisant le protocole de fichier pack natif de Git. Cela nécessite un
connexion bidirectionnelle en duplex intégral.

Commandes prises en charge : Contact.

rapporter
Peut découvrir des références distantes et transférer des objets accessibles depuis celles-ci vers les références locales
magasin d'objets.

Commandes prises en charge : liste, rapporter.

importer
Peut découvrir des références distantes et des objets de sortie accessibles à partir d'elles sous forme de flux dans
format d'importation rapide.

Commandes prises en charge : liste, importer.

vérifier la connectivité
Peut garantir que lorsqu'un clone est demandé, le pack reçu est autonome
et est connecté.

Si un assistant fait de la publicité Contact, Git l'utilisera si possible et reviendra à un autre
capacité si l'assistant le demande lors de la connexion (voir le Contact commande sous
COMMANDES). Lors du choix entre rapporter et importer, Git préfère rapporter. Autres interfaces
peut avoir un autre ordre de préférence.

Divers capacités
option
Pour spécifier des paramètres tels que la verbosité (la quantité de sortie à écrire sur stderr) et
profondeur (la quantité d'historique souhaitée dans le cas d'un clone superficiel) qui affecte la façon dont
d'autres commandes sont exécutées.

spécification de référence
Pour les assistants à distance qui mettent en œuvre importer or Exporter, cette capacité permet à
les références doivent être contraintes à un espace de noms privé, au lieu d'écrire dans des références/têtes ou
références/télécommandes directement. Il est recommandé à tous les importateurs fournissant les importer
utiliser cette capacité. C'est obligatoire pour Exporter.

Un assistant annonçant la spécification de référence de capacité
refs/heads/*:refs/svn/origin/branches/* indique que, lorsqu'on lui demande d'importer
refs/heads/topic, le flux qu'il génère mettra à jour le
refs/svn/origin/branches/topic ref.

Cette fonctionnalité peut être annoncée plusieurs fois. La première spécification de référence applicable
a la priorité. La partie gauche des spécifications de référence annoncées avec cette fonctionnalité doit
couvre toutes les références signalées par la commande list. Si aucune spécification de référence la capacité est
annoncé, il y a une refspec implicite *:*.

Lors de l'écriture d'assistants distants pour des systèmes de contrôle de version décentralisés, il est
conseillé de conserver une copie locale du référentiel pour interagir avec, et de laisser le
les références d'espace de noms privés pointent vers ce référentiel local, tandis que les références/distants
L'espace de noms est utilisé pour suivre le référentiel distant.

bidi-import
Cela modifie le importer capacité. Les commandes d'importation rapide chat-blob et ls Vous pouvez
être utilisé par les assistants à distance pour récupérer des informations sur les blobs et les arbres qui
existent déjà dans la mémoire de fast-import. Cela nécessite un canal de fast-import vers
l'assistant distant. S'il est annoncé en plus de « import », Git établit une
de l'importation rapide vers l'entrée standard de l'assistant distant. Il s'ensuit que Git et
Les imports rapides sont tous deux connectés à l'entrée standard de l'assistant distant. Git peut envoyer
plusieurs commandes à l'assistant distant, il est nécessaire que les assistants qui utilisent
bidi-import tamponner tout importer commandes d'un lot avant d'envoyer des données à
Importation rapide. Ceci permet d'éviter de mélanger les commandes et les réponses d'importation rapide sur le
entrée standard de l'assistant.

marques d'exportation
Cela modifie le Exporter capacité, demandant à Git de vider les marques internes
table à une fois terminé. Pour plus de détails, consultez --export-marques= in
git-fast-export (1).

marques d'importation
Cela modifie le Exporter capacité, demandant à Git de charger les marques spécifiées
dans avant de traiter toute entrée. Pour plus de détails, consultez
--import-marques= in git-fast-export (1).

balises signées
Cela modifie le Exporter capacité, demandant à Git de transmettre
--signed-tags=verbatim à git-fast-export(1). En l'absence de cette capacité,
Git utilisera --signed-tags=avertissement-strip.

COMMANDES

Les commandes sont données par l'appelant sur l'entrée standard de l'assistant, une par ligne.

capacités
Liste les fonctionnalités de l'assistant, une par ligne, se terminant par une ligne vide.
la capacité peut être précédée de *, ce qui les rend obligatoires pour les versions Git utilisant
L'assistant distant doit comprendre. Toute capacité obligatoire inconnue constitue une erreur fatale.

La prise en charge de cette commande est obligatoire.

liste
Répertorie les références, une par ligne, au format « [ ...]". La valeur
peut être un hachage hexadécimal sha1, "@ " pour une référence symbolique, ou "?" pour indiquer que l'assistant
Impossible d'obtenir la valeur de la référence. Une liste d'attributs séparés par des espaces suit la
nom ; les attributs non reconnus sont ignorés. La liste se termine par une ligne vide.

Voir ATTRIBUTS DE LA LISTE DE RÉFÉRENCE pour une liste des attributs actuellement définis.

Pris en charge si l'assistant dispose de la capacité « récupérer » ou « importer ».

liste pour-pousser
Similaire à liste, sauf qu'il est utilisé si et seulement si l'appelant veut
Liste de références résultante pour préparer les commandes push. Un assistant prenant en charge les commandes push et fetch.
peut utiliser ceci pour distinguer pour quelle opération la sortie de liste va être
utilisé, réduisant éventuellement la quantité de travail à effectuer.

Pris en charge si l'assistant dispose de la capacité « push » ou « export ».

option
Définit l'option d'aide au transport à . Affiche une seule ligne contenant
un ok (option définie avec succès), non pris en charge (option non reconnue) ou erreur
(option est pris en charge mais n'est pas valable pour cela). Les options doivent être
placé avant d'autres commandes et peut influencer le comportement de ces commandes.

Voir OPTIONS pour une liste des options actuellement définies.

Pris en charge si l'assistant dispose de la capacité « option ».

rapporter
Récupère l'objet donné et écrit les objets nécessaires dans la base de données.
Les commandes sont envoyées par lots, une par ligne, et terminées par une ligne vide.
Une seule ligne vide lorsque toutes les commandes de récupération d'un même lot sont terminées. Seuls les objets
qui ont été signalés dans la sortie de liste avec un sha1 peut être récupéré de cette façon.

En option, peut générer un bloquer ligne indiquant un fichier sous GIT_DIR/objects/pack
qui consiste à conserver un pack jusqu'à ce que les références puissent être convenablement mises à jour.

Si option vérifier la connectivité est demandé, l'assistant doit afficher connectivité-ok if
le clone est autonome et connecté.

Pris en charge si l'assistant a la capacité « récupérer ».

pousser + :
Pousse le local donné valider ou créer une branche vers la branche distante décrite par .
Une séquence de lots d'un ou plusieurs pousser les commandes se terminent par une ligne vide (si
il n'y a qu'une seule référence à push, une seule pousser la commande est suivie d'un espace
ligne). Par exemple, voici deux lots de pousser, le premier demandant le
assistant à distance pour pousser la référence locale maître à la référence distante maître et le local TÊTE
à la télécommande une succursale, et le deuxième demandant de pousser l'arbitre foo à ref Bar (mise à jour forcée
demandé par le +).

pousser refs/heads/master:refs/heads/master
pousser HEAD:refs/heads/branch
\n
pousser +refs/heads/foo:refs/heads/bar
\n

Aucune ou plusieurs options de protocole peuvent être saisies après la dernière pousser commande, avant le
ligne vide de fin de lot.

Lorsque la poussée est terminée, génère un ou plusieurs ok or erreur ? lignes
pour indiquer la réussite ou l'échec de chaque référence poussée. Le rapport d'état est
terminé par une ligne vide. Le champ d'option peut être cité dans une chaîne de style C
s'il contient un LF.

Pris en charge si l'assistant a la capacité « push ».

importer
Produit un flux d'importation rapide qui importe la valeur actuelle de la référence nommée. Il peut
importez également d'autres références si nécessaire pour construire l'historique efficacement.
Le script écrit dans un espace de noms privé spécifique à l'assistant. La valeur de la référence nommée
doit être écrit dans un emplacement de cet espace de noms dérivé en appliquant les refspecs
de la capacité « refspec » au nom de la référence.

Particulièrement utile pour l'interopérabilité avec un système de gestion de versions étranger.

Tout comme pousser, une séquence de lots d'un ou plusieurs importer se termine par un blanc
ligne. Pour chaque lot de importer, l'assistant distant doit produire un flux d'importation rapide
terminé par un fait commander.

Notez que si le bidi-import la capacité est utilisée, la séquence de lots complète doit être
mis en mémoire tampon avant de commencer à envoyer des données à l'importation rapide pour éviter le mélange des commandes et
réponses d'importation rapide sur l'entrée standard de l'assistant.

Pris en charge si l'assistant dispose de la capacité « importer ».

Exporter
Indique à l'assistant distant que toute entrée ultérieure fait partie d'un flux d'importation rapide
(généré par jet exportation rapide) contenant des objets qui doivent être poussés vers le
éloigné.

Particulièrement utile pour l'interopérabilité avec un système de gestion de versions étranger.

Le manuel de formation marques d'exportation et marques d'importation les capacités, si elles sont spécifiées, affectent cette commande dans
dans la mesure où ils sont transmis à jet exportation rapide, qui chargera/stockera ensuite une table de
Marques pour les objets locaux. Ceci peut être utilisé pour implémenter des opérations incrémentielles.

Pris en charge si l'assistant dispose de la capacité « exporter ».

Contact
Se connecte au service donné. L'entrée et la sortie standard de l'assistant sont connectées.
au service spécifié (le préfixe git est inclus dans le nom du service, donc par exemple, la récupération utilise
git-upload-pack (en tant que service) côté distant. Les réponses valides à cette commande sont vides.
ligne (connexion établie), se retirer (pas de support de transport intelligent, retour au mode muet
transports) et juste quitter avec un message d'erreur imprimé (impossible de se connecter, ne vous embêtez pas
(tentant de revenir en arrière). Après le saut de ligne mettant fin à la réponse positive (vide), le
La sortie du service démarre. Une fois la connexion terminée, l'assistant distant se ferme.

Pris en charge si l'assistant dispose de la capacité « connecter ».

Si une erreur fatale se produit, le programme écrit le message d'erreur sur stderr et se termine.
l'appelant doit s'attendre à ce qu'un message d'erreur approprié soit imprimé si l'enfant ferme
la connexion sans compléter une réponse valide pour la commande en cours.

Des commandes supplémentaires peuvent être prises en charge, comme cela peut être déterminé à partir des capacités signalées par
l'assistant.

REF LISTE CARACTÉRISTIQUES

Le manuel de formation liste La commande produit une liste de références dans laquelle chaque référence peut être suivie d'une liste de
attributs. Les attributs de la liste de références suivants sont définis.

inchangé
Cette référence est inchangée depuis la dernière importation ou récupération, bien que l'assistant ne puisse pas
déterminer nécessairement quelle valeur cela produit.

OPTIONS

Les options suivantes sont définies et (dans des circonstances appropriées) définies par Git si le
l'assistant à distance a le option capacité.

option verbosité
Modifie la verbosité des messages affichés par l'assistant. Une valeur de 0 pour moyens
que les processus fonctionnent silencieusement et que l'assistant ne produit qu'une sortie d'erreur. 1 est le
niveau de verbosité par défaut et valeurs plus élevées de correspondent au nombre de -v
drapeaux passés sur la ligne de commande.

option le progrès {oui|non}
Active (ou désactive) les messages de progression affichés par l'assistant de transport pendant une
commander.

option profondeur
Approfondit l’histoire d’un référentiel peu profond.

option suivre les tags {oui|non}
Si cette option est activée, l'assistant doit automatiquement récupérer les objets de balise annotés si l'objet
La balise vers laquelle elle pointe a été transférée lors de la commande de récupération. Si la balise n'est pas récupérée,
par l'assistant, une deuxième commande de récupération sera généralement envoyée pour demander la balise
spécifiquement. Certains assistants peuvent utiliser cette option pour éviter un second réseau
connexion.

option à sec {oui|non}: Si vrai, faire comme si l'opération s'était terminée avec succès, mais
ne modifient pas réellement les données du référentiel. Pour la plupart des assistants, cela ne s'applique qu'aux pousser,
si pris en charge.

option chemin de service
Définit le chemin de service (--upload-pack, --receive-pack, etc.) pour la prochaine connexion. Assistant distant
peut prendre en charge cette option, mais ne doit pas compter sur cette option définie avant la connexion
la demande se produit.

option vérifier la connectivité {oui|non}
Demandez à l'assistant de vérifier la connectivité d'un clone.

option forcer {oui|non}
Demander à l'assistant d'effectuer une mise à jour forcée. Valeur par défaut : non.

option clonage {'vrai|non}
Notifier l'assistant qu'il s'agit d'une demande de clonage (c'est-à-dire que le référentiel actuel est garanti)
vide).

option mise à jour superficielle {'vrai|non}
Autoriser l'extension de .git/shallow si les nouvelles références le nécessitent.

option certificat push {'vrai|non}
Le panneau GPG pousse.

Utiliser gitremote-helpers en ligne avec les services onworks.net