GitBucketをdockerで構築

1. GitBucket

1.1. 目的

未だにソース管理されていない現場が、まだまだあるのでバージョン管理システムを構築し、運用ルールを設ける指標を考えてみました。

私自身、バージョン管理システムでの運用を実施したことがないので勉強を兼ねてますので、色々と不備はあると思いますが何事も経験してみないことには、不具合を理解することができないと思うのでご指摘あればお願いします。

また私は、バージョン管理システムをDevOpsの最初の一歩と考えています。バージョン管理システム自体は、本来は、集中型と分散型のメリット・デメリットを考慮した上で検討すべきなのでしょうが、安易に最近の流行りであるGitを導入してみました。

Dockerコンテナ環境の構築は前回のDockerでコンテナ環境簡単構築を参照。

1.2. GitBucketとは？

GitBucketとは、Gitのリポジトリ環境を自前で構築するサーバであり、OSSのGitHubクローンです。

GitHub等で世間にソースコードを公開はしたくないが、Gitでリポジトリを管理するのに適したミドルウェアです。

GitBucketは「GitHubクローン」をうたっており、UIはかなり寄せてあります。

リポジトリブラウザはもちろんのことフォーク機能、イシュートラッカー、Wikiなど、GitHubの主要機能のほとんどが実装されていますでのGitHubを使ったことがある人からすれば、違和感なく使うことができるでしょう。

2. GitBucket構築

2.1. 環境

CentOS : 7.5.1804 Docker : 18.09.0, build 4d60db4 Docker-compose : 1.23.2, build 1110ad01 ※Dockerには、[Docker CE]とエンタープライズ版の[Docker EE]がありますが、今回は無償の[Docer CE]を使用します。 GitBucket 4.29.0

2.2. docker imageのダウンロード

gitbucketのdocker imageをダウンロードするには、以下のコマンドを実行するだけで完了となります。

# docker pull gitbucket/gitbucket
Using default tag: latest
latest: Pulling from gitbucket/gitbucket
5040bd298390: Pull complete
fce5728aad85: Pull complete
c42794440453: Pull complete
0c0da797ba48: Pull complete
7c9b17433752: Pull complete
114e02586e63: Pull complete
e4c663802e9a: Pull complete
4f8252fa05f0: Pull complete
9da190d7177d: Pull complete
Digest: sha256:2a418a857fdf624f05fd4958c9eae25fbb26ccbe7dbad02497d3f8adfedf2d18
Status: Downloaded newer image for gitbucket/gitbucket:latest

ダウンロードしたdocker imageを確認するには

# docker images
REPOSITORY            TAG                 IMAGE ID            CREATED             SIZE
gitbucket/gitbucket   latest              8a9b1c7d4155        10 days ago         362MB

2.3. docker imageの起動・停止

以下のようにして簡単に起動できます。

# docker run -d -p 8080:8080 gitbucket/gitbucket

gitbucketにSSH接続も行う場合は-p 29418:29418を指定します。

# docker run -d -p 8080:8080 -p 29418:29418 gitbucket/gitbucket

データディレクトリの場所を指定するには-vで指定できます。

# docker run -d -p 8080:8080 -v `pwd`/gitbucket:/gitbucket gitbucket/gitbucket

プロセスを確認するには

# docker ps -a
CONTAINER ID        IMAGE                 COMMAND                  CREATED             STATUS              PORTS                               NAMES
5e4857ec99d5        gitbucket/gitbucket   "sh -c 'java -jar /o…"   17 minutes ago      Up 17 minutes       0.0.0.0:8080->8080/tcp, 29418/tcp   dazzling_matsumoto

停止するには

# docker stop <CONTAINER ID>

停止した場合は、STATUSが[Exited]となります。

# docker ps -a
CONTAINER ID        IMAGE                 COMMAND                  CREATED             STATUS                        PORTS               NAMES
5e4857ec99d5        gitbucket/gitbucket   "sh -c 'java -jar /o…"   21 minutes ago      Exited (137) 28 seconds ago                       dazzling_matsumoto

2.4. ブラウザアクセス

クライアントからブラウザで以下にアクセスし http://:8080/

以下のユーザでログインすること。 user:root password:root

2.5. DockerでGitBucketのコンテナを永続化+Port変更

docker上のコンテナで作成したリポジトリ情報は，コンテナを破棄した時に同時に消滅してしまいます。そのため、dockerのデータボリューム機能及びdocker compose機能を用いて永続化をしました。

まずは、Dockerfileでデータボリューム及びbuildする対象を設定。＋Portをdefault8080から8888に変更

# vi Dockerfile
FROM java:8-jre

MAINTAINER Naoki Takezoe <takezoe [at] gmail.com>

ADD https://github.com/gitbucket/gitbucket/releases/download/4.30.0/gitbucket.war /opt/gitbucket.war

RUN ln -s /gitbucket /root/.gitbucket

VOLUME ./gitbucket/gitbucket-data:/gitbucket

# Port for web page
EXPOSE 8888
# Port for SSH access to git repository (Optional)
EXPOSE 29418

ENV MAX_FILE_SIZE=3145728

CMD ["sh", "-c", "java -jar /opt/gitbucket.war --max_file_size=$MAX_FILE_SIZE"]

そして、docker composeの設定＋Portをdefault8080から8888に変更

# vi docker-compose.yml
version: '2'
services:
  gitbucket:
    image: gitbucket:4.30.0
    ports:
      - 8888:8080
      - 29418:29418
    volumes:
      - ./gitbucket/gitbucket-data:/gitbucket
    restart: always

docker composeから起動(docker-compose.ymlが存在するディレクトリで実行すること)

# docker-compose up -d

docker composeからの停止は

# docker-compose down

docker composeからのプロセス確認は

# docker-compose ps

@legitwhiz

legit whiz 技術レポート