Harbor复制规则中namespace含义、查看方法及缺失报错咨询

一、Namespace在复制规则里的作用 #

Harbor里的Namespace和项目是一一对应的，它就是镜像名称里namespace/镜像名:标签的前缀部分，比如library/nginx:latest里的library。在复制规则里指定Namespace，就是限定只复制这个分组下的镜像；如果不填，默认会覆盖所有命名空间的镜像（还要看你设置的复制范围）。

二、查看Harbor Namespace的几种方法 #

• Web控制台直接看：登录Harbor后，左侧菜单栏点「项目」，列表里的每个项目名就是一个Namespace。
• 用API查询：执行下面的命令（替换成你的Harbor地址和账号密码）：

  curl -u "用户名:密码" -X GET "http://你的Harbor地址/api/v2.0/projects"
  

  返回结果里的name字段就是Namespace名称。
• Docker CLI查询：本地登录Harbor仓库后，执行docker search 你的Harbor地址/，结果里的前缀就是Namespace。

三、针对NOT_FOUND错误的排查 #

你贴的错误{"code":10010,"message":"object is not found"}，大概率和Namespace配置或镜像状态有关，给你几个排查点：

1. 核对复制规则里的Namespace：确认你填的Namespace在源Harbor里真实存在，别写错大小写（Harbor里Namespace是大小写敏感的）。
2. 检查账号权限：用来执行复制的账号，有没有访问目标Namespace下镜像的权限，没权限也会报找不到对象。
3. 验证镜像是否存在：错误详情里的b585659c082d58ddadf5f9a7是镜像的digest值，去源Harbor里搜这个digest，看看镜像是不是已经被删了，或者根本不存在。
4. 检查复制规则的过滤条件：如果规则设了标签过滤之类的条件，可能过滤后没有匹配到任何镜像，也会触发这个错误。

内容的提问来源于stack exchange，提问作者MichalT