GitLab CI/CD パイプライン

目次

• 概要
• 使用時期
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

GitLab Runner インフラストラクチャとコンテナ実行を使用して、ビルド、テスト、デプロイを自動化する包括的な GitLab CI/CD パイプラインを作成します。

使用時期

• GitLab リポジトリの CI/CD セットアップ
• マルチステージビルドパイプライン
• Docker レジストリ統合
• Kubernetes デプロイメント
• Review App デプロイメント
• キャッシュ最適化
• 依存関係管理

クイックスタート

最小限の実装例:

# .gitlab-ci.yml
image: node:18-alpine

variables:
  DOCKER_DRIVER: overlay2
  FF_USE_FASTZIP: "true"

stages:
  - lint
  - test
  - build
  - security
  - deploy-review
  - deploy-prod

cache:
  key: ${CI_COMMIT_REF_SLUG}
  paths:
    - node_modules/
    - .npm/

lint:
  stage: lint
  script:
    - npm install
// ... (see reference guides for full implementation)

リファレンスガイド

references/ ディレクトリの詳細な実装:

ベストプラクティス

✅ すべきこと

• ステージを使用してパイプラインフローを整理する
• 依存関係のキャッシングを実装する
• テストレポートに成果物を使用する
• 適切なキャッシュキーを設定する
• only と except での条件付き実行を実装する
• ジョブ依存関係に needs: を使用する
• expire_in で成果物をクリーンアップする
• 一貫した環境のために Docker を使用する
• セキュリティスキャンステージを実装する
• ジョブのリソース制限を設定する
• マージリクエストパイプラインを使用する

❌ すべきではないこと

• 並列化可能なテストを直列で実行する
• 不要なキャッシングをすべてに行う
• 大きな成果物を無期限に保存する
• シークレットを設定ファイルに保存する
• 必要のない特権付き Docker を実行する
• セキュリティスキャンをスキップする
• パイプライン失敗を無視する
• 適切な制御なしに only: [main] を使用する