一般的なデプロイの問題のトラブルシューティング

デプロイが遅いか、失敗する

デプロイは、特にプロジェクトまたはデプロイサーバーに多くのディレクトリとファイルが含まれている場合、リソースを大量に消費する操作になる可能性があります。設定ダイアログ (Ctrl+Alt+S) で、ビルド、実行、デプロイに移動し、デプロイを高速化できる次の構成オプションを調べます。

• 不要なディレクトリをデプロイから除外します（たとえば、images）。これはデプロイ: 除外されたパスタブページから行うことができます。

• オプションページで、最新のファイルを上書きするをクリアして、アップロードする必要がないファイルのアップロードをスキップします。

• サーバーによっては、アドバンスト FTP 設定でのアクティブ転送モードとパッシブ転送モードの切り替えが役立ちます。これは、サーバーのデプロイ: 接続タブでパッシブモードを切り替えることで実行できます。

ファイル転送が応答しなくなる

これは、WebStorm が IPv6(英語) を介して IPv4(英語) ホストを解決しようとした場合に発生する可能性があります。デフォルトでは、WebStorm は受信 IPv4 接続のみをリッスンします。IPv6 が無効になっていることを確認するには、WebStorm JVM オプションを確認します。

ダウンロード / アップロードアクションは利用できません

マッピングがないため、ダウンロード / アップロードアクションを使用できない場合があります。ダウンロードするファイルまたはフォルダーがどのマッピングでも構成されていない場合、WebStorm はそれをダウンロードしません。マッピングは、3. プロジェクトフォルダーをサーバーフォルダーと URL パスにマップするに従って構成できます。

一部のアクションでは、設定ダイアログのデプロイページでデフォルトのデプロイサーバーを選択する必要があります。

一部のフォルダーはデプロイされません

デプロイされていないフォルダーの一般的な原因は、明示的に除外されている場合です。これを解決するには、リモートホストツールウィンドウで指定のフォルダーを右クリックし、コンテキストメニューからパスを除外対象から除去を選択します。これが完了すると、フォルダーがデプロイされます。

これは、設定ダイアログ (Ctrl+Alt+S) のデプロイページからも設定できます。サーバーの除外対象パスタブを開き、除外されたパスを削除します。ソースフォルダーとターゲットフォルダーの両方をチェックする必要があることに注意してください。オプションページの項目を名前で除外で、フォルダーを名前で除外することもできます。

プロジェクト間でのデプロイ構成の共有

デプロイサーバーは IDE レベルで構成されています。これらのサーバーはすべてのプロジェクトで使用でき、それらの間で共有できます。

プロジェクト間で名前と接続の詳細（デプロイ: 接続タブタブで指定）のみが共有されることに注意してください。マッピングと除外パスはプロジェクト固有のものであり、別々に設定する必要があります。このアプローチを使用すると、接続の詳細を一度入力するだけで、プロジェクトごとにマッピングと除外パスを設定し、接続の詳細を共有することができます。これは、プロジェクトが同じデプロイサーバーを共有し、同じ接続設定を使用する場合に便利です。プロジェクト間で接続設定が異なる場合は、プロジェクトごとに個別に設定する必要があります。

必要に応じて、デプロイ: 接続タブのこのプロジェクトでのみ表示するチェックボックスを選択することにより、単一のプロジェクトでサーバーが表示されるように設定できます。

IDE 設定ではマッピングを設定できません

デフォルトの新しいプロジェクト設定は、新しいプロジェクトのデフォルト設定を構成するために使用され、現在開いているプロジェクトには影響しません。現在のプロジェクトの設定を構成するには、設定ダイアログ Ctrl+Alt+S を使用します。

同じフォルダー内のサブフォルダーは、異なるデプロイ設定を持つことができますか？ ローカルフォルダーを複数の場所にデプロイできますか？

フォルダーをアップロードしてマッピングを構成するときは、次の点に注意してください。

• 特定のフォルダーのマッピングをデプロイサーバー上の異なるパスに指定できます。これは、サーバーのデプロイ: マッピングタブで設定できます。

• 特定のフォルダーとファイルをアップロード / ダウンロードから除外することができます。これは、サーバーのデプロイ: 除外されたパスタブで設定できます。

• 同じフォルダー（または複数のサブフォルダー）を異なるサイトに一度にアップロードすることはできません。個別のデプロイ構成を作成し、各サイトに 1 つずつアップロードする必要があります。

これが必要な場合は、デプロイ先と同期 ... コマンドを使用して、アップロードごとに使用可能なデプロイサーバーから選択できます。

マイサーバーに配置して同期メニュー項目にキーボードショートカットを割り当てることができません

キーボードショートカットを <サーバー名> にデプロイされたものと同期コマンドに直接割り当てることはできません。汎用のデプロイ先と同期 ... コマンドにのみ割り当てることができます。これにより、サーバーのリストが表示されるポップアップメニューが表示されます。詳細については、キーボードショートカットを設定するを参照してください。

特定のデプロイサーバーにキーボードショートカットを割り当てる場合は、マクロを記録して代わりにショートカットを割り当てることができます。

アップロードが行われる前に、ファイル上でスクリプトや実行ファイルを実行できますか？

CSS の縮小、イメージの最適化などは、アップロードが行われる前に実行する必要のあるアクションです。これを行うための最良のアプローチは、アップロードの開始時ではなく、WebStorm の File Watchers を使用して、ファイルが変更されたときに実行することです。デプロイサーバーにアップロードするときが来たら、代わりに処理済みファイルをアップロードします。

これが機能するには、オプションページで外部変更をスキップするチェックボックスをオフにする必要があることに注意してください。

ファイルが自動的にアップロードされないことがある

デフォルトでは、WebStorm はいくつかの外部プロセス（VCS、transpiler など）によってファイルが変更された場合にそれらのファイルをアップロードします。ファイルがアップロードされていない場合は、オプションページの変更されたファイルのデフォルトサーバーへの自動アップロードが常時に設定され、外部変更をスキップするチェックボックスがオフになっていることを確認してください。

デプロイ前またはデプロイ後のアクションを実行できますか？

実行 / デバッグ構成を使用することが可能です。偽の実行 / デバッグ構成、または最後のステップである実行 / デバッグ構成を作成し、起動前に必要なステップを追加できます。

FTP の問題: 無効な子孫ファイル名 "http:"

デプロイサーバーが構成されている場合、またはプロジェクト設定で接続のテストボタンを使用している場合、無効な子孫ファイル名 "http:" エラーが表示されます。名前にコロン : が含まれるすべてのファイル名は無効とみなされます。

これは、プロジェクト内に http: という名前を含むファイルが存在する場合に発生する可能性があります。WebStorm が FTP 接続に使用するライブラリ（Apache Commons VFS）は、そのようなファイルを含むフォルダーの内容を読み取ることができないため、操作が失敗します。唯一の解決策は、http: という名前を含むファイルをプロジェクトから削除することです。

WebStorm はサーバーに接続しているようですが、ファイルを一覧表示したり、アップロードを実行したりできません

これは、デプロイサーバーがいわゆるパッシブ FTP 接続を必要とするためです。このモードを設定するには、選択したサーバーのデプロイ: 接続タブのパッシブモードチェックボックスを選択します。

Git checkout を使用してブランチを変更するときのファイルのデプロイ

Git checkout を使用してブランチを切り替えるときにファイルをデプロイするには、いくつかの方法があります。

• 1 つの方法は、ファイルと外部の変更を常にアップロードするようにデプロイを設定することです。これを行うには、オプションページで変更されたファイルのデフォルトサーバーへの自動アップロードを常時に設定し、外部変更をスキップするチェックボックスをオフにします。ブランチを切り替えると、すべてのファイルがサーバーにアップロードされます。

• git-ftp(英語) を使用してください。最小のアップロードを実行し、ファイルとディレクトリの削除をミラーリングすることもできます。

WebStorm は FTPS サーバーとの接続を確立できません

FTPS サーバーが TLS1.0 /TLS 1.1 を使用するように構成されている場合、WebStorm はそれに接続できず、次のエラーメッセージが表示されます。

これは、WebStorm が TLS1.2 以降を介したサーバーへの接続をサポートしているために発生します。TLS1.0 および TLS1.1 の使用はサポート(英語)されていません。これらのプロトコルは非推奨であり、安全でないと見なされているためです。

回避策として、WebStorm JVM オプションを調整することにより、TLS 1.0 /TLS1.1 サポートを有効にすることができます。古いプロトコルを使用すると、環境にセキュリティリスクが発生する可能性があり、発生する可能性があり、最後の手段と見なされることに注意してください。