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

GitHub Actionsについて

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

GitHub ActionsはGitHub Free、GitHub Pro、GitHub Team、GitHub Enterprise Cloud、GitHub Oneで利用できます。 GitHub Actions is not available for private repositories owned by accounts using legacy per-repository plans. 詳しい情報については「GitHubの製品」を参照してください。

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

GitHub Actionsについて

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

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

ワークフローは、Linux、macOS、Windows、コンテナで、'ランナー'と呼ばれるGitHubがホストするマシン上で実行できます。 あるいは、自分が所有もしくは管理するマシン上でワークフローを実行するために、独自にランナーをホストすることもできます。 詳しい情報については「セルフホストランナーについて」を参照してください。

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

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

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

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

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

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

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

Disabling or limiting GitHub Actions for your repository or organization

By default, GitHub Actions is enabled on all repositories. You can choose to disable GitHub Actions or limit the use of public actions. When you limit the use of public actions, people can only use local actions that exist in your repository or organization.

For more information, see "Disabling or limiting GitHub Actions for a repository" or "Disabling or limiting GitHub Actions for your organization."

ワークフロー実行の通知

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

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

使用制限

There are some limits on GitHub Actions usage, and will vary depending on whether you use GitHub-hosted or self-hosted runners. これらの制限は変更されることがあります。

  • Job execution time - Each job in a workflow can run for up to 6 hours of execution time. ジョブがこの制限に達すると、ジョブは終了させられ、完了できずに失敗します。 This limit does not apply to self-hosted runners.

  • Workflow run time - Each workflow run is limited to 72 hours. If a workflow run reaches this limit, the workflow run is cancelled. この制限は、セルフホストランナーにも適用されます。

  • Job queue time - Each job for self-hosted runners can be queued for a maximum of 24 hours. If a self-hosted runner does not start executing the job within this limit, the job is terminated and fails to complete. This limit does not apply to GitHub-hosted runners.

  • API requests - You can execute up to 1000 API requests in an hour across all actions within a repository. この制限を超えた場合、超過のAPIコールは失敗し、それによってジョブも失敗するかもしれません。 この制限は、セルフホストランナーにも適用されます。

  • Concurrent jobs - The number of concurrent jobs you can run in your account depends on your GitHub plan, as indicated in the following table. この制限を超えた場合、超過のジョブはキューイングされます。 There are no concurrency limits for self-hosted runners.

    GitHubプラン最大同時ジョブ最大同時macOSジョブ
    無料205
    Pro405
    Team605
    Enterprise18050
  • Job matrix - A job matrix can generate a maximum of 256 jobs per workflow run. この制限は、セルフホストランナーにも適用されます。

Usage policy

In addition to the usage limits, you must ensure that you use GitHub Actions within the GitHub Terms of Service. For more information on GitHub Actions-specific terms, see the GitHub Additional Product Terms.

GitHub Actionsの支払いについて

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

サポートへの連絡

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

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

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

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

参考リンク

担当者にお尋ねください

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

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