👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Stay tuned for a blog post later today.


ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

ワークフローの実行の管理

You can view the status and results of each step in your workflow, cancel a pending workflow, view billable job execution minutes, debug and re-run a failed workflow, search and download logs, and download artifacts.

GitHub ActionsはGitHub Free、GitHub Pro、GitHub FreeのOrganization、GitHub Team、GitHub Enterprise Cloud、GitHub Oneで利用できます。 GitHub Actionsは、レガシーのリポジトリごとのプランを使っているアカウントが所有しているプライベートリポジトリでは利用できません。 詳しい情報については「GitHubの製品」を参照してください。

ここには以下の内容があります:

探していたものは見つけられましたか?

ワークフロー管理について

ワークフローの実行ページから、ワークフローの実行が進行中か完了しているかを確認できます。 実行が進行中の場合はキャンセルできます。 パブリックなリポジトリの分も含むワークフローの実行情報を見るには、GitHubのアカウントにログインしなければなりません。 詳細は「GitHub 上のアクセス権限」を参照してください。

実行が完了している場合には、結果が成功か失敗か、キャンセルされたか、またはニュートラルかを確認できます。 実行が失敗した場合には、ビルドログを表示して検索し、失敗の原因を診断してワークフローを再実行することもできます。 You can also view billable job execution minutes, or download logs and build artifacts.

アノテーションされたワークフローの実行イメージ

GitHub Actionsは、Checks APIを使用してワークフローのステータス、結果、ログを出力します。 GitHub は、ワークフローの実行に対してそれぞれ新しいチェックスイートを作成します。 チェックスイートには、ワークフロー内の各ジョブに対するチェック実行が含まれ、各ジョブにはステップが含まれています。 GitHub Actionsは、ワークフローのステップとして実行されます。 For more information about the Checks API, see "Checks."

ノート: リポジトリには正当なワークフローファイルだけをコミットするようにしてください。 .github/workflowsに不正なワークフローファイルが含まれていると、GitHub Actionsは新規のコミットのたびに失敗するワークフローの実行を生成します。

ワークフロー履歴を表示する

ワークフローの実行の各ジョブと、ジョブの各ステップを表示することができます。 詳しい情報については「GitHub Actionsの中核的概念」を参照してください。 リポジトリの読み取りアクセス権を持つ人は、以下のステップを実行できます。

ワークフローファイルで設定されたステップに加えて、各ジョブにはジョブの実行の開始と完了のための追加タスクも含まれます。 これらのステップは、"Set up job"及び"Complete job"としてワークフローの実行にログインします。

GitHubホストランナー上のジョブの実行では、"Set up job"はランナーの仮想環境の詳細を記録し、ランナーマシン上にあったプリインストールされたツールのリストへのリンクを含みます。

  1. GitHubで、リポジトリのメインページにアクセスしてください。
  2. リポジトリ名の下でActions(アクション)をクリックしてください。
    メインのリポジトリナビゲーション内のアクションタブ
  3. 左のサイドバーで、表示させたいワークフローをクリックしてください。
    左サイドバーのワークフローのリスト
  4. "Workflow runs(ワークフローの実行)"の下で、表示させたい実行の名前をクリックしてください。
    ワークフローの実行の名前
  5. あるいは実行が失敗した場合にワークフローを再実行するには、ワークフローの右上隅で [Re-run checks] ドロップダウンメニューから [Re-run all checks] を選択します。
    [Re-run checks] ドロップダウンメニュー

ワークフローの実行をキャンセルする

ワークフローの実行をキャンセルすると、GitHubはそのワークフローに含まれるすべてのステップをキャンセルします。 リポジトリへの書き込みレベルのアクセス権を持つ人は、以下のステップを実行できます。

  1. GitHubで、リポジトリのメインページにアクセスしてください。
  2. リポジトリ名の下でActions(アクション)をクリックしてください。
    メインのリポジトリナビゲーション内のアクションタブ
  3. 左のサイドバーで、表示させたいワークフローをクリックしてください。
    左サイドバーのワークフローのリスト
  4. "Workflow runs(ワークフローの実行)"の下で、表示させたい実行の名前をクリックしてください。
    ワークフローの実行の名前
  5. ワークフローの右上隅で、[Cancel check suite] をクリックします。
    [Cancel check suite] ボタン

Viewing billable job execution minutes

You can view the execution time of a job, including the billable minutes that a job accrued.

Billable job execution minutes are only shown for jobs run on private repositories that use GitHub-hosted runners. There are no billable minutes when using GitHub Actions in public repositories or for jobs run on self-hosted runners.

  1. GitHubで、リポジトリのメインページにアクセスしてください。

  2. リポジトリ名の下でActions(アクション)をクリックしてください。

    メインのリポジトリナビゲーション内のアクションタブ

  3. 左のサイドバーで、表示させたいワークフローをクリックしてください。

    左サイドバーのワークフローのリスト

  4. "Workflow runs(ワークフローの実行)"の下で、表示させたい実行の名前をクリックしてください。

    ワークフローの実行の名前

  5. Under the job summary, click Run and billable time details.

    Run and billable time details link

    Note: The billable time shown does not include any rounding or minute multipliers. To view your total GitHub Actions usage, including rounding and minute multipliers, see "Viewing your GitHub Actions usage."

ログを表示してエラーを診断する

ワークフローの実行を失敗した場合には、どのステップが失敗の原因になったかを確認し、失敗したステップのビルドログを確かめてトラブルシューティングすることができます。 各ステップの実行にかかった時間もわかります。 ログファイルの特定の行のパーマリンクをコピーして、チームで共有することもできます。 リポジトリの読み取りアクセス権を持つ人は、以下のステップを実行できます。

GitHubは、完全なビルドログと成果物が90日間保存されます。

  1. GitHubで、リポジトリのメインページにアクセスしてください。
  2. リポジトリ名の下でActions(アクション)をクリックしてください。
    メインのリポジトリナビゲーション内のアクションタブ
  3. 左のサイドバーで、表示させたいワークフローをクリックしてください。
    左サイドバーのワークフローのリスト
  4. "Workflow runs(ワークフローの実行)"の下で、表示させたい実行の名前をクリックしてください。
    ワークフローの実行の名前
  5. 左のサイドバーで、表示させたいジョブをクリックしてください。
    左サイドバーのジョブのリスト
  6. ログを展開して、失敗したステップを確認するには、ステップをクリックします。
    失敗したステップの名前
  7. あるいはログの中の特定の行へのリンクを取得するには、そのステップの行番号をクリックします。 Webブラウザのアドレスバーからリンクをコピーできます。
    リンクをコピーするボタン

ログを検索する

特定のステップのビルドログを検索できます。 ログを検索する際、展開されているステップのみが結果に含まれます。 リポジトリの読み取りアクセス権を持つ人は、以下のステップを実行できます。

  1. GitHubで、リポジトリのメインページにアクセスしてください。
  2. リポジトリ名の下でActions(アクション)をクリックしてください。
    メインのリポジトリナビゲーション内のアクションタブ
  3. 左のサイドバーで、表示させたいワークフローをクリックしてください。
    左サイドバーのワークフローのリスト
  4. "Workflow runs(ワークフローの実行)"の下で、表示させたい実行の名前をクリックしてください。
    ワークフローの実行の名前
  5. 左のサイドバーで、表示させたいジョブをクリックしてください。
    左サイドバーのジョブのリスト
  6. 検索に含めたい各ステップを展開するには、そのステップをクリックします。
    ステップの名前
  7. ログ出力の右上隅にある [Search logs] 検索ボックスに、検索語句を入力します。
    ログを検索するための検索ボックス

ログのダウンロード

ワークフローの実行からは、ログファイルをダウンロードできます。 また、ワークフローの成果物もダウンロードできます。 詳しい情報については「成果物を使ったワークフローのデータの永続化」を参照してください。 リポジトリの読み取りアクセス権を持つ人は、以下のステップを実行できます。

  1. GitHubで、リポジトリのメインページにアクセスしてください。
  2. リポジトリ名の下でActions(アクション)をクリックしてください。
    メインのリポジトリナビゲーション内のアクションタブ
  3. 左のサイドバーで、表示させたいワークフローをクリックしてください。
    左サイドバーのワークフローのリスト
  4. "Workflow runs(ワークフローの実行)"の下で、表示させたい実行の名前をクリックしてください。
    ワークフローの実行の名前
  5. ログをダウンロードするには、[Download logs] ドロップダウンメニューから、ダウンロードしたいログを選択します。
    [Download logs] ドロップダウンメニュー

ログの削除

ワークフローの実行からログファイルを削除できます。 リポジトリへの書き込みレベルのアクセス権を持つ人は、以下のステップを実行できます。

  1. GitHubで、リポジトリのメインページにアクセスしてください。
  2. リポジトリ名の下でActions(アクション)をクリックしてください。
    メインのリポジトリナビゲーション内のアクションタブ
  3. 左のサイドバーで、表示させたいワークフローをクリックしてください。
    左サイドバーのワークフローのリスト
  4. "Workflow runs(ワークフローの実行)"の下で、表示させたい実行の名前をクリックしてください。
    ワークフローの実行の名前
  5. ログファイルを削除するには、Delete all logs(すべてのログを削除)ボタンをクリックして、確認の要求を見てください 。
    Delete all logs ログを削除すると、Delete all logs(すべてのログを削除)ボタンはなくなり、ワークフローの実行中にログファイルが残っていないことを示します。

デバッグロギングの有効化

ワークフロージョブあるいはステップが期待どおりに動作しない理由を診断する上で、十分な詳細がワークフローのログになかった場合、追加のデバッグロギングを有効化できます。

These extra logs are enabled by setting secrets in the repository containing the workflow, so the same permissions requirements will apply:

  • Organizationのレベルでシークレットを作成するには、管理アクセス権を持っていなければなりません。
  • ユーザアカウントのリポジトリにシークレットを作成するには、そのリポジトリのオーナーでなければなりません。 Organizationのリポジトリにシークレットを作成するには、管理アクセス権を持っていなければなりません。
  • REST APIを使ってシークレットを作成するには、リポジトリに対する書き込みアクセス権を持っていなければなりません。 For more information, see "GitHub Actions secrets API."

シークレットの設定に関する詳しい情報については、「暗号化されたシークレットの作成と利用」を参照してください。

ランナーの診断ロギングの有効化

Runner diagnostic logging provides additional log files that contain information about how a runner is executing a job. ログアーカイブには、2つのログファイルが追加されます。

  • ランナープロセスログにはジョブの実行のためのランナーの調整とセットアップに関する情報が含まれます。
  • ワーカープロセスログには、ジョブの実行が記録されます。
  1. ランナー診断ロギングを有効化するには、ワークフローを含むリポジトリ内で以下のシークレットを設定してください: ACTIONS_RUNNER_DEBUGtrueにしてください。

  2. ランナーの診断ログをダウンロードするには、ワークフローの実行のログアーカイブをダウンロードしてください。 ランナーの診断ログはrunner-diagnostic-logsフォルダに含まれています。 ログのダウンロードに関する詳しい情報については「ログのダウンロード」を参照してください。

ステップのデバッグロギングの有効化

ステップのデバッグロギングは、ジョブの実行の間と実行後のジョブのログの詳細度を高めます。

  1. ステップのデバッグロギングを有効化するには、ワークフローを含むリポジトリで以下のシークレットを設定しなければなりません: ACTIONS_STEP_DEBUGtrueにしてください。

  2. このシークレットを設定すると、ステップログにより多くのデバッグイベントが示されるようになります。 詳しい情報については「障害の診断のためのログの閲覧」を参照してください。

参考リンク

探していたものは見つけられましたか?

担当者にお尋ねください

探しているものが見つからなかったでしょうか?

弊社にお問い合わせください