Github Actions Trigger

🚀 GitHub アクションガイド

このガイドでは、GitHub Actions を操作するための各種ツールの使用方法を説明します。これらのツールを使って、GitHub Actions の情報取得、ワークフローのトリガー、リポジトリ内のアクションの一覧表示、最新のリリース版の取得などを行うことができます。

🚀 クイックスタート

このガイドでは、以下の主要な操作について説明します。

• GitHub Action の詳細情報を取得する方法
• GitHub ワークフローをトリガーする方法
• 特定のリポジトリ内のすべての GitHub Actions を一覧表示する方法
• リポジトリの最新の 2 つのリリース版を取得する方法

✨ 主な機能

• get_github_action ツールを使用して、特定の GitHub Action の詳細情報を取得できます。
• trigger_github_action ツールを使用して、特定の GitHub ワークフローをトリガーできます。
• get_github_actions ツールを使用して、特定のリポジトリ内のすべての GitHub Actions を一覧表示できます。
• get_github_release ツールを使用して、リポジトリの最新の 2 つのリリース版を取得できます。

📦 インストール

このガイドで紹介するツールのインストール方法については、原ドキュメントに記載がないため省略します。

💻 使用例

GitHub Action 情報の取得

get_github_action ツールを使用して、特定の GitHub Action の詳細情報を取得します。

リクエスト形式

{
  "owner": "actions",
  "repo": "checkout",
  "ref": "v4"
}

レスポンス例

{
  "name": "Checkout",
  "description": "Check out a Git repository at a particular version",
  "author": "GitHub",
  "inputs": [
    {
      "name": "repository",
      "description": "Repository name with owner. For example, actions/checkout",
      "default": "",
      "required": false
    },
    {
      "name": "ref",
      "description": "The branch, tag or SHA to checkout.",
      "default": "",
      "required": false
    }
  ],
  "runs": {
    "using": "node20",
    "main": "dist/index.js"
  }
}

GitHub ワークフローのトリガー

trigger_github_action ツールを使用して、特定の GitHub ワークフローをトリガーします。

リクエスト形式

{
  "owner": "username-or-org",
  "repo": "repository-name",
  "workflow_id": "ci.yml",
  "inputs": {
    "deploy_environment": "production",
    "debug_enabled": "true"
  }
}

レスポンス例

{
  "success": true,
  "message": "Workflow dispatch event triggered successfully",
  "run": {
    "id": 12345678,
    "url": "https://github.com/owner/repo/actions/runs/12345678",
    "status": "queued",
    "conclusion": null,
    "created_at": "2025-03-19T06:45:12Z",
    "triggered_by": "API"
  }
}

注意事項

⚠️ 重要提示

1. ワークフローは workflow_dispatch イベントをサポートするように設定する必要があります。
2. GitHub トークンには workflow スコープの権限が必要です。
3. 入力パラメータは、ワークフロー定義のパラメータと一致させる必要があります。

リポジトリ内の GitHub Actions の取得

get_github_actions ツールを使用して、特定のリポジトリ内のすべての GitHub Actions を一覧表示します。

リクエスト形式

{
  "owner": "actions",
  "repo": "checkout"
}

レスポンス例

{
  "count": 1,
  "actions": [
    {
      "name": "Checkout",
      "description": "Check out a Git repository at a particular version",
      "author": "GitHub",
      "inputs": [
        {
          "name": "repository",
          "description": "Repository name with owner. For example, actions/checkout",
          "default": "",
          "required": false
        },
        {
          "name": "ref",
          "description": "The branch, tag or SHA to checkout.",
          "default": "",
          "required": false
        }
      ],
      "runs": {
        "using": "node20",
        "main": "dist/index.js"
      }
    }
  ]
}

最新の 2 つのリリース版の取得

get_github_release ツールを使用して、リポジトリの最新の 2 つのリリース版を取得します。

リクエスト形式

{
  "owner": "actions/runner",
  "repo": "runners"
}

レスポンス例

[
  {
    "tag_name": "2.286.0",
    "name": "GitHub Hosted Runner for Windows release 2.286.0",
    "body": "New release of GitHub Hosted Runner for Windows.",
    "published_at": "2024-03-19T15:00:00Z"
  },
  {
    "tag_name": "2.285.0",
    "name": "GitHub Hosted Runner for Windows release 2.285.0",
    "body": "New release of GitHub Hosted Runner for Windows.",
    "published_at": "2024-03-18T15:00:00Z"
  }
]

注意事項

⚠️ 重要提示

• デフォルトでは、このツールは最新の 2 つのリリース版を返します。
• より多くまたは少ないリリース版が必要な場合は、リクエストパラメータを調整してください。

以上のツールとサンプルを使用することで、GitHub Actions を使った開発フローの自動化をより深く理解し、活用することができます。