Skip to content

fix(docker): Docker Hub untagged image 자동 삭제 API 수정#711

Merged
jk-kim0 merged 1 commit intomainfrom
fix/dockerhub-cleanup-api
Feb 13, 2026
Merged

fix(docker): Docker Hub untagged image 자동 삭제 API 수정#711
jk-kim0 merged 1 commit intomainfrom
fix/dockerhub-cleanup-api

Conversation

@jk-kim0
Copy link
Copy Markdown
Contributor

@jk-kim0 jk-kim0 commented Feb 13, 2026

Summary

  • Docker Hub의 Advanced Image Management API(/v2/repositories/.../images?status=inactive)가 폐지(retired)되어 매 빌드마다 cleanup step이 404로 조용히 실패하고 있었음
  • 새로운 manifests API 엔드포인트로 교체하여 untagged image 자동 삭제 복구
  • 38줄 인라인 bash 코드를 독립 Python 스크립트(bin/dockerhub-cleanup.py)로 분리

Details

Root Cause: Docker Hub가 /v2/repositories/{ns}/{repo}/images 엔드포인트를 폐지. continue-on-error: true 설정 때문에 실패가 숨겨져 있었음.

New API:

용도 기존 (404) 신규 (작동 확인)
목록 GET /v2/repositories/.../images?status=inactive GET /v2/namespaces/{ns}/repositories/{repo}/manifests
삭제 POST /v2/repositories/.../images/delete DELETE /v2/namespaces/{ns}/repositories/{repo}/manifests

검증 결과: 로컬에서 실행하여 12개 untagged manifest 삭제 성공, 삭제 후 0개 확인.

Test plan

  • python3 bin/dockerhub-cleanup.py --dry-run 로컬 실행 확인
  • main 머지 후 GHA workflow 트리거하여 cleanup step 정상 동작 확인
  • Docker Hub에서 untagged image가 남아있지 않은지 확인

🤖 Generated with Claude Code

기존 Advanced Image Management API(`/v2/repositories/.../images?status=inactive`)가
Docker Hub에서 폐지되어 404를 반환하고 있었음. 새로운 manifests API로 교체:
- LIST: GET /v2/namespaces/{ns}/repositories/{repo}/manifests
- DELETE: DELETE /v2/namespaces/{ns}/repositories/{repo}/manifests

인라인 bash 코드를 독립 Python 스크립트(bin/dockerhub-cleanup.py)로 분리.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 13, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
querypie-docs Ready Ready Preview, Comment Feb 13, 2026 11:43am

Request Review

@jk-kim0 jk-kim0 self-assigned this Feb 13, 2026
@jk-kim0 jk-kim0 merged commit 73de552 into main Feb 13, 2026
7 checks passed
@jk-kim0 jk-kim0 deleted the fix/dockerhub-cleanup-api branch February 13, 2026 11:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant