# Latchkey とは？

> Latchkey は GitHub Actions 向けの CI/CD 分析と、マネージドな自己修復ランナーを提供します。パイプラインのコスト、失敗の理由を可視化し、一時的な障害を自動的に修復するより高速なインフラでジョブを実行できます。

Source: https://latchkey.dev/ja/documentation/what-is-latchkey

## Summary

- Latchkey = GitHub Actions 向けの CI/CD **分析** + **マネージドな自己修復ランナー**。どちらの機能も個別に利用できます。
- **組織** に対する GitHub App を通じて接続します。個人アカウントは自動的に拒否されます。
- すべてのプランで 30 日間の無料トライアル、登録時にクレジットカードは不要。ランナーは $0.0025/分から、毎月 2,000 分以上が無料です。

Latchkey は、GitHub Actions 上で開発するチームのために 2 つのことを行います。

- **CI/CD 分析** ワークフローの実行がコスト、パフォーマンス、信頼性のダッシュボードになり、さらにプルリクエストとして適用できる AI による最適化の推奨事項が得られます。
- **マネージドな自己修復ランナー** ジョブを `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 の権限](/documentation/security-and-permissions) にあります。

> **組織アカウントのみ**
> Latchkey は GitHub の組織アカウントで動作します。GitHub の個人アカウントはサポートされていません。個人アカウントにアプリがインストールされた場合、そのインストールは拒否され、自動的に削除されます。

## GitHub ホストのランナー単独との比較

分析機能は、ジョブが既に実行されている場所ならどこでも動作します。この比較はランナー機能について、つまりジョブが GitHub ホストのランナーから Latchkey ランナーへ移ったときに何が変わるかについてです。

導入は設計上、段階的です。両方のラベルファミリーが並行して動作し続けるため、1 つのジョブを移して 1 週間観察し、そこから拡大できます。[最初のジョブを実行する](/documentation/run-your-first-job) では 1 行の変更を解説し、[マネージドランナーの概要](/documentation/runners-overview) にはサイズと価格の完全な表があります。

## 試すのにかかる費用

すべてのワークスペースは **30 日間の無料トライアル** から始まり、どのプランも開始時にクレジットカードを求めません。新しいワークスペースは自動的に Launch プランで始まり、プランは後から請求モーダルの **Change Plan** で変更できます。プランは $5/月からで、すべてのプランには毎月無料のマネージドランナー分数が含まれます (Developer は 2,000、Launch は 4,000、Scale は 6,000)。トライアルはワークスペースごとに 1 回だけ実行され、後で購読したりプランを変更したりしてもリスタートしません。詳細は [プランと無料トライアル](/documentation/plans-and-trial) をご覧ください。

## 必要なもの

- GitHub の **組織** アカウント (個人アカウントではありません)。個人アカウントのインストールは拒否され自動的に削除されるため、これは推奨事項ではなく必須要件です。
- GitHub App をインストールできるよう、その組織に対する **owner または admin 権限**。どちらもない場合は、組織の owner にインストールを依頼するか、admin 権限を付与してもらってください。
- ダッシュボード用の **デスクトップブラウザ**。Latchkey のダッシュボードは現時点でデスクトップ専用で、モバイルやタブレットのブラウザはサインイン後にブロックされます。メール、Slack、プッシュによる [通知](/documentation/notifications) が、デスクを離れているときもカバーします。

## 進む道を選ぶ

- **Latchkey を評価中です** GitHub App が読み取り・変更できる範囲を正確に把握することから始め、その後プランとトライアル条件を比較します。
- **セットアップの準備ができています** Quickstart で、サインインから動作するダッシュボードまで約 5 分で到達できます。
- **ランナーを導入します** サイズ、価格、マネージドランナーの違い、そして最初のジョブの前に必要なもの。
- **トラブルシューティング中です** キューで待機するジョブから空のダッシュボードまで、症状ごとの修正方法。

### Latchkey とは何ですか?

Latchkey は独立して使える 2 つの機能で構成されています。GitHub Actions 向けの CI/CD 分析と、自己修復するマネージドランナーです。分析側はパイプラインのコストと失敗の理由を可視化します。ランナー側はより高速なインフラでジョブを実行し、実行中に一時的な失敗を修復します。どちらか一方だけの利用も可能です。

### Latchkey を使うには GitHub の Organization が必要ですか?

はい。Latchkey は Organization にインストールされた GitHub App 経由で接続し、個人アカウントはインストール時に自動的に拒否されます。個人アカウントで作業している場合は、無料の Organization を作成し、リポジトリを移管してからインストールしてください。

### Latchkey を試すのにいくらかかりますか?

すべてのプランに 30 日間の無料トライアルが付き、登録時にクレジットカードは不要です。ランナーは 1 分 $0.0025 から利用でき、各プランに毎月 2,000 分以上の無料ランナー時間が含まれるため、トライアルは通常まったく費用がかかりません。

---

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