GitLab の開発環境は GitLab Development Kit で構築します。
(年々手順が簡単になっているので2017年12月のバージョンで記載します。)
公式の Prepare your computer と Set-up GDK に記載されている所から
GitLab Community Edition (CE) の開発環境の構築手順を抜粋しました。
Install
Ruby package
- Homebrew で rbenv をインストールします。
- Ruby のバージョンは .ruby-version を参考に決定します。
- 開発環境を作成するディレクトリでは Ruby のバージョンを指定します。
$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
$ brew install rbenv ruby-build
$ rbenv install 2.3.6
$ rbenv local 2.3.6
$ gem install bundler
$ rbenv rehash
Other package
- いろいろな言語やミドルウェアをインストールします。
- PostgreSQL 10.x系は対応していません。
$ brew install git redis postgresql@9.6 libiconv icu4c pkg-config cmake go openssl node yarn coreutils re2
$ bundle config build.eventmachine --with-cppflags=-I/usr/local/opt/openssl/include
GitLab Development Kit
- GitLab Community Edition は公式から Fork します。
-
gitlab_repoに Fork したURLを指定します。 - Fork ボタンをクリックしてから完了まで意外と時間がかかりました。
-
$ gem install gitlab-development-kit
$ gdk init
$ cd gitlab-development-kit
$ gdk install gitlab_repo=https://gitlab.com/[name]/gitlab-ce.git
-
*** Setup finished! ***が表示されると完了です。- 時間が３０分以上はかかりました。特に Seed で時間が使われます。
*********************************************
************** Setup finished! **************
*********************************************
cat HELP
# GitLab Development Kit cheat sheet
gdk run # Start everything
gdk run db # Start enough to run tests
gdk run app # Start GitLab, needs 'gdk run db'
gdk install gitlab_repo=https://my-fork # Install everything
gdk update # Pull application changes from Git
gdk reconfigure # Delete and regenerate all config files created by GDK
gdk psql -d gitlabhq_development # Postgres console
gdk redis-cli # Redis console
# Development admin account: root / 5iveL!fe
Start everything
-
gdk runコマンドで GitLab を利用するアプリケーションが開始されます。
$ gdk run
-
http://localhost:3000にアクセスしてrootユーザーのパスワードの入力します。
Tips
- 公式のブランチに更新するには
support/set-gitlab-upstreamコマンドで Upstream ブランチを登録します。 - そうすると
gdk updateコマンドでソースコードの更新から再構築まで実行されます。
$ support/set-gitlab-upstream
$ gdk update
Link
この記事を書いている途中に gdk install コマンドで使用される rake dev:setup コマンドにバグが見つかりイシューを登録するとすぐにマージされました。
2018年3月10日のOSS Gate大阪ワークショップではGitLabのイベントを開催します。OSS開発に参加してコントリビュートしましょう！