git-fetch - Dalam talian dalam Awan

JADUAL:

NAMA

git-fetch - Muat turun objek dan rujukan dari repositori lain

SINOPSIS

pergi ambil [ ] [ [ ...]]
pergi ambil [ ]
pergi ambil --pelbagai [ ] [( | )...]
pergi ambil --semua [ ]

DESCRIPTION

Ambil cawangan dan/atau teg (secara kolektif, "rujukan") daripada satu atau lebih repositori lain,
bersama-sama dengan objek yang diperlukan untuk melengkapkan sejarah mereka. Cawangan pengesanan jauh adalah
dikemas kini (lihat penerangan tentang di bawah untuk cara mengawal tingkah laku ini).

Secara lalai, sebarang teg yang menunjuk ke dalam sejarah yang sedang diambil juga diambil; yang
kesannya ialah untuk mengambil teg yang menghala ke cawangan yang anda minati. Lalai ini
tingkah laku boleh diubah dengan menggunakan pilihan --tags atau --no-tags atau dengan mengkonfigurasi
jauh. .tagOpt. Dengan menggunakan refspec yang mengambil teg secara eksplisit, anda boleh mengambil teg
yang tidak menunjuk ke cawangan yang anda minati juga.

pergi ambil boleh diambil daripada sama ada satu repositori bernama atau URL, atau daripada beberapa
repositori sekali gus jika diberikan dan terdapat alat kawalan jauh. kemasukan dalam
fail konfigurasi. (Lihat git-config(1)).

Apabila tiada alat kawalan jauh ditentukan, secara lalai alat kawalan jauh asal akan digunakan, melainkan jika ada alat kawalan jauh
cawangan huluan dikonfigurasikan untuk cawangan semasa.

Nama rujukan yang diambil, bersama-sama dengan nama objek yang mereka tunjuk, ialah
ditulis kepada .git/FETCH_HEAD. Maklumat ini boleh digunakan oleh skrip atau arahan git lain,
seperti git-tarik(1).

PILIHAN

--semua
Ambil semua alat kawalan jauh.

-a, --tambah
Tambahkan nama rujukan dan nama objek rujukan yang diambil pada kandungan sedia ada
.git/FETCH_HEAD. Tanpa pilihan ini, data lama dalam .git/FETCH_HEAD akan ditimpa.

--depth=
Hadkan pengambilan kepada bilangan komit yang ditentukan dari hujung setiap cawangan terpencil
sejarah. Jika mengambil ke a cetek repositori yang dibuat oleh git clone dengan --depth=
pilihan (lihat git-clone(1)), mendalami atau memendekkan sejarah kepada bilangan yang ditentukan
melakukan. Teg untuk komitmen yang lebih mendalam tidak diambil.

--tidak cetek
Jika repositori sumber lengkap, tukar repositori cetek kepada yang lengkap,
mengalih keluar semua batasan yang dikenakan oleh repositori cetek.

Jika repositori sumber cetek, ambil sebanyak mungkin supaya arus
repositori mempunyai sejarah yang sama dengan repositori sumber.

--kemas kini-cetek
Secara lalai apabila mengambil dari repositori cetek, git fetch menolak rujukan itu
memerlukan pengemaskinian .git/shallow. Pilihan ini mengemas kini .git/shallow dan menerima rujukan sedemikian.

--lari kering
Tunjukkan apa yang akan dilakukan, tanpa membuat sebarang perubahan.

-f, --force
Bila pergi ambil digunakan dengan : refspec, ia enggan mengemas kini
cawangan tempatan melainkan cawangan terpencil ia mengambil adalah keturunan
daripada . Pilihan ini mengatasi semakan itu.

-k, --simpan
Simpan pek yang dimuat turun.

--pelbagai
Benarkan beberapa dan hujah yang akan dinyatakan. Tidak s mungkin
dinyatakan.

-p, --pangkas
Selepas mengambil, alih keluar sebarang rujukan penjejakan jauh yang tidak lagi wujud pada
jauh. Tag tidak tertakluk kepada pemangkasan jika ia diambil hanya kerana
teg lalai mengikut automatik atau disebabkan oleh pilihan --tags. Walau bagaimanapun, jika teg diambil kerana
kepada refspec eksplisit (sama ada pada baris arahan atau dalam konfigurasi jauh, untuk
contoh jika alat kawalan jauh telah diklon dengan pilihan --mirror), maka ia juga tertakluk
kepada pemangkasan.

-n, --tiada-tag
Secara lalai, teg yang menghala ke objek yang dimuat turun daripada repositori jauh
diambil dan disimpan secara tempatan. Pilihan ini melumpuhkan teg automatik ini berikutan. The
tingkah laku lalai untuk alat kawalan jauh boleh ditentukan dengan alat kawalan jauh. .tetapan tagOpt.
Lihat git-config(1).

--refmap=
Apabila mengambil rujukan yang disenaraikan pada baris arahan, gunakan refspec yang ditentukan (boleh diberikan
lebih daripada sekali) untuk memetakan rujukan ke cawangan penjejakan jauh, bukannya nilai
remote.*.fetch pembolehubah konfigurasi untuk repositori jauh. Lihat bahagian pada
"Cawangan Penjejakan Jauh Dikonfigurasikan" untuk butiran.

-t, --tag
Ambil semua teg dari alat kawalan jauh (iaitu, ambil teg jauh refs/tags/* ke dalam tag tempatan
dengan nama yang sama), sebagai tambahan kepada apa sahaja yang lain akan diambil. menggunakan
pilihan ini sahaja tidak tertakluk kepada pemangkasan tag, walaupun --prune digunakan (walaupun
tag juga boleh dipangkas jika ia juga merupakan destinasi refspec eksplisit; lihat
--pangkas).

--recurse-submodules[=ya|atas permintaan|tidak]
Pilihan ini mengawal jika dan dalam keadaan apa yang baru melakukan submodul yang dihuni
harus diambil juga. Ia boleh digunakan sebagai pilihan boolean untuk melumpuhkan sepenuhnya
rekursi apabila ditetapkan kepada tidak atau untuk mengulang tanpa syarat ke dalam semua submodul berpenduduk
apabila ditetapkan kepada yes, yang merupakan lalai apabila pilihan ini digunakan tanpa sebarang nilai. guna
permintaan untuk hanya berulang ke dalam submodul berpenduduk apabila superprojek mendapatkan semula a
komit yang mengemas kini rujukan submodul kepada komit yang belum ada dalam
klon submodul tempatan.

--no-recurse-submodul
Lumpuhkan pengambilan submodul secara rekursif (ini mempunyai kesan yang sama seperti menggunakan
--recurse-submodules=no pilihan).

--submodule-prefix=
Prepend ke laluan yang dicetak dalam mesej bermaklumat seperti "Mengambil submodul
foo". Pilihan ini digunakan secara dalaman apabila mengulangi submodul.

--recurse-submodules-default=[ya|atas permintaan]
Pilihan ini digunakan secara dalaman untuk memberikan nilai lalai bukan negatif buat sementara waktu
pilihan --recurse-submodules. Semua kaedah lain untuk mengkonfigurasi submodul fetch
rekursi (seperti tetapan dalam gitmodules(5) dan git-config(1)) mengatasi pilihan ini,
seperti yang menentukan --[no-]recurse-submodules secara langsung.

-u, --kemas kini-kepala-ok
Secara lalai pergi ambil enggan mengemas kini kepala yang sepadan dengan arus
cawangan. Bendera ini melumpuhkan cek. Ini adalah semata-mata untuk kegunaan dalaman untuk pergi tarik
untuk berkomunikasi dengan pergi ambil, dan melainkan anda melaksanakan Porselin anda sendiri, anda
tidak sepatutnya menggunakannya.

--pek muat naik
Apabila diberikan, dan repositori untuk diambil dari dikendalikan oleh pergi pek ambil,
--exec= dihantar kepada arahan untuk menentukan laluan bukan lalai untuk
arahan dijalankan di hujung yang lain.

-q, --senyap
Lulus --quiet ke git-fetch-pack dan senyapkan sebarang arahan git yang digunakan secara dalaman.
Kemajuan tidak dilaporkan kepada aliran ralat standard.

-v, --verbose
Berkata-kata.

--kemajuan
Status kemajuan dilaporkan pada aliran ralat standard secara lalai apabila ia berlaku
dilampirkan pada terminal, melainkan -q ditentukan. Bendera ini memaksa status kemajuan walaupun
jika aliran ralat standard tidak diarahkan ke terminal.


Repositori "jauh" yang merupakan sumber operasi ambil atau tarik. ini
parameter boleh sama ada URL (lihat bahagian URL GIT di bawah) atau nama alat kawalan jauh
(lihat bahagian REMOTES di bawah).


Nama yang merujuk kepada senarai repositori sebagai nilai alat kawalan jauh. di dalam
fail konfigurasi. (Lihat git-config(1)).


Menentukan rujukan yang hendak diambil dan rujukan tempatan yang hendak dikemas kini. Apabila tidak s
muncul pada baris arahan, rujukan untuk diambil dibaca dari jauh. .ambil
pembolehubah sebaliknya (lihat CAWANGAN PENGESAN JAUH YANG DIKONFIGURASI di bawah).

Format a parameter ialah tambah + pilihan, diikuti dengan rujukan sumber
, diikuti dengan titik bertindih :, diikuti dengan rujukan destinasi . Kolon boleh
ditinggalkan apabila kosong.

tag bermaksud sama seperti rujukan/tag/ :refs/tags/ ; ia meminta untuk diambil
semuanya sehingga tag yang diberikan.

Ref jauh yang sepadan diambil, dan jika bukan rentetan kosong, the
ref tempatan yang sepadan dengannya dimajukan pantas menggunakan . Jika tambah + pilihan ialah
digunakan, ref tempatan dikemas kini walaupun ia tidak menghasilkan kemas kini ke hadapan pantas.

Nota
Apabila cawangan jauh yang anda ingin ambil diketahui akan digulung semula dan berasaskan semula
selalunya, ia dijangka bahawa petua baharunya tidak akan turun dari yang sebelumnya
tip (seperti yang disimpan dalam cawangan penjejakan jauh anda pada kali terakhir anda mengambil). awak
ingin menggunakan tanda + untuk menunjukkan kemas kini bukan ke hadapan pantas diperlukan
untuk cawangan tersebut. Tidak ada cara untuk menentukan atau mengisytiharkan bahawa cawangan akan menjadi
disediakan dalam repositori dengan tingkah laku ini; pengguna yang menarik hanya perlu
tahu ini adalah corak penggunaan yang dijangkakan untuk cawangan.

GIT URL

Secara umum, URL mengandungi maklumat tentang protokol pengangkutan, alamat
pelayan jauh, dan laluan ke repositori. Bergantung pada protokol pengangkutan, beberapa
maklumat ini mungkin tiada.

Git menyokong protokol ssh, git, http dan https (selain itu, ftp dan ftps boleh digunakan
untuk mengambil dan rsync boleh digunakan untuk mengambil dan menolak, tetapi ini tidak cekap dan
tidak digunakan; jangan gunakannya).

Pengangkutan asli (iaitu git:// URL) tidak melakukan pengesahan dan harus digunakan dengan
berhati-hati pada rangkaian tidak selamat.

Sintaks berikut boleh digunakan dengannya:

· ssh://[user@]host.xz[:port]/path/to/repo.git/

· git://host.xz[:port]/path/to/repo.git/

· http[s]://host.xz[:port]/path/to/repo.git/

· ftp[s]://host.xz[:port]/path/to/repo.git/

· rsync://host.xz/path/to/repo.git/

Sintaks seperti scp alternatif juga boleh digunakan dengan protokol ssh:

· [pengguna@]host.xz:path/to/repo.git/

Sintaks ini hanya dikenali jika tiada garis miring sebelum titik bertindih pertama. Ini membantu
bezakan laluan tempatan yang mengandungi kolon. Contohnya laluan tempatan foo:bar boleh
ditentukan sebagai laluan mutlak atau ./foo:bar untuk mengelakkan disalahtafsirkan sebagai url ssh.

Protokol ssh dan git juga menyokong ~ pengembangan nama pengguna:

· ssh://[user@]host.xz[:port]/~[user]/path/to/repo.git/

· git://host.xz[:port]/~[user]/path/to/repo.git/

· [pengguna@]host.xz:/~[pengguna]/path/to/repo.git/

Untuk repositori tempatan, juga disokong oleh Git secara asli, sintaks berikut mungkin
digunakan:

· /path/to/repo.git/

· fail:///path/to/repo.git/

Kedua-dua sintaks ini kebanyakannya setara, kecuali apabila pengklonan, apabila yang pertama membayangkan
--pilihan tempatan. Lihat git-clone(1) untuk butiran.

Apabila Git tidak tahu bagaimana untuk mengendalikan protokol pengangkutan tertentu, ia cuba menggunakan
jauh- pembantu jauh, jika ada. Untuk meminta pembantu jauh secara eksplisit,
sintaks berikut boleh digunakan:

· ::

di mana mungkin laluan, pelayan dan laluan, atau rentetan seperti URL arbitrari
dikenali oleh pembantu jauh khusus yang dipanggil. Lihat gitremote-pembantu(1) untuk
butiran.

Jika terdapat sejumlah besar repositori jauh yang dinamakan serupa dan anda ingin menggunakan a
format yang berbeza untuk mereka (sehingga URL yang anda gunakan akan ditulis semula ke dalam URL yang
kerja), anda boleh membuat bahagian konfigurasi dalam borang:

[url" "]
bukannya =

Sebagai contoh, dengan ini:

[url "git://git.host.xz/"]
insteadOf = host.xz:/path/to/
insteadOf = kerja:

URL seperti "work:repo.git" atau seperti "host.xz:/path/to/repo.git" akan ditulis semula dalam mana-mana
konteks yang mengambil URL sebagai "git://git.host.xz/repo.git".

Jika anda ingin menulis semula URL untuk push sahaja, anda boleh membuat bahagian konfigurasi bagi
bentuk:

[url" "]
pushInsteadOf =

Sebagai contoh, dengan ini:

[url "ssh://example.org/"]
pushInsteadOf = git://example.org/

URL seperti "git://example.org/path/to/repo.git" akan ditulis semula ke
"ssh://example.org/path/to/repo.git" untuk menolak, tetapi tarik masih akan menggunakan yang asal
URL.

JAUHKAN

Nama salah satu daripada berikut boleh digunakan dan bukannya URL sebagai hujah:

· alat kawalan jauh dalam fail konfigurasi Git: $GIT_DIR/config,

· fail dalam direktori $GIT_DIR/remotes, atau

· fail dalam direktori $GIT_DIR/branches.

Semua ini juga membenarkan anda untuk menghilangkan refspec daripada baris arahan kerana masing-masing
mengandungi refspec yang git akan gunakan secara lalai.

Dinamakan jauh in konfigurasi fail
Anda boleh memilih untuk memberikan nama alat kawalan jauh yang telah anda konfigurasikan sebelum ini
git-remote(1), git-config(1) atau pun dengan suntingan manual pada fail $GIT_DIR/config. URL
alat kawalan jauh ini akan digunakan untuk mengakses repositori. Refspec alat kawalan jauh ini ialah
digunakan secara lalai apabila anda tidak memberikan refspec pada baris arahan. Entri dalam
fail konfigurasi akan muncul seperti ini:

[jauh" "]
url =
pushurl =
tolak =
ambil =

The digunakan untuk menolak sahaja. Ia adalah pilihan dan lalai kepada .

Dinamakan fail in $GIT_DIR/jarak jauh
Anda boleh memilih untuk memberikan nama fail dalam $GIT_DIR/remotes. URL dalam fail ini
akan digunakan untuk mengakses repositori. Refspec dalam fail ini akan digunakan sebagai lalai
apabila anda tidak memberikan refspec pada baris arahan. Fail ini sepatutnya mempunyai yang berikut
format:

URL: salah satu daripada format URL di atas
Tolak:
Tarik:

Tekan: garisan digunakan oleh pergi menolak dan Tarik: garisan digunakan oleh pergi tarik and pergi ambil.
Garisan Tolak Berbilang: dan Tarik: boleh ditentukan untuk pemetaan cawangan tambahan.

Dinamakan fail in $GIT_DIR/cawangan
Anda boleh memilih untuk memberikan nama fail dalam $GIT_DIR/cawangan. URL dalam fail ini
akan digunakan untuk mengakses repositori. Fail ini hendaklah mempunyai format berikut:

#

adalah diperlukan; # adalah pilihan.

Bergantung pada operasi, git akan menggunakan salah satu daripada refspec berikut, jika anda tidak
sediakan satu pada baris arahan. ialah nama fail ini dalam $GIT_DIR/branches
dan lalai untuk menguasai.

git fetch menggunakan:

rujukan/kepala/ :refs/heads/

git push menggunakan:

KEPALA:refs/heads/

DIKONFIGURASI JARAK JAUH CAWANGAN

Anda sering berinteraksi dengan repositori jauh yang sama dengan kerap dan berulang kali mengambil
daripadanya. Untuk menjejaki kemajuan repositori jauh sedemikian, git fetch
membolehkan anda mengkonfigurasi jauh. .fetch pembolehubah konfigurasi.

Biasanya pemboleh ubah seperti ini mungkin kelihatan seperti ini:

["asal" jauh]
fetch = +refs/heads/*:refs/remotes/origin/*

Konfigurasi ini digunakan dalam dua cara:

· Apabila git fetch dijalankan tanpa menyatakan cawangan dan/atau tag yang hendak diambil pada
baris arahan, cth git fetch origin atau git fetch, remote. .mengambil nilai
digunakan sebagai refspecs—mereka menentukan rujukan yang hendak diambil dan rujukan tempatan yang mana
kemas kini. Contoh di atas akan mengambil semua cawangan yang wujud dalam asal (iaitu mana-mana
ref yang sepadan dengan sebelah kiri nilai, refs/heads/*) dan kemas kini nilai
cawangan penjejakan jauh yang sepadan dalam hierarki refs/remote/origin/*.

· Apabila git fetch dijalankan dengan cawangan eksplisit dan/atau tag untuk diambil pada baris arahan,
cth git fetch origin master, the s diberikan pada baris arahan tentukan apa
akan diambil (cth master dalam contoh, yang merupakan tangan pendek untuk master:,
yang seterusnya bermaksud "mengambil master cawangan tetapi saya tidak menyatakan secara jelas apa
cawangan penjejakan jauh untuk mengemas kini dengannya daripada baris arahan"), dan contohnya
arahan akan diambil hanyalah yang master cawangan. alat kawalan jauh. .mengambil nilai
tentukan cawangan penjejakan jauh mana, jika ada, dikemas kini. Apabila digunakan dengan cara ini,
jauh. .nilai ambil tidak mempunyai sebarang kesan dalam membuat keputusan apa akan diambil
(iaitu nilai tidak digunakan sebagai refspecs apabila baris arahan menyenaraikan refspecs); mereka
hanya digunakan untuk membuat keputusan di mana rujukan yang diambil disimpan dengan bertindak sebagai a
pemetaan.

Penggunaan alat kawalan jauh yang terakhir. nilai .fetch boleh ditindih dengan memberikan
--refmap= parameter (s) pada baris arahan.

CONTOH

· Kemas kini cawangan penjejakan jauh:

$ git fetch asal

Perintah di atas menyalin semua cawangan dari ruang rujukan/kepala/ ruang nama dan stor jauh
mereka ke ruang nama rujukan/jarak jauh/asal/asal, melainkan cawangan. .ambil
pilihan digunakan untuk menentukan refspec bukan lalai.

· Menggunakan refspec secara eksplisit:

$ git fetch origin +pu:pu maint:tmp

Ini mengemas kini (atau mencipta, seperti yang perlu) cawangan pu dan tmp dalam repositori tempatan oleh
mengambil dari cawangan (masing-masing) pu dan menyelenggara dari repositori jauh.

Cawangan pu akan dikemas kini walaupun ia tidak maju pantas, kerana memang begitu
diawali dengan tanda tambah; tmp tidak akan menjadi.

· Intip cawangan jauh, tanpa mengkonfigurasi alat kawalan jauh dalam repositori tempatan anda:

$ git fetch git://git.kernel.org/pub/scm/git/git.git maint
$ git log FETCH_HEAD

Perintah pertama mengambil cawangan utama dari repositori di
git://git.kernel.org/pub/scm/git/git.git dan arahan kedua menggunakan FETCH_HEAD untuk
meneliti cawangan dengan git-log(1). Objek yang diambil akhirnya akan dialih keluar oleh
pengemasan terbina dalam git (lihat git-gc(1)).

Gunakan git-fetch dalam talian menggunakan perkhidmatan onworks.net