CentOS 7下Yum及RPM安裝GitLab CE 14.0.3
一、概述
GitLab是一個利用Ruby on Rails開發的開源應用程序，實現一個自托管的Git項目倉庫，可通過Web界面進行訪問公開的或者私人項目。它擁有與GitHub類似的功能，能夠瀏覽源代碼，管理缺陷和注釋。可以管理團隊對倉庫的訪問，它非常易于瀏覽提交過的版本并提供一個文件歷史庫。團隊成員可以利用內置的簡單聊天程序(Wall)進行交流。它還提供一個代碼片段收集功能可以輕松實現代碼復用，便于日后有需要的時候進行查找。
二、部署環境說明
本文中使用本地VM虛機部署測試。
OS：CentOS 7.8 x64
IP：192.168.168.100
虛機配置：2核CPU、4G內存
注：系統為最小化安裝，部署前已完成系統初始化、內核及安全優化。
官方文檔：
https://doc.gitlab.cc/omnibus/
推薦安裝方法：官方 Linux 軟件包。Linux軟件包安裝速度更快、升級更容易，并且包含其他方法所沒有的增強可靠性的功能。 通過單個包(也稱為 Omnibus)安裝，該包捆綁了運行 GitLab 所需的所有不同服務和工具。 建議至少 4 GB 的內存。
三、基礎依賴環境
1.安裝依賴
- yum -y install curl policycoreutils-python openssh-server perl
2.防火墻配置
CentOS7 默認使用firewall，本文中禁用firewall，使用iptables。后續按實際配置需求開放端口。
3.安裝 Postfix(CentOS 7系統一般已默認安裝)
使用Postfix發送通知電子郵件。如果想使用其他解決方案發送電子郵件，請跳過此步驟并在安裝GitLab后配置外部SMTP服務器。
- yum -y install postfix
- systemctl enable postfix
- systemctl start postfix
四、YUM安裝GitLab
1.添加 GitLab 包存儲庫
方法一：使用官方YUM源
- curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | bash
方法二：使用國內YUM源
## 新建REPO文件
- vi /etc/yum.repos.d/gitlab-ce.repo
- //添加如下內容
- [gitlab-ce]
- name=Gitlab CE Repository
- baseurl=https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el$releasever/
- gpgcheck=0
- enabled=1
## 更新本地yum緩存
- yum makecache fast
2.安裝
## 安裝最新版
- yum -y install gitlab-ce
安裝完成如下圖所示。
上圖提示：GitLab 無法檢測到實例的有效主機名，請通過設置 /etc/gitlab/gitlab.rb 文件中的“external_url”配置項為GitLab實例配置URL。
## 安裝指定版本
- yum -y install gitlab-ce-x.x.x
- //x.x.x代表版本號
五、RPM包安裝GitLab
如果不習慣通過安裝存儲庫來安裝Gitlab，可以下載RPM包來安裝。RPM包集成了它所需要的軟件，簡化安裝步驟。
官方RPM包地址：
https://packages.gitlab.com/gitlab/gitlab-ce
國內RPM包地址：
https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/
- cd /data/tools
- wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-14.0.3-ce.0.el7.x86_64.rpm
- rpm -ivh gitlab-ce-14.0.3-ce.0.el7.x86_64.rpm
安裝完成如下圖所示。
上圖提示：GitLab 無法檢測到實例的有效主機名，請通過設置 /etc/gitlab/gitlab.rb 文件中的“external_url”配置項為GitLab實例配置URL。
六、配置GitLab
1.修改gitlab.rb配置
## 設置 external_url ，綁定監聽的域名或IP端口。若GitLab需通過公網訪問，最好配置域名加HTTPS;若是內部網絡訪問，則可配置IP+端口，也可配置域名，用戶通過配置本地hosts解析訪問。
## 本文中為測試，使用IP+端口的方式，即 http://192.168.168.100:90。設置的端口不能被占用，默認是80端口，如果80已經使用，可自定義其它端口，并在防火墻設置開放相對應的端口。
- vi /etc/gitlab/gitlab.rb
2.加載配置
- gitlab-ctl reconfigure
- //第一次配置時間較長，請耐心等待
注：①初始化默認管理員帳戶的用戶名為 root ，密碼存儲在
/etc/gitlab/initial_root_password 文件中，此文件將在 24 小時后的第一次重新配置運行中清除。
②若非必要不建議做第二次初始化，后續若有修改配置文件使用命令 gitlab-ctl restart 重啟所有組件服務即可生效新的配置。
③先修改gitlab.rb文件中的“external_url”選項值，再使用“gitlab-ctl reconfigure”命令配置GitLab。就不需要在配置后修改 “
/var/opt/gitlab/gitlab-rails/etc/gitlab.yml ”文件中的“Web server settings”的值，如下圖：
以及不需要修改 “
/var/opt/gitlab/nginx/conf/gitlab-http.conf ”文件的“server”選項中的"listen"和“server_name”的值，如下圖：
七、測試訪問
## 查看初始化管理員帳戶密碼，密碼存儲在
/etc/gitlab/initial_root_password 文件中。本文中初始化管理員帳戶生成的密碼為：w8HgJZJd2+USFDwKxQWqRO2FWUQjE9UfBUFbLx3kfRM=
## 瀏覽器地址欄輸入：http://ip:port/，本文為http://192.168.168.100:90。服務器iptables防火墻已放開90端口。
## 輸入初始管理員賬戶: root 密碼：XGi+u+5Z3Nga/lLK+
fgpxTuTOADzHd9h9vWmquUU4cQ= ，登錄。
## 登錄成功后的首頁。
## 接下來就可以使用GitLab了，本文中不一一闡述。
八、修改管理員密碼
管理員帳戶root密碼是初始化默認生成的，建議在首次登錄后進行修改。
方法一：
## 點擊首頁左上角 "Menu" → “Admin” ，如下圖所示：
## 左側欄中 “Overview” → “Users”，會在右側頁面中顯示當前用戶，新安裝部署的GitLab只有一個管理員帳戶，單擊管理員帳戶信息欄最后的 "Edit"。如下圖所示：
## 在編輯頁面的"Password"選項中輸入兩次新密碼，點擊頁面底部的"Save changes"，保存更改。
方法二：
## 點擊首頁右上角管理員帳戶頭像 → “Edit profile” ，如下圖所示：
## 點擊左側欄中 “Password”，在右側頁面中輸入管理員帳戶當前密碼、兩次新密碼，點擊“Save password”保存更改。如下圖所示：
方法三：
通過Rails 控制臺重置管理員帳戶密碼。
Rails 控制臺官方文檔：
https://docs.gitlab.com/ce/administration/operations/rails_console.html
登錄GitLab應用所在的服務器，執行下列命令：
## 對于使用YUM源或RPM包安裝的使用如下命令連接Rails 控制臺
- gitlab-rails console
## 使用如下命令完成重置密碼
- user = User.first
- //切換至超級管理員，id為1的是超級管理員
- user.password = 'yourNewpassword'
- //密碼至少8個字符，此處重置的新密碼為"yourNewpassword"
- user.save!
- //如無問題返回"true"
## 修改完成，輸入 quit 或 exit 退出Rails 控制臺。
方法四：
使用Rake Task重置管理員帳戶密碼。
官方文檔：
https://docs.gitlab.com/ce/security/reset_user_password.html
登錄GitLab應用所在的服務器，執行下列命令：
- gitlab-rake "gitlab:password:reset"
- //輸入管理員帳戶及兩次新密碼
九、GitLab常用命令
- ## 配置GitLab
- gitlab-ctl reconfigure
- ## 啟動所有 gitlab 組件
- gitlab-ctl start
- ## 停止所有 gitlab 組件
- gitlab-ctl stop
- ## 重啟所有 gitlab 組件
- gitlab-ctl restart
- ## 查看服務狀態
- gitlab-ctl status
- ## 檢查GitLab
- gitlab-rake gitlab:check SANITIZE=true --trace
- ## 查看日志
- gitlab-ctl tail
【編輯推薦】
