[[GitLabサーバインストールとメンテ注意事項]] * 目次 [#la6e12bc] #contents * 動機 [#z55447e1] GitLabを立ち上げて、ReadMeなどの閲覧でMarkDown書いて、そんでもってPlantUmlがmarkdown内に記述できたら、以下のメリットがあるのではないかと思った ** メリット [#kab36434] テキストなので、diffを使った差分がわかるので以下のメリットがある。 - 汎用的なツールで違いを見つけることができる。つまり、低コスト - 差分だけの確認でよいので、時間の節約 - テキストなので、成果物のファイルサイズが小さくて済むので、マシンリソースの節約 - gitがつかえるので、分散管理でドキュメントの消失に強い * GitLabをDockerをつかってインストール [#f79010c2] 公式サイトの以下のページを見る https://docs.gitlab.com/ee/install/ インストール方法はたくさんあるが、今回はdockerを使ったやり方にする ** dockerを利用したGitLabのインストール [#dd55d77f] 今回は、どの環境でも素早く構築できることを信じてDockerでインストールする方法をためしてみようと思う。 https://docs.gitlab.com/ee/install/docker.html Docker for Windows は公式にはサポートされていないようだ。でもやりたいのは、ローカルマシンのwindows上で動作させることだからなんとかやってみる。 成功事例の以下のブログ記事を参考にしてみよう。 ***Windows10にDocker ComposeでGitlabを導入 [#qec795ad] https://qiita.com/peanuts2013/items/105be140eb9826cfdb2d *** Windows+Docker(Compose)でGitlabをローカルに立ち上げた時の話 [#q9e96503] https://qiita.com/beeeegle/items/b8d8da113f272f61af44 *** gitlabのDockerイメージ [#if2e5780] https://hub.docker.com/r/gitlab/gitlab-ee/ いや、まてよコミュニティーエディションは、こっちか https://registry.hub.docker.com/r/gitlab/gitlab-ce/ こっちがコミュニティーエディションのほうが無料のはず。まあ、そんなことは気にしなくても、dockerを使ったインストールのブログをあされば、docker-composeの設定が書いてあるとおもうから、それをつかえばいい。 *** 機能の比較 [#o6733efb] https://about.gitlab.com/features/?stage=plan 無料で使える機能が充実している、よっぽど使い倒す気持ちがない以上は無料プランでよいとおもった。 JIRAとも連携できるのか、ふむふむ。 * 手順 [#ye66473d] ** 手順1 docker-compose.ymlを作る [#jf391b4f] docker-compose.ymlとは、複数のdockerで立ち上げるサーバの設定ファイルみたいなもので、dockerは停止させるとdockerに保存したファイルは初期化されやすいので、そのサーバ内で使うデータは volumes: で指定したところに格納するようになっている。 *** docker-compose.yml [#g1a440cc] version: "3.9" services: web: image: 'gitlab/gitlab-ce:latest' restart: always hostname: 'gitlab.example.com' environment: GITLAB_OMNIBUS_CONFIG: | external_url 'http://web:8929' gitlab_rails['gitlab_shell_ssh_port'] = 2224 ports: - '8929:8929' - '2224:22' - '443:443' volumes: - '/srv/gitlab/config:/etc/gitlab' - '/srv/gitlab/logs:/var/log/gitlab' - '/srv/gitlab/data:/var/opt/gitlab' 参考URL: https://qiita.com/beeeegle/items/b8d8da113f272f61af44 ** dockerコンポーズする [#t99254a4] docker-compose up -d * GitLabでPlantUmlを使う手順 [#s5375ad8] https://docs.gitlab.com/ee/administration/integration/plantuml.html#configure-your-plantuml-server