(参考)他言語で行う場合の例
本章では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リポジトリに記載されています。
- 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リポジトリに記載されています。
- 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の基本 で扱っています。