コンテナにホストマシンからアクセスするために、ポートの公開について学びます。

これでやっとブラウザから App コンテナと Mail コンテナの Web サーバにアクセスできるようになります。

全体構成とハイライト

やることの確認

このページで初登場する構築のコマンドとオプション

コンテナを起動する - container run

ポートの公開とは

コンテナはホストマシンから隔離されており、コンテナ内で Web サーバや DB サーバを起動してもそのままではホストマシンからアクセスすることはできません。

Web サーバなどいわゆるパブリックネットワークに置くようなコンテナでは、その問題を解決するために ホストマシンに対して ポートの公開を行うことになります。

構築

App コンテナの Web サーバのポートを公開する

App コンテナでは PHP のビルトインウェブサーバーが 8000 ポートで起動しています。

この 8000 ポートをコンテナ起動時に公開することで、ホストマシンからビルトインウェブサーバーにアクセスできるようになります。

公開ポートは --publish host-machine:container の形式でマッピングします。
このとき host-machine 側のポートは起動する人が自由に決めます が、1024 未満のポートは特権ポートと呼ばれるあらかじめ用途が決められているポートなるので避けておくのが無難です。

コンテナの 8000 ポートをホストマシンの 8000 ポートに割り当てることも可能ですが、8000 ポートは使われていることが多い^[1]ので今回は 18000 ポートにマッピングします。

$ docker container run                        \
    --name app                                \
    --rm                                      \
    --detach                                  \
    --interactive                             \
    --tty                                     \
    --mount type=bind,src=$(pwd)/src,dst=/src \
    --publish 18000:8000                      \
    docker-practice:app                       \
    php -S 0.0.0.0:8000 -t /src

ポートが公開できたことを確認する

ここまでの設定と操作が全てうまくいっていれば、やっとブラウザから http://localhost:18000 を開くことができます。

Mail Form 画面も開きます。

正しく表示されない場合は、--detach オプションを外して出力をよく確認したり、コンテナに配置されている設定ファイルを bash を使って確認したりしてください。

せっかくブラウザから操作できるようになりましたが、Mail Form の Send ボタンはまだメールを送信できませんし、

Mail History 画面はまだ開けません。

Mail コンテナと DB コンテナにはまだ接続できないからです。

ホストマシン - コンテナ の通信はできるようにはなりましたが、コンテナ - コンテナ の通信は ポートの公開では解決できません。
これは 【 ３部: ネットワーク 】で対応します。

Mail コンテナの Web サーバのポートを公開する

Mail コンテナにも Web サーバがあるので、同じようにポートを公開しておきましょう。

Mail コンテナでは Web サーバ ( 8025 ポート ) と SMTP サーバ ( 1025 ポート ) を起動していますが、公開するのは 8025 ポートだけです。
SMTP サーバ ( 1025 ポート ) を公開しないのは、ホストマシンからメールを送信するつもりはないからです。

こちらもポートの衝突を避けるために適当にずらし、18025 にマッピングします。

$ docker container run     \
    --name mail            \
    --rm                   \
    --detach               \
    --platform linux/amd64 \
    --publish 18025:8025   \
    mailhog/mailhog:v1.0.1

これで MailHog も http://localhost:18025 でアクセスできるようになりました。

もっとも、メールは一通もありませんが。

まとめ

このページの手順書と成果物は次のディレクトリで公開されています。

混乱してしまったときに参考にしてください。

ポイント

• ホストマシンからアクセス したい場合は、コンテナのポートを公開する
• コンテナ側のポートは、起動しているサービスに合わせる
• ホストマシン側のポートは、衝突しないように自分で決める

できるようになったことの確認

次のページに進む前に

起動オプションをどんどん増やしていくため、このページで起動したコンテナは終了します。

$ docker container rm --force \
    app mail