PyCharm 2026.3 Help

チュートリアル: PyCharm でデプロイ

プロジェクトファイルをローカルまたはマウントされたフォルダーにコピーし、コピーを比較して、変更を保存したときに自動アップロードされるように構成します。 このセットアップはファイルを転送するだけで、アプリケーションをビルドしたり起動したりしません。

FTP/SFTP/WebDAV 接続プラグインを有効化する

この機能は、デフォルトで PyCharm にバンドルされ有効になっている FTP/SFTP/WebDAV Connectivity プラグインに依存しています。 関連機能が利用できない場合は、プラグインが無効になっていないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン​ を選択します。

  2. FTP/SFTP/WebDAV Connectivity プラグインを見つけて、 有効化 をクリックします。

始める前

以下を確認してください:

  • PyCharm バージョン 5.0 以降を使用しています。 このチュートリアルは PyCharm 2024.1 で作成されています。

  • コードをデプロイするリモートホストへのアクセス権があります。

デプロイサーバーを構成する

新しいサーバーを追加する

  1. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デプロイ を選択します。

    または、メインメニューの ツール | デプロイ | 構成 に移動します。

  2. 項目を追加する をクリックし、 ローカルまたはマウント済みフォルダー を選択します。

    サーバーの追加ダイアログ
  3. 開いた 新規サーバーの作成 ダイアログでサーバー名を入力し、 OK をクリックします。

    新しいサーバーが追加されましたが、アップロードされたファイルを実際に参照する Web サーバー URL http://localhost のみが表示されます。

サーバーのルートフォルダーを指定する

  1. フォルダー フィールドで、プロジェクトファイルをアップロードするディレクトリを指定します。

    作成した宛先フォルダーへの絶対パスを入力するか、 閲覧 をクリックして選択します。

    この場合、これは /Users/jetbrains/deployment ローカルフォルダーです。 パスを手動で入力するか、 Shift+Enter を押します。

  2. このプロジェクトでのみ表示 を選択したままにして、現在のプロジェクトでこの構成を使用します。 構成を他のプロジェクトで使用する場合や、後でエクスポートする場合は、選択を解除します。

    デプロイ接続タブ

デプロイパスを指定する

  1. 次に、 マッピングタブに切り替えます。

    ただし、プロジェクトツリー内の他のディレクトリを選択することもできます。 デフォルトのパスを使用しましょう。

  2. デプロイメントパス フィールド (デフォルトでは空) で、PyCharm が ローカルパス フィールドで指定されたフォルダーからデータをアップロードするサーバー上のフォルダーを指定します。

    この例では、 アプリケーション です。 このパスは、Web サーバーのルートフォルダー ( Users/jetbrains/deployment ) を基準として指定されます。

  3. Web パス のデフォルトの / 値のままにします。

    デプロイマッピングタブ

変更を適用すると、サーバーを使用できるようになります。

リモートホストの参照

ツール | デプロイ | リモートホストの参照 を選択します。 リモートホスト ツールウィンドウで、 MyRemoteServer を選択して宛先フォルダーを参照します。

リモートホストツールウィンドウ

ファイルのデプロイ

サーバーにファイルをアップロードする

  1. プロジェクト ツールウィンドウ Alt+1 で、 README.md を右クリックします。

  2. デプロイ | MyRemoteServer にアップロードする を選択します。 このアクションが表示されない場合は、 デプロイ | アップロード先… を選択し、 MyRemoteServer を選びます。 ファイル転送 ツールウィンドウで結果を確認します。

    デプロイアップロード

プロジェクト内の各ディレクトリの内容をアップロードすることもできます。 プロジェクト ツールウィンドウでアップロードするディレクトリを右クリックし、 デプロイ | MyRemoteServer にアップロードする を選択します。

リモートとローカルバージョンを比較する

README.md ファイルにはローカルコピーとリモートコピーがあり、それらは同一です。 ローカルバージョンを変更します。

  • リモートホストツールウィンドウ ツールウィンドウで、 README.md を右クリックし、 ローカルバージョンと比較 を選択します。 PyCharm によって差分ビューアーが開きます。

    差分ビューアー

サーバーからファイルをダウンロードする

  1. リモートホストツールウィンドウ ツールウィンドウで、 README.md ファイルを右クリックし、 ここからダウンロード を選択します。 PyCharm に警告が表示されます。

    デプロイダウンロードの警告

変更を同期する

デフォルトのサーバーにファイルを自動的にアップロードする

PyCharm プロジェクトとまったく同じファイルをサーバー上に用意する必要がある場合、自動アップロードが役立ちます。 自動アップロードとは、IDE で変更が発生するたびに、その変更がデフォルトのデプロイサーバーにデプロイされることを意味します。

変更されたファイルの自動アップロード中にその設定がデフォルトで適用される場合、デプロイサーバーはデフォルトと見なされます。

デフォルトサーバーを定義する

  1. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デプロイ を選択します。

    または、メインメニューの ツール | デプロイ | 構成 に移動します。

  2. サーバーのリストからデフォルトにするサーバーを選択し、サーバーリストの上にあるツールバーの 「デフォルトとして使用」ボタン をクリックします。

自動アップロードを有効にする

デフォルトサーバーが設定されると、このサーバーへのアップロードを自動化できます。

  1. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デプロイ | オプション を選択します。

    または、メインメニューの ツール | デプロイ | オプション に移動します。

  2. 変更されたファイルをデフォルトサーバーに自動アップロードする ドロップダウンリストから、次のオプションのいずれかを選択します。

    • 常に: 自動保存および明示的保存のたびにファイルをアップロードします。

    • 明示的な保存アクション時: この保存が ファイル | すべて保存 を選択するか、 Ctrl+S を押して手動で呼び出された場合にのみ、保存後にファイルをアップロードします。

常に モードは本番環境へのデプロイは推奨されません:開発中に不完全なコードがアップロードされ、本番アプリケーションが破損する可能性があります。

外部の変更をアップロードする

外部変更とは、Git ブランチの変更やコードジェネレーターによって更新されたファイルなど、IDE 外部で行われた変更です。 PyCharm の内部または外部で実行されたツールから発生することがあります。

これらの変更を自動アップロードに含めるには、 設定 | ビルド、実行、デプロイ | デプロイ | オプション を開きます。 変更されたファイルをデフォルトサーバーに自動アップロードする を 常に または 明示的な保存アクション時 に設定し、 外部変更をスキップする の選択を解除します。

明示的な保存アクション時 では、 ファイル | すべて保存 Ctrl+S を使用して保留中の変更をアップロードします。

なし では、自動アップロードが無効になり、 外部変更をスキップする は使用できません。

外部変更をスキップする

デプロイ設定のエクスポート / インポート

デプロイサーバーのセットアップが完了したので、サーバー構成設定をエクスポートし、別のコンピューターにインポートできます。

設定を ZIP アーカイブにエクスポート

  1. メインメニューから ファイル | IDE 設定の管理 | 設定のエクスポート を選択します。

  2. 開いた 設定のエクスポート ダイアログで、 Web サーバー チェックボックスが選択されていることを確認し、ターゲットアーカイブのパスを指定します。

    サーバーデプロイ設定をエクスポートする

ZIP アーカイブから設定をインポートする

  1. メインメニューから ファイル | IDE 設定の管理 | 設定のインポート… を選択します。

  2. 開いたダイアログで設定を含む ZIP アーカイブを選択してください。

  3. 開く インポートするコンポーネントの選択 ダイアログで適用したい設定を選択し、 OK をクリックします。

要約

ローカルまたはマウントされた宛先を構成し、ファイルをコピーして比較し、自動アップロードを有効にしました。 SFTP 経由で別のコンピューターにファイルを転送するには、 リモートサーバー構成を作成します。

2026 年 10 月 30 日