クイックスタート
このページでは、Takumi Runner の導入から最初のワークフロー実行までの手順を説明します。
前提条件
Takumi Runner を利用するには、以下の条件を満たしている必要があります。
- Shisho Cloud の組織と、それに所属するユーザーを持っていること
- GitHub Organization の管理者権限を持っていること
- Takumi サブスクリプションが有効であること
手順
1. Runner 機能を有効にする
Shisho Cloud コンソールのサイドバーから Runner を開き、セットアップタブに進みます。セットアップウィザードが表示されますので、最初のステップで Runner 機能を有効にする を完了してください。
2. GitHub App をインストールする
続いて、セットアップウィザードの次のステップで GitHub App をインストール ボタンをクリックしてください。GitHub のインストール画面に遷移します。
- Runner を有効にする対象を選択してください
- All repositories を選ぶとすべてのリポジトリで利用できる
- Only select repositories を選ぶと特定のリポジトリのみ有効になる
- Install をクリックしてインストールを完了してください
GitHub App のインストールには、GitHub Organization の Owner 権限が必要です。権限がない場合は、Organization の管理者にインストールをリクエストしてください。管理者による承認後、Shisho Cloud コンソールの 設定 > サービス連携 > CI/CD 連携 セクション内にある GitHub Actions の連携カードから、既存の GitHub App を連携 を選択してインストールできます。
GitHub App が取得するアクセス権限の詳細は GitHub 連携 > GitHub App の権限 をご覧ください。
3. ワークフローファイルを編集する
既存のワークフローファイル（.github/workflows/*.yml）の runs-on を takumi-runner に変更します。
jobs:
build:
runs-on: takumi-runner
steps:
- uses: actions/checkout@v4
- run: npm install
- run: npm test
4. ワークフローを実行する
コードをプッシュするか、GitHub 上で手動実行してワークフローをトリガーしてください。Takumi Runner が自動的にジョブを受け取り、セキュアな VM 上で実行します。
5. トレースを確認する
ワークフローの実行が完了すると、Shisho Cloud コンソールの Runner > ジョブタブにジョブの実行履歴が表示されます。
ジョブをクリックすると、概要画面でプロセス実行・ネットワーク通信・ファイルアクセスの一覧を確認できます。
タイムラインタブでは、ワークフローの各ステップとそのトレースを確認できます。
