PhpStorm 2025.1 ヘルプ

Podman

Podman(英語) は、コンテナーをルートとして、またはルートレスモードで実行できるデーモンレスコンテナーマネージャーです。Podman コマンドは Docker と完全に互換性があるため、一方を他方に置き換えることができます: alias docker=podman

コア Podman ランタイム環境は、Linux オペレーティングシステムでのみ実行できます。ただし、他のオペレーティングシステム用のリモートクライアント(英語)を使用して、Podman を実行しているマシン上のコンテナーを管理することができます。このトピックでは、PhpStorm が Podman のリモートクライアントとして機能する方法について説明します。

Docker プラグインを有効にする

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

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

  2. インストール済みタブを開き、Docker プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

ポッドマンを実行する

Podman バージョン 3.2.0 以降では、 podman machine (英語) コマンドセットを使用して、Podman で仮想マシンを実行できます。

  1. Podman をインストールします(英語)

  2. 新しい仮想マシンを初期化します。

    podman machine init --rootful=true

    詳細については、podman machine init (英語) を参照してください。

  3. Podman 仮想マシンを起動します。

    podman machine start

    詳細については、podman machine start (英語) を参照してください。

成功した場合、出力には Podman API の URL と、PhpStorm またはその他の Docker クライアントから Podman に接続するために使用できる値を持つ DOCKER_HOST 変数が含まれます。例:

unix:///var/folders/3p/qnvz_wss4g32qcwxcmvsk70c0000gp/T/podman/podman-machine-default-api.sock

PhpStorm から Podman に接続する

Podman の実行については、ポッドマンを実行するを参照してください。

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

  2. The Add button をクリックして、Docker 構成を追加します。

  3. Podman を選択し、ポッドマン接続リストでポッドマンマシン(英語)の名前を選択します。

    すべてが正しければ、ページの下部に接続完了が表示されます。

詳細は、Docker 接続設定を参照してください。

Podman Linux 接続エラーのトラブルシューティング

Podman への接続を確立できなかった場合、PhpStorm は、Podman 実行可能ファイルは見つかったが、Podman ソケットへの接続に失敗したことを示すエラーを表示します。

詳細については Podman ドキュメント(英語)を参照し、次の手順で問題をトラブルシューティングしてください。

  1. 再起動後に systemd ソケットが自動的に起動し、指定されたユーザーとして実行されるように設定します。

    systemctl --user enable podman.socket loginctl enable-linger <USER>
  2. サービスの systemd ソケットを root として起動します。

    sudo systemctl start podman.socket
  3. 再起動後にソケットが自動的に開始されるように設定します。

    sudo systemctl enable podman.socket