Quay から MinIO イメージをプルすると unauthorized が返されるようになりました
9月18日、MinIO のイメージが Docker Hub から消えたことについて記事を書きました。
当時、私たちが必要としていた過去の MinIO イメージは、まだ Quay から取得できました。Docker Hub から Quay へ切り替えることで、失敗していたプルは再び成功するようになりました。
10月2日、同じイメージをもう一度プルしてみました。
docker pull quay.io/minio/minio:RELEASE.2025-09-07T16-13-09Z
Quay から返ってきたのは、次のエラーです。
Error response from daemon: unauthorized: access to the requested resource is not authorized
認証なしのプルは、unauthorized で失敗しました。このエラーだけでは、イメージが削除されたのかどうかはわかりません。確かなのは、認証なしでは取得できなくなったということです。
Docker Hub から MinIO イメージが消えた後、私たちは Quay を代わりの取得元として紹介しました。しかし今度は、同じリリースを Quay から認証なしでプルできなくなりました。
同じリリースは StableBuild に残っていた
StableBuild の Docker ミラーに Quay 対応を追加した際、テストのためにこの MinIO リリースを StableBuild 経由でプルしていました。MinIO はテスト用途だけでなく、StableBuild の内部でも利用しています。
そのリリースはすでにキャッシュされていたため、10月2日にも同じコピーをプルできました。
ダイジェストは、イメージを最初にキャッシュした際に記録したものと一致しました。
sha256:14cea493d9a34af32f524e538b8346cf79f3321eff8e708c1e2960462bd8936e
9月に使用したものと同じ MinIO リリースです。プルを成功させるためだけに古いバージョンへ切り替える必要はありませんでした。
キャッシュされたコピーを取得できた理由
StableBuild の Docker ミラーは、プルスルーキャッシュとして動作します。
初めてミラー経由でイメージをプルすると、StableBuild が上流のレジストリからイメージを取得し、そのコピーを保存します。その後、同じタグをプルすると、保存済みのコピーが返されます。
MinIO イメージが一度キャッシュされれば、それ以降のプルは Quay が認証なしで提供し続けるかどうかに左右されません。
ただし、上流から取得できなくなる前にイメージをキャッシュしておく必要があります。StableBuild は、一度も保存していないイメージを復元することはできません。
MinIO イメージが Docker Hub から消えたとき、Quay は別の取得元として利用できました。しかしそれは、依然として他のレジストリが同じイメージを提供し続けることを前提にしていました。
今回は、すでに自分たちのコピーを保存していました。
MinIO を使ったビルドが失敗している場合
これらの MinIO イメージに依存するビルドが失敗し始めた場合は、まず自社で管理している場所に同じイメージが残っていないか確認してください。
たとえば、次のような場所です。
- 自社のコンテナレジストリ
- プルスルーキャッシュ
- CI ランナー
- 以前そのイメージをプルした開発マシン
コピーが見つかった場合は、ビルドが想定しているリリースとアーキテクチャであることを確認してください。ダイジェストを記録していれば、それも照合してください。
取得できなくなったイメージを別の MinIO リリースに置き換えれば、ビルドを動かせるかもしれません。しかしそれはソフトウェアの変更にほかならず、他の変更と同様にテストが必要です。
キャッシュされたコピーがあれば時間稼ぎにはなりますが、あくまで一時的な対処です。今後も MinIO に依存し続けるのであれば、そのイメージを恒久的な解決策として扱うのではなく、現在もメンテナンスされている代替ソフトウェアの検討を始めることをおすすめします。
Docker Hub からプルできなくなったとき、Quay は実用的な代替手段になりました。その後、Quay からの認証なしのプルも失敗するようになりましたが、StableBuild にコピーを保存していたため、同じイメージを再び取得できました。
上流からまだ取得できる依存性については、StableBuild の無料アカウントを作成して、Docker ミラー経由でイメージを保存してみてください。
