GitLab の基礎

バージョン管理は、ファイルの変更を「いつ、誰が、何のために」と一緒に残す仕組みです。

Git は、この履歴を自分の PC の中に持つ道具です。GitLab は、その履歴をチームで共有する置き場に、Issue(やること)、MR(変更の提案とレビュー)、CI/CD(自動の検査と実行)を一緒にしたものです。

研修の GitLab は Community Edition(無料版)です。AI と一緒に開発する体制に要る機能の多くは入っていますが、承認の強制や AI の機能は有料版にあります。

dlive-training/dl-training-app は、中古 IT 機器の保守と販売を行う会社(演習用の架空の会社)の基幹システムです。PHP 7.4 で動く、見積と在庫の画面を持っています。

• 1つの Issue に1つのブランチ、1つの MR
• ブランチは Issue の画面の Create merge request で作る。名前は Issue 番号から始まり(例 12-fmt-money-test)、MR と Issue が自動でつながる
• 作業中の MR は Draft にしておく。Draft の MR はマージできない
• AI が作るブランチは ai/issue-番号-… の形で、人のブランチと名前で見分けられる
• main には直接 push できない(保護ブランチ)。main に入るのは、マージだけ

パイプラインは、段(stage)の順に、ジョブ(job)を動かします。同じ段のジョブは並んで動き、前の段が赤なら次の段は動きません。

どのジョブをどのきっかけで動かすかは、ジョブの rules に書きます。研修リポジトリでは、.gitlab-ci.yml の workflow:rules で、MR があるブランチへの push では MR のパイプラインだけを走らせています。ブランチ用と MR 用の2本に分かれると、「パイプラインが通らないとマージできない」が MR 用の1本しか見ず、ブランチ用で赤のテストがあってもマージできてしまうからです。

workflow:
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
    - if: $CI_COMMIT_BRANCH && $CI_OPEN_MERGE_REQUESTS && $CI_PIPELINE_SOURCE == "push"
      when: never
    - if: $CI_COMMIT_BRANCH

include:
  - local: ci/jobs/*.yml