前提条件
- GitHubアカウント
- 管理したいリポジトリへのアクセス権限
パーソナルアクセストークンの作成
- GitHub.comにアクセスしてアカウントにサインイン
- 右上のプロフィール画像をクリック
- ドロップダウンメニューから「Settings」を選択
- 左サイドバーで「Developer settings」をクリック
- 「Personal access tokens」をクリック
- 「Tokens (classic)」または「Fine-grained tokens」を選択
適切なトークンタイプの選択
パーソナルアクセストークン(クラシック)
- 用途: プライベートリポジトリへの完全アクセスとレガシー統合
- 必要なスコープ:
repo
- プライベートリポジトリの完全制御public_repo
- パブリックリポジトリのみアクセスworkflow
- GitHub Actionワークフローの更新admin:org
- 組織の完全制御(必要な場合)
細粒度パーソナルアクセストークン
- 用途: より安全で細かい権限設定
- リポジトリアクセス: 特定のリポジトリまたはすべてのリポジトリを選択
- 必要な権限:
- リポジトリ権限:
Issues
: 読み取りと書き込みPull requests
: 読み取りと書き込みContents
: 読み取りと書き込みMetadata
: 読み取り専用
- リポジトリ権限:
トークンの生成
クラシックトークンの場合:
- 「Generate new token (classic)」をクリック
- トークンに説明的な名前を付ける(例:「Jinba Flow統合」)
- 有効期限を設定(推奨:90日以下)
- 必要なスコープを選択:
- ✅
repo
(プライベートリポジトリの完全制御) - ✅
workflow
(GitHub Actionワークフローの更新)
- ✅
- 「Generate token」をクリック
- 重要: トークンをすぐにコピーしてください - 後で見ることはできません!
細粒度トークンの場合:
- 「Generate new token」をクリック
- トークンに説明的な名前を付ける
- 有効期限を設定
- 「All repositories」または特定のリポジトリを選択
- 「Repository permissions」で以下を設定:
- Issues: 読み取りと書き込み
- Pull requests: 読み取りと書き込み
- Contents: 読み取りと書き込み
- Metadata: 読み取り専用
- 「Generate token」をクリック
- 重要: トークンをすぐにコピーしてください - 後で見ることはできません!
Jinba Flowでの設定
- Jinba Flowのワークスペース設定に移動
- 「シークレット」セクションに移動
- 利用可能な認証情報のリストで「GitHub」を見つける
- 「Configure」または「Add New」をクリック
- GitHub認証情報を入力:
- Token: パーソナルアクセストークン(クラシックトークンは
ghp_
で始まり、細粒度トークンはgithub_pat_
で始まります) - Username: GitHubユーザー名
- Token: パーソナルアクセストークン(クラシックトークンは
- 「Save」をクリックして認証情報を保存
使用方法
設定後、フローでGitHubを使用して以下ができます:- イシューの一覧表示と作成
- プルリクエストの管理
- リポジトリコンテンツの読み取り
- ファイルの更新とコミットの作成
- ワークフローとアクションの管理
- GitHub APIとの対話