GitHub Actions基礎

GitHub Actionsとは

GitHub上でコードを自動実行する仕組み。push時にテストを走らせたり、定時にスクリプトを実行したりできる。

設定ファイル: .github/workflows/〇〇.yml

最小のワークフロー

name: テスト実行
on:
  push:
    branches: [main]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'
      - run: pip install -r requirements.txt
      - run: pytest

構造の説明

項目	説明	例
`name`	ワークフロー名	`CI`
`on`	実行タイミング	push, schedule, workflow_dispatch
`jobs`	ジョブ定義	test, build, deploy
`runs-on`	実行環境	ubuntu-latest, windows-latest
`steps`	実行手順	uses or run

トリガー（実行タイミング）

# push時
on:
  push:
    branches: [main]

# プルリクエスト時
on:
  pull_request:

# 定期実行（毎日3時UTC）
on:
  schedule:
    - cron: '0 3 * * *'

# 手動実行ボタン
on:
  workflow_dispatch:

よく使うアクション

アクション	用途
`actions/checkout@v4`	コードをチェックアウト（必須）
`actions/setup-python@v5`	Python環境のセットアップ
`actions/setup-node@v4`	Node.js環境
`actions/cache@v4`	キャッシュで高速化
`actions/upload-artifact@v4`	成果物の保存
`actions/deploy-pages@v4`	GitHub Pagesデプロイ

環境変数・シークレット

steps:
  - name: API呼び出し
    env:
      API_KEY: ${{ secrets.MY_API_KEY }}
    run: python3 script.py

シークレットは Settings → Secrets and variables → Actions で設定。ログには表示されない。

確認方法

リポジトリの Actions タブで実行履歴・ログを確認

CLI: gh run list / gh run view / gh run watch

← ガイド一覧に戻る