Git Bare Repo

tags: git GSS

前言

遇到一個情境是需要將 Subversion 上的專案搬到 Git 上，但原本的 Subversion 將會有其他人繼續開發，而 Git 上後續變更的內容將不會推回 Subversioin 上，但 Subversion 上的版本將不會頻繁地更新回 Git 上，所以更像是 Subversion 單向 的更新/匯出到 Git 上。

在使用 subgit 工具轉換時，Subversion 轉出來的是一個 Bare Repo，故有了此篇的 Bare Repo 簡介。

詳情: Subversion to Git

基本 Git 教學: Git 筆記

簡介

Git 儲存庫 (Git Repository) 大致可以分為三種

• 本地的儲存庫 (local repository)
• 共用的儲存庫 (shared repository)
• 遠端的儲存庫 (remote repository)

其實都是差不多的東西，Git 是分散式的版本控制，所以只是放置的位置、使用者不同而已。

local repository

$ git init myproject
$ cd myproject
$ ls
.git/

用 init 不帶參數新增的專案包含: 工作目錄 (Working Directory) + Git 儲存庫 (Git Repository)

• 工作目錄: 放置程式的地方，ex: .py、.js 的檔案
• Git 儲存庫: .git 資料夾

remote repository

常見的託管平台: github、gitlab、BitBucket、…etc

遠端已經存在的專案

$ git clone http://github.com/hbdoy/xxx

將 local 的 repo 首次提交

$ git remote add origin https://github.com/hbdoy/xxx.git
$ git push -u origin master

// also you can use
$ git push --all
$ git push --tags

// or
$ git push --mirror

若遠端的 repo 網址改變，可以修改 origin 位址

$ git remote set-url origin https://github.com/hbdoy/new_xxx.git

shared repository

和 remote repository 差不多，都可供多人同時使用開發，實作上也可以理解為 Git Bare Repo (裸庫)

$ git init --bare bareproject

不同於上面，Bare Repo 只有 Git 儲存庫 (Git Repository) 而已，也就是沒有 工作目錄，因為沒有程式檔案，所以你無法在上面 git add、git commit，他的用意也不是要讓你在上面開發的。

Bare Repo 雖說有 Git 儲存庫，但他沒有 .git 資料夾，而是將裡面的內容直接放到專案根目錄下，專案的資料夾名稱習慣會在最後面加上 .git，EX: bareproject.git

bareproject.git/

對比一般含有工作目錄的 Repo

Bare Repo 的儲存庫內容物其實不完全等於 .git 中的東西，.git 還會包含一些工作目錄下的資訊，而這些資訊不會放到 Bare Repo 中

用途

Bare Repo 像是一個 Git Server，可以讓別人 clone 下來開發，開發完再 push 回去，比起上面兩者是用來開發(工作)用的，Bare Repo 是用來分享(共享)的，而且沒有存著程式檔案，整個專案資料夾容量較小。

情境

• 在 Linux 上建立 Bare Repo，讓數個開發者透過 ssh 來存者這個資料夾，進行 clone & push 等操作

  如何在 Linux 上建立 Remote Bare Git Repo 可參考:

  1. https://blog.gtwang.org/linux/linux-git-server-using-ssh/
  2. https://stevenitlife.blogspot.com/2015/02/repository.html

• 或是建立在其他資料夾同步軟體，EX: Google Sync、Dropbox

差異

• 一般 Git Repo 用來開發，工作目錄存著程式檔案、儲存庫記錄著所有檔案的版本訊息
• Bare Repo 用來單純紀錄檔案的版本訊息，中心點上建立一個 Bare Repo，所有專案成員可以 push 自己編輯的版本訊息到這個 Repo

Bare Repo 常用指令

建立

local

$ git --bare init xxx

將 Remote Repo 轉成 Bare Repo

$ git clone --bare http://github.com/hbdoy/mypoject

Clone

Clone From Bare Repo

此處示範 clone 本地上的 bare repo

$ git clone roulette.git

可以看到 Bare Repo Clone 出來的專案自動長出工作目錄

但要注意他的 origin，若要推到其他 remote repo 記得修改

Push

Push to Bare Repo

延續上方的 clone from local bare repo

$ cd roulette/

1. 在 roulette 下新增一個 test.txt 檔案
   
2. git add、git commit
3. git push (to bare repo)

進入一開始 clone 來源的 bare repo

$ cd roulette.git/

此時可以看到剛剛 clone 來源的 bare repo: roulette.git 已經多了一個 git log

但是一樣不會看到 test.txt 檔案

搬遷 Remote Git Repo 情境

本地沒有完整專案

不需要 clone 一大包東西下來，可以 clone 一個 bare git repo (只有 git 儲存庫)，再推到新位址去就好

$ git clone --bare https://github.com/hbdoy/xxx

$ cd xxx.git
$ git push --mirror https://github.com/hbdoy/new_project

參考文件

https://blog.csdn.net/pcplayer/article/details/72784096
https://ithelp.ithome.com.tw/articles/10132804
https://www.saintsjd.com/2011/01/what-is-a-bare-git-repository/