gitremote-helpers - Online in de cloud

PROGRAMMA:

NAAM

gitremote-helpers - Helperprogramma's voor interactie met externe opslagplaatsen

KORTE INHOUD

git op afstand- [ ]

PRODUCTBESCHRIJVING

Hulpprogramma's op afstand worden normaal gesproken niet rechtstreeks door eindgebruikers gebruikt, maar worden wel opgeroepen
door Git wanneer het moet communiceren met externe repository's. Git ondersteunt dit niet standaard. A
De gegeven helper zal een subset van de hier gedocumenteerde mogelijkheden implementeren. Wanneer Git het nodig heeft
om met een repository te communiceren met behulp van een externe helper, wordt de helper als een
onafhankelijk proces, stuurt opdrachten naar de standaardinvoer van de helper en verwacht resultaten
uit de standaarduitvoer van de helper. Omdat een helper op afstand als een zelfstandig proces draait
vanuit Git is het niet nodig om Git opnieuw te koppelen om een ​​nieuwe helper toe te voegen, noch is het nodig om de
helper bij de implementatie van Git.

Elke helper moet het commando "capabilities" ondersteunen, dat Git gebruikt om te bepalen wat
andere commando's die de helper accepteert. Die andere opdrachten kunnen worden gebruikt om te ontdekken en
update externe referenties, transporteer objecten tussen de objectdatabase en de externe
repository en werk de lokale objectopslag bij.

Git wordt geleverd met een "curl"-familie van externe helpers, die verschillende transportprotocollen afhandelen,
zoals git-remote-http, git-remote-https, git-remote-ftp en git-remote-ftps. Zij
de mogelijkheden implementeren halen, optie en duwen.

AANROEPING

Hulpprogramma's op afstand worden aangeroepen met één of (optioneel) twee argumenten. De eerste
argument specificeert een externe repository zoals in Git; het is ofwel de naam van een geconfigureerd
afstandsbediening of een URL. Het tweede argument specificeert een URL; het is meestal van de vorm
://, maar elke willekeurige string is mogelijk. De GIT_DIR milieu
variabele is ingesteld voor de externe helper en kan worden gebruikt om te bepalen waar deze moet worden opgeslagen
aanvullende gegevens of vanuit welke map aanvullende Git-opdrachten moeten worden aangeroepen.

Wanneer Git een URL van het formulier tegenkomt ://, Waar is een
protocol dat het niet native kan verwerken, wordt automatisch aangeroepen git op afstand-
met de volledige URL als tweede argument. Als een dergelijke URL rechtstreeks op de
opdrachtregel, is het eerste argument hetzelfde als het tweede, en als het wordt aangetroffen in a
geconfigureerde afstandsbediening, is het eerste argument de naam van die afstandsbediening.

Een URL van het formulier :: geeft Git expliciet de opdracht om aan te roepen git
op afstand- Met als tweede argument. Als een dergelijke URL wordt aangetroffen
direct op de opdrachtregel is het eerste argument , en of het wordt aangetroffen in
een geconfigureerde afstandsbediening is, is het eerste argument de naam van die afstandsbediening.

Bovendien, wanneer een geconfigureerde afstandsbediening dat heeft op afstand. .vcs ingesteld op , Geit
expliciet beroept git op afstand- Met als eerste argument. Indien ingesteld, wordt de
tweede argument is op afstand. .url; anders wordt het tweede argument weggelaten.

INVOER FORMAT

Git stuurt de externe helper een lijst met commando's op standaardinvoer, één per regel. De eerste
commando is altijd de mogelijkheden commando, in reactie waarop de helper op afstand moet
druk een lijst af met de mogelijkheden die het ondersteunt (zie hieronder), gevolgd door een lege regel. De
reactie op het capaciteiten commando bepaalt welke commando's Git gebruikt in de rest van
de commandostroom.

De opdrachtstroom wordt beëindigd met een lege regel. In sommige gevallen (aangegeven in de
documentatie van de relevante commando's), wordt deze lege regel in sommige gevallen gevolgd door een payload
ander protocol (bijvoorbeeld het pack-protocol), terwijl dit bij andere het einde van de invoer aangeeft.

Mogelijkheden
Van elke helper op afstand wordt verwacht dat hij slechts een subset van opdrachten ondersteunt. De operaties A
helper-ondersteuningen worden bij Git gedeclareerd in het antwoord op het commando capabilities (zie
OPDRACHTEN, hieronder).

Hieronder geven we een lijst van alle gedefinieerde mogelijkheden en voor elke optie vermelden we welke opdrachten a
helper met die mogelijkheid moet bieden.

Mogelijkheden For voortvarend
connect
Kan proberen verbinding te maken git ontvang-pakket (om te duwen), git upload-pakket, enz. voor
communicatie met behulp van het eigen packfile-protocol van git. Dit vereist een tweerichtingsverkeer,
full-duplex verbinding.

Ondersteunde commando's: connect.

duwen
Kan externe refs ontdekken en lokale commits en de geschiedenis die daaraan voorafgaat pushen
naar nieuwe of bestaande externe refs.

Ondersteunde commando's: lijst voor-push, duwen.

exporteren
Kan referenties op afstand ontdekken en gespecificeerde objecten uit een snel importstream pushen
externe ref.

Ondersteunde commando's: lijst voor-push, exporteren.

Als een helper adverteert connect, Git zal het indien mogelijk gebruiken en terugvallen op een ander
mogelijkheid als de helper dit vraagt ​​bij het verbinden (zie de connect commando onder
OPDRACHTEN). Bij het kiezen tussen duwen en exporteren, Git geeft de voorkeur duwen. Andere frontends
kan een andere volgorde van voorkeur hebben.

geen-privé-update
Bij gebruik van het referentiespecificatie mogelijkheid werkt git normaal gesproken de privéreferentie bij
succesvolle duw. Deze update wordt uitgeschakeld wanneer de externe helper het
bekwaamheid geen-privé-update.

Mogelijkheden For Ophalen
connect
Kan proberen verbinding te maken git upload-pakket (voor ophalen), git ontvang-pakket, enz. voor
communicatie met behulp van het eigen packfile-protocol van Git. Dit vereist een
bidirectionele, full-duplex verbinding.

Ondersteunde commando's: connect.

halen
Kan externe referenties ontdekken en objecten die van daaruit bereikbaar zijn, overbrengen naar de lokale
object winkel.

Ondersteunde commando's: lijst, halen.

importeren
Kan referenties op afstand ontdekken en objecten uitvoeren die vanaf hen bereikbaar zijn als een stream-in
snel importformaat.

Ondersteunde commando's: lijst, importeren.

controleer connectiviteit
Kan garanderen dat wanneer een kloon wordt aangevraagd, het ontvangen pakket op zichzelf staat
en is verbonden.

Als een helper adverteert connect, Git zal het indien mogelijk gebruiken en terugvallen op een ander
mogelijkheid als de helper dit vraagt ​​bij het verbinden (zie de connect commando onder
OPDRACHTEN). Bij het kiezen tussen halen en importeren, Git geeft de voorkeur halen. Andere frontends
kan een andere volgorde van voorkeur hebben.

Diversen mogelijkheden
optie
Voor het opgeven van instellingen zoals breedsprakigheid (hoeveel uitvoer er naar stderr moet worden geschreven) en
diepte (hoeveel geschiedenis is gewenst in het geval van een ondiepe kloon) die van invloed zijn op hoe
andere commando's worden uitgevoerd.

referentiespecificatie
Voor helpers op afstand die implementeren importeren or exporteren, deze mogelijkheid maakt het mogelijk
refs moet worden beperkt tot een privénaamruimte, in plaats van te schrijven naar refs/heads of
refs/afstandsbedieningen direct. Het wordt aanbevolen dat alle importeurs die de importeren
mogelijkheid gebruik dit. Het is verplicht voor exporteren.

Een helper die reclame maakt voor de mogelijkheid refspec
refs/heads/*:refs/svn/origin/branches/* zegt dat wanneer wordt gevraagd om te importeren
refs/heads/topic, de stream die het uitvoert, zal de
refs/svn/oorsprong/branches/onderwerp ref.

Deze mogelijkheid kan meerdere keren worden geadverteerd. De eerste toepasselijke refspec
heeft voorrang. De linkerhand van de refspecificaties die met deze mogelijkheid worden geadverteerd, moet dat wel doen
bestrijk alle refs gerapporteerd door de lijstopdracht. Als Nee referentiespecificatie vermogen is
geadverteerd, is er een impliciete refspecificatie *:*.

Bij het schrijven van remote-helpers voor gedecentraliseerde versiebeheersystemen is dat wel het geval
geadviseerd om een ​​lokale kopie van de repository te bewaren voor interactie, en om de
private naamruimte refs verwijzen naar deze lokale repository, terwijl de refs/remotes
naamruimte wordt gebruikt om de externe repository te volgen.

bidi-import
Dit wijzigt de importeren vermogen. De snelimportopdrachten kat-blob en ls wel
worden gebruikt door helpers op afstand om informatie op te halen over blobs en bomen die
bestaan ​​al in het geheugen van fast-import. Hiervoor is een kanaal nodig van fast-import naar
de hulp op afstand. Als het naast "importeren" wordt geadverteerd, maakt Git een
pipe van fast-import naar de stdin van de externe helper. Hieruit volgt dat Git en
fast-import zijn beide verbonden met de stdin van de externe helper. Omdat Git kan verzenden
meerdere commando's naar de remote-helper waarvan de helpers gebruik moeten maken
bidi-import alles bufferen importeren opdrachten van een batch voordat er gegevens naar worden verzonden
snel importeren. Dit is om te voorkomen dat commando's en snelle importreacties op het
standaard van de helper.

export-merken
Dit wijzigt de exporteren mogelijkheid, waarbij Git wordt geïnstrueerd om de interne markeringen te dumpen
tafel aan wanneer voltooid. Lees verder voor meer informatie --export-markeringen= in
git-fast-export(1).

import-merken
Dit wijzigt de exporteren mogelijkheid, waarbij Git wordt geïnstrueerd om de gespecificeerde markeringen te laden
in voordat er enige invoer wordt verwerkt. Lees verder voor meer informatie
--import-markeringen= in git-fast-export(1).

ondertekende tags
Dit wijzigt de exporteren mogelijkheid, waarbij Git wordt geïnstrueerd om te slagen
--ondertekende tags=woordelijk naar git-fast-export(1). Bij gebrek aan deze mogelijkheid,
Git zal gebruiken --signed-tags=waarschuwingsstrip.

COMMANDO'S

Commando's worden door de beller gegeven via de standaardinvoer van de helper, één per regel.

mogelijkheden
Geeft de mogelijkheden van de helper weer, één per regel, eindigend met een lege regel. Elk
vermogen kan worden voorafgegaan *, wat ze verplicht markeert voor Git-versies die gebruiken
de helper op afstand om het te begrijpen. Elke onbekende verplichte mogelijkheid is een fatale fout.

Ondersteuning voor deze opdracht is verplicht.

lijst
Geeft een overzicht van de referenties, één per regel, in het formaat ' [ ...]". De waarde
kan een hex sha1-hash zijn, "@ " voor een symref, of "?" om aan te geven dat de helper
kon de waarde van de ref niet achterhalen. Een door spaties gescheiden lijst met attributen volgt de
naam; niet-herkende kenmerken worden genegeerd. De lijst eindigt met een lege regel.

Zie REF LIST ATTRIBUTEN voor een lijst met momenteel gedefinieerde attributen.

Ondersteund als de helper de mogelijkheid 'ophalen' of 'importeren' heeft.

lijst voor-push
Soortgelijke lijst, behalve dat het wordt gebruikt als en alleen als de beller dat wil
resulterende ref-lijst om push-opdrachten voor te bereiden. Een helper die zowel duwt als apporteert
kan dit gebruiken om te onderscheiden voor welke bewerking de uitvoer is lijst wordt
gebruikt, waardoor mogelijk de hoeveelheid werk die moet worden uitgevoerd wordt verminderd.

Ondersteund als de helper de mogelijkheid "push" of "export" heeft.

optie
Stelt de transporthulpoptie in naar . Voert een enkele regel uit met daarin
een van ok (optie succesvol ingesteld), niet gesteund (optie niet herkend) of fout
(keuze wordt ondersteund, maar is hiervoor niet geldig). Opties zouden dat moeten zijn
ingesteld vóór andere commando's, en kan het gedrag van die commando's beïnvloeden.

Zie OPTIES voor een lijst met momenteel gedefinieerde opties.

Ondersteund als de helper over de optie "optie" beschikt.

halen
Haalt het gegeven object op en schrijft de benodigde objecten naar de database. Ophalen
opdrachten worden batchgewijs verzonden, één per regel, afgesloten met een lege regel. Uitgangen een
enkele lege regel wanneer alle ophaalopdrachten in dezelfde batch zijn voltooid. Alleen objecten
die zijn gerapporteerd in de uitvoer van lijst met een sha1 kan op deze manier worden opgehaald.

Optioneel kan een uitvoer worden uitgevoerd slot regel die een bestand aangeeft onder GIT_DIR/objects/pack
die een pakket bewaart totdat de referenties op de juiste manier kunnen worden bijgewerkt.

Indien optie controleer connectiviteit wordt gevraagd, moet de helper uitvoeren connectiviteit-ok if
de kloon is op zichzelf staand en verbonden.

Ondersteund als de helper de mogelijkheid 'ophalen' heeft.

duwen + :
Duwt de gegeven lokale waarde commit of branch naar de externe branch beschreven door .
Een batchreeks van een of meer duwen commands wordt afgesloten met een lege regel (if
er is maar één verwijzing naar push, een single duwen commando wordt gevolgd door een spatie
lijn). Het volgende zou bijvoorbeeld twee batches zijn duwen, de eerste die de vraag stelt
remote-helper om de lokale ref meester naar de externe ref meester en de lokale HEAD
naar de afstandsbediening tak, en de tweede vraagt ​​om ref foo naar ref bars (gedwongen update
aangevraagd door de +).

druk op refs/heads/master:refs/heads/master
push HEAD:refs/heads/branch
\n
druk op +refs/heads/foo:refs/heads/bar
\n

Er kunnen na de laatste nul of meer protocolopties worden ingevoerd duwen commando, voor de
de afsluitende lege regel van de batch.

Wanneer de push voltooid is, worden er één of meer uitgevoerd ok or fout ? lijnen
om het succes of falen van elke geduwde ref aan te geven. De uitvoer van het statusrapport is
afgesloten met een lege regel. Het optieveld kan worden geciteerd in een tekenreeks in C-stijl
als het een LF bevat.

Ondersteund als de helper over de "push"-mogelijkheid beschikt.

importeren
Produceert een snelle importstroom die de huidige waarde van de genoemde ref importeert. Het kan
importeer bovendien indien nodig andere refs om de geschiedenis efficiënt op te bouwen. De
script schrijft naar een helperspecifieke privénaamruimte. De waarde van de genoemde ref
moet naar een locatie in deze naamruimte worden geschreven, afgeleid door de refspecs toe te passen
van de "refspec"-mogelijkheid tot de naam van de ref.

Vooral handig voor interoperabiliteit met een buitenlands versiebeheersysteem.

Net als duwen, een batchreeks van een of meer importeren wordt afgesloten met een spatie
lijn. Voor elke batch van importeren, zou de externe helper een snelle importstream moeten produceren
beëindigd door een gedaan opdracht.

Merk op dat als de bidi-import Wanneer de mogelijkheid wordt gebruikt, moet de volledige batchsequentie worden uitgevoerd
gebufferd voordat u begint met het verzenden van gegevens naar snel importeren om vermenging van opdrachten te voorkomen
antwoorden snel importeren op de stdin van de helper.

Ondersteund als de helper over de mogelijkheid voor "importeren" beschikt.

exporteren
Instrueert de helper op afstand dat eventuele daaropvolgende invoer deel uitmaakt van een snelle importstroom
(gegenereerd door git snel exporteren) met objecten die naar de moeten worden geduwd
afstandsbediening.

Vooral handig voor interoperabiliteit met een buitenlands versiebeheersysteem.

De export-merken en import-merken mogelijkheden, indien gespecificeerd, hebben invloed op deze opdracht
voor zover ze worden doorgegeven git snel exporteren, die vervolgens een tabel van zal laden/opslaan
markeringen voor lokale objecten. Dit kan worden gebruikt voor de implementatie van incrementele bewerkingen.

Ondersteund als de helper de mogelijkheid "exporteren" heeft.

connect
Maakt verbinding met de gegeven dienst. Standaardingang en standaarduitgang van helper zijn verbonden
naar de opgegeven service (git-voorvoegsel is opgenomen in de servicenaam, dus bijvoorbeeld ophalen gebruikt
git-upload-pakket als service) aan de externe kant. Geldige antwoorden op deze opdracht zijn leeg
lijn (verbinding tot stand gebracht), fallback (geen slimme transportondersteuning, val terug naar dom
transports) en sluit gewoon af met een afgedrukte foutmelding (kan geen verbinding maken, doe geen moeite
proberen terug te vallen). Nadat de regelfeed het positieve (lege) antwoord heeft beëindigd, wordt de
de output van de dienst begint. Nadat de verbinding is beëindigd, vertrekt de externe helper.

Ondersteund als de helper de mogelijkheid "verbinden" heeft.

Als er een fatale fout optreedt, schrijft het programma de foutmelding naar stderr en wordt afgesloten. De
De beller mag verwachten dat er een passende foutmelding wordt afgedrukt als het kind sluit
de verbinding zonder een geldig antwoord voor de huidige opdracht te voltooien.

Er kunnen aanvullende commando's worden ondersteund, zoals kan worden bepaald uit de mogelijkheden die worden gerapporteerd door
de helper.

REF LIJST ATTRIBUTEN

De lijst commando produceert een lijst met refs waarin elke ref kan worden gevolgd door een lijst met
attributen. De volgende referentielijstattributen zijn gedefinieerd.

onveranderd
Deze ref is ongewijzigd sinds de laatste import of ophaalactie, hoewel de helper dat niet kan
noodzakelijkerwijs bepalen welke waarde dat produceerde.

OPTIES

De volgende opties worden gedefinieerd en (onder geschikte omstandigheden) ingesteld door Git als de
hulp op afstand heeft de optie vermogen.

optie breedsprakigheid
Verandert de breedsprakigheid van berichten die door de helper worden weergegeven. Een waarde van 0 voor middelen
dat processen stil verlopen en dat de helper alleen foutuitvoer produceert. 1 is de
standaardniveau van breedsprakigheid en hogere waarden van corresponderen met het aantal -v
vlaggen doorgegeven op de opdrachtregel.

optie vooruitgang {waar|vals}
Schakelt voortgangsberichten in (of uit) die worden weergegeven door de transporthelper tijdens een
opdracht.

optie diepte
Verdiept de geschiedenis van een ondiepe opslagplaats.

optie volgtags {waar|vals}
Indien ingeschakeld, moet de helper automatisch geannoteerde tagobjecten ophalen als het object
de tag wijst naar werd overgedragen tijdens de ophaalopdracht. Als de tag niet wordt opgehaald
door de helper wordt meestal een tweede ophaalcommando verzonden om naar de tag te vragen
specifiek. Sommige helpers kunnen deze optie mogelijk gebruiken om een ​​tweede netwerk te vermijden
verbinding.

optie oefening {waar|vals}: Indien waar, doe dan alsof de bewerking succesvol is voltooid, maar
verander feitelijk geen repositorygegevens. Voor de meeste helpers geldt dit alleen voor de duwen,
indien ondersteund.

optie servpad
Stelt het servicepad in (--upload-pack, --receive-pack etc.) voor de volgende verbinding. Hulp op afstand
ondersteunt deze optie mogelijk, maar mag er niet op vertrouwen dat deze optie is ingesteld voordat verbinding wordt gemaakt
verzoek plaatsvindt.

optie controleer connectiviteit {waar|vals}
Vraag de helper om de connectiviteit van een kloon te controleren.

optie dwingen {waar|vals}
Vraag de helper om een ​​krachtupdate uit te voeren. Standaard ingesteld op vals.

optie klonen {'WAAR|vals}
Informeer de helper dat dit een kloonverzoek is (dat wil zeggen dat de huidige repository gegarandeerd is).
leeg).

optie update-ondiep {'WAAR|vals}
Sta toe om .git/shallow uit te breiden als de nieuwe refs dit vereisen.

optie duwcertificaat {'WAAR|vals}
GPG-bord duwt.

Gebruik gitremote-helpers online met behulp van onworks.net-services