Git - Was ist "Refspec"

Einer refspec sagt git, wie die Zuordnung von Referenzen von einem entfernten auf den lokalen repo.

Den Wert, den Sie aufgeführt wurde +refs/heads/*:refs/remotes/origin/* +refs/merge-requests/*/head:refs/remotes/origin/merge-requests/*; also lassen Sie uns brechen, dass nach unten.

Haben Sie zwei Muster, die mit einem Raum zwischen Ihnen; dies bedeutet nur, Sie geben mehrere Regeln. (Das pro git-Buch bezieht sich auf diese als zwei refspecs; das ist wohl technisch korrekt. Allerdings werden Sie fast immer haben die Fähigkeit, Liste mehrere refspecs wenn Sie brauchen, um, so in den Tag zu Tag Leben, das es wahrscheinlich macht wenig Unterschied.)

Die ersten Muster, dann ist +refs/heads/*:refs/remotes/origin/* hat drei Teile:

Den + Mittel, um die Regel anwenden, ohne Fehler, selbst wenn dabei bewegen würde, ein Ziel-ref in eine nicht-fast-forward-Manier. Ich komme noch darauf zurück.

Den Teil vor dem : (aber nach der + wenn es eine ist) die "source" - Muster. Das ist refs/heads/*, was bedeutet diese Regel gilt für jede remote-Referenz unter refs/heads (was bedeutet, Zweige).

Den Teil nach dem : ist die "Ziel" - Muster. Das ist refs/remotes/origin/*.

Also, wenn der Ursprung hat eine Niederlassung master, dargestellt als refs/heads/master, so erstellen Sie einen remote-branch Referenz origin/master vertreten als refs/remotes/origin/master. Und so weiter für jeden Zweig-name (*).

Also zurück +... angenommen, der Ursprung

A --- B <--(master)

Holen Sie sich und, die Anwendung, die refspec erhalten Sie

A --- B <--(origin/master)

(Wenn Sie typische tracking-Regeln und hat einen pull haben Sie auch master wies auf B.)

A --- B <--(origin/master)(master)

Nun einige Dinge geschehen auf der Fernbedienung. Jemand habe vielleicht eine reset löschen B, dann verpflichtet C, dann gezwungen, einen push. Also die remote, sagt

A --- C <--(master)

Wenn Sie Holen, Sie bekommen

A --- B
 \
  C

und git müssen entscheiden, ob Sie erlauben das verschieben von origin/master aus B zu C. Standardmäßig würde es nicht zulassen, weil dies nicht einem fast-forward - (würde es Ihnen sagen, es abgelehnt, den Zug für die das "ref"), aber da die Regel beginnt mit + so wird es akzeptieren.

A --- B <--(master)
 \
  C <--(origin/master)

(Pull wird in diesem Fall dazu führen, dass ein merge-commit.)

Das zweite Muster ist ähnlich, aber für merge-requests refs (die ich annehmen, ist in Bezug auf Ihre server die Umsetzung von PR -, ich bin nicht mit ihm vertraut).

Mehr über refspecs: https://git-scm.com/book/en/v2/Git-Internals-The-Refspec