メインコンテンツへスキップ
最もスムーズなクラウドテンプレートでも問題が発生することがあります。このガイドでは、最も一般的なクラウドテンプレートの問題に対する最も迅速な修正方法を説明します。

​
クイックリファレンス

カテゴリ典型的な症状
ワークスペース作成「プロビジョニング」が永続、クローンエラー、セットアップスクリプト失敗
接続セッションからアタッチできない、ペアリングスピナーが停止しない、「マシン利用不可」
パフォーマンスリビルドが遅い、ターミナルの高レイテンシ、エディターの動作が重い
Devcontainerビルドエラー、「command not found」、ポートにアクセスできない
一般的な使用Gitが認証情報を要求、ディスク容量不足、アクセス拒否

​
1. ワークスペース作成の問題

Diagnose
  • Error toast shows “clone failed” with a Git exit code
  • Private repo? Missing OAuth scopes?
Resolve
  1. Verify the repo is enabled and displays Connected in Integrations
  2. Refresh your OAuth token if prompted

​
2. 接続の問題

1

Check Machine Selector

In your session, click the CPU icon → ensure Cloud Machine is selected.
If it shows Local Machine, switch to Cloud Machine and pick the template.
2

Browser & Network

  • Use Chrome or Edge (other browsers may block WebSocket upgrades).
  • Disable VPN/proxy to rule out WebSocket filtering.
  • Reload the session tab (⌘R / Ctrl-R).

​
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%が解決します。迷ったときは躊躇せずリビルドをクリックしてください。