본문 바로가기

Program

Docker Hub API 최신 변경 로그 정리

반응형

 

🐳 Docker Hub API 최신 변경 로그 정리 (2025년 기준)

Docker Hub API는 Docker 이미지를 검색하고, 다운로드하며, 퍼블리시할 수 있도록 도와주는 매우 강력한 도구입니다. 특히 자동화된 CI/CD 파이프라인이나 개발자 도구에 통합될 때 필수적입니다. 이 글에서는 Docker Hub API Changelog의 내용을 기반으로 최근 업데이트된 내용과 개발자에게 중요한 변화 포인트를 정리했습니다.

 

📌 1. API 버전 2.0 릴리즈 요약

Docker는 기존 API의 문제점을 개선하기 위해 v2.0 API를 발표했습니다. 이 버전은 보안 강화와 일관된 응답 포맷 제공을 주요 목표로 하고 있으며, 다음과 같은 핵심 변경 사항이 포함됩니다:

  • OAuth 인증 기반 전환
    기존의 Token 기반 인증에서 OAuth2 방식으로 점차 이동 중입니다. 이를 통해 더 정교한 권한 제어와 제3자 애플리케이션 인증이 가능해졌습니다.
  • 레이트 리밋 정책 명확화
    이전에는 암묵적으로 동작하던 요청 제한 정책이 명확히 문서화되었으며, 사용자 유형(익명/인증)에 따라 API 사용량 제한이 달라집니다.
  • OpenAPI 스펙 채택
    Swagger 기반 문서 제공을 통해 자동화된 클라이언트 코드 생성을 지원합니다. 개발자는 쉽게 TypeScript, Python, Go 등의 언어에서 API 클라이언트를 생성할 수 있습니다.

🔧 2. 주요 기능 개선 사항

🔐 인증 관련 업데이트

  • 로그인 API는 더 이상 사용자 비밀번호를 직접 전달하지 않고, JWT(Json Web Token) 기반의 토큰 발급 방식을 사용합니다.
  • 외부 서비스에서 액세스 권한을 요청할 때, scopes 파라미터를 이용하여 세분화된 접근 권한을 명시할 수 있습니다.

📦 레포지토리 API 변경

  • GET /v2/repositories/{namespace}/{repo}
    기존보다 더 많은 메타데이터 필드를 제공하며, 특히 최신 푸시 시간(last pushed), 이미지 사이즈, 자동 빌드 상태 등 실시간 정보 접근이 개선되었습니다.
  • POST /v2/repositories/{namespace}
    신규 저장소 생성 시 namespace 정책private/public 설정이 명확하게 지정 가능합니다.

🔁 태그 관련 개선

  • 태그 목록 조회 API에서 pagination 기능이 강화되어, 대형 저장소에서 수천 개의 태그를 효율적으로 불러올 수 있습니다.
  • 태그 삭제 API (DELETE /v2/repositories/{namespace}/{repo}/tags/{tag})가 안정화되었으며, 삭제 이후에도 일시적인 soft-delete 보관 기간이 존재합니다.
반응형

 

⚠️ 3. 더 이상 사용되지 않는 기능 (Deprecated)

다음 API들은 향후 버전에서 제거될 예정이므로 기존 프로젝트에서 사용 중이라면 점검이 필요합니다:

  • /legacy/repos/ 관련 엔드포인트들
    예전 Hub 인터페이스에 기반한 API는 완전히 중단 예정입니다.
  • Token 기반 인증 (/login)
    사용자 비밀번호를 직접 넘겨주는 방식은 보안상 위험하므로, 더 이상 권장되지 않습니다.

🧪 4. 개발자 체크리스트

항목 확인 사항

🔑 인증 방식 OAuth2 토큰 방식으로 전환했는가?
📄 OpenAPI Swagger 기반으로 문서를 참고했는가?
🗃️ 저장소 정보 레포지토리 정보를 최신 스펙에 맞게 파싱 중인가?
🔁 태그 관리 pagination 및 삭제 기능을 새롭게 반영했는가?
🚫 Deprecated 레거시 API를 제거했는가?

💡 활용 팁

  • Postman으로 테스트: Docker Hub API는 인증이 필요한 경우가 많으므로, Postman에서 OAuth2 인증을 설정하고 다양한 요청을 테스트해보는 것이 좋습니다.
  • CI/CD 연동: GitHub Actions, GitLab CI와 연동하여 이미지 자동 푸시 및 삭제에 활용하면 매우 유용합니다.
  • API Rate Limit 대응: 사용량이 많은 경우 유료 Docker 계정을 이용해 레이트 리밋을 해소하거나 캐싱 전략을 병행하세요.

✍️ 마무리

Docker Hub API는 지속적으로 발전하며 보안성과 개발 편의성을 높이고 있습니다. 특히 OpenAPI 문서 채택, OAuth2 인증 도입, 태그 관리 API 강화는 실무에서 매우 유용하게 작용할 수 있습니다. 기존에 사용 중이던 API가 deprecated 대상인지 꼭 확인하고, 새로운 구조로 마이그레이션하는 것을 권장드립니다.


✅ 추천 태그

  • #DockerAPI
  • #도커허브
  • #OAuth2
  • #API변경로그
  • #DevOps자동화

 

 

Docker로 개발하기: 컨테이너 기반 개발의 시작

 

Docker로 개발하기: 컨테이너 기반 개발의 시작

📦 Docker로 개발하기: 컨테이너 기반 개발의 시작컨테이너로 개발 환경을 통합하고, 개발·배포를 더 쉽게!✅ 컨테이너 개발이란?전통적인 개발 환경에서는 각자의 PC에 Node.js, Python, Java, MySQL 등

jjig810906.tistory.com

 

 

반응형