跳到主要內容

Linux 中將現有的專案加到 GitHub

按時備份自己的文件或 code 是一個好習慣，以前尚未進入資訊科學這個領域時，最常使用的備份方式大概就是 Copy & Paste + Rename （Ex: Test .txt -> Test_20130723.txt）。這個方法很簡單也很快速，但是，有些小小的問題，如 1. 時間久了檔案佔用會很大的空間，2. 不知道每一個複製的版本究竟修改了什麼，3. 協同合作的時候檔案覆蓋即一去不復返。
上述的問題讓我開始找尋其他的方案來管理程式碼，並且可以與其他人協同合作。幾年前，在 synology 的 NAS 上安裝 SVN Server，開始使用 subversion 做版本管控。SVN 的 Client-Server 架構，在個人使用上倒也還蠻順利，沒出過什麼亂子，直到發生沒有網路就沒有辦法版本更新的事情，才開始注意到分散式版本管控的好處。另外，在 OpenSource 的場合中也常常聽到討論使用 GitHub 作爲 Git Server 的專案，決定來接觸接觸。Git 有下面幾項優點：

  1. 便宜的 Branch：Git 對 branch 是對整個資料夾做快照（snapshot）的方式，追蹤的是檔案的內容，即使在不同的 branch 內也只會有一個實體，所以既省空間又比較有效率。
  2. 聰明的 commit：Git 是與 snapshot 作比對不是單純的使用 diff 來比較 commit 的檔案。
  3. 分散式管理：Git 本地端有自己的 repository，即使沒有連線的狀態下仍然可以 commit，有網路時再 push 到 server 上就好。
  4. Repository 毀壞的風險低：分散式的架構在每一份 Client 都會有一份 repository，即使 Server 上的 repository 毀損還是可以由其他的 Client 端恢復。

在這篇文章中，不討論如何在自己的 Server 上架設 Git Server，會着重在 Linux 中如何把現有的專案加入 GitHub 上。有機會再和大家分享自己架設 Git Server 的經驗 :)

  1. 如果還沒安裝 git，在 uBuntu / Mint 中請輸入
    $ sudo apt-get install git-core在 fedora 中請輸入
    $ sudo yum install git
  2. 設定本機的 Git 環境。設定後會產生 ～/.gitconfig
    $ git config --global user.name "ninthday"
    $ git config --global user.email "your_email@example.com"
  3. 登入 GitHub 帳號，在右上角點選新增一個 repository（Create a new repo）
  4. 填寫資料建立一個完成新增
  5. 由於採用 SSH 方式的安全性較高，這裏以 SSH 作爲例子。首先，產生一個 key 給 GitHub 使用
    $ ssh-keygen -t rsa -f [filename] (ex: ninthday)
  6. 將 key 放到 GitHub 裏面，Account settings -> SSH keys -> Add SSH key
    $ cat ~/.ssh/ninthday.pub把 cat 得到的內容填到 key 中

  7. 設定專門給 GitHub 使用的 key 和 config
    $ vim ~/.ssh/config
    Host github
    HostName github.com
    User git
    Port 22
    identityfile ~/.ssh/ninthday
  8. 測試連線
    $ ssh github
    The authenticity of host 'github.com (204.232.175.90)' can't be established.
    RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
    Are you sure you want to continue connecting (yes/no)? yes
    Warning: Permanently added 'github.com,204.232.175.90' (RSA) to the list of known hosts.
    PTY allocation request failed on channel 0
    Hi ninthday! You've successfully authenticated, but GitHub does not provide shell access.
    Connection to github.com closed.
  9. 取得 GitHub API Token，「Account settings -> Applications -> Personal API Access Tokens -> Create new token 」，複製 token string
  10. 本機設定 GitHub token
    $ git config --global github.user username
    $ git config --global github.token [token string]
  11. 切換到已存在的工作資料夾，輸入初始化指令
    $ cd my_test
    $ git init
    Initialized empty Git repository in /[path]/my_test/.git/
  12. 將檔案加到 repository 的準備狀態
    $ git add *
  13. 檢查一下目前的追蹤狀態
    $ git status
  14. 送交檔案 commit 並加上說明
    $ git commit -m "my first commit"
  15. 在 GitHub my_test repository page 右側複製 URL。在我的例子中是使用 SSH 連接方式。
  16. 將 GitHub repository 加入 remote origin
    $ git remote add origin github:ninthday/my_test.git
    因爲在步驟8中已經設定過連線，所以在這裏把 GitHub 提供的 SSH URL 中的  git@github.com 更換成 github（git@github.com:ninthday/my_test.git -> github:ninthday/my_test.git）
  17. 由 GitHub 上拉下來本機
    $ git pull origin master
  18. 最後將本地端推到 GitHub 上
    $ git push origin master
    大致會出現類似下面的訊息
    Counting objects: 25, done.
    Delta compression using up to 4 threads.
    Compressing objects: 100% (24/24), done.
    Writing objects: 100% (24/24), 2.21 MiB | 658 KiB/s, done.
    Total 24 (delta 4), reused 0 (delta 0)
    To github:ninthday/myComputing.git
       7696115..b24a89b  master -> master
如果不是使用 SSH 的方式，也可以參考 GitHub 官方的說明。
標籤：

留言

張貼留言

這個網誌中的熱門文章

Word的合併列印如何出現「千分位」符號

今天樓下的同事突然問我一個問題，合併列印的時候如何顯示「千分位符號」（逗號），就是12 , 300。在Excel我們可以很容易的為儲存格裡的數字加上千分位的標記，但是儲存格實際儲存的還是只有數字，那個千分位符號是Excel給我們看的一種「格式」。 當我們在Word裡使用Excel做好的報表來合併列印的時候，Word會最真實的將這個數字欄位給讀出來，呈現在合併列印的欄位數值裡，無論在Excel理事不是有設定千分位符號，在Word合併列印後卻沒有出現，所以我們同樣的必須給他加上格式。 Word裡加上格式並不如Excel裡按一下就完成，加上逗號的千分位格式方法如後： 1.在Word裡插入合併列印的欄位變數。 2.在變數上按滑鼠右鍵，選擇「切換功能變數代碼」（也可以直接按Alt+F9），變數會由 經費 >> 變成 { MERGEFIELD "經費" } 。 3.加上格式就是把 { MERGEFIELD "經費" } 在}前加入數字格式參數 /##,###，會成為 { MERGEFIELD "經費" /# ##,### }（這裡指定五位數，以此類推） #：這個格式項目會指定要在結果中顯示的必要位數；如果結果不含該位數的數字，則 Word 會顯示一個空格。 0：這個格式項目會指定要在結果中顯示的必要位數；如果結果不含該位數的數字，則 Word 會顯示 0 (零)。 4.預覽內容，就可以發現千分位（逗號）出現，如果數值有零的話，最好可以換成 /# ##,## 0 ，避免空格出現。 數字格式參數請參考 Microsoft Office Online 。
1 則留言
閱讀完整內容

使用 Stackedit 發佈至 Blogger

使用 StackEdit 發佈至 Blogger 目前部落格裡新的文章幾乎都是在 StackEdit 上使用 Markdown 來完成撰寫，是一個舒適的撰寫體驗，也更能讓自己專注在文章的撰寫，不用去調整版面上的細節。StackEdit 除了可以將文本直接存在 Google Drive 上，圖形直接嵌入引用 Google+ 相簿，讓整個寫作的流程都是在雲端上完成，另外一個我喜歡的優點，是能夠直接將寫好的文章發佈到自己的部落格上。 發佈至 Blogger 部落格 將文章發佈至 Blogger 上的方法非常簡單，在 StackEdit 的左上角開啓左邊的功能列，拉開 Publish 項目並點選 Blogger，如下圖： 第一次使用時會導引至 Google 的授權頁，回到彈出的對話視窗，填寫好 Blogger 的 URL 內容。新發佈不用填寫 POST ID，這個是未來若需要更新內容的時候使用的。 按下「OK」後就完成發佈的動作，發佈完成後，在 StackEdit 該篇文章的右上角會出現 Blogger 的 Icon。 部落格的樣本改造 文章發佈至 Blogger 後有的模板會有小小的問題，如果我們使用 Markdown 時沒有寫入圖片的最大寬度，插入的圖片若比較大就會造成圖形突破樣板的驚嚇感。 這個可以透過自己改造Blogger 模板內容的 CSS，將圖片最大限制在某個數值。簡單一點的方式，是選擇現在 Blogger 中就已經有限制圖片大小的佈景主題。 程式碼高亮標識 StackEdit 的程式區塊是有支援程式碼高亮標識（Highlight）的功能，預設是使用 Highlight.js 的函式庫，也可以使用 Google prettify。Highlight.js 目前已經支援 118 種的程式語法自動偵測。還有 54 種的 Style 可以選擇。但是發佈至 Blogger 後因模板沒有相關的引入，所以程式碼區塊就和一般的文字一樣，沒有區塊和程式碼標識的區別。 我們可以透過修改 Blogger 的樣板的樣式，引入 Highlight.js 的函式庫與樣式。進入 Blogger 的後臺管理頁面，在左方的選單中選擇 範本 ，然後右方選 編輯 HTML ，開啓樣板的 HTML 編輯畫面。 我們可以在 Highlight.js ...
2 則留言
閱讀完整內容

SSH tunnel 方式連結限制區域的伺服器

SSH tunnel 方式連結限制區域的伺服器 自從進了前公司，好久沒有時間好好的更新部落格內容了。近期離開待了將近兩年的公司，和好朋友一起創立了新的新創公司，一起在農業上用技術來幫助返鄉的青小農，希望讓用更有溫度的數據來降低青農們的門檻。 新的開始新的期待，希望自己能繼續保持赤子熱忱，把研究過的方法記錄下來分享。 在這個資安即國安的時代（嗯…那是政府的口號），大部分的伺服器都會有許多的安全設定，無論是更新的規則或是防火牆的限制等等。會限制在某個網段甚至是某個 IP 才能進行連線某些服務，對於常常喜歡加入文青到咖啡廳 Out coding 的宅宅，還是要想辦法鑽回去連線伺服器。 如果在限制區域中有一臺能對外開放連線的 SSH 機器，我們便能夠使用 SSH Tunnel 的方式橋接回去，透過通道連結到目標伺服器。說穿了其實這臺對外的機器就是跳板，我們可以利用這個跳板以類似 Port forwarding 的方式，將遠端伺服器的 IP 與 Port 對應至本機的一組位址與 Port。 Linux 下的連接方式 大部分的 Unix-Like 系統都有內建 SSH 的 Client 指令，我們只需要在 terminal 下指令就可以達到目的。 指令如下： $ ssh - N -f - L LOCAL_PORT :DEST_HOST :DEST_HOST_PORT SSH_USER @SSH_SERVER_IP SSH 參數說明 -N : 連接後不執行任何的遠端指令 -f : 連線後在背景執行 -L port:host:hostport: 在 Client 與 Server 建立一組 secure tunneling LOCAL_PORT ：本機連接埠 DEST_HOST ：目標連線伺服器位址 DEST_HOST_PORT ：目標連線伺服器埠號 SSH_USER@SSH_SERVER_IP ：做爲跳板的機器連線 Example： $ ssh -N -f -L 33890 :192 .168 .1 .100 :5022 username @ 168.95.1.1 上述的例子，會透過 168.95.1.1 這臺跳板機器，將限制區域內 192.168.1.100，Port...
張貼留言
閱讀完整內容