GitHub統合を設定して、Jinba Flowワークフローからリポジトリ、イシュー、プルリクエスト、その他のGitHubリソースを管理できるようにします。

前提条件

  • GitHubアカウント
  • 管理したいリポジトリへのアクセス権限

パーソナルアクセストークンの作成

  1. GitHub.comにアクセスしてアカウントにサインイン
  2. 右上のプロフィール画像をクリック
  3. ドロップダウンメニューから「Settings」を選択
  4. 左サイドバーで「Developer settings」をクリック
  5. 「Personal access tokens」をクリック
  6. 「Tokens (classic)」または「Fine-grained tokens」を選択

適切なトークンタイプの選択

パーソナルアクセストークン(クラシック)

  • 用途: プライベートリポジトリへの完全アクセスとレガシー統合
  • 必要なスコープ:
    • repo - プライベートリポジトリの完全制御
    • public_repo - パブリックリポジトリのみアクセス
    • workflow - GitHub Actionワークフローの更新
    • admin:org - 組織の完全制御(必要な場合)

細粒度パーソナルアクセストークン

  • 用途: より安全で細かい権限設定
  • リポジトリアクセス: 特定のリポジトリまたはすべてのリポジトリを選択
  • 必要な権限:
    • リポジトリ権限:
      • Issues: 読み取りと書き込み
      • Pull requests: 読み取りと書き込み
      • Contents: 読み取りと書き込み
      • Metadata: 読み取り専用

トークンの生成

クラシックトークンの場合:

  1. 「Generate new token (classic)」をクリック
  2. トークンに説明的な名前を付ける(例:「Jinba Flow統合」)
  3. 有効期限を設定(推奨:90日以下)
  4. 必要なスコープを選択:
    • repo (プライベートリポジトリの完全制御)
    • workflow (GitHub Actionワークフローの更新)
  5. 「Generate token」をクリック
  6. 重要: トークンをすぐにコピーしてください - 後で見ることはできません!

細粒度トークンの場合:

  1. 「Generate new token」をクリック
  2. トークンに説明的な名前を付ける
  3. 有効期限を設定
  4. 「All repositories」または特定のリポジトリを選択
  5. 「Repository permissions」で以下を設定:
    • Issues: 読み取りと書き込み
    • Pull requests: 読み取りと書き込み
    • Contents: 読み取りと書き込み
    • Metadata: 読み取り専用
  6. 「Generate token」をクリック
  7. 重要: トークンをすぐにコピーしてください - 後で見ることはできません!

Jinba Flowでの設定

  1. Jinba Flowのワークスペース設定に移動
  2. 「シークレット」セクションに移動
  3. 利用可能な認証情報のリストで「GitHub」を見つける
  4. 「Configure」または「Add New」をクリック
  5. GitHub認証情報を入力:
    • Token: パーソナルアクセストークン(クラシックトークンはghp_で始まり、細粒度トークンはgithub_pat_で始まります)
    • Username: GitHubユーザー名
  6. 「Save」をクリックして認証情報を保存

使用方法

設定後、フローでGitHubを使用して以下ができます:
  • イシューの一覧表示と作成
  • プルリクエストの管理
  • リポジトリコンテンツの読み取り
  • ファイルの更新とコミットの作成
  • ワークフローとアクションの管理
  • GitHub APIとの対話