跳到主要內容

架設 Gitlab 於 uBuntu 12.04.3 LTS（Non-root path）

有一個 GUI 的界面對我們的親和力總是比較高的，即使是習慣 Coding 的人還是會想有一個好的介面來使用 Git，諸如 github 與 bitbucket 此類的 Code hosting，也都設計了想當好的 Web Interface 提供相當好的使用體驗。如果我們想要有好的界面，但是又想自己 Hosting Code 在自己的伺服器呢？目前有許多 Open Source 的專案提供了這類的  Web 應用，我比較喜歡的是 Indefero（基於PHP） 和 Gitlab（基於Ruby） 這兩套。Indefero 是類似 Google Code 的網站，而 GitLab 則是類似 Github 的界面。
Indefero
GitLab
由於個人比較喜歡 GitLab 的界面，所以雖然對 Ruby 不是很熟悉，決定來挑戰一下安裝 GitLab。參考了 Tsung's Blog：將 GitLab 架設 於 Ubuntu 12.04 (Precise) 和 官方的安裝說明文件，不同的地方主要是在前述方法會成爲主要的 Root 網站，但我運行的伺服器還有運行其他的 Web 服務，所以要安裝在非主目錄。尋找解決方法和測試，花了將近 8 個小時，爲了方便自己記憶，決定記錄下整個過程。

套件需求


  • Python 2.5+
  • ruby 1.9.3+
  • git 1.7.10+
  • redis 2.0+
  • MySQL（or PostgreSQL）

基本環境安裝

  1. 更新套件庫資料
    $ sudo apt-get update
    $ sudo apt-get dist-upgrade
  2. 安裝 VIM 作爲編輯工具，並設定爲預設編輯器（若已安裝請略過）
    $ sudo apt-get install -y vim
    $ sudo update-alternatives --set editor /usr/bin/vim.basic
  3. 安裝必要的套件
    $ sudo apt-get install -y build-essential zlib1g-dev libyaml-dev libssl-dev libgdbm-dev libreadline-dev libncurses5-dev libffi-dev curl openssh-server redis-server checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libicu-dev logrotate
  4. 確定 Python 的版本，必須是 2.5+
    $ python --version
  5. 確認能夠使用 python2 使用 Python，如果不行請自行建立連結
    $ python2 --version

    # 如果出現 command not found 錯誤請建立連結
    $ sudo ln -s /usr/bin/python /usr/bin/python2
  6. 安裝 python-docutils
    $ sudo apt-get install -y python-docutils

確認 Git 安裝的版本必須要在 1.7.10 以上

  1. 檢查目前 12.04 官方套件庫的版本資訊
    $ apt-cache showpkg git-core
    Package: git-core
    Versions:
    1:1.7.9.5-1
    # 目前的版本爲 1.7.9.5 所以必須手動安裝 Git
  2. 安裝 Git 相依性套件
    $ sudo apt-get install -y libexpat1-dev gettext libz-dev
  3. 手動安裝 Git
    $ cd /tmp
    $ curl --progress https://git-core.googlecode.com/files/git-1.8.4.1.tar.gz | tar xz
    $ cd git-1.8.4.1/
    $ make prefix=/usr/local all

    # 指定安裝至 /usr/local/bin（預設會裝至 ~/bin/）
    $ sudo make prefix=/usr/local install

安裝 Ruby

  1. 安裝 Ruby 2.0+ （若有安裝 Ruby 1.8 請先移除）
    $ mkdir /tmp/ruby && cd /tmp/ruby
    $ curl --progress ftp://ftp.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p353.tar.gz | tar xz
    $ cd ruby-2.0.0-p353
    $ ./configure --disable-install-rdoc
    $ make
    $ sudo make install
  2. 安裝 Bundler Gem
    $ sudo gem install bundler --no-ri --no-rdoc

新增 GitLab 系統帳號

  1. 不允許登入
    $ sudo adduser --disabled-login --gecos 'GitLab' git

安裝 GitLab shell

  1. 切換至 git 帳號家目錄
    $ cd /home/git
  2. 複製 GitLab shell
    $ sudo -u git -H git clone https://github.com/gitlabhq/gitlab-shell.git
    $ cd gitlab-shell
  3. 切換至正確的版本（使用 git tag 找最新版）
    $ sudo -u git -H git checkout v1.7.6
  4. 編輯 config 檔
    $ sudo -u git -H cp config.yml.example config.yml

    # 修改 gitlab_url, 改成自己的 domain name, http://your-domain-name/
    $ sudo -u git -H editor config.yml
  5. 執行安裝
    $ sudo -u git -H ./bin/install

安裝資料庫

  1. 資料庫安裝可以參考檔案 databases.md
  2. 我是使用 MySQL，安裝的方式不再贅述，以 root 身份登入
    $ mysql -u root -p
  3. 建立 GitLab 使用的 MySQL 帳號
    mysql> CREATE USER 'gitlab'@'localhost' IDENTIFIED BY '$password';
  4. 建立 GitLab production 資料庫和設定權限
    mysql> CREATE DATABASE IF NOT EXISTS `gitlabhq_production` DEFAULT CHARACTER SET `utf8` COLLATE `utf8_unicode_ci`;
    mysql> GRANT SELECT, LOCK TABLES, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON `gitlabhq_production`.* TO 'gitlab'@'localhost';
  5. 使用 gitlab 帳號, 測試 MySQL 連線狀況
    $ sudo -u git -H mysql -u gitlab -p -D gitlabhq_production
    # 如果看到 mysql> 表示成功了

安裝與設定 GitLab

  1. 切換至 git 家目錄，複製檔案
    $ cd /home/git

    # 由 Github 複製 GitLab 檔案
    $ sudo -u git -H git clone https://github.com/gitlabhq/gitlabhq.git gitlab
    $ cd /home/git/gitlab
  2. Checkout 穩定版本，git branch -a 或 git branch -r 找 stable 版本
    $ sudo -u git -H git checkout 6-3-stable
  3. 設定 GitLab
    $ cd /home/git/gitlab

    # 複製 GitLab Config 範本
    $ sudo -u git -H cp config/gitlab.yml.example config/gitlab.yml

    # 修改設定，將所有 localhost 更換成我們的 domain name
    # 因爲前述步驟中，我們 Git 是由 Source 自行安裝，將 bin_path 修改爲 /usr/local/bin/git
    $ sudo -u git -H editor config/gitlab.yml

    # 確認 GitLab 可以寫入 log/ 和 tmp/ 資料夾
    $ sudo chown -R git log/
    $ sudo chown -R git tmp/
    $ sudo chmod -R u+rwX  log/
    $ sudo chmod -R u+rwX  tmp/

    # 建立新資料夾給 satellites
    $ sudo -u git -H mkdir /home/git/gitlab-satellites

    # 建立資料夾給 sockets/pids
    $ sudo -u git -H mkdir tmp/pids/
    $ sudo -u git -H mkdir tmp/sockets/
    $ sudo chmod -R u+rwX  tmp/pids/
    $ sudo chmod -R u+rwX  tmp/sockets/

    # 建立 public/uploads 資料夾
    $ sudo -u git -H mkdir public/uploads
    $ sudo chmod -R u+rwX  public/uploads

    # 複製 unicorn 範例及設定，如果2G RAM, worker_processes 可以改成 3
    $ sudo -u git -H cp config/unicorn.rb.example config/unicorn.rb
    $ sudo -u git -H editor config/unicorn.rb

    # 複製 Rack attack 範例及設定
    $ sudo -u git -H cp config/initializers/rack_attack.rb.example config/initializers/rack_attack.rb
    $ sudo -u git -H git config --global user.name "GitLab"
    $ sudo -u git -H git config --global user.email "gitlab@localhost"
    $ sudo -u git -H git config --global core.autocrlf input
    # 到此設定完成可以再檢查確認 gitlab.yml, unicorn.rb 是否存在, 檢查 gitlab.yml 設定是否正確

GitLab Database 設定

  1. 我是使用 MySQL 所以複製 database.yml.mysql，使用Postgresql 請複製 database.yml.postgresql
    $ sudo -u git cp config/database.yml.mysql config/database.yml
  2. 修改 database.yml 中  production（第一個部分）中的設定，將 'secure password' 修改爲 資料庫 gitlab 帳號的密碼
    $ sudo -u git -H editor config/database.yml
  3. 修改 database.yml 權限，只有 git 帳號可以讀取
    $ sudo -u git -H chmod o-rwx config/database.yml

安裝 Gems

  1. 切換至 gitlab 目錄
    $ cd /home/git/gitlab
  2. MySQL 的使用者，選項請使用 "without ... postgres"，PostgresSQL 的使用者請使用 "without ... mysql"
    $ sudo -u git -H bundle install --deployment --without development test postgres aws

初始化資料庫

  1. 輸入 "yes" 來建立需要的資料庫內容
    $ sudo -u git -H bundle exec rake gitlab:setup RAILS_ENV=production
  2. 完成後將取得 GitLab 系統預設帳號、密碼
    Administrator account created:
        login.........admin@local.host
        password......5iveL!fe

設定開機啓動與 Logrotate

  1. 複製 init Script，加上執行權限
    $ sudo cp lib/support/init.d/gitlab /etc/init.d/gitlab
    $ sudo chmod +x /etc/init.d/gitlab
  2. 設定開機啓動 GitLab
    $ sudo update-rc.d gitlab defaults 21
  3. 設定 Logrotate
    $ sudo cp lib/support/logrotate/gitlab /etc/logrotate.d/gitlab

檢查GitLab 應用程式狀態和啓動

  1. 檢查 GitLab 環境設定狀態
    $ sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production
  2. 啓動 GitLab
    $ sudo service gitlab start
    # 或是
    $ sudo /etc/init.d/gitlab restart
  3. 再檢查應用程式的狀態，如果都出現綠色就是沒有問題，否則再仔細檢查前述的步驟
    $ sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production

設定 Apache2 環境

這個部分是我和大家比較不一樣的地方，是設定 Sub directory，像是：http://www.example.com/gitlab/ 。如果你的伺服器比較單純，沒有進行其他的網站服務，可以使用 Tsung's Blog 上的方法，下載 gitlab.conf 即可。
  1. 有三個檔案需要修改：application.rb、gitlab.yml、unicorn.rb，將下面資料前面的註解移除。
    # 移除 config.relative_url_root = "/gitlab" 前方註解
    $ sudo -u git -H editor config/application.rb

    # 移除 relative_url_root: /gitlab 前方註解
    $ sudo -u git -H editor config/gitlab.yml

    # 移除 ENV['RAILS_RELATIVE_URL_ROOT'] 前方註解
    $ sudo -u git -H editor config/unicorn.rb
  2. 設定網站的 Alias 至 apache2 中
    $ sudo vim /etc/apache2/sites-available/default
    Alias /gitlab "/home/git/gitlab/public"
    <Directory /home/git/gitlab/public>
        Options -MultiViews
        SetEnv RAILS_RELATIVE_URL_ROOT "/gitlab"
    </directory>
  3. 啓用下面幾項模組
    $ sudo a2enmod rewrite proxy proxy_http
  4. 修改 Proxy 設定，檔案中加入下面幾行
    $ sudo vim /etc/apache2/mod-available/proxy.conf
    ProxyRequests On
    ProxyPreserveHost on
    <proxy>
      AddDefaultCharset off
      Order deny,allow
      Allow from all
      AllowOverride All
    </proxy>
  5. 修改 apache2.conf 設定
    $ sudo vim /etc/apache2/apache2.conf
    # 檔案最後加上下列兩行
    ProxyPass         /gitlab/ http://127.0.0.1:8080/gitlab/
    ProxyPassReverse  /gitlab/ http://127.0.0.1:8080/gitlab/
  6. 重新啓動 Apache 和 GitLab
    $ sudo service apache2 restart
    $ sudo service gitlab restart

修改 unicorn listen 設定（選擇性）

因爲我的 8080 Port 運行著 Tomcat，所以必須修改 unicorn 的 listen port 避免他們打架 XD
  1. 切換到 gitlab 目錄
    $ cd /home/git/gitlab
  2. 修改 config/unicorn.rb 資料，找到 listen 的地方修改 8080 更換成想要的 Port 號碼
    $ sudo -u git -H editor config/unicorn.rb
    listen "127.0.0.1:9242"
  3. 前段第五點 apache2.conf 設定，改爲下列
    $ sudo vim /etc/apache2/apache2.conf
    ProxyPass         /gitlab/ http://127.0.0.1:9242/gitlab/
    ProxyPassReverse  /gitlab/ http://127.0.0.1:9242/gitlab/
  4. 重新啓動 Apache 和 GitLab
到這裏 GitLab 就架設完成了~ ！連到 http://your-domain-name/gitlab/ 享受甜美的果實吧！（第一次啓動會花比較久的時間，請耐心等候）


標籤：

留言

張貼留言

這個網誌中的熱門文章

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...
張貼留言
閱讀完整內容