GitHub Actions

Author

Ryo Nakagami

Published

2025-01-14

Modified

2025-11-21

はじめに

プロセスやタスクの実行を自動化し,管理するためのシステムのことをワークフローエンジンと呼びます. Github ActionsはGitHubが提供するワークフローエンジンです.

GitHub Actionsを用いることで次のようなタスクを自動化することができます.

  • pull_requestをトリガーとして,pytestやlinter checkを実行
  • バージョンタグを作成した際に,自動でリリースノートを生成し,バイナリをアップロード
  • Markdown形式のドキュメントを自動生成し,GitHub Pagesにデプロイ

GitHub Actionsはワークフローという単位でタスクを管理・自動化します.このワークフローを定義するファイルはワークフローファイルと呼ばれ, GitHubではYAML形式で.github/workflowsディレクトリ以下に記述します.このワークフローファイルの設定をこの章では解説します.

▶  ワークフローファイルの基本ルール

  • ファイル拡張子は.yml, .yamlのいずれか
  • ワークフロー構文はYAML形式で記述
  • YAMLのアンカー,エイリアスは使用できない
  • ワークフローファイルは.github/workflowsディレクトリ直下へ配置