ドキュメントメニュー
はじめに
ダッシュボードと分析
マネージドランナー
キャッシュ
チームと通知
請求とプラン
ヘルプ
Latchkey とは?
Latchkey は GitHub Actions 向けの CI/CD 分析と、マネージドな自己修復ランナーを提供します。パイプラインのコスト、失敗の理由を可視化し、一時的な障害を自動的に修復するより高速なインフラでジョブを実行できます。

Latchkey は、GitHub Actions 上で開発するチームのために 2 つのことを行います。
runs-on: latchkey-small に向けると、実行中に一時的な障害を検出して修復する、高速かつエフェメラルで隔離されたインフラ上で実行されます。どちらの機能も単独で利用できます。多くのチームは、まず分析から始めて支出を把握し、その後で最も負荷の重いワークフローを Latchkey ランナーへ移行します。
2 つの機能が独立しているのは、それぞれ異なるポイントで接続するためです。分析には GitHub App のインストール以外は何も必要ありません。既存の実行は、どこで実行されていても取り込まれてダッシュボードになります。ランナーは 1 行の runs-on: を変更するだけで 1 ジョブずつ導入でき、移行中も GitHub ホストのラベル (ubuntu-latest など) は並行して動作し続けます。
Latchkey が GitHub に接続する仕組み#
リポジトリにインストールするエージェントはなく、あなたが決めるまで既存のワークフローへの変更は一切ありません。
「エージェント不要」という点は明記する価値があります。Latchkey は、GitHub App に配信されるワークフローイベントと、.github/workflows/ 配下のワークフロー YAML の読み取りからパイプラインを把握します。リポジトリには何も追加されず、CI はこれまでとまったく同じように動作し続けます。Latchkey はワークフローファイル以外のアプリケーションのソースコードを読み取ることはなく、secret や環境変数の値を読むこともありません。完全な権限モデルは セキュリティと GitHub の権限 にあります。
GitHub ホストのランナー単独との比較#
分析機能は、ジョブが既に実行されている場所ならどこでも動作します。この比較はランナー機能について、つまりジョブが GitHub ホストのランナーから Latchkey ランナーへ移ったときに何が変わるかについてです。
GitHub ホストのランナー単独
- 定価 $0.008/分の 2 vCPU Linux ランナー
- 一時的な障害 (レジストリのタイムアウト、OOM kill、ディスクフル) は、人間が気づいて再実行をクリックするまで赤いままです
- 無料分数は GitHub プランに含まれる分だけです
同じジョブを Latchkey ランナーで
- $0.0025/分から (
latchkey-small)、GitHub ホストの定価より最大 70% 安価 - 自己修復が実行中に一時的な障害を検出して修復するため、人間による再実行なしにビルドがグリーンになります
- すべてのプランで毎月 2,000 分以上が無料、GitHub が含む分よりも多くなります
- ランナー 1 台につき 1 ジョブ、インバウンドアクセスのないプライベートネットワーク上で実行され、ジョブ後に破棄されます
導入は設計上、段階的です。両方のラベルファミリーが並行して動作し続けるため、1 つのジョブを移して 1 週間観察し、そこから拡大できます。最初のジョブを実行する では 1 行の変更を解説し、マネージドランナーの概要 にはサイズと価格の完全な表があります。
試すのにかかる費用#
すべてのプランは 30 日間の無料トライアル から始まります。Developer と Launch プランは開始時にクレジットカードを求めません。プランは $5/月からで、すべてのプランには毎月無料のマネージドランナー分数が含まれます (Developer は 2,000、Launch は 4,000、Scale は 6,000)。トライアルはワークスペースごとに 1 回だけ実行され、後でプランを変換したり変更したりしてもリスタートしません。詳細は プランと無料トライアル をご覧ください。
必要なもの#
- GitHub の 組織 アカウント (個人アカウントではありません)。個人アカウントのインストールは拒否され自動的に削除されるため、これは推奨事項ではなく必須要件です。
- GitHub App をインストールできるよう、その組織に対する owner または admin 権限。どちらもない場合は、組織の owner にインストールを依頼するか、admin 権限を付与してもらってください。
- ダッシュボード用の デスクトップブラウザ。Latchkey のダッシュボードは現時点でデスクトップ専用で、モバイルやタブレットのブラウザはサインイン後にブロックされます。メール、Slack、プッシュによる 通知 が、デスクを離れているときもカバーします。