ドキュメントメニュー
マネージドランナー
ワークフローファイル
Latchkey とは?
Latchkey は GitHub Actions 向けの CI/CD 分析と、マネージドな自己修復ランナーを提供します。パイプラインのコスト、失敗の理由を可視化し、一時的な障害を自動的に修復するより高速なインフラでジョブを実行できます。
- 30 日間
- 無料トライアル クレジットカード不要
- $0.0025
- ランナー 1 分あたり GitHub ホストより 58% 安価
- 2,000+
- 無料分数/月 すべてのプランで
- 約 5 分
- 最初のデータまで Quickstart 経由で
要点
- Latchkey = GitHub Actions 向けの CI/CD 分析 + マネージドな自己修復ランナー。どちらの機能も個別に利用できます。
- GitHub App を通じて接続します。個人アカウントでは Latchkey CI を実行できます。Latchkey on GH (GitHub Actions で動く Latchkey のマネージドランナー) には GitHub の 組織 が必要です。
- すべてのプランで 30 日間の無料トライアル、登録時にクレジットカードは不要。ランナーは $0.0025/分から、毎月 2,000 分以上が無料です。

Latchkey は、GitHub Actions 上で開発するチームのために 2 つのことを行います。
runs-on: latchkey-small に向けると、実行中に一時的な障害を検出して修復する、高速かつエフェメラルで隔離されたインフラ上で実行されます。どちらの機能も単独で利用できます。多くのチームは、まず分析から始めて支出を把握し、その後で最も負荷の重いワークフローを Latchkey ランナーへ移行します。
2 つの機能が独立しているのは、それぞれ異なるポイントで接続するためです。分析には GitHub App のインストール以外は何も必要ありません。既存の実行は、どこで実行されていても取り込まれてダッシュボードになります。ランナーは 1 行の runs-on: を変更するだけで 1 ジョブずつ導入でき、移行中も GitHub ホストのラベル (ubuntu-latest など) は並行して動作し続けます。
Latchkey が GitHub に接続する仕組み#
- 01GitHub App をインストールGitHub 組織への 1 回限りのインストール
- 02リポジトリを選択有効にしたリポジトリのみが監視されます
- 03イベントが流入ワークフローの実行が webhook 経由でほぼリアルタイムに届きます
- 04ダッシュボードと AI分析、推奨事項、ランナーが起動します
リポジトリにインストールするエージェントはなく、あなたが決めるまで既存のワークフローへの変更は一切ありません。
「エージェント不要」という点は明記する価値があります。Latchkey は、GitHub App に配信されるワークフローイベントと、.github/workflows/ 配下のワークフロー YAML の読み取りからパイプラインを把握します。リポジトリには何も追加されず、CI はこれまでとまったく同じように動作し続けます。Latchkey はワークフローファイル以外のアプリケーションのソースコードを読み取ることはなく、secret や環境変数の値を読むこともありません。完全な権限モデルは セキュリティと GitHub の権限 にあります。
GitHub ホストのランナー単独との比較#
分析機能は、ジョブが既に実行されている場所ならどこでも動作します。この比較はランナー機能について、つまりジョブが GitHub ホストのランナーから Latchkey ランナーへ移ったときに何が変わるかについてです。
GitHub ホストのランナー単独
- 定価 $0.006/分の 2 vCPU Linux ランナー
- 一時的な障害 (レジストリのタイムアウト、OOM kill、ディスクフル) は、人間が気づいて再実行をクリックするまで赤いままです
- 無料分数は GitHub プランに含まれる分だけです
同じジョブを Latchkey ランナーで
- $0.0025/分から (
latchkey-small)、ランナー 1 分あたり GitHub ホストより 52〜58% 安価 - 自己修復が実行中に一時的な障害を検出して修復するため、人間による再実行なしにビルドがグリーンになります
- すべてのプランで毎月 2,000 分以上が無料、GitHub が含む分よりも多くなります
- ランナー 1 台につき 1 ジョブ、インバウンドアクセスのないプライベートネットワーク上で実行され、ジョブ後に破棄されます
導入は設計上、段階的です。両方のラベルファミリーが並行して動作し続けるため、1 つのジョブを移して 1 週間観察し、そこから拡大できます。最初のジョブを実行する では 1 行の変更を解説し、マネージドランナーの概要 にはサイズと価格の完全な表があります。
試すのにかかる費用#
最初のワークスペースは 30 日間の無料トライアル から始まり、どのプランも開始時にクレジットカードを求めません。新しいワークスペースは自動的に Launch プランで始まり、プランは後から Billing ページの Change plan で変更できます。プランは $5/月からで、すべてのプランには毎月無料のマネージドランナー分数が small 換算で含まれます (Developer は 2,000、Launch は 4,000、Scale は 6,000)。無料トライアルはおひとりにつき 1 回で、後で購読したりプランを変更したりしてもリスタートしません。詳細は プランと無料トライアル をご覧ください。
必要なもの#
- GitHub アカウント。個人アカウントでは Latchkey CI を実行でき、Latchkey on GH には GitHub の 組織 アカウントが必要です。
- 組織の場合は、GitHub App をインストールできるよう、その組織に対する owner または admin 権限。どちらもない場合は、組織の owner にインストールを依頼するか、admin 権限を付与してもらってください。
- ダッシュボード用の タブレット、ノートパソコン、またはデスクトップの画面。幅が 768 px 未満の画面では、サインイン後に、より大きな画面が必要であるという通知が表示されます。メール、Slack、プッシュによる 通知 が、デスクを離れているときもカバーします。
進む道を選ぶ#
Latchkey とは何ですか?
Latchkey は独立して使える 2 つの機能で構成されています。GitHub Actions 向けの CI/CD 分析と、自己修復するマネージドランナーです。分析側はパイプラインのコストと失敗の理由を可視化します。ランナー側はより高速なインフラでジョブを実行し、実行中に一時的な失敗を修復します。どちらか一方だけの利用も可能です。
Latchkey を使うには GitHub の Organization が必要ですか?
Latchkey CI には不要です。個人アカウントでも接続して実行できます: ダッシュボードでリポジトリを選択してから、ワークフローファイルを .latchkey/workflows/ の下にコミットしてプッシュしてください。Latchkey on GH には Organization にインストールされた GitHub App が必要です。個人アカウントで作業している場合は、無料の Organization を作成し、リポジトリを移管してからインストールしてください。
Latchkey を試すのにいくらかかりますか?
すべてのプランに 30 日間の無料トライアルが付き、登録時にクレジットカードは不要です。ランナーは 1 分 $0.0025 から利用でき、各プランに毎月 2,000 分以上の無料ランナー時間が含まれるため、トライアルは通常まったく費用がかかりません。