# Latchkey ランナーで最初のジョブを実行する

> 1 行の YAML を変更するだけで GitHub Actions ジョブをマネージドランナーに切り替え、ピックアップされる様子を見て、ダッシュボードで確認します。

Source: https://latchkey.dev/ja/documentation/run-your-first-job

## Summary

- 1 行を変更: `runs-on: latchkey-small` (`[self-hosted, latchkey-small]` の配列形式も同じように機能します)。
- GitHub の実行上のランナー名と、Runners ページのフリートアクティビティで確認します。
- ジョブがキューに留まる場合は、エラーではなくルーティングまたは課金の問題です。トラブルシューティングを参照してください。

**始める前に**
- [ ] Latchkey GitHub App が私の組織にインストールされている
- [ ] リポジトリが Latchkey で監視されている
- [ ] 私のトライアルまたはサブスクリプションがアクティブである

## 1 行の変更

ラベルを記憶から入力する必要はまったくありません: [Runners ページ](/documentation/runners-dashboard) の **Your runners** テーブルの各行には **Copy CI snippet** アクションがあり、各ランナーの詳細ドロワーには、ラベルとコピー可能なスニペットを備えた **Use in CI** カードが含まれています。

どちらのラベル形式も同じようにルーティングされます。あなたの規約が好むほうを使ってください:

## または生成する

## デプロイして確認する

1. **コミットしてワークフローをトリガーする** 変更をプッシュするか、ワークフローを手動でトリガーします。GitHub では、ランナーがピックアップするまでジョブはキュー状態として表示されます: ウォームランナーが利用可能なら数秒、新しいランナーなら約 10 秒 (GitHub ホステッドは通常 30-60 秒)、いずれの場合もキュー待ち時間はゼロです。
2. **どこで実行されたか確認する** GitHub の実行ビューで、ジョブのランナー名により、GitHub ホステッドではなく Latchkey のマシンが引き受けたことが確認できます。すべてのランナーは 1 ジョブの後に破棄されるため、実行ごとに見慣れた名前を期待しないでください: 各ジョブを新しいマシンが引き受けます。これは [エフェメラル設計](/documentation/runners-overview) が意図どおりに機能している証です。
3. **分数を見つける** Latchkey ダッシュボードでは、[Runners ページ](/documentation/runners-dashboard) がその実行をあなたのフリートアクティビティに表示し、その分数が無料ティアに対して計上されます。時間が経つと、同じ数字がさらに 2 か所に現れます: 課金モーダル (無料ティアの進捗、課金対象の分数、これまでの推定コスト) と、GitHub の支出と並べて Latchkey ランナーの支出を追跡する [コスト分析](/documentation/cost-analysis) ページです。詳細は [ランナーの使用量と無料分](/documentation/runner-usage-and-free-minutes) にあります。

## ジョブが "queued" のまま留まる場合

ピックアップされないジョブは、あらゆるルーティング問題の標準的な症状です: リポジトリが監視されていない、マネージドランナーが有効になっていない、ラベルにタイプミスがある、カスタムランナーのイメージがまだビルド中である、または課金によってランナーの起動がブロックされている。これらの場合、GitHub の UI に明示的なエラーは表示されません。[トラブルシューティング: ジョブがキューに留まる](/documentation/troubleshooting) を順にたどって、どれに該当するかを特定してください。

## よくある質問

### GitHub ホステッドのラベルは引き続き機能しますか?

はい。`ubuntu-latest` などは並行して機能し続けます。Latchkey をインストールしてもそれらは何も変わりません。一度に 1 ジョブずつ移行し、残りは好きなだけ手を付けずに残せます。

### 1 つのワークフローで Latchkey と GitHub ホステッドのランナーを混在させられますか?

はい、自由に。`runs-on` はジョブごとに決定されるため、ワークフローは Linux ジョブを `latchkey-*` ラベルで実行しつつ、GPU、Windows、macOS、arm64 ホストを必要とするジョブは GitHub ホステッドや他のランナーに留めることができます。

### runs-on 以外に何か変更する必要はありますか?

ほとんどのワークフローでは不要です。[ランナーイメージ](/documentation/runner-image-software) は GitHub ホステッドランナーに匹敵するか上回るよう設計されており、`actions/setup-*` ステップは同じ toolcache レイアウトから解決されるため、ジョブの残りはそのままです。

### この最初の実行にはいくらかかりますか?

分数はジョブごとに切り上げて 1 分単位でサイズの料金で課金され、すべてのプランに毎月の無料分が含まれます。無料ティアを既に使い切っていない限り、短いテスト実行に費用はかかりません。[ランナーの使用量と無料分](/documentation/runner-usage-and-free-minutes) を参照してください。

> **多数のワークフローを移行する**
> **Migrate Runners** ツール (オーナー/管理者、ダッシュボードのサイドバーと [Runners ページ](/documentation/runners-dashboard) にあります) は、ファイルを 1 つずつ編集する代わりに、リポジトリごとにレビュー準備済みのプルリクエストを 1 つ、1 回のパスで最大 20 の監視対象リポジトリまで開きます。完全なガイドは [GitHub ホステッドランナーからの移行](/documentation/migrate-from-github-hosted) を参照してください。

---

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