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

GitHub Actionsについて

GitHub Actions では、カスタムソフトウェア開発のライフサイクル (SDLC) にわたるワークフローを GitHub リポジトリに直接作成することができます。

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

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

GitHub Actionsについて

GitHub Actionsは、コードを保存しするのと同じ場所でソフトウェア開発のワークフローを自動化し、プルリクエストやIssueで協力することを支援します。 個々のタスクを書き、アクションを呼び出し、それらを組み合わせてカスタムのワークフローを作成できます。 ワークフローとは、GitHubで任意のコードプロジェクトをビルド、テスト、パッケージ、リリース、またはデプロイするためにリポジトリで設定できる、カスタムの自動プロセスです。

GitHub Actions では、エンドツーエンドの継続的インテグレーション (CI) と継続的デプロイメント (CD) 機能をリポジトリに直接ビルドすることができます。 GitHub Actionsは、GitHubに組み込まれている継続的インテグレーションサービスを駆動します。 詳細については、「継続的インテグレーションについて」を参照してください。

Workflows run in Linux, macOS, Windows, and containers on GitHub-hosted machines, called 'runners'. Alternatively, you can also host your own runners to run workflows on machines you own or manage. For more information see, "About self-hosted runners."

ワークフローの作成には、リポジトリで定義されているアクション、GitHubのパブリックリポジトリにあるオープンソースのアクション、または公開されているDockerコンテナイメージを使用できます。 フォークされたリポジトリのワークフローは、デフォルトでは動作しません。

ワークフローで使用するアクションをGitHubで見つけ、GitHubコミュニティと共有するアクションをビルドできます。 カスタムアクションの作成については、「アクションのビルド」を参照してください。

特定のイベントで実行するように設定したワークフローファイルを作成できます。 詳細については、「ワークフローの設定」と「GitHub Actionsのワークフロー構文」を参照してください。

一般的な用語の定義については「GitHub Actionsの中核的な概念」を参照してください。

GitHubコミュニティでアクションを見つける

GitHub Marketplaceは、GitHubコミュニティによって構築されたアクションを見つけ、共有し、利用するための中央となる場所です。 詳しい情報については「ワークフロー中でのGitHub Marketplaceからのアクションの利用」を参照してください。

GitHub上のパブリックリポジトリで共有されているオープンソースのアクションでプロジェクトをカスタマイズし、actions Organization内でGitHubによって構築されたアクションを使うこともできます。

ワークフロー実行の通知

GitHub Actionsに対するメールあるいはWeb通知を有効化すると、あなたが起動したワークフローランが完了すると通知されます。 この通知には、ワークフローランのステータス(成功、失敗、ニュートラル、キャンセルされたランが含まれます)が含まれます。 ワークフローランが失敗したときにだけ通知を受けるようにすることもできます。

リポジトリのActionsタブでワークフローランのステータスを見ることもできます。 詳細については、「ワークフロー実行の管理」を参照してください。

使用制限

There are some limits on GitHub Actions usage. Unless specified, the following limits apply only to GitHub-hosted runners, and not self-hosted runners. These limits are subject to change.

  • 同時に実行できるワークフローはリポジトリごとに最大で20です。 If exceeded, any additional workflows are queued.

  • ワークフローの各ジョブは、最大で6時間まで実行できます。 If a job reaches this limit, the job is terminated and fails to complete.

  • The number of concurrent jobs you can run across all repositories in your account depends on your GitHub plan. If exceeded, any additional jobs are queued.

    GitHubプラン 最大同時ジョブ 最大同時macOSジョブ
    無料 20 5
    Pro 40 5
    Team 60 5
    Enterprise 180 15
  • 1時間に実行できるAPIリクエストは、1つのリポジトリの全アクションで最大1000までです。 This limit also applies to self-hosted runners. If exceeded, additional API calls will fail, which might cause jobs to fail.

In addition to these limits, GitHub Actions should not be used for:

  • 法律違反、またはそれ以外で当社の利用規約またはコミュニティガイドラインに反しているコンテンツまたは行為
  • クリプトマイニング
  • サーバーレスコンピューティング
  • GitHub ユーザまたは GitHub サービスを危険にさらす行為
  • GitHub Actionsが使用されるリポジトリに関連するソフトウェアプロジェクトの製造、テスト、デプロイ、公開に関連しないその他の行為。 つまり、GitHub Actionsを使用して常識的に不適切と判断できることはしないこと

このような使用制限違反や、GitHub Actionsの悪用を防ぐために、GitHubはGitHub Actionsの使用を監視する場合があります。 GitHub Actionsを不正利用した場合には、ジョブが停止されたり、GitHub Actionsの使用を制限されたりすることもあります。

GitHub Actionsの支払いについて

パブリックリポジトリでは、GitHub Actionsの利用は無料です。 プライベートリポジトリでは、それぞれのGitHubアカウントは使用している製品に応じて一定量の無料の分とストレージを受け取ります。 詳細は「GitHub Actions の支払いについて」を参照してください。

サポートへの連絡

たとえば構文、GitHubホストランナー、アクションの構築など、ワークフローの設定に関して何か支援が必要な場合は、GitHub コミュニティフォーラムのGitHub Actionsボードで既存のトピックを探してみるか、新しいトピックを開始してください。

GitHub Actionsについてのフィードバックもしくは機能リクエストがあるなら、それらをGitHub Actionsのフィードバックフォームで共有してください。

あなたの利用方法、もしくは意図する利用方法が利用制限のカテゴリに当てはまるかどうかに関わらず、以下のいずれかの場合はGitHub Supportまたは GitHub Premium Supportに連絡してください。

  • アカウントに間違った制約が課されていると思われる場合
  • たとえばユニークIDのような予想外のエラーに、アクションの実行時に遭遇した場合
  • 既存の動作が期待される、ただし必ずしもドキュメント化されてはいない動作と矛盾するような状況に遭遇した場合

参考リンク

担当者にお尋ねください

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

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