Docker Hub Automatisierung
Automatisieren Sie Ihre Docker-Hub-Workflows – erstellen und verwalten Sie Organisationen, Repositories, Teams, fügen Sie Mitglieder hinzu, richten Sie Webhooks für Image-Pushs ein und listen Sie Container-Images auf.
Toolkit-Dokumentation: composio.dev/toolkits/docker_hub
Einrichtung
- Fügen Sie den Composio MCP-Server zu Ihrem Client hinzu:
https://rube.app/mcp - Verbinden Sie Ihr Docker-Hub-Konto, wenn Sie dazu aufgefordert werden (JWT/Token-Authentifizierung)
- Beginnen Sie mit der Nutzung der untenstehenden Workflows
Kern-Workflows
1. Organisationen auflisten
Verwenden Sie DOCKER_HUB_LIST_ORGANIZATIONS, um herauszufinden, zu welchen Organisationen der authentifizierte Benutzer gehört.
Tool: DOCKER_HUB_LIST_ORGANIZATIONS
Eingaben:
- page: integer (1-basiert, Standard 1)
- page_size: integer (1-100, Standard 25)
2. Eine Organisation erstellen
Verwenden Sie DOCKER_HUB_CREATE_ORGANIZATION, um eine neue Docker-Hub-Organisation programmatisch zu erstellen.
Tool: DOCKER_HUB_CREATE_ORGANIZATION
Eingaben:
- orgname: string (erforderlich) – Kleinbuchstaben, Buchstaben/Zahlen/._- nur, mindestens 2 Zeichen
- company: string (optional) – Firmenname, der mit der Organisation verknüpft ist
Hinweis: Erfordert JWT-Authentifizierung, die über /v2/users/login bezogen wird, und kann eingeschränkten Zugriff haben.
3. Organisationsdetails und Repositories abrufen
Verwenden Sie DOCKER_HUB_GET_ORGANIZATION, um Namensrauminformationen und dessen Repositories abzurufen. Funktioniert mit jedem öffentlichen Namensraum.
Tool: DOCKER_HUB_GET_ORGANIZATION
Eingaben:
- organization: string (erforderlich) – z. B. "docker", "bitnami", "library"
4. Ein Repository erstellen
Verwenden Sie DOCKER_HUB_CREATE_REPOSITORY, um öffentliche oder private Repositories unter einem Namensraum zu erstellen.
Tool: DOCKER_HUB_CREATE_REPOSITORY
Eingaben:
- namespace: string (erforderlich) – Docker-Hub-Benutzername oder Organisationsname
- name: string (erforderlich) – Kleinbuchstaben; Buchstaben, Zahlen, ._- erlaubt
- description: string (optional) – maximal 100 Zeichen
- full_description: string (optional) – Markdown-README-Inhalt
- is_private: boolean (Standard false) – private Repositories erfordern einen kostenpflichtigen Tarif
5. Repositories mit Filterung auflisten
Verwenden Sie DOCKER_HUB_LIST_REPOSITORIES, um Repositories innerhalb eines Namensraums mit Sortierung und Inhaltsart-Filterung aufzulisten.
Tool: DOCKER_HUB_LIST_REPOSITORIES
Eingaben:
- namespace: string (erforderlich) – z. B. "library", "myorg"
- ordering: "name" | "last_updated" | "pull_count" (mit - für absteigende Reihenfolge)
- page: integer (Standard 1)
- page_size: integer (1-100, Standard 25)
- content_types: string (kommagetrennt, z. B. "image,artifact")
6. Teams, Mitglieder und Webhooks verwalten
Verwenden Sie DOCKER_HUB_LIST_TEAMS, um Teams innerhalb einer Organisation aufzulisten, DOCKER_HUB_ADD_ORG_MEMBER, um Benutzer einzuladen, und DOCKER_HUB_CREATE_WEBHOOK für Push-Benachrichtigungen.
Tool: DOCKER_HUB_LIST_TEAMS
- Listet alle Teams/Gruppen innerhalb einer Docker-Hub-Organisation auf
Tool: DOCKER_HUB_ADD_ORG_MEMBER
- Lädt einen Benutzer ein, einer Organisation beizutreten, per Docker-ID oder E-Mail
- Erfordert Besitzer- oder Admin-Berechtigungen
Tool: DOCKER_HUB_CREATE_WEBHOOK
- Erstellt einen Webhook auf einem Repository für Image-Push-Benachrichtigungen
- Zwei-Schritt-Prozess: Webhook erstellen, dann Hook-URL hinzufügen
- Erfordert Admin-Berechtigungen auf dem Repository
Bekannte Fallstricke
| Fallstrick | Detail |
|---|---|
| JWT-Authentifizierung | DOCKER_HUB_CREATE_ORGANIZATION erfordert JWT-Auth von /v2/users/login – Standard-API-Token reichen möglicherweise nicht aus. |
| Limits bei privaten Repos | Das Erstellen privater Repositories (is_private: true) erfordert einen kostenpflichtigen Docker-Hub-Tarif. |
| Einschränkungen bei Organisationsnamen | Organisationsnamen müssen Kleinbuchstaben sein, mindestens 2 Zeichen lang und nur Buchstaben, Zahlen, ., _ oder - enthalten. |
| Webhook in zwei Schritten | DOCKER_HUB_CREATE_WEBHOOK ist ein zweistufiger Prozess: Zuerst den Webhook mit einem Namen erstellen, dann eine Hook-URL hinzufügen. |
| Paginierung | Alle Auflistungs-Endpunkte verwenden seitenbasierte Paginierung – Seiten durchlaufen, bis keine Ergebnisse mehr vorhanden sind. |
Kurzreferenz
| Tool-Slug | Beschreibung |
|---|---|
DOCKER_HUB_LIST_ORGANIZATIONS | Organisationen auflisten, zu denen der Benutzer gehört |
DOCKER_HUB_CREATE_ORGANIZATION | Eine neue Docker-Hub-Organisation erstellen |
DOCKER_HUB_GET_ORGANIZATION | Organisationsdetails und Repository-Liste abrufen |
DOCKER_HUB_CREATE_REPOSITORY | Ein Repository unter einem Namensraum erstellen |
DOCKER_HUB_LIST_REPOSITORIES | Repositories mit Filterung und Sortierung auflisten |
DOCKER_HUB_LIST_TEAMS | Teams/Gruppen innerhalb einer Organisation auflisten |
DOCKER_HUB_ADD_ORG_MEMBER | Einen Benutzer zu einer Organisation einladen |
DOCKER_HUB_CREATE_WEBHOOK | Push-Benachrichtigungs-Webhook auf einem Repository erstellen |
Bereitgestellt von Composio