Docker Hub

通过您已连接 OOMOL 的账户操作 Docker Hub。该能力调用 docker_hub 连接器（通过 oo CLI）；OOMOL 在服务端注入凭据，因此您无需处理原始 token。

执行操作

假设用户已安装 oo CLI、完成登录并已连接 Docker Hub。请勿主动执行 oo auth login 或打开连接 URL — 直接运行操作即可。仅当命令因认证或连接错误而实际失败时，才回退至首次配置流程。

1. 检查契约（schema）：在构建请求负载前，先获取该操作权威的输入/输出结构定义：

oo connector schema "docker_hub" --action ""

2. 执行操作：传入符合输入结构定义的 JSON 负载：

oo connector run "docker_hub" --action "" --data '' --json

• --data 接受 JSON 对象字符串，或以 @path/to/file.json 形式指定本地文件路径；若省略该参数，则默认发送空对象 {}。
• 响应格式为 { "data": ..., "meta": { "executionId": "..." } }；其中执行 ID 位于 meta.executionId 字段下。

以下列出了所有可用操作，每项附有一行简要说明；会改变状态的操作标有 [write] 或 [destructive] 标签。在构造 --data 前，请务必使用 oo connector schema 获取该操作最新的、权威的输入字段定义。

可用操作

• add_org_member — 使用 Docker Hub 官方批量邀请接口（单次邀请一人），向 Docker Hub 组织邀请指定 Docker ID 或邮箱地址。[write]
• create_repository — 在指定命名空间（namespace）内创建一个 Docker Hub 仓库。[write]
• delete_team — 删除组织内的一个 Docker Hub 团队。[destructive]
• get_image — 通过 digest 查找 Docker Hub 镜像变体：扫描仓库已发布的 tag 列表实现。这是一个基于官方 tag 列表响应构建的仓库级辅助操作。
• get_repository — 获取指定命名空间内 Docker Hub 仓库的详细元数据。
• get_tag — 获取指定 Docker Hub 仓库 tag 的元数据及对应镜像变体信息。
• get_team — 获取组织内的一个 Docker Hub 团队。
• list_org_access_tokens — 列出组织的 Docker Hub 访问令牌（access tokens）。
• list_org_members — 列出组织成员，支持可选的过滤与分页。
• list_repositories — 列出指定命名空间下的 Docker Hub 仓库，支持可选的名称过滤与排序。
• list_team_members — 列出组织内某 Docker Hub 团队的成员。
• list_teams — 列出组织下的所有 Docker Hub 团队。
• remove_org_member — 将成员从 Docker Hub 组织中移除。[destructive]
• remove_team_member — 将用户从组织内的 Docker Hub 团队中移除。[destructive]

安全性

• 未标注标签的操作均为只读操作（get / list / search），可直接安全执行。
• 标注 [write] 的操作会修改 Docker Hub 状态 — 执行前须向用户确认具体请求负载内容及其影响。
• 标注 [destructive] 的操作将删除或覆盖数据 — 执行前必须明确确认目标对象，并获得用户的显式批准。

首次配置

以下为一次性步骤 — 不要在每次调用时重复执行。仅当命令因对应原因失败时，才运行相应步骤。

• oo: command not found — 安装 oo CLI（其他平台安装指南：https://cli.oomol.com/install-guide.md）：

  curl -fsSL https://cli.oomol.com/install.sh | bash    # macOS / Linux
  

  irm https://cli.oomol.com/install.ps1 | iex           # Windows PowerShell
  

• 未登录 / 认证错误 — 一次性登录您的 OOMOL 账户：

  oo auth login
  

• scope_missing / credential_expired / app_not_ready / app_not_found — Docker Hub 尚未连接，或连接已过期、缺少必要权限范围（scope）。请通过以下链接完成一次连接（认证类型：API key）：

  https://console.oomol.com/app-connections?provider=docker_hub
  

• HTTP 402 / OOMOL_INSUFFICIENT_CREDIT — 账户余额不足导致服务暂停。请访问 https://console.oomol.com/billing/token-recharge 充值后重试。

相关资源

• Docker Hub 主页：https://hub.docker.com