PostgreSQLとpsqlの使い捨て環境を立ち上げる
使い捨ての実験環境として、PostgreSQLとpsqlをDockerコンテナ上で動かしたときの記録です。
仕事だと便利な環境がすでに用意されており、いざ自分で作ろうとしたらちゃんとわかってないことも多く、思いのほか手こずってしまったためメモしておきます。
環境
- macOS 10.15.7
- Docker Desktop for Mac 4.3.2
- PostgreSQL 11.14
結論
PostgreSQLをコンテナ上に立ち上げる
PostgreSQL 11であれば、以下の流れで立ち上げることができます。
Dockerのイメージを取得する。
docker pull postgres:11
Dockerのネットワークを作成する。
docker network create some-network
PostgreSQL 11のコンテナを起動する。
docker run --rm --name some-postgres -h some-postgres --network some-network -e POSTGRES_PASSWORD=mysecretpassword -d postgres:11
このコマンドで起動するPostgreSQLは次の設定を持ちます。
- コンテナ名:
some-postgres(--nameオプションの値) - ホスト名:
some-postgres(-hオプションの値) - Dockerのネットワーク:
some-network(--networkオプションの値) - PostgreSQLのパスワード:
mysecretpassword(POSTGRES_PASSWORD環境変数の値)
psqlをコンテナ上で起動する
前述の方式で起動したPostgreSQLであれば、以下のコマンドでpsqlを起動し接続することができます。
docker run -it --rm --network some-network postgres:11 psql -h some-postgres -U postgres
経緯メモ
以下は、最終的な結果に至るまでの調査の流れや、自分の理解が曖昧だった箇所のメモです。読み飛ばしてもらって構いません。
まず、コンテナイメージを取ってきます。
PostgreSQLのオフィシャルイメージはこちらにあります。
一通り起動できたらイメージの軽量化は検討していけばよいので、いったんはツールの豊富なDebianベースのイメージを選んでいます。
docker pull postgres:11
上記公式サイトに「How to use this image」があるので、それに沿って試していきます。
何も考えずに実行してみると、some-networkがない旨のエラーになりますね。
❯ docker run -it --rm --network some-network postgres psql -h some-postgres -U postgres
docker: Error response from daemon: network some-network not found.
そもそもDockerのネットワークをよくわかってないので、マニュアルを読んでいきます。
lsができるようなので、これで既存のネットワークを確認します。3つでてきました。 たしかにsome-networkという名前のものはないですね。
❯ docker network ls
NETWORK ID NAME DRIVER SCOPE
c9d19e1f3143 bridge bridge local
4586fb082355 host host local
e27d19bd233f none null local
ちなみに、--networkオプションを指定しない場合、デフォルトでbridgeというネットワークに接続するようです。
じゃあ、--networkオプションはべつに指定せず、bridgeネットワークを使えばよいのでは？ ということで、このオプションを外して再度実行してみます。
起動はしたようです。
❯ docker run --rm --name some-postgres -h some-postgres -e POSTGRES_PASSWORD=mysecretpassword -d postgres:11
960c2f13845b115ebf5b9264a8ba9e40fd2ef87191b36c1d4739b432f0041009
psqlから繋いでみます。
ホスト名(some-postgres)が見つからないエラーになりました…。
❯ docker run -it --rm postgres psql -h some-postgres -U postgres
psql: error: could not translate host name "some-postgres" to address: Name or service not known
Dockerがどうやって名前を解決しているかがそもそもわかってないので、またマニュアルを読んでいきます。
このように書かれていました。
Docker デーモンは内蔵 DNS サーバを動かし、ユーザ定義ネットワーク上でコンテナがサービス・ディスカバリを自動的に行えるようにします。
「ユーザー定義ネットワーク」とあるので、ホスト名で解決したければDockerのネットワークを自分で作っておく必要がありそうな雰囲気。
ググって見つけた以下の記事でもネットワークを作っているので、この理解は間違ってなさそうです。(参考にさせていただきました！ありがとうございます！)
ということでネットワークを作っていきます。ネットワーク関連のコマンドは こちら に載っています。
❯ docker network create some-network
16bdc928a8fcc027447b1ed6ad630b8a13cead57ed7306cccfc1925789d374da
ちなみにdocker network inspect {ネットワーク名}で、作成したネットワークの詳細を確認できます。
❯ docker network inspect some-network
[
{
"Name": "some-network",
"Id": "16bdc928a8fcc027447b1ed6ad630b8a13cead57ed7306cccfc1925789d374da",
"Created": "2022-01-26T14:09:09.9730416Z",
"Scope": "local",
"Driver": "bridge",
"EnableIPv6": false,
"IPAM": {
"Driver": "default",
"Options": {},
"Config": [
{
"Subnet": "172.24.0.0/16",
"Gateway": "172.24.0.1"
}
]
},
"Internal": false,
"Attachable": false,
"Ingress": false,
"ConfigFrom": {
"Network": ""
},
"ConfigOnly": false,
"Containers": {},
"Options": {},
"Labels": {}
}
]
このネットワークを使い、再度PostgreSQLとpsqlを立ち上げてみます。
ネットワークの指定は-hオプションでできます。
-h, --hostname string Container host name
PostgreSQL
❯ docker run --rm --name some-postgres -h some-postgres --network some-network -e POSTGRES_PASSWORD=mysecretpassword -d postgres:11
54f76df1e9e5442914addc16656063fbb1a89c105611e32496e9c6a3748cdbc4
psql
❯ docker run -it --rm --network some-network postgres:11 psql -h some-postgres -U postgres
Password for user postgres:
psql (11.14 (Debian 11.14-1.pgdg90+1))
Type "help" for help.
postgres=#
無事繋がりました🎉
Discussion