ベストプラクティス

Factoryでクラウドテンプレートを最大限活用するための実践的なヒントとワークフロー

クラウドテンプレートを使用すると、一貫性のある本番環境対応の開発環境を数秒で立ち上げることができます。以下は、テンプレートを高速で予測可能、かつチームに優しく保つための実証済みのプラクティスです。

​

1. スマートセットアップスクリプトのプラクティス

プラクティス	重要な理由	実行方法
依存関係順にコマンドを配置	後のコマンドは前のインストールに依存する可能性がある。	パッケージインストールを最初に実行：npm ci && npm run build または pip install -r requirements.txt && pytest -q
正確なパッケージマネージャーを使用	一貫したロックファイルがバージョンドリフトを防ぐ。	再現可能なビルドのために npm ci（npm install ではない）、pnpm -w i、または pip install -r requirements.txt を使用
エラーハンドリングを追加	最初の失敗でビルドを停止し、デバッグ時間を節約する。	適切なエラーハンドリングのためにスクリプトを #!/usr/bin/env bash と set -euo pipefail で開始
スクリプトを早期に実行可能にする	ビルド中の権限エラーを回避する。	chmod +x ./scripts/setup.sh && bash ./scripts/setup.sh を追加するか、bash ./scripts/setup.sh を直接使用
スクリプトをべき等に保つ	セットアップの再実行で問題が発生しないようにする。	pip install --no-deps のようなフラグを使用するか、ファイルを作成する前に既存ファイルをチェック
重い処理を最小限に抑える	長いビルドはテンプレート作成を遅くする。	必要最小限のセットアップに集中し、オプションのツールは後で手動インストールに委ねる

ヒント： セットアップスクリプトをまずローカルでテストしましょう。スクリプトはリポジトリルートで bash で実行され、厳密なエラーハンドリングのために set -euo pipefail を追加できます。

---

​

2. スケールするワークフローパターン

タスクごとに起動

リモートセッションは使い捨てとして扱います。チケットまたはPRごとに1つ作成し、マージ後にアーカイブします。 メリット: 完全な分離と「自分の環境では動く」ズレの解消。

並列環境

複数のブランチをテストする必要がありますか？2つの別々のセッションを起動すれば、プロセスを終了せずにコンテキストを切り替えられます。

---

​

3. チームコラボレーションのヒント

ヒント	詳細
テンプレートを明確に命名	追跡するリポジトリに従ってテンプレートに名前を付ける。例：repo-name というリポジトリで作業するための repo-name
エントリーコマンドを文書化	一般的なタスク（npm run dev、pytest）を含む AGENTS.md ファイルを追加。Droid がこのファイルを自動的に読み取ります

​

5. トラブルシューティング一覧

症状	解決方法
リビルドが遅い	.dockerignore を確認し、重いインストールをイメージにキャッシュし、軽量なベースを使用
Git が認証情報を要求	統合 → リポジトリでリポジトリ統合が有効になっていることを確認
ディスク容量不足エラー	パッケージキャッシュをプルーン（npm cache clean --force）するかテンプレートを再ビルド

これらのプラクティスに従うことで、クラウドテンプレートを高速、安全、協調的に保つことができ、マシンの設定ではなくコードの出荷に集中できます。