ドキュメントメニュー
はじめに
ダッシュボードと分析
マネージドランナー
キャッシュ
チームと通知
請求とプラン
ヘルプ
よくある質問
アカウント、ランナー、セルフヒーリング、データ、請求に関する手早い回答。
トピック別にまとめた手早い回答と、より詳しい情報がある完全なページへのリンクです。回答を探すのではなく特定の問題をデバッグしている場合は、代わりに症状リストから始めてください:
アカウントとセットアップ#
個人のGitHubアカウントでLatchkeyを使えますか?
いいえ。LatchkeyはGitHubの組織アカウントでのみ動作します。個人アカウントのインストールは拒否され、自動的に削除されます。GitHubの組織の作成は無料で、1分で済みます。
試すのにクレジットカードは必要ですか?
いいえ。DeveloperとLaunchはカードなしで30日間のトライアルを開始します。Scaleはトライアルを適用したうえでチェックアウトを通過します。
誰がworkspaceのオーナーになりますか?
GitHub Appをインストールした人です。workspaceごとにオーナーは正確に1人であり、オーナー権限は後でTransfer Ownershipによって別のメンバーに引き継げます。チームと役割を参照してください。
複数のGitHub組織でLatchkeyを使えますか?
はい。各インストールは、独自のプラン、チーム、リポジトリ、データを持つ独自のworkspaceを取得し、ダッシュボードのサイドバーにあるworkspace切り替えでそれらを移動できます。
複数のworkspaceに所属できますか?
はい。複数のworkspaceに所属している場合、ダッシュボードのサイドバーにあるworkspace切り替えでそれらを移動できます。各workspaceは独自のプラン、チーム、データを持ちます。
オンボーディング中にリポジトリを選択する必要がありますか?
いいえ。リポジトリの選択をスキップし、後でダッシュボードのモニタリングモーダルからリポジトリを追加できます。リポジトリの管理を参照してください。
スマートフォンでダッシュボードを使えますか?
まだできません: ダッシュボードはデスクトップ専用であり、モバイルブラウザはブロック通知を表示します。メール、Slack、プッシュ通知が、デスクを離れているときもあなたをカバーします。
ランナー#
Latchkeyを使うためにワークフローを変更する必要がありますか?
変更するのは runs-on: の行だけで、移動を選んだジョブに対してのみです。それ以外はそのままで、GitHubホストランナーも並行して動作し続けます。
どのオペレーティングシステムが利用できますか?
x86_64上のUbuntu 24.04 LTSです。現時点でWindows、macOS、arm64、GPUランナーはありません。それらのジョブは他のランナーに残し、1つのワークフロー内で自由に組み合わせてください。
Dockerは動作しますか?
はい、ネイティブに動作します: BuildKit、buildx、composeを備えたDocker CEがプリインストールされており、マルチアーキテクチャのイメージビルド用のQEMUも含まれます。
ジョブはどれくらい速く開始しますか?
ウォームランナーが利用可能なときは数秒です(LaunchとScaleはウォームプール容量を含みます)。コールドスタートは約10秒で、GitHubホストの一般的な30-60秒に対してです。
ジョブはどれくらいの時間実行できますか?
ランナーごとに最大4時間です。ジョブがまだ実行中でもマシンは4時間で終了します。完全な制限は制限と同時実行にあります。
同時に何個のジョブを実行できますか?
デフォルトでworkspaceごとに20の稼働中ランナーです。アイドル状態のウォームランナーはカウントされず、より高い上限も利用可能です。上限を超えるジョブは空きを待ちます。
ジョブ間でランナーにファイルを保持できますか?
いいえ。ランナーは使い捨てです: マシンごとに1ジョブで、その後破棄されるため、ローカルディスクに書き込まれたものはジョブ終了時に消えます。永続化にはartifactsやcachesを使用してください。
ランナーはどこで実行されますか?
AWS us-east-1の、Ubuntu 24.04 LTS x86_64マシン上です。制限と同時実行を参照してください。
カスタムランナーはどのように課金されますか?
カスタム設定のランナーは、その形状に関わらずxlargeレート($0.0200/min)で課金されます。カスタムランナーを参照してください。
私のAIコーディングエージェントはCIの失敗を確認できますか?
はい: APIキーでLatchkey MCPサーバーに接続すれば、失敗のトリアージ、失敗バンドルの取得、エディタからの修正の推進ができます。AIエージェントを接続するを参照してください。
セルフヒーリング#
セルフヒーリングは私のコードを変更しますか?
いいえ。実行中の修正は、ジョブ後に破棄されるエフェメラルなランナーにのみ影響します。永続的な修正はレビュー用のプルリクエストとしてのみ提案され、自動でマージされるものは何もありません。
セルフヒーリングをオフにできますか?
はい: Settingsのセルフヒーリングでworkspace全体(オーナーおよび管理者)、Runnersページでランナー設定ごとに設定できます。現時点でリポジトリごとのトグルはありません。
実際の失敗を隠してしまいますか?
いいえ。既知の一時的なクラス(ネットワーク、メモリ、ディスク、不足しているツール、設定のドリフト)にのみ介入します。本物のコードとテストの失敗は通常どおり失敗し、すべての修復はRecent Healsフィードに記録されます。
セルフヒーリングが何をしたかを確認するには?
すべての介入はRunnersページのRecent Healsフィードに、そのカテゴリ、判定、および取られたアクションがわかりやすい言葉で表示されます。修復された実行はPipeline Performanceの実行テーブルでもフラグ付けされ、その修復レポートへディープリンクします。
リトライで請求が膨らむことはありますか?
いいえ。リトライはステップごとに上限があり、AI診断ステージには約3分のハードな時間予算があり、ランナー自体には4時間の寿命上限があります。詳細はセルフヒーリングにあります。
データと請求#
LatchkeyはGitHubから何を読み取りますか?
ワークフローの実行とジョブのメタデータ、およびワークフローのYAMLファイルです。アプリケーションのソースコードは読み取らず、シークレットや環境変数の値も決して読み取りません。詳細はセキュリティとGitHubの権限にあります。
リポジトリを無効化したりキャンセルしたりすると、データはどうなりますか?
リポジトリを無効化すると取り込みが停止し、そのデータはアーカイブされます。キャンセルするとアクセスはブロックされますが、データは保持されるため再サブスクライブで復元されます。workspaceを削除すると永久に削除されます。
ランナーの使用状況はどのように課金されますか?
ジョブごとに切り上げて、サイズごとのレートで、分単位で、プランの無料分の後に課金されます。ランナーの使用状況と無料分を参照してください。
無料分はいつリセットされますか?
各暦月の1日です。無料枠内の分は費用がかかりません。それを超える使用分のみが分単位のレートで課金されます。
ランナーの使用に支出上限はありますか?
サブスクリプションが登録されている場合、ハードな上限はありません: ジョブは実行され続け、超過分は請求書に計測され、含まれる分の80%と再び100%で警告が出ます。カードなしトライアルでは、無料分を使い切ると、サブスクライブするまで新しいマネージドランナーのジョブがブロックされます。
支払いが失敗するとどうなりますか?
サブスクリプションはPast Dueになります: 支払い方法がStripeポータルで修正されるまで、ダッシュボードとAPIへのアクセスがブロックされ、ランナーの起動が停止します。データは影響を受けません。サブスクリプションの管理を参照してください。
請求書はどこで見つけられますか?
Stripeのカスタマーポータルです: 請求モーダルを開き、Manage Billingをクリックします。請求書(PDF付き)、支払い方法、サブスクリプションの詳細はすべてそこで管理されます。
後でプランを変更できますか?
はい: 請求モーダルのChange Planでその場でアップグレードまたはダウングレードできます。監視中のリポジトリ数を下回るダウングレードでは、どのリポジトリを監視し続けるか選ぶよう求められ、Developerへのダウングレードにはworkspaceのメンバーが1人だけである必要があります。プラン変更でトライアルが再開されることはありません。
チームとworkspace#
プランには何シート含まれますか?
Launchは1シート、Scaleは5シートを含みます。追加シートは1つあたり$5/monthです。Developerプランは個人利用向けのため、そこではチーム招待は利用できません。チームと役割を参照してください。
招待でOwner役割を付与できますか?
いいえ。招待はAdminまたはMemberを付与します。workspaceを引き渡すには、オーナーがTransfer Ownershipを使用します。
招待はどれくらい有効ですか?
1日から30日の間(デフォルトは7日)の有効期限と、最大使用回数を選択します。招待はPending Invitesタブからいつでも取り消せます。