[docker] Debian(buster)系イメージで nslookup や dig が使えないとき

Tech

※ 本記事はアフィリエイト広告(Amazonアソシエイト)を含みます。

[docker] Debian(buster)系イメージで nslookup や dig が使えないとき

コンテナから外部のAPIにつながらない。DNSの問題かな?と nslookup を打ったら、

bash: nslookup: command not found

buster って結構色々入ってる状態かと思ってたけど、dnsutils は入ってなかったのね。

対処: dnsutils を入れる

apt-get update
apt-get install -y dnsutils

dnsutils に nslookup・dig・nsupdate がまとめて入っています。

⚠️ 公式イメージはサイズ削減のため apt のパッケージリストを空にしているので、先に apt-get update が必要です。いきなり install すると Unable to locate package dnsutils になります。

Dockerfile に書くなら

調査のたびに入れ直すのが面倒なら、開発用イメージに入れておきます。

RUN apt-get update \
  && apt-get install -y --no-install-recommends dnsutils \
  && rm -rf /var/lib/apt/lists/*

最後の rm はイメージを太らせないためのお作法です。

イメージ別の入れ方

ベースイメージコマンド
Debian / Ubuntu 系apt-get update && apt-get install -y dnsutils
Alpineapk add --no-cache bind-tools

ℹ️ Debian 11(bullseye)以降では、実体のパッケージ名が bind9-dnsutils になっています。dnsutils を指定しても移行用パッケージ経由で入るので、上のコマンドのままで大丈夫です。

インストールせずに名前解決だけ確認する

本番に近いコンテナにはパッケージを足したくない、ということもあります。名前が引けるかどうかだけなら、最初から入っている getent で確認できます。

getent hosts example.com

IPアドレスが返ってくれば名前解決はできています。コンテナ内の DNS 設定そのものは /etc/resolv.conf を見ればOK。

cat /etc/resolv.conf

docker compose のネットワーク内なら、ここに Docker の内部DNS(127.0.0.11)が入っているはずです。

まとめ

  • buster などの slim 寄りなイメージには nslookup / dig が入っていない
  • apt-get update && apt-get install -y dnsutils で入る(Alpine は bind-tools)
  • 入れたくないときは getent hosts と /etc/resolv.conf で最低限の確認ができる

ℹ️ なお Debian 10(buster)自体はサポート期間を終えています。新しく作るイメージは bookworm など現行のバージョンをベースにするのがおすすめです。

docker