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

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

ワークフローの各ステップのステータスと結果を表示する、保留中のワークフローをキャンセルする、失敗したワークフローをデバッグして再実行する、ログを検索してダウンロードする、アーチファクトをダウンロードするなどが可能です。

GitHub Actionsは現在、限定パブリックベータとして利用可能で、変更となる可能性があります。ベータ期間中は、高価なワークフローやコンテンツにこの機能を利用することは避けてください。

詳細は「GitHub Actionsについて」(/articles/about-github-actions) を参照してください。

You can manage a workflow run if you have GitHub Actions enabled and have write permissions to a repository or are a member of an organization that owns a repository.

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

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

You can see whether a workflow run is in progress or complete from the workflow run page. 実行が進行中の場合はキャンセルできます。 実行が完了している場合には、結果が成功か失敗か、キャンセルされたか、またはニュートラルかを確認できます。 実行が失敗した場合には、ビルドログを表示して検索し、失敗の原因を診断してワークフローを再実行することもできます。 ログとビルドアーチファクトをダウンロードすることも可能です。

Annotated workflow run image

GitHub Actionsは、Checks APIを使用してワークフローのステータス、結果、ログを出力します。 GitHub creates a new check suite for each workflow triggered by the same event. The check suite contains a check run for each job in the workflow, and each job includes steps. GitHub Actionsは、ワークフローのステップとして実行されます。 Checks APIに関する詳しい情報については、GitHub 開発者ドキュメンテーションで「Checks」を参照してください。

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

ワークフローの実行の各ジョブと、ジョブの各ステップを表示することができます。 詳細については、「GitHub Actionsについて」を参照してください。

各ジョブにはデフォルトで [Set up Job] ステップと [Complete job] ステップがあり、ワークフローでアクションが設定されます。

  1. GitHub で、リポジトリのメインページへ移動します。

  2. リポジトリ名の下で [Actions] をクリックします。

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

  3. 左のサイドバーで、表示するワークフローをクリックします。

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

  4. [Workflow runs] で、表示する実行の名前をクリックします。

    ワークフロー実行の名前

  5. オプションとして、実行が失敗した場合にワークフローを再実行するには、ワークフローの右上隅で [Re-run checks] ドロップダウンメニューから [Re-run all checks] を選択します。

    [Re-run checks] ドロップダウンメニュー

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

ワークフローの実行をキャンセルすると、GitHubはそのワークフローに含まれるすべてのステップをキャンセルします。

  1. GitHub で、リポジトリのメインページへ移動します。

  2. リポジトリ名の下で [Actions] をクリックします。

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

  3. 左のサイドバーで、表示するワークフローをクリックします。

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

  4. [Workflow runs] で、表示する実行の名前をクリックします。

    ワークフロー実行の名前

  5. ワークフローの右上隅で、[Cancel check suite] をクリックします。

    [Cancel check suite] ボタン

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

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

GitHubには完全なビルドログとアーチファクトが補完されますが、その期間はプッシュで90日間、プルリクエストで30日間です。 プルリクエストの場合の保持期間は、そのプルリクエストに対してプッシュがあるたびにリセットされます。

  1. GitHub で、リポジトリのメインページへ移動します。

  2. リポジトリ名の下で [Actions] をクリックします。

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

  3. 左のサイドバーで、表示するワークフローをクリックします。

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

  4. [Workflow runs] で、表示する実行の名前をクリックします。

    ワークフロー実行の名前

  5. 左のサイドバーで、表示するジョブをクリックします。

    左サイドバーのジョブリスト

  6. ログを展開して、失敗したステップを確認するには、ステップをクリックします。

    失敗したステップの名前

  7. オプションで、ログの特定の行のリンクをコピーするには、その行にカーソルを置いて をクリックします。

    リンクをコピーするボタン

ログを検索する

特定のステップのビルドログを検索できます。 ログを検索する際、展開されているステップのみが結果に含まれます。

  1. GitHub で、リポジトリのメインページへ移動します。

  2. リポジトリ名の下で [Actions] をクリックします。

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

  3. 左のサイドバーで、表示するワークフローをクリックします。

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

  4. [Workflow runs] で、表示する実行の名前をクリックします。

    ワークフロー実行の名前

  5. 左のサイドバーで、表示するジョブをクリックします。

    左サイドバーのジョブリスト

  6. 検索に含めたい各ステップを展開するには、そのステップをクリックします。

    ステップの名前

  7. ログ出力の右上隅にある [Search logs] 検索ボックスに、検索語句を入力します。

    ログを検索するための検索ボックス

ログとアーチファクトをダウンロードする

アーチファクトとは、コードをビルドしてテストするときに作成されるファイルのことです。 たとえば、アーチファクトには、バイナリまたパッケージファイル、テスト結果、スクリーンショット、ログファイルなどがあります。 実行が完了すると、これらのファイルはワークフローを実行した仮想環境から削除され、アーカイブされてダウンロードできるようになります。

  1. GitHub で、リポジトリのメインページへ移動します。

  2. リポジトリ名の下で [Actions] をクリックします。

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

  3. 左のサイドバーで、表示するワークフローをクリックします。

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

  4. [Workflow runs] で、表示する実行の名前をクリックします。

    ワークフロー実行の名前

  5. ログをダウンロードするには、[Download logs] ドロップダウンメニューから、ダウンロードしたいログを選択します。

    [Download logs] ドロップダウンメニュー

  6. アーチファクトをダウンロードするには、[Artifacts] ドロップダウンメニューを使用して、ダウンロードしたいアーチファクトを選択します。

    [Artifacts] ドロップダウンメニュー

参考リンク

GitHub Actions ](/articles/workflow-syntax-for-github-actions)のワークフロー構文

担当者にお尋ねください

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

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