# マネージドランナーの概要

> Latchkey ランナーとは何か、4 つのサイズとその価格、GitHub ホステッドランナーとの違い、そして最初のジョブの前に必要なものについて説明します。

Source: https://latchkey.dev/ja/documentation/runners-overview

## Summary

- 4 つのサイズ: `latchkey-small` (2 vCPU、$0.0025/min) から `latchkey-xlarge` (16 vCPU、$0.0200/min) まで、Ubuntu 24.04 x64。
- ランナーごとに 1 ジョブで、その後破棄されます。ウォームピックアップは数秒 (Launch 以上)、コールドスタートは約 10 秒です。
- すべてのプランに月あたり 2,000-6,000 分の無料ランナー時間が含まれます。

Latchkey のマネージドランナーは、GitHub Actions のジョブを実行するエフェメラルな仮想マシンです。各ランナーは正確に 1 つのジョブを実行し、その後破棄されるため、すべてのジョブはクリーンで隔離されたマシンから始まります。すべてのランナーには [自己修復](/documentation/self-healing) も組み込まれています。

## サイズと価格

| ラベル | vCPU | メモリ | ディスク | 価格 |
| --- | --- | --- | --- | --- |
| `latchkey-small` | 2 | 8 GB | 100 GB | $0.0025/min |
| `latchkey-medium` | 4 | 16 GB | 100 GB | $0.0050/min |
| `latchkey-large` | 8 | 32 GB | 100 GB | $0.0100/min |
| `latchkey-xlarge` | 16 | 64 GB | 200 GB | $0.0200/min |

すべてのランナーは **x86_64 上の Ubuntu 24.04 LTS** (AWS m6a クラスのハードウェア) で、[包括的なプリインストール済みツールチェーン](/documentation/runner-image-software) を備えています。課金は 1 分単位で、ジョブごとに切り上げられ、すべてのプランに毎月の無料分が含まれます (Developer で 2,000、Launch で 4,000、Scale で 6,000。つまり中位ティアでは月 4,000 で、GitHub の 3,000 に対してです)。[ランナーの使用量と無料分](/documentation/runner-usage-and-free-minutes) を参照してください。

## どのサイズを選ぶべきか?

以下の内容は規則ではなく指針として扱ってください。あなた自身のジョブの実行時間こそが本当のベンチマークです。ほとんどのチームに役立つパターンは、すべてを `latchkey-small` にデフォルト設定し、より多くを必要とすると証明された特定のジョブだけを昇格させることです。

| サイズ | 最初によく合う用途 | 理由 |
| --- | --- | --- |
| `latchkey-small` | Lint、ユニットテスト、スクリプト、小規模ビルド | ほとんどの CI ジョブは I/O バウンドまたはシングルコアバウンドで、2 vCPU / 8 GB が最低料金でそれらをカバーします |
| `latchkey-medium` | 一般的なアプリのテストスイート、Docker イメージビルド | small の 2 倍の CPU とメモリで、並列テストランナーとマルチステージイメージビルドに対応します |
| `latchkey-large` | コンパイル負荷の高いビルド、並列統合スイート | 8 vCPU / 32 GB はコア数に応じてスケールする作業に適しています: 大規模な TypeScript、Rust、Java、C++ のビルド |
| `latchkey-xlarge` | モノレポビルド、メモリを大量に消費するエンドツーエンドスイート | 16 vCPU / 64 GB に加えて 200 GB のディスクで、そうでなければ分割が必要な最も重いジョブに対応します |

このラインナップの 2 つの特性が、適切なサイジングを考えやすくします。1 段階上がるごとに vCPU、メモリ、1 分あたりの料金が倍になるため、あるジョブを 1 サイズ上げるのは、そのジョブの所要時間を少なくとも半分にできるときに割に合います: 同じかそれ以下のコストで、より速いフィードバックが得られます。そして `runs-on` はワークフローごとではなくジョブごとに選択されるため、`latchkey-large` 上の 1 つの重いビルドジョブが、あなたの lint ジョブを `latchkey-small` から追い出すことは決してありません。

> ****
> どのプリセット比率も合わない場合 (たとえば控えめな CPU に対して多くのメモリ、あるいはプリセットが提供する以上のディスク) は、[カスタムランナー構成](/documentation/custom-runners) を作成してください。カスタムランナーは xlarge の料金で課金される点に注意してください。

## チームが乗り換える理由

- **価格:** GitHub ホステッドよりランナー 1 分あたり最大 60% 安く、GitHub が含めるよりも多くの無料分があります (中位ティアで 3,000 に対して 4,000)。
- **速度:** コールドスタートが約 10 秒 (GitHub ホステッドは通常 30-60 秒) でキュー待ち時間ゼロ、ウォームピックアップは数秒で完了します。
- **自己修復:** 一時的な障害 (レジストリのタイムアウト、OOM kill、ディスク満杯、ツール欠如) が実行中に検出され修正されます。
- **隔離:** ランナーごとに 1 ジョブで、インバウンドアクセスのないプライベートネットワーク上にあり、ジョブ後に破棄されます。
- **管理すべきインフラがゼロ:** ビルドすべきランナーイメージも、調整すべきオートスケーリングも、パッチを当てるべきランナーエージェントもありません。

## 設計によりエフェメラル

すべてのランナーは 1 つのジョブのために作成され、そのジョブが終了した瞬間に破棄されます。ジョブ間で何も持続しません: 残ったプロセスも、古いキャッシュも、以前のジョブがディスクに書き込んだファイルもありません。そのクリーンマシンの保証こそが、実行を再現可能にするものです。ジョブが今日は成功し明日は失敗する場合、その違いはあなたの変更や依存関係にあり、長命なマシンに蓄積された状態にあるのではありません。

同じ特性がセキュリティのストーリーも支えます。ランナーは単回使用の認証情報でジャストインタイムに登録され、インバウンドアクセスのないプライベートネットワーク上で動作し、正確に 1 つのジョブを受け取って破棄されます: あるジョブが別のジョブを観測する余地はなく、パッチや堅牢化を要する長命なマシンもありません。全体像は [セキュリティと権限](/documentation/security-and-permissions) を参照してください。

これを念頭に計画してください: ランナーのローカルディスクに書き込まれたものは、ジョブが終わると消えます。GitHub ホステッドランナーとまったく同じように、ビルド出力はアーティファクトとして永続化し、インストールはキャッシュで高速化してください。

## 前提条件

- Latchkey の [GitHub App がインストールされている](/documentation/install-the-github-app) こと (組織に対して)。
- リポジトリが Latchkey で [監視されている](/documentation/managing-repositories) こと。
- マネージドランナーがワークスペースで有効になっていること (アプリのインストール時に自動的にセットアップされます。ダッシュボードの **Runners** ページで準備状況と構成を確認できます)。
- サブスクリプションまたはトライアルがアクティブであること。期限切れのトライアルや失効したサブスクリプションではランナーの起動がブロックされます。[ランナーの使用量と無料分](/documentation/runner-usage-and-free-minutes) を参照してください。

## プロビジョニングの仕組み

GitHub が `latchkey-*` ラベルの付いたジョブをキューに入れると、Latchkey はそれを既にウォームなランナーに渡すか、新しいランナーを起動します:

いずれの場合も、ランナーはジョブの後に破棄されます。ライフサイクル全体、ウォームプール、同時実行数、そしてジョブが待たされる理由については、[プロビジョニングの仕組み](/documentation/runner-provisioning) にまとまっています。4 つのプリセットに加えて、独自のラベルを持つ [カスタムランナー構成](/documentation/custom-runners) を作成でき、ダッシュボードの [Runners ページ](/documentation/runners-dashboard) がそのすべてを管理する場所です。

## うまくいく移行戦略

一括移行は必要なく、避けることをお勧めします。GitHub ホステッドのラベルは `latchkey-*` ラベルと並行して機能し続けるため、一度に 1 ジョブずつ移動し、あなた自身のワークロードで両者を直接比較できます。

不安定または遅いワークフローが最良のパイロットになるのは、安い分、速いピックアップ、[自己修復](/documentation/self-healing) がすべて、既に痛みのある場所に現れるからです。1 週間後、[Runners ページ](/documentation/runners-dashboard) がコスト、節約、修復アクティビティを判断材料として提供します。確信が持てたら、[Runners ページ](/documentation/runners-dashboard) の **Migrate Runners** ツール (オーナーと管理者) が、一度に最大 20 のリポジトリを切り替えるマージ準備済みのプルリクエストを開きます。完全なウォークスルーは [GitHub ホステッドランナーからの移行](/documentation/migrate-from-github-hosted) を参照してください。GPU、Windows、macOS、arm64 ホストを必要とするジョブは GitHub ホステッドや他のランナーに留まり、単一のワークフロー内で混在させても問題ありません。

プロバイダー間で迷っていますか? Learn ライブラリには、GitHub ホステッド、Blacksmith、BuildJet などをカバーする独立した [ランナー比較ハブ](/learn/compare-runners) があり、さらに切り替える前にあなた自身の数字で支出を見積もる [GitHub Actions コスト計算機](/learn/ci-cost/github-actions-cost-calculator) もあります。

### Latchkey ランナーにはどのサイズがありますか?

4 サイズあり、すべて Ubuntu 24.04 x64 です。2 vCPU で 1 分 $0.0025 の `latchkey-small` から、16 vCPU で 1 分 $0.0200 の `latchkey-xlarge` までです。すべてのプランに、プランに応じて月 2,000 〜 6,000 分の無料ランナー時間が含まれます。

### Latchkey ランナーはどれくらい速く起動しますか?

Launch 以上のプランではウォームピックアップが数秒、コールドスタートは約 10 秒です。いずれの場合もランナーは新しいマシンで、1 ジョブにつき 1 台、実行後に破棄されます。

### Latchkey ランナーは GitHub ホスト型と何が違いますか?

重要な違いは 2 つです。公表料金が 2 vCPU で 1 分 $0.0025 であり、同等の GitHub ホスト型の $0.006 より安いこと。そしてマシン上の自己修復エージェントが、レジストリのタイムアウトや OOM といった一時的な失敗をジョブを失敗させずに実行中に修復することです。

---

Latchkey runs CI/CD that repairs its own failures. Agent entry points: https://latchkey.dev/agent.txt, https://latchkey.dev/openapi.json, https://latchkey.dev/llms.txt