Tambah repositori ke ruang kerja

Panduan ini menunjukkan cara mendaftarkan checkout Git ke dalam ruang kerja, mengindeksnya semula dan membuangnya kembali.

Repositori berskop ruang kerja. Tiada daftar global dan tiada langkah memautkan: menambah repositori dan meletakkannya dalam ruang kerja ialah tindakan yang sama. Checkout yang sama yang didaftarkan dalam dua ruang kerja menjadi dua baris bebas dengan dua id yang berbeza — merentas ruang kerja, identiti sesuatu repositori ialah laluan sistem failnya, tidak pernah idnya.

Sebelum anda bermula

Folder hanya boleh didaftarkan jika ketiga-tiga syarat ini dipenuhi:

Ia berada di dalam worktree Git.
Worktree itu mempunyai remote origin.
Remote origin itu menunjuk ke hos kod yang disokong: github.com, gitlab.com atau bitbucket.org.

Apa-apa selain itu ditolak pada masa pendaftaran dengan mesej yang eksplisit: “Folder is not inside a git work tree.”, “No origin remote configured for this repository.” atau “The origin remote is not hosted on a supported forge (github.com, gitlab.com, bitbucket.org).”. Tiada mod setempat sahaja.

Hos kod dibaca daripada remote dan disimpan pada repositori — anda tidak pernah memilihnya. Sesuatu ruang kerja boleh menyimpan repositori daripada ketiga-tiganya sekali gus, dan setiap satunya dihubungi melalui API-nya sendiri dengan kelayakannya sendiri. Namespace bersarang GitLab dikekalkan, jadi gitlab.com/group/subgroup/project didaftarkan sebagai pemilik group/subgroup, nama project.

Folder itu juga mesti berada pada mesin yang menghoskan cc_server, di dalam salah satu direktori --repo-roots pelayan tersebut. Senarai benarkan itu lalainya ialah direktori utama pengguna pelayan, dan menyemak imbas melebihi sesuatu root akan ditolak.

Daftarkan checkout

Buka Tetapan → Ruang kerja → Repositori (/workspaces/<id>/settings/workspace/repositories).
Klik Tambah repositori.

Dialog itu ialah pelayar boleh navigasi terhadap sistem fail pelayan, bukan sistem fail anda. Alirannya sama pada desktop, web dan telefon, kerana pemilih folder asli akan memilih folder pada mesin yang salah.

Navigasi dalam root yang dikonfigurasikan pada pelayan. Folder yang merupakan checkout git akan ditandakan.
Tandakan mana-mana bilangan folder. Pilihan itu kekal semasa anda bernavigasi, jadi anda boleh mengumpulkan checkout daripada beberapa folder.
Daftarkan kesemuanya dalam satu kelompok.

Satu pilihan yang gagal tidak pernah menggugurkan seluruh kelompok yang lain — anda menerima id yang dicipta serta ralat mengikut laluan bagi setiap yang ditolak. Mendaftarkan semula laluan yang sudah ada dalam ruang kerja ini akan memulangkan repositori sedia ada dan bukan mencipta pendua.

Setiap repositori yang didaftarkan muncul dalam senarai dengan owner/name-nya, lencana yang menamakan hos kodnya, dan laluannya pada pelayan. Repositori GitHub juga memaparkan avatar pemiliknya; hos kod lain tiada URL avatar pemilik yang boleh dijangka, jadi ia berpatah balik kepada inisial.

Lencana hos kod itu penting dalam ruang kerja campuran: dua repositori boleh kedua-duanya bernama acme/web pada hos kod yang berbeza, dan kelakuannya berbeza — apa yang boleh dilakukan oleh sesuatu semakan, dan ke mana sesuatu pautan menuju.

Apa yang berlaku seterusnya

Pendaftaran melancarkan peristiwa RepoAdded yang berskop kepada ruang kerja ini, yang memulakan pipeline index_code untuk checkout itu. Itulah yang mengisi graf kod, supaya carian dan analisis kesan mempunyai sesuatu untuk dijawab.

Hanya fail yang bahasanya mempunyai tatabahasa yang disertakan akan diindeks (Dart, JavaScript, TypeScript, TSX, PHP, Python, Rust, Zig, C, C++, Go, Java, Ruby, C#, Swift, Kotlin, R, Assembly, MATLAB dan Ada). Lihat Cari kod dengan graf kod.

Indeks semula repositori

Setiap baris membawa butang Indeks kod. Klik butang itu untuk menjalankan semula pengindeks bagi checkout tersebut; semasa ia berjalan butang itu menjadi paparan kemajuan yang menunjukkan bilangan fail siap berbanding jumlah, dengan kawalan batal. Apabila selesai, ia bertukar menjadi tanda semak dengan bilangan simbol, atau amaran jika larian itu gagal.

Susun semula repositori

Seret pemegang pada baris itu. Susunan yang anda tetapkan itulah susunan yang dibaca semula oleh setiap senarai repositori dalam aplikasi.

Betulkan pautan GitHub

Ikon pautan pada baris itu membuka editor untuk pemilik dan nama repositori GitHub bagi repositori tersebut — berguna apabila remote itu dinamakan semula atau dipindahkan.

Buang repositori

Buka Tetapan → Ruang kerja → Repositori.
Klik ikon tong sampah pada baris itu.
Sahkan “Buang repositori dari ruang kerja?”

Dialog itu menyatakan apa yang akan dilakukannya: “name akan dibuang dari ruang kerja ini. Fail setempat pada cakera tidak disentuh.”

Penyingkiran memadamkan baris repositori daripada ruang kerja ini dan mengalirkan pemadaman kepada baris graf kodnya — simbol, tepi, fail dan pusat pemeriksaan indeks — serta setiap geran repositori bagi setiap ahli padanya, pautan ruang–repositorinya dan rekod checkout terasingnya. Checkout yang sama yang didaftarkan dalam ruang kerja lain ialah baris bebas dan tidak terjejas. Worktree pada cakera yang ditunjuk oleh rekod-rekod itu tidak dirobohkan oleh pemadaman ini.

Panduan berkaitan

Konsep berkaitan

Ruang kerja dan pengasingan