Docker Hub 자동화
Docker Hub 워크플로우를 자동화하세요 — 조직, 리포지토리, 팀을 생성 및 관리하고, 멤버를 추가하며, 이미지 푸시 웹훅을 설정하고 컨테이너 이미지를 조회할 수 있습니다.
도구 키트 문서: composio.dev/toolkits/docker_hub
설정
- 클라이언트에 Composio MCP 서버를 추가하세요:
https://rube.app/mcp - 메시지가 나타나면 Docker Hub 계정을 연결하세요 (JWT/토큰 인증)
- 아래 워크플로우를 사용하기 시작하세요
핵심 워크플로우
1. 조직 목록 조회
DOCKER_HUB_LIST_ORGANIZATIONS을 사용하여 인증된 사용자가 속한 조직을 확인합니다.
도구: DOCKER_HUB_LIST_ORGANIZATIONS
입력:
- page: 정수 (1부터 시작, 기본값 1)
- page_size: 정수 (1-100, 기본값 25)
2. 조직 생성
DOCKER_HUB_CREATE_ORGANIZATION을 사용하여 프로그래밍 방식으로 새로운 Docker Hub 조직을 생성합니다.
도구: DOCKER_HUB_CREATE_ORGANIZATION
입력:
- orgname: 문자열 (필수) -- 소문자, 영문/숫자/._-만 가능, 최소 2자
- company: 문자열 (선택) -- 조직과 연결된 회사 이름
참고: /v2/users/login을 통해 얻은 JWT 인증이 필요하며, 접근이 제한될 수 있습니다.
3. 조직 세부 정보 및 리포지토리 조회
DOCKER_HUB_GET_ORGANIZATION을 사용하여 네임스페이스 정보와 그 안의 리포지토리를 검색합니다. 모든 공개 네임스페이스에서 작동합니다.
도구: DOCKER_HUB_GET_ORGANIZATION
입력:
- organization: 문자열 (필수) -- 예: "docker", "bitnami", "library"
4. 리포지토리 생성
DOCKER_HUB_CREATE_REPOSITORY을 사용하여 네임스페이스 아래에 공개 또는 비공개 리포지토리를 생성합니다.
도구: DOCKER_HUB_CREATE_REPOSITORY
입력:
- namespace: 문자열 (필수) -- Docker Hub 사용자 이름 또는 조직 이름
- name: 문자열 (필수) -- 소문자; 영문, 숫자, ._- 허용
- description: 문자열 (선택) -- 최대 100자
- full_description: 문자열 (선택) -- Markdown README 내용
- is_private: 불리언 (기본값 false) -- 비공개 리포지토리는 유료 플랜 필요
5. 필터링하여 리포지토리 목록 조회
DOCKER_HUB_LIST_REPOSITORIES을 사용하여 네임스페이스 내 리포지토리를 정렬 및 콘텐츠 유형 필터링과 함께 열거합니다.
도구: DOCKER_HUB_LIST_REPOSITORIES
입력:
- namespace: 문자열 (필수) -- 예: "library", "myorg"
- ordering: "name" | "last_updated" | "pull_count" (내림차순은 접두사 - 사용)
- page: 정수 (기본값 1)
- page_size: 정수 (1-100, 기본값 25)
- content_types: 문자열 (쉼표로 구분, 예: "image,artifact")
6. 팀, 멤버 및 웹훅 관리
DOCKER_HUB_LIST_TEAMS을 사용하여 조직 내 팀 목록을 조회하고, DOCKER_HUB_ADD_ORG_MEMBER로 사용자를 초대하며, DOCKER_HUB_CREATE_WEBHOOK으로 푸시 알림을 설정합니다.
도구: DOCKER_HUB_LIST_TEAMS
- Docker Hub 조직 내 모든 팀/그룹 목록을 조회합니다.
도구: DOCKER_HUB_ADD_ORG_MEMBER
- Docker ID 또는 이메일로 사용자를 조직에 초대합니다.
- 소유자 또는 관리자 권한이 필요합니다.
도구: DOCKER_HUB_CREATE_WEBHOOK
- 리포지토리에 이미지 푸시 알림용 웹훅을 생성합니다.
- 두 단계 프로세스: 웹훅 생성 후, 훅 URL 추가
- 리포지토리에 대한 관리자 권한이 필요합니다.
알려진 문제점
| 문제 | 세부 사항 |
|---|---|
| JWT 인증 | DOCKER_HUB_CREATE_ORGANIZATION은 /v2/users/login의 JWT 인증이 필요합니다. 일반 API 토큰으로는 충분하지 않을 수 있습니다. |
| 비공개 리포지토리 제한 | 비공개 리포지토리 생성(is_private: true)은 유료 Docker Hub 플랜이 필요합니다. |
| 조직 이름 제약 | 조직 이름은 소문자, 최소 2자, 영문/숫자/./_/-만 포함해야 합니다. |
| 웹훅 두 단계 | DOCKER_HUB_CREATE_WEBHOOK은 두 단계 프로세스입니다: 먼저 이름으로 웹훅을 생성한 후, 훅 URL을 추가합니다. |
| 페이지네이션 | 모든 목록 엔드포인트는 페이지 기반 페이지네이션을 사용합니다. 결과가 소진될 때까지 페이지를 반복합니다. |
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
DOCKER_HUB_LIST_ORGANIZATIONS | 사용자가 속한 조직 목록 조회 |
DOCKER_HUB_CREATE_ORGANIZATION | 새 Docker Hub 조직 생성 |
DOCKER_HUB_GET_ORGANIZATION | 조직 세부 정보 및 리포지토리 목록 조회 |
DOCKER_HUB_CREATE_REPOSITORY | 네임스페이스 아래 리포지토리 생성 |
DOCKER_HUB_LIST_REPOSITORIES | 필터링 및 정렬로 리포지토리 목록 조회 |
DOCKER_HUB_LIST_TEAMS | 조직 내 팀/그룹 목록 조회 |
DOCKER_HUB_ADD_ORG_MEMBER | 조직에 사용자 초대 |
DOCKER_HUB_CREATE_WEBHOOK | 리포지토리에 푸시 알림 웹훅 생성 |
Composio 제공