Linux 下 GitLab 安装教程
Linux 下 GitLab 安裝教程
- 安裝 Linux
- 下載 GitLab
- 安裝 GitLab
- 登錄 GitLab
- GitLab 漢化
- GitLab 設(shè)置密鑰
- 卸載 GitLab
為了便于以后使用,這里先給出 GitLab 使用中的常用命令。
-
啟動 GitLab 服務(wù):gitlab-ctl start
-
關(guān)閉 GitLab 服務(wù):gitlab-ctl stop
-
重啟 GitLab 服務(wù):gitlab-ctl restart
-
操作系統(tǒng)內(nèi)存查看:free -m
筆者的運行環(huán)境:
-
Linux:CentOS 8 x86_64
-
GitLab:gitlab-ee-14.3.6-ee.0.el8.x86_64
安裝 Linux
目前,GitLab 不支持直接安裝在 Windows 中,因此進(jìn)行這個教程之前,必須要先安裝好一個 Linux 操作系統(tǒng)。這個 Linux 操作系統(tǒng)可以安裝在虛擬機中,也可以安裝在真實的電腦中。關(guān)于這方面的內(nèi)容,可見筆者的其它博客:
VMware Workstation Pro 16 安裝教程:
https://blog.csdn.net/wangpaiblog/article/details/112152218?spm=1001.2014.3001.5502
Linux 操作系統(tǒng) CentOS Stream 安裝教程:
https://blog.csdn.net/wangpaiblog/article/details/119792728?spm=1001.2014.3001.5502
為了方便遠(yuǎn)程輸入命令、將文件加入到 Linux 操作系統(tǒng)中,最好還要在一臺 Windows 操作系統(tǒng)上面使用一種終端控制軟件,如 Xshell、Xftp 等。關(guān)于這方面的內(nèi)容,可見筆者的另一篇博客:
如何在 Windows 主機上訪問本地局域網(wǎng)中的 Linux 主機:
https://blog.csdn.net/wangpaiblog/article/details/120052152?spm=1001.2014.3001.5502
一般來說,安裝一個軟件有 3 種方法:離線安裝、在線安裝、免安裝。通常,離線安裝是最好的方法,同時也通常是筆者的首選,本文亦使用的是離線安裝的方法。
對于 Linux,這三種方法各有千秋。筆者分別試驗了這 3 種方法,但只給出離線安裝的方法。因為對于安裝來說,提供多種選擇實屬多余,還會增加讀者選擇上的負(fù)擔(dān)。
對于 Linux,離線安裝的好處與壞處分別為:
- 好處:除了第一次下載需要下載完整的安裝包之外,之后每次安裝都可無需聯(lián)網(wǎng)。這樣不僅節(jié)約了流量,而且無需擔(dān)心未來安裝包會失效。相對免安裝,安裝操作會在操作系統(tǒng)中注冊該軟件的信息,會安裝時會自動執(zhí)行某些操作,通常可以避免一些手動配置。
- 壞處:離線安裝無法自動安裝依賴。如果所要安裝的安裝包依賴其它安裝包,安裝者需要自己手動下載完所有的依賴安裝包。
由于 Linux 操作系統(tǒng)的種類繁多,因此首先要知道要安裝 Linux 操作系統(tǒng)的處理器架構(gòu)信息。以 CentOS 8 x86_64 為例,輸入以下命令:
cat /proc/version[root@localhost ~]# cat /proc/version Linux version 4.18.0-348.el8.x86_64 (mockbuild@kbuilder.bsys.centos.org) (gcc version 8.5.0 20210514 (Red Hat 8.5.0-3) (GCC)) #1 SMP Tue Oct 19 15:14:17 UTC 2021
可以看出,上述的關(guān)鍵信息為 x86_64。記住這一點,下面將會用上。
Linux 的 PMS 工具主流有兩種。
對于基于 Red Hat 的發(fā)行版,其 PMS 工具為 rpm,對應(yīng)的安裝命令為 yum。
對于基于 Debian 的發(fā)行版,其 PMS 工具為 dpkg,對應(yīng)的安裝命令為 aptitude。
筆者的操作系統(tǒng) CentOS 8 x86_64 屬于 Red Hat,將使用后綴為 rpm 的安裝包。如果讀者使用的操作系統(tǒng)為 Ubuntu,需要選擇后綴為 deb 的安裝包。如果讀者不知道如何分辨,可以輸入以下命令來驗證:
yum[root@localhost xshell_win10]# yum [...一長串說明文字...]
如果輸入 yum 之后,出現(xiàn)了一大串的說明文字,說明應(yīng)該使用后綴為 rpm 的安裝包。如果提示 yum 命令不存在,說明應(yīng)該使用后綴為 deb 的安裝包。當(dāng)然,讀者也可以通過輸入命令 aptitude 來進(jìn)行進(jìn)一步的驗證。
下載 GitLab
GitLab 有 CE 與 EE 兩種版本,其中,CE 指的是 Community Edition(社區(qū)版) ,EE 指的是 Enterprise Edition(企業(yè)版)。顯然,顧名思義,EE 是一種收費版。如果沒有特殊的需求,選擇哪個版本無關(guān)緊要。官方推薦安裝 EE 版,給出的理由是,安裝 EE 版本后,如果不想付費,可以不付費,只是會缺少相應(yīng)的功能。但如果安裝完 CE 版本后,又想安裝 EE 版本,還需要重新安裝(見 https://about.gitlab.com/install/ce-or-ee/)。這里,筆者安裝的是 EE 版。畢竟,國內(nèi)的環(huán)境良好,有很多途徑可以讓付費產(chǎn)品變成免費。
到官網(wǎng)中下載 GitLab,網(wǎng)址:https://packages.gitlab.com/gitlab/gitlab-ee
注意,這里要根據(jù)前面查看的 Linux 系統(tǒng)的信息來下載對應(yīng)的安裝包。此處筆者應(yīng)該選擇帶 x86、64、Linux 8 字樣的安裝包。
再次提醒,安裝包不要選錯了,選擇錯誤的安裝包在安裝后可能出現(xiàn)各種難解的問題。比方說,Centos Stream 與 Centos 不是同一種操作系統(tǒng),而在筆者編寫本教程的時候,GitLab 并沒有為 Centos Stream 提供安裝包,所以如果操作系統(tǒng)是 Centos Stream,那目前是不能安裝 GitLab 的!
【提示】
??GitLab 官網(wǎng)中已經(jīng)給出了 GitLab 安裝配置的參考教程,鏈接:https://about.gitlab.com/install/#centos-8
安裝 GitLab
下載完成之后,可以使用 Xftp 將安裝包置入 Linux 操作系統(tǒng)中。然后進(jìn)行該安裝包目錄,輸入以下命令進(jìn)行安裝:
sudo yum localinstall gitlab-ee-14.3.6-ee.0.el8.x86_64.rpm(注意:雖然這是離線安裝包,但安裝時并非完全不需要網(wǎng)絡(luò)。在初次安裝時,操作系統(tǒng)可能會首先對軟件倉庫進(jìn)行更新,此過程需要聯(lián)網(wǎng)。)
設(shè)置 GitLab 網(wǎng)頁客戶端網(wǎng)址。網(wǎng)址應(yīng)該由 IP 與端口號組成。IP 是 GitLab 所在的 Linux 服務(wù)器的 IP。端口號可任意想一個不會與已有的端口號相沖突的端口號。應(yīng)在文件 gitlab.rb 中設(shè)置這個信息。文件 gitlab.rb 在目錄 /etc/gitlab 中。修改文件 gitlab.rb 的方法有很多,可以直接用 Xftp 將打開此文件進(jìn)行修改。
在修改前,如果因為好奇等原因已經(jīng)啟動了 GitLab 服務(wù),則需要使用如下命令關(guān)閉 GitLab 服務(wù)。
gitlab-ctl stop在文件 gitlab.rb 中的 external_url 一行上添加如下代碼。如果沒有 external_url 這一行,那就新加這一行。
external_url 'http://ip地址:端口號'其中,ip地址、端口號 要換成實際的值。
在防火墻中對外開啟此端口。
firewall-cmd --zone=public --add-port=端口號/tcp --permanentfirewall-cmd --reload
其中,端口號 要換成上面設(shè)置的實際值。
設(shè)置 GitLab 的數(shù)據(jù)存放路徑。此處如果不設(shè)置,則默認(rèn)路徑為 /var/opt/gitlab/git-data/。修改的方法是在文件 gitlab.rb 編寫如下代碼:(注意:在修改路徑前,要將原 GitLab 的數(shù)據(jù)存放目錄下的文件拷貝到新目錄中。)
git_data_dirs({"default" => {"path" => "自定義的 GitLab 倉庫儲存路徑"} })其中,自定義的 GitLab 倉庫儲存路徑 要改成實際的值。
使用如下命令使上面的配置生效。
如果曾經(jīng)多次反復(fù)卸載過 GitLab,而且沒有卸載干凈,則此過程很容易卡住。需要中斷操作然后將 GitLab 卸載干凈再來進(jìn)行此操作。
gitlab-ctl reconfigure如果是第一次配置,則執(zhí)行完上述命令之后,GitLab 服務(wù)會自動設(shè)置成開機啟動且馬上會啟動。如果沒有 GitLab 服務(wù)沒有啟動,也可以使用如下命令。
gitlab-ctl start登錄 GitLab
現(xiàn)在到任一能訪問到該 Linux 服務(wù)器的瀏覽器中輸入如下網(wǎng)址,應(yīng)該就可以訪問 GitLab 網(wǎng)頁端了。
http://ip地址:端口號其中,ip地址、端口號 要換成實際的值。
此時應(yīng)該看到的是 GitLab 登錄界面。在 GitLab 第一次初始化時,會自動生成一個管理員賬戶。其中,該賬戶的用戶名為 root,密碼在一個自動生成的文件 /etc/gitlab/initial_root_password 中(密碼不會含空格),且會在 24 小時后自動被刪除。
現(xiàn)在要做的是,先備份上述的文件 initial_root_password,然后登錄管理員賬戶修改管理員密碼。新密碼長度不能小于 8 位。
GitLab 漢化
如果更喜歡中文,GitLab 提供了中文界面,可按下圖所示設(shè)置。設(shè)置完成之后,刷新界面即可生效。
【注意】
??有的人使用嘗試對 GitLab 進(jìn)行漢化(https://gitlab.com/xhang/gitlab)。建議不要這樣做,此漢化有風(fēng)險,如果操作不當(dāng)有可能會破壞 GitLab 的程序,使之無法使用。此過程不可逆,請謹(jǐn)慎操作。
上面的登錄界面還可以用于注冊新用戶。不過,新用戶注冊完成之后需要管理員審批。如果不需要審批功能,可以登錄管理員賬戶將其關(guān)閉。
GitLab 設(shè)置密鑰
如果想要向 GitLab 上傳推送文件,這需要向 GitLab 添加公鑰,這方面的內(nèi)容與 GitHub 等網(wǎng)站相同,可見筆者的另一篇博客:
Git、TortoiseGit、GitHub、Gitee、GitLab 安裝與入門使用:
https://blog.csdn.net/wangpaiblog/article/details/121278972
卸載 GitLab
如果不小心破壞了 GitLab 的運行環(huán)境而又無法修復(fù),這就需要重裝 GitLab。在卸載前,注意要備份 GitLab 中倉庫的數(shù)據(jù)文件。徹底卸載 GitLab 的流程如下。
停止 GitLab 服務(wù)。
gitlab-ctl stop卸載 GitLab。(卸載這種操作有風(fēng)險,可能導(dǎo)致再次安裝時永遠(yuǎn)失敗,請三思后行)
sudo yum erase gitlab*sudo rpm -e gitlab-ee
查看與 GitLab 相關(guān)的進(jìn)程。
ps aux | grep gitlab根據(jù) PID,殺死那個有很多省略號的進(jìn)程。
kill -9 進(jìn)程 PID 號其中,進(jìn)程 PID 號 要換成實際的值。
刪除與 GitLab 相關(guān)的文件
find / -name gitlab | xargs rm -rf刪除以下的 Linux 用戶:(此操作可能有風(fēng)險,謹(jǐn)慎使用)
userdel -rf gitlab-wwwuserdel -rf gitlab-redis
userdel -rf gitlab-psql
userdel -rf gitlab-prometheus
userdel -rf git
卸載完重啟 Linux。
reboot總結(jié)
以上是生活随笔為你收集整理的Linux 下 GitLab 安装教程的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 简易 IM 双向通信电脑端 GUI 应用
- 下一篇: linux java maven项目_J