Quickstart: ゼロからダッシュボードまで

GitHub でサインイン

latchkey.dev/sign-in にアクセスし、GitHub アカウントでサインインします。監視したい組織にアクセスできる GitHub アカウントを使用してください。ステップ 3 のアプリのインストールはこのアイデンティティで行われ、アプリをインストールした人がワークスペースの owner になります。途中で中断された場合は、もう一度サインインするだけで、オンボーディングは中断したところから再開します。

プランを選択

新規アカウントはプラン選択画面に移動します。すべてのプランは 30 日間の無料トライアルから始まります。Developer と Launch はクレジットカードなしですぐに始まります。Scale は先にチェックアウトを経て、そこでトライアルが適用されます。この段階での実際的な違いは、監視できるリポジトリ数です。Developer は 1、Launch は最大 10、Scale は最大 40 です。選択を考えすぎないでください。後でプランを変更でき、その際にトライアルがリスタートすることはありません。完全な比較は プランと無料トライアル にあります。

GitHub App をインストール

オンボーディングのステップ 1「GitHub を接続」で、Latchkey アプリをインストールするために GitHub へ移動します。Latchkey を承認 をクリックすると、GitHub がインストールページを開きます。GitHub がインストール先を尋ねたら、組織 を選択してください (個人アカウントではありません)。組織に対する owner または admin 権限が必要です。どちらもない場合は、組織の owner にアプリのインストールを依頼するか、admin 権限を付与してもらってください。アプリがアクセスできるものとできないものについては GitHub App をインストールする で説明しています。

監視するリポジトリを選択

オンボーディングのステップ 2 では、検索と可視性フィルターとともに組織のリポジトリが一覧表示されます。Latchkey に監視させたいものを選択してください。カウンターにはプランで許可される数が表示されます (Developer は 1、Launch は 10、Scale は 40)。選ぶ際に知っておくとよいことが 2 つあります。マネージドランナーは監視対象のリポジトリのみを扱うため、latchkey-* ラベルを向ける予定のリポジトリは含めてください。また、このステップを完全にスキップし、後でダッシュボードからリポジトリを追加することもできます。プラン上限内で選ぶ際のガイダンスは リポジトリの管理 にあります。

完了してダッシュボードを開く

ステップ 3 でセットアップが確認され、ダッシュボードに移動します。初回訪問時には、短いガイド付きツアーが各エリアを案内します。いつでもスキップできます。有効にした各リポジトリについて、Latchkey は直近 30 日間の完了済みワークフロー実行をバックフィルするため、ほとんどのチームは数分でデータを確認できます。バックフィルの実行中は進捗バナーが表示され、完了すると AI 分析が自動的に開始します。ページが空に見える場合は、まず上部のフィルターバーを確認してください。分析ページは選択したリポジトリのデータを表示し、何も選択されていない場合は 1 つ選ぶよう促します。

任意: Latchkey ランナーでジョブを実行

任意のワークフローの 1 行を変更して、マネージドな自己修復ランナーを試します。push すると、ランナーがピックアップするまでジョブは GitHub 上でキュー待機と表示されます。ウォームなランナーがある場合は数秒、新しいランナーがコールドスタートする場合は約 10 秒です。ジョブがどこで実行されたかを確認する方法を含む完全な手順は 最初のジョブを実行する にあります。

jobs:
  build:
    runs-on: latchkey-small
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test

任意: チームを招待

Launch と Scale では、ダッシュボードのサイドバーで Team を開き、メールまたは共有リンクでチームメイトを招待します (Developer プランは個人利用向けのため、そこでは招待は利用できません)。招待では Admin または Member ロールが付与されます。チームとロール をご覧ください。