GitLab的簡單使用

GitLab是一個利用Ruby on Rails開發的開源應用程序,實現一個自託管的Git項目倉庫,可通過Web界面進行訪問公開的或者私人項目。

它擁有與Github類似的功能,能夠瀏覽源代碼,管理缺陷和註釋。可以管理團隊對倉庫的訪問,它非常易於瀏覽提交過的版本並提供一個文件歷史庫。團隊成員可以利用內置的簡單聊天程序(Wall)進行交流。它還提供一個代碼片段收集功能可以輕鬆實現代碼複用,便於日後有需要的時候進行查找。開源中國代碼託管平臺git.oschina.net就是基於GitLab項目搭建。

添加新項目

1、選擇創建新項目

登錄成功後,點擊導航條上的 “+” 就可以進入創建項目的頁面

2、填寫項目的信息

在創建工程的頁面,按照要求填寫項目的名稱和可見性等信息。

(1)Project path:項目的路徑,一般可以認爲是項目的名稱

(2)Import prject from:從哪導入項目,提供Github/Bitbucket等幾個選項

(3)Description(項目的描述):可選項,對項目的簡單描述

(4)Visibility Level(項目可見級別):提供Private(私有的,只有你自己或者組內的成員能訪問)/Internal(所有登錄的用戶)/Public(公開的,所有人都可以訪問)三種選項。

添加和配置SSH公鑰

SSH(Secure Shell)是一種安全協議,在你的電腦與GitLab服務器進行通信時,我們使用SSH密鑰(SSH Keys)認證的方式來保證通信安全。你可以在網絡上搜索到關於SSH密鑰的更多介紹;下面我們重點講解如何創建 SSH密鑰,並將密鑰中的公鑰添加到GitLab,以便我們通過SSH協議來訪問Git倉庫。

SSH 密鑰的創建需要在終端(命令行)環境下進行,我們首先進入命令行環境。通常在OS X和Linux平臺下我們使用終端工具(Terminal),在Windows平臺中,可以使用Git Bash工具。

進入命令行環境後,我們執行以下操作來創建 SSH 密鑰。

1.進入SSH目錄

cd ~/.ssh

(1)如果還沒有 ~/.ssh 目錄,可以手工創建一個(mkdir ~/.ssh),之後再通過cd ~/.ssh進入SSH目錄

(2)可以通過ls -l命令查看SSH目錄下的文件,來確認你是否已經生成過SSH密鑰;如果SSH目錄爲空,我們開始第二步,生成 SSH 密鑰;如果存在id_rsa.pub這個文件,說明你之前生成過SSH密鑰,後面有介紹如何添加多個sshkey

2.生成SSH密鑰

我們通過下面的命令生成密鑰,請將命令中的[email protected]替換爲你自己的Email地址。

ssh-keygen -t rsa -C "[email protected]"

在SSH生成過程中會出現以下信息,按屏幕的提示操作即可;

$ ssh-keygen -t rsa -C "[email protected]"

Generating public/private rsa key pair.

Enter passphrase (empty for no passphrase):

Enter same passphrase again:

Your identification has been saved in /Users/USERNAME/.ssh/id_rsa.

Your public key has been saved in /Users/USERNAME/.ssh/id_rsa.pub.

The key fingerprint is:

15:81:d2:7a:c6:6c:0f:ec:b0:b6:d4:18:b8:d1:41:48 [email protected]

說明:

(1)一般情況下,在命令行中輸入密碼、口令一類的信息時是沒有信息回顯的。在我們這一步的操作中,輸入passphrase口令時,命令行界面上不會隨着鍵盤敲入密碼而有什麼反饋。

(2)當提示Enter passphrase (empty for no passphrase) :時,可以直接按兩次回車鍵輸入一個空的 passphrase;也可以選擇輸入一個 passphrase 口令,如果此時你輸入了一個passphrase,請牢記,之後每次提交時都需要輸入這個口令來確認。

3.獲取SSH公鑰信息

SSH密鑰生成結束後,你可以在SSH目錄下看到私鑰id_rsa和公鑰id_rsa.pub這兩個文件,不要把私鑰文件id_rsa的信息透露給任何人。我們可以通過文本編輯器或cat命令來查看id_rsa.pub公鑰信息。

(1)通過編輯器。使用你熟悉的文本編輯器,比如 記事本、Sublime Text等軟件打開id_rsa.pub,複製裏面的所有內容以備下一步使用。

(2)通過cat命令。在命令行中敲入cat id_rsa.pub,回車執行後命令行界面中會顯示id_rsa.pub文件裏的內容,複製後在下一步使用。

(3)通過直接使用命令將id_rsa.pub文件裏的內容複製到剪切板中

Windows:clip < ~/.ssh/id_rsa.pub

Mac:pbcopy < ~/.ssh/id_rsa.pub

GNU/Linux (requires xclip):xclip -sel clip < ~/.ssh/id_rsa.pub

4.添加SSH公鑰到gitlab

(1)打開https://gitlab.com/profileProfile配置頁面,選擇SSH Keys.

(2)添加SSH公鑰

按照要求填寫Title和Key,其中Title是Key的描述信息(如My_work_computer等),Key是上面複製的SSH公鑰的內容,直接粘貼到輸入框中保存即可。

5.測試SSH連接

ssh -T [email protected]

如果連接成功的話,會出現以下信息。

Welcome to GitLab, USERNAME!

如何同時使用多個SSH公鑰

如果你已經有了一套ssh(筆者的電腦上就有好幾套如github/gitcafe/gitlab,三者各不一樣),爲了保證各個服務能正常使用需要配置多個SSH Key。可以按照以下的步驟來實現多套SSH Key的共同工作:

1.生成SSH密鑰

假設你已經有了一套名爲id_rsa的公祕鑰,將要生成的公祕鑰名稱爲gitlab,你也可以使用任何你喜歡的名字。記得把以下命令中的[email protected]改爲你的Email地址

ssh-keygen -t rsa -C "[email protected]" -f ~/.ssh/gitlab

說明:

(1)-f後面的參數是自定義的SSH Key的存放路徑,將來生成的公祕鑰的名字分別是gitlab.pub和gitlab

(2)其他的和上面生成密鑰的步驟相同,只是多了下面的配置的步驟

2.配置自定義的公祕鑰名稱

在SSH用戶配置文件~/.ssh/config中指定對應服務所使用的公祕鑰名稱,如果沒有config文件的話就新建一個(vim ~/.ssh/config),並輸入以下內容(可以添加多個):

Host gitlab.com www.gitlab.com

IdentityFile ~/.ssh/gitlab

導入項目或提交代碼

1、初始上傳代碼

(1)可以先將項目clone到本地然後將文件拷貝到目錄下面再提交上去

git clone [email protected]:USERNAME/PROJECTNAME.git

cd WatchDemo

touch README.md

git add README.md

git commit -m "add README"

git push -u origin master

(2)如果項目存在需要導入到gitlab可以直接將項目導入上去

cd existing_folder

git init

git remote add origin [email protected]:USERNAME/PROJECTNAME.git

git push -u origin master

說明:

(1)請將上面的USERNAME和PROJECTNAME替換成用戶名和項目的名稱

(2)existing_folder指的是項目在本地的路徑(根路徑)

2、其他使用請參考《使用GitHub進行項目託管》,或者是到網絡上查看Git的相關資料

感謝GitCafe,一個非常優秀的代碼託管平臺,本文很多資料來源於GitCafe官方提供的幫助手冊

參考資料

1、《GitLab Help》

2、《Gitcafe Help》

3、《Gitlab的使用》

4、《用GitLab搭建自己的私有GitHub》

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章