Docker の 429 とは何か？（公式の定義）

429 は、HTTP標準仕様（RFC 9110）で定められているステータスコードの一つです。

Docker の文脈では、このコードは次のことを意味します。

短時間に送ったリクエスト数が上限を超えました。

このエラーが出たときは、次の「原因」の節を確認してください。

このエラーが発生する主な原因

Docker で 429 が出るときに、最もよく見られる原因を挙げます。

  • Docker Hub へのイメージ取得回数が無料枠の上限に達した
  • CI/CDパイプラインが短時間に大量の pull を実行している

具体的な解決手順

上の原因ごとの対処法を、実行できる手順の形でまとめました。 上から順番に試すことで、多くの場合は解決できます。

  1. Docker Hub にログインすることで取得上限を引き上げる
  2. よく使うイメージをプライベートレジストリーまたはローカルキャッシュに保存する
  3. pull の頻度を下げるよう CI 設定を見直す

それでも解決しない場合は、Docker の公式ドキュメントで最新の情報を確認するか、公式のコミュニティフォーラムやサポートに問い合わせてください。

免責事項：本記事の内容は、執筆時点の公開情報をもとに作成したものです。ソフトウェアの仕様は予告なく変更されることがあります。最新の情報は各ツールの公式サポートページをご確認ください。本記事の情報を利用した結果生じたいかなる損害についても、著者および運営者は責任を負いかねます。