最もスムーズなクラウドテンプレートでも問題が発生することがあります。このガイドでは、最も一般的なクラウドテンプレートの問題に対する最も迅速な修正方法を説明します。Documentation Index
Fetch the complete documentation index at: https://factory-docs-auto-sync-jp-docs.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
クイックリファレンス
| カテゴリ | 典型的な症状 |
|---|---|
| ワークスペース作成 | 「プロビジョニング」が永続、クローンエラー、セットアップスクリプト失敗 |
| 接続 | セッションからアタッチできない、ペアリングスピナーが停止しない、「マシン利用不可」 |
| パフォーマンス | リビルドが遅い、ターミナルの高レイテンシ、エディターの動作が重い |
| Devcontainer | ビルドエラー、「command not found」、ポートにアクセスできない |
| 一般的な使用 | Gitが認証情報を要求、ディスク容量不足、アクセス拒否 |
1. ワークスペース作成の問題
リポジトリのクローンに失敗
リポジトリのクローンに失敗
診断
- Gitの終了コード付きで*“clone failed”*エラートーストが表示される
- プライベートリポジトリですか？OAuthスコープが不足していませんか？
- リポジトリが有効化され、IntegrationsでConnectedと表示されていることを確認します
- 求められた場合はOAuthトークンを更新します
2. 接続の問題
マシンセレクターを確認
セッションでCPUアイコンをクリックし、Cloud Machineが選択されていることを確認します。
Local Machineと表示される場合は、Cloud Machineに切り替えてテンプレートを選択します。
3. パフォーマンスと速度
| 症状 | 修正方法 |
|---|---|
| リビルドが5分以上かかる | .dockerignore、node_modules、*.pyc、ビルド出力に対して.dockerignoreを追加する• より軽量なベースイメージを使用（例：alpine） |
| ターミナルのレイテンシ | 重いJSを使用している未使用のブラウザタブを閉じる• ローカル帯域幅を確認（5 Mbps以上推奨）• リアルタイムスペルチェック拡張機能を一時停止 |
| エディターの遅延 | 必要でない限り開発ツール（nodemon、webpack --watch）のファイルウォッチャーを無効化• 自動保存はコラボレーション時のみ使用 |
4. 一般的な使用上のトラブル
| 問題 | 解決方法 |
|---|---|
| Gitが認証情報を要求する | リポジトリ統合が接続されていることを確認してください。クラウドテンプレートはHTTPSトークンを自動的に注入します。 |
| ディスククォータ超過 | パッケージキャッシュ（npm cache clean --force、pip cache purge）をクリア、大きなビルドアーティファクトを削除、またはテンプレートをリビルド。 |
| ファイル保存でアクセス拒否 | ファイルがリポジトリテンプレート外にあります。/workspaces/<repo>/内に保存してください。 |
| グローバルパッケージをインストールできない | npm install -gまたはpip install --userを使用。まだブロックされる場合は、postCreateCommandにコマンドを追加。 |
| リビルド後に履歴が失われる | /workspaces外のものはリビルド中にクリアされます。重要なスクリプトをコミットするか、リポジトリ内に保存してください。 |
さらなるヘルプが必要ですか？
- ベストプラクティス – Cloud Template Best Practices guideでパフォーマンスを最適化
- サポート – テンプレートIDとエラーメッセージと共にFactoryサポートチャンネルまでご連絡ください
クイックリビルドで問題の80%が解決します。迷ったときは躊躇せずリビルドをクリックしてください。