Podman の 503 エラーが発生した場合、Podman API サービスやコンテナレジストリが一時的に利用できない状態です。以下の手順で原因を特定し、解決します。
よくある原因
Podman API サービスが起動していない
Podman を使用する際、バックグラウンドで動作する Podman API サービス（podman.socket）が停止しています。このサービスが起動していないと、コンテナの管理操作やレジストリへのアクセスができなくなります。特に、Podman をシステムサービスとして起動する場合や、リモート接続を使用する場合に多く発生します。
コンテナレジストリが一時的に停止またはメンテナンス中
Docker Hub や Quay.io などのコンテナレジストリが予期しないダウンタイムやメンテナンス作業中の場合、イメージのプル操作時に 503 エラーが返されます。これはレジストリ側の問題であるため、レジストリの復旧を待つ必要があります。
ネットワーク接続に問題がある
Podman が実行されているホストとコンテナレジストリ間のネットワーク接続が切断されている、またはファイアウォールルールがレジストリへのアクセスをブロックしている場合、503 エラーが発生します。DNS 解決の失敗も同様の症状を引き起こします。
解決手順
ステップ 1: Podman API サービスの状態を確認する
まず、Podman API サービスが正常に起動しているか確認します。以下のコマンドを実行してください。
systemctl status podman.socket
出力例として active (running) と表示されていれば、サービスは起動しています。inactive (dead) や failed と表示されている場合は、次のステップでサービスを起動します。
ステップ 2: Podman API サービスを起動する
サービスが停止している場合、以下のコマンドで起動します。
systemctl start podman.socket
システムブート時に自動的にサービスが起動するように設定する場合は、以下のコマンドを実行してください。
systemctl enable podman.socket
ステップ 3: ネットワーク接続を確認する
レジストリへの接続テストを行います。以下のコマンドでインターネット接続を確認してください。
ping 8.8.8.8
接続が確認できない場合は、ネットワークインターフェースの設定を確認するか、ファイアウォール設定を見直します。DNS 解決を確認する場合は以下を実行します。
nslookup docker.io
ステップ 4: レジストリのステータスを確認する
使用しているコンテナレジストリの公式ステータスページを確認します。Docker Hub であれば https://www.docker.com/status で、Quay.io であれば https://status.quay.io で確認できます。障害情報が掲示されている場合は、復旧を待つ必要があります。
ステップ 5: Podman サービスをリスタートする
上記の確認後も問題が解決しない場合は、以下のコマンドで Podman サービス全体をリスタートします。
systemctl restart podman
systemctl restart podman.socket
それでも解決しない場合
Podman のログを詳細に確認して、具体的なエラーメッセージを取得します。
journalctl -u podman -n 50
journalctl -u podman.socket -n 50
代替レジストリの使用も検討してください。例えば、Docker Hub の代わりに Quay.io や独自のレジストリを使用する場合、Podman の設定ファイル /etc/containers/registries.conf を編集して、レジストリの優先順位やミラーサーバーを指定できます。
[[registry]]
location = "docker.io"
mirror = [
"https://mirror.example.com"
]
それでも解決しない場合は、Podman の再インストールやシステムの再起動を検討してください。
免責事項：本記事の内容は、執筆時点の公開情報をもとに作成したものです。ソフトウェアの仕様は予告なく変更されることがあります。最新の情報は各ツールの公式サポートページをご確認ください。本記事の情報を利用した結果生じたいかなる損害についても、著者および運営者は責任を負いかねます。