GitHub Actions の step とは？

step は GitHub Actions における最小の実行可能単位です。それぞれがコマンドを実行するか、action を呼び出します。

job は step のリストです。step は同じ runner 上で順番に実行され、それぞれがシェルコマンドを実行するか、パッケージ化された action を呼び出せます。これが実際に作業を行う方法です。

何であるか

step は job の steps: リスト内の項目です。2 つの種類は run:（シェルコマンド）と uses:（action への参照）です。

steps:
  - uses: actions/checkout@v4
  - name: Install and test
    run: |
      npm ci
      npm test

仕組み

step は順次実行されます。runner の filesystem を共有するため、先行する step が状態（リポジトリのクローン、依存関係のインストール）を準備し、後続の step がそれに依存します。

命名と条件

読みやすいログのために step に name: を付けます。if: で step を条件付きで実行でき、outputs を生成する場合は他の場所からその結果を参照できます。

なぜ重要か

step は実際の build、test、deploy コマンドが存在する場所です。小さく、適切に名前を付けて保つことで、ログ内で失敗を簡単に特定できます。

関連する概念

step は job 内に存在し、uses: で action を呼び出せ、後続の step が消費する step outputs を生成できます。

重要なポイント

• step は 1 つのタスクです。run: コマンドまたは uses: action です。
• step は順番に実行され、runner の filesystem を共有します。
• 読みやすいログのために step に名前を付け、if: でゲートします。

関連ガイド