Automação do Docker Hub
Automatize seus workflows no Docker Hub — crie e gerencie organizações, repositórios, equipes, adicione membros, configure webhooks de push de imagem e liste imagens de contêineres.
Documentação do toolkit: composio.dev/toolkits/docker_hub
Configuração
- Adicione o servidor MCP da Composio ao seu cliente:
https://rube.app/mcp - Conecte sua conta do Docker Hub quando solicitado (autenticação JWT/token)
- Comece a usar os workflows abaixo
Workflows Principais
1. Listar Organizações
Use DOCKER_HUB_LIST_ORGANIZATIONS para descobrir a quais organizações o usuário autenticado pertence.
Ferramenta: DOCKER_HUB_LIST_ORGANIZATIONS
Entradas:
- page: integer (baseado em 1, padrão 1)
- page_size: integer (1-100, padrão 25)
2. Criar uma Organização
Use DOCKER_HUB_CREATE_ORGANIZATION para criar programaticamente uma nova organização do Docker Hub.
Ferramenta: DOCKER_HUB_CREATE_ORGANIZATION
Entradas:
- orgname: string (obrigatório) -- minúsculas, apenas letras/números/._-, mínimo 2 caracteres
- company: string (opcional) -- nome da empresa associado à organização
Nota: Requer autenticação JWT obtida via /v2/users/login e pode ter acesso restrito.
3. Obter Detalhes da Organização e Repositórios
Use DOCKER_HUB_GET_ORGANIZATION para recuperar informações do namespace e seus repositórios. Funciona com qualquer namespace público.
Ferramenta: DOCKER_HUB_GET_ORGANIZATION
Entradas:
- organization: string (obrigatório) -- ex.: "docker", "bitnami", "library"
4. Criar um Repositório
Use DOCKER_HUB_CREATE_REPOSITORY para criar repositórios públicos ou privados sob um namespace.
Ferramenta: DOCKER_HUB_CREATE_REPOSITORY
Entradas:
- namespace: string (obrigatório) -- nome de usuário ou organização do Docker Hub
- name: string (obrigatório) -- minúsculas; letras, números, ._- permitidos
- description: string (opcional) -- máximo 100 caracteres
- full_description: string (opcional) -- conteúdo README em Markdown
- is_private: boolean (padrão false) -- repositórios privados exigem plano pago
5. Listar Repositórios com Filtragem
Use DOCKER_HUB_LIST_REPOSITORIES para enumerar repositórios dentro de um namespace com ordenação e filtragem por tipo de conteúdo.
Ferramenta: DOCKER_HUB_LIST_REPOSITORIES
Entradas:
- namespace: string (obrigatório) -- ex.: "library", "myorg"
- ordering: "name" | "last_updated" | "pull_count" (prefixar com - para ordem decrescente)
- page: integer (padrão 1)
- page_size: integer (1-100, padrão 25)
- content_types: string (separado por vírgulas, ex.: "image,artifact")
6. Gerenciar Equipes, Membros e Webhooks
Use DOCKER_HUB_LIST_TEAMS para listar equipes em uma organização, DOCKER_HUB_ADD_ORG_MEMBER para convidar usuários e DOCKER_HUB_CREATE_WEBHOOK para notificações de push.
Ferramenta: DOCKER_HUB_LIST_TEAMS
- Lista todas as equipes/grupos dentro de uma organização do Docker Hub
Ferramenta: DOCKER_HUB_ADD_ORG_MEMBER
- Convida um usuário para ingressar em uma organização por Docker ID ou e-mail
- Requer permissões de proprietário ou administrador
Ferramenta: DOCKER_HUB_CREATE_WEBHOOK
- Cria um webhook em um repositório para notificações de push de imagem
- Processo de duas etapas: criar webhook e depois adicionar URL do hook
- Requer permissões de administrador no repositório
Armadilhas Conhecidas
| Armadilha | Detalhe |
|---|---|
| Autenticação JWT | DOCKER_HUB_CREATE_ORGANIZATION requer autenticação JWT via /v2/users/login — tokens API padrão podem não ser suficientes. |
| Limites de repositórios privados | Criar repositórios privados (is_private: true) exige um plano pago do Docker Hub. |
| Restrições de nome de organização | Nomes de organização devem ser minúsculos, pelo menos 2 caracteres, contendo apenas letras, números, ., _ ou -. |
| Webhook em duas etapas | DOCKER_HUB_CREATE_WEBHOOK é um processo de duas etapas: primeiro criar o webhook com um nome, depois adicionar uma URL de hook. |
| Paginação | Todos os endpoints de listagem usam paginação baseada em página — itere pelas páginas até que os resultados se esgotem. |
Referência Rápida
| Slug da Ferramenta | Descrição |
|---|---|
DOCKER_HUB_LIST_ORGANIZATIONS | Listar organizações a que o usuário pertence |
DOCKER_HUB_CREATE_ORGANIZATION | Criar uma nova organização no Docker Hub |
DOCKER_HUB_GET_ORGANIZATION | Obter detalhes da organização e lista de repositórios |
DOCKER_HUB_CREATE_REPOSITORY | Criar um repositório sob um namespace |
DOCKER_HUB_LIST_REPOSITORIES | Listar repositórios com filtragem e ordenação |
DOCKER_HUB_LIST_TEAMS | Listar equipes/grupos dentro de uma organização |
DOCKER_HUB_ADD_ORG_MEMBER | Convidar um usuário para uma organização |
DOCKER_HUB_CREATE_WEBHOOK | Criar webhook de notificação de push em um repositório |
Desenvolvido por Composio