(参考)他言語で行う場合の例

本章ではPythonのflake8とpytestを題材に扱いましたが、同じ考え方で他の言語でも静的解析・自動テストをCI/CDパイプラインに組み込めます。ここでは参考として、Go言語とJavaScript / TypeScriptで行う場合のワークフロー例を掲載します。実際にハンズオンとして動かす必要はありません。

1. Go言語

Goでは、以下のツールが本章で扱ったflake8・pytestに相当する位置付けで使われます。

  • 静的解析: golangci-lint(gofmt / go vet / staticcheck など複数のリンタを集約したツール)
  • 自動テスト: go test(標準のtestingパッケージ)

これらをGitHub Actionsで動かす場合、.github/workflows/code-check.ymlに静的解析用と自動テスト用の2つのジョブを定義します。ワークフローの骨格(on: pull_request によるトリガーや、ジョブごとに独立したランナーで並列実行される点など)はPython版とまったく同じです。以下では、Go版で違いが出るステップを、静的解析と自動テストのジョブごとに解説します。

1.1 静的解析(golangci-lint)ジョブ

静的解析用のジョブとして、以下のようなgo-lintジョブを定義します。

name: Go Code Check

on:
  pull_request:
    branches:
      - main

jobs:
  go-lint:
    name: Run go-lint
    runs-on: ubuntu-latest

    steps:
      # ソースコードのチェックアウト
      - name: Checkout code
        uses: actions/checkout@v5

      # Go環境をセットアップ
      - name: Set up Go
        uses: actions/setup-go@v5
        with:
          go-version: "1.22"

      # golangci-lint で静的解析を実行
      - name: Run golangci-lint
        uses: golangci/golangci-lint-action@v6
        with:
          version: latest

Python版と違いが出るステップを解説します。

- name: Set up Go
  uses: actions/setup-go@v5
  with:
    go-version: "1.22"

Goのランタイムをセットアップします。golangci-lintはGo製のツールのため、実行にはGoのランタイムが必要です。actions/setup-go@v5に対する詳細は、こちらのGitHubリポジトリに記載されています。

actions/setup-go

- name: Run golangci-lint
  uses: golangci/golangci-lint-action@v6
  with:
    version: latest

Python版ではpip install flake8とflake8 .の2ステップに分かれていましたが、Goではgolangci/golangci-lint-actionを使うとインストールと実行を1つのアクションで完結できます。プロジェクト直下に.golangci.ymlがあれば、その設定を自動で読み取って解析します。actions/setup-goのキャッシュとも連携するため、2回目以降の実行が速くなる利点もあります。

1.2 自動テスト(go test)ジョブ

続いて、同じcode-check.ymlのjobs:配下に、以下のようなgo-testジョブを追加します。

  go-test:
    name: Run go-test
    runs-on: ubuntu-latest

    steps:
      # ソースコードのチェックアウト
      - name: Checkout code
        uses: actions/checkout@v5

      # Go環境をセットアップ
      - name: Set up Go
        uses: actions/setup-go@v5
        with:
          go-version: "1.22"

      # go test で自動テストを実行
      - name: Run go test
        run: go test ./... -race -cover

Python版と違いが出るステップを解説します。

- name: Set up Go
  uses: actions/setup-go@v5
  with:
    go-version: "1.22"

静的解析ジョブと同じく、Goのランタイムをセットアップします。ジョブは独立したランナーで動作するため、go testを実行するジョブでも改めてセットアップが必要です。

- name: Run go test
  run: go test ./... -race -cover

go testはGoの標準機能のため、pip install pytestのような追加インストールは不要です。./...は「カレントディレクトリ配下のすべてのパッケージ」を意味し、-raceはgoroutine間のデータ競合を検出するレース検出器を、-coverはカバレッジの計測を有効にします。

Python版との対応関係を整理すると、以下のようになります。

役割 Python Go
ランタイムのセットアップ actions/setup-python actions/setup-go
静的解析ツールのインストールと実行 pip install flake8 → flake8 . golangci/golangci-lint-action(インストールと実行を1アクションで完結)
自動テストツールのインストールと実行 pip install pytest → pytest -v go test ./... -race -cover(Goの標準機能のため追加インストール不要)

golangci-lintやgo testのローカル環境での使い方や設定は、Go講座の Goで静的解析をしよう と Goで自動テストをしよう で詳しく解説しています。

2. JavaScript / TypeScript

JavaScript / TypeScriptでは、以下のツールが本章で扱ったflake8・pytestに相当する位置付けで使われます。TypeScriptを使う場合は、eslintに加えてtsc --noEmitによる型チェックも静的解析の一部として一緒に走らせるのが一般的です。

  • 静的解析: eslint(構文・スタイルチェック)、tsc --noEmit(TypeScriptの型チェック)
  • 自動テスト: vitest(テストランナー、Next.jsやViteとの相性が良い)

これらをGitHub Actionsで動かす場合、.github/workflows/code-check.ymlに静的解析用と自動テスト用の2つのジョブを定義します。Node.jsのプロジェクトでは、eslint・typescript・vitestなどのツールをpackage.jsonのdevDependenciesとして管理するため、CI/CDパイプライン側では**npm ciで依存関係をまとめてインストールする**手順が入ります。以下では、JavaScript / TypeScript版で違いが出るステップを、静的解析と自動テストのジョブごとに解説します。

2.1 静的解析(ESLint + tsc)ジョブ

静的解析用のジョブとして、以下のようなfrontend-lintジョブを定義します。

name: Frontend Code Check

on:
  pull_request:
    branches:
      - main

jobs:
  frontend-lint:
    name: Run frontend-lint
    runs-on: ubuntu-latest

    steps:
      # ソースコードのチェックアウト
      - name: Checkout code
        uses: actions/checkout@v5

      # Node.js環境をセットアップ
      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "20"
          cache: "npm"

      # 依存パッケージをインストール
      - name: Install dependencies
        run: npm ci

      # ESLintで静的解析を実行
      - name: Run ESLint
        run: npm run lint

      # tsc で型チェックを実行
      - name: Run type check
        run: npx tsc --noEmit

Python版と違いが出るステップを解説します。

- name: Set up Node.js
  uses: actions/setup-node@v4
  with:
    node-version: "20"
    cache: "npm"

Node.jsのランタイムをセットアップします。eslint・tscはいずれもNode.js上で動作するツールのため、これらを実行するにはNode.jsランタイムのインストールが必要です。cache: "npm"を指定するとpackage-lock.jsonをキーに依存パッケージのキャッシュが効くようになり、2回目以降のnpm ciが速くなります。actions/setup-node@v4に対する詳細は、こちらのGitHubリポジトリに記載されています。

actions/setup-node

- name: Install dependencies
  run: npm ci

package-lock.jsonに記録されたバージョンで依存パッケージをまとめてインストールします。npm installではなくnpm ciを使うことで、package-lock.jsonと完全に一致するバージョンだけがインストールされ、CI/CDパイプラインでの再現性が担保されます。

- name: Run ESLint
  run: npm run lint

package.jsonのscripts.lintに定義されたコマンドを実行します。Next.jsのプロジェクトでは、雛形の時点でnext lintまたはeslintを呼ぶスクリプトが用意されています。.eslintrcやeslint.config.mjsの設定に沿って構文・スタイルの問題を検出します。

- name: Run type check
  run: npx tsc --noEmit

TypeScriptの型チェックを実行します。--noEmitオプションを付けることで、JavaScriptファイルを出力せず、型エラーの検出だけを行います。eslintは構文・スタイルの問題を、tscは型の整合性を検出するため、両者は補完関係にあります。TypeScriptを使うプロジェクトでは、2つを同じジョブ内で連続実行する構成が一般的です。

2.2 自動テスト(Vitest)ジョブ

続いて、同じcode-check.ymlのjobs:配下に、以下のようなfrontend-testジョブを追加します。

  frontend-test:
    name: Run frontend-test
    runs-on: ubuntu-latest

    steps:
      # ソースコードのチェックアウト
      - name: Checkout code
        uses: actions/checkout@v5

      # Node.js環境をセットアップ
      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "20"
          cache: "npm"

      # 依存パッケージをインストール
      - name: Install dependencies
        run: npm ci

      # Vitestで自動テストを実行
      - name: Run Vitest
        run: npx vitest run

Python版と違いが出るステップを解説します。

- name: Set up Node.js
  uses: actions/setup-node@v4
  with:
    node-version: "20"
    cache: "npm"

- name: Install dependencies
  run: npm ci

Node.jsのセットアップとnpm ciは、静的解析ジョブと同じです。ジョブは独立したランナーで動作するため、vitestを実行するジョブでも同じ準備が必要になります。

- name: Run Vitest
  run: npx vitest run

vitestはローカル環境では監視モード(ファイル変更を検出して再実行する対話モード)で動作しますが、vitest runとrunサブコマンドを付けると1回だけ実行して終了するモードになります。CI/CDパイプラインではプロセスが終了する必要があるため、runサブコマンドの指定が必須です。

Python版との対応関係を整理すると、以下のようになります。

役割 Python JavaScript / TypeScript
ランタイムのセットアップ actions/setup-python actions/setup-node
依存関係のインストール pip install <ツール> を都度実行 npm ci でpackage.jsonの記述をまとめてインストール
静的解析ツールの実行 flake8 . npm run lint(eslint)+ npx tsc --noEmit(型チェック)
自動テストツールの実行 pytest -v npx vitest run

eslintやtscの設定については、フロントエンド講座の TypeScriptへの移行 と Next.jsの基本 で扱っています。