Harbor 镜像仓库综合管理技能。用于 Harbor 日常运维、项目与镜像管理、安全扫描、清理策略、CI/CD 集成、GitOps、复制规则、存储管理、备份恢复、webhook 联动等所有 Harbor 相关操作。当用户提到 Harbor、镜像仓库管理、Docker 镜像、镜像安全扫描、CI/CD 镜像推送/拉取、GitOps 镜像策略、Harbor Webhook 时触发此技能。
Harbor Manager
功能概述
Harbor Manager是一项面向实际任务的技能,主要用于Harbor 是企业级容器镜像仓库(CNCF 毕业项目);首次使用需要配置连接信息,优先使用环境变量(可在 TOOLS.md 中预填):;
核心要点
- HARBOR_URL;
- Harbor 地址(不含 /);
- HARBOR_USERNAME;
使用与执行
管理员账号;admin;HARBOR_PASSWORD;密码或 API Token;Harbor12345;或通过对话传入;Token 优。
结果检查与注意事项
它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
Harbor Manager
Harbor 是企业级容器镜像仓库(CNCF 毕业项目)。
环境准备
首次使用需要配置连接信息,优先使用环境变量(可在 TOOLS.md 中预填):
| 变量 | 说明 | 示例 |
|---|---|---|
HARBOR_URL |
Harbor 地址(不含 /) | https://harbor.mycompany.com |
HARBOR_USERNAME |
管理员账号 | admin |
HARBOR_PASSWORD |
密码或 API Token | Harbor12345 |
或通过对话传入。Token 优先(比密码更安全)。
快速诊断
# 检查 Harbor 健康状态
curl -s -u "$HARBOR_USER:$HARBOR_PASS" "$HARBOR_URL/api/v2.0/health" | jq .
# 列出所有项目(Python)
python3 -c "
import requests, os
r = requests.get(f'{os.environ["HARBOR_URL"]}/api/v2.0/projects',
headers={'Authorization': f'Basic {os.environ["HARBOR_AUTH"]}'})
print(r.json())
"
项目管理
创建项目
curl -X POST "$HARBOR_URL/api/v2.0/projects"
-u "$HARBOR_USER:$HARBOR_PASS"
-H "Content-Type: application/json"
-d '{
"project_name": "my-app",
"public": false,
"metadata": {"description": "业务镜像仓库", "storage_quota": "500G"}
}'
修改存储配额(Python)
# refs: references/harbor-api.md
import requests, base64, os
auth = base64.b64encode(f"{u}:{p}".encode()).decode()
headers = {"Authorization": f"Basic {auth}", "Content-Type": "application/json"}
# 查找项目ID
proj = requests.get(f"{url}/api/v2.0/projects", params={"name": "my-app"}, headers=headers).json()[0]
pid = proj["project_id"]
# 更新配额(单位:bytes,500G = 500*1024^3)
requests.put(f"{url}/api/v2.0/projects/{pid}",
headers=headers, json={"metadata": {"storage_quota": str(500*1024**3)}})
print(f"项目 {pid} 配额已更新为 500G")
镜像管理
列出镜像
# 按项目列出所有镜像
curl "$HARBOR_URL/api/v2.0/projects/my-app/repositories"
-u "$HARBOR_USER:$HARBOR_PASS" | jq '.[].name'
# 查看某镜像的所有标签
curl "$HARBOR_URL/api/v2.0/projects/my-app/repositories/my-app--api/tags"
-u "$HARBOR_USER:$HARBOR_PASS" | jq '.[].name'
# 镜像详情(含大小、扫描状态)
curl "$HARBOR_URL/api/v2.0/projects/my-app/repositories/my-app--api/artifacts?with_tag=true&with_scan_overview=true"
-u "$HARBOR_USER:$HARBOR_PASS" | jq '.[].{tags: .tag, size: .size, scan: .scan_summary}'
删除镜像(按标签)
# 删除指定标签(保留其他标签)
curl -X DELETE
"$HARBOR_URL/api/v2.0/projects/my-app/repositories/my-app--api/tags/v1.2.3"
-u "$HARBOR_USER:$HARBOR_PASS"
# 批量删除(用 jq 生成)
TAGS=$(curl -s "$HARBOR_URL/api/v2.0/projects/my-app/repositories/my-app--api/tags"
-u "$HARBOR_USER:$HARBOR_PASS" | jq -r '.[].name | select(startswith("v0"))')
for tag in $TAGS; do
echo "删除: $tag"
curl -X DELETE "$HARBOR_URL/api/v2.0/projects/my-app/repositories/my-app--api/tags/$tag"
-u "$HARBOR_USER:$HARBOR_PASS"
done
删除不留用的镜像(Python)
# refs: references/cleanup-policy.md
import requests, base64, os, datetime
def delete_artifact(project, repo, reference, dry_run=True):
url = f"{os.environ['HARBOR_URL']}/api/v2.0/projects/{project}/repositories/{repo}/artifacts/{reference}"
if dry_run:
print(f"[演练] 应删除: {url}")
else:
r = requests.delete(url, headers=auth_header)
print(f"[已删除] {reference}" if r.status_code == 200 else f"[失败] {r.status_code}")
注意:Harbor GC 需要手动触发,删除后运行垃圾回收。
清理策略
配置保留策略
策略规则在 references/cleanup-policy.md 中有详细说明。
典型场景:
| 场景 | 规则 |
|---|---|
| 保留最近 N 个版本 | kept_tags >= N(按 push 时间排序) |
| 删除 N 天前镜像 | pushed_time < now - N days |
| 保留带有特定前缀的标签 | tag =~ ^release- |
| 清理快照版本 | tag =~ ^snap- |
演练模式(评估影响)
python3 /root/.openclaw/workspace/skills/harbor-manager/scripts/cleanup_dryrun.py --project my-app --repo my-app--api --policy "保留最近5个" --url "$HARBOR_URL"
清理策略推荐 YAML 格式
# 清理策略示例(用于自动化脚本生成)
project: my-app
repo: my-app--api
rules:
- action: delete
condition: tag not in recent(5)
exclude:
tags: ["latest", "stable", "release-*"]
- action: delete
condition: pushed_time < days_ago(30)
exclude:
tags: ["latest"]
垃圾回收(GC)
# 1. 触发 GC(拉取管理员 credentials)
curl -X POST "$HARBOR_URL/api/v2.0/system/gc/schedule"
-u "$HARBOR_USER:$HARBOR_PASS"
-H "Content-Type: application/json"
-d '{"schedule":{"type":"manual"}}'
# 2. 查看 GC 状态
curl "$HARBOR_URL/api/v2.0/system/gc"
-u "$HARBOR_USER:$HARBOR_PASS" | jq '.[] | {id: .id, status: .job_status, start: .start_time}'
# 3. GC 完成后清理孤儿 Blob(自动执行,也可手动触发)
curl -X POST "$HARBOR_URL/api/v2.0/system/gc/schedule"
-u "$HARBOR_USER:$HARBOR_PASS"
-H "Content-Type: application/json"
-d '{"schedule":{"type":"none"}, "dry_run": false}'
⚠️ GC 期间 Harbor 会进入维护模式,建议在低峰期执行。
存储使用情况
# 查看项目存储使用
curl "$HARBOR_URL/api/v2.0/projects/my-app"
-u "$HARBOR_USER:$HARBOR_PASS" | jq '{name: .name, storage: .metadata.storage_quota, used: .metadata.storage_quota_used}'
# 查看系统总体存储
curl "$HARBOR_URL/api/v2.0/statistics"
-u "$HARBOR_USER:$HARBOR_PASS" | jq '{total: .total_storage, used: .used_storage, free: .free_storage}'
复制管理
创建复制规则
curl -X POST "$HARBOR_URL/api/v2.0/replication/policies"
-u "$HARBOR_USER:$HARBOR_PASS"
-H "Content-Type: application/json"
-d '{
"name": "backup-to-dr-site",
"src_registry": {"id": 1, "name": "local"},
"dest_registry": {"id": 2, "name": "dr-harbor"},
"filters": [
{"type": "name", "value": "my-app/.*"},
{"type": "tag", "value": ".*"}
],
"trigger": {"type": "scheduled", "trigger_settings": {"cron": "0 2 * * * *"}},
"deletion": true,
"override": true
}'
触发立即执行
curl -X POST "$HARBOR_URL/api/v2.0/replication/executions"
-u "$HARBOR_USER:$HARBOR_PASS"
-H "Content-Type: application/json"
-d '{"policy_id": 3}'
# 查看执行状态
curl "$HARBOR_URL/api/v2.0/replication/executions?policy_id=3"
-u "$HARBOR_USER:$HARBOR_PASS" | jq '.[] | {id: .id, status: .status, summary: .status_ext}'
代理缓存(Proxy Cache)
创建代理缓存项目
curl -X POST "$HARBOR_URL/api/v2.0/projects"
-u "$HARBOR_USER:$HARBOR_PASS"
-H "Content-Type: application/json"
-d '{
"project_name": "proxy-cache-dockerhub",
"public": false,
"metadata": {
"proxy_cache_name": "dockerhub",
"description": "Docker Hub 代理缓存"
}
}'
使用代理缓存拉取镜像
# Pod 层面配置代理(通过 /etc/docker/daemon.json)
{
"registry-mirrors": ["https://proxy-cache-dockerhub.harbor.mycompany.com"]
}
# 或手动拉取
docker pull proxy-cache-dockerhub.library/nginx:latest
漏洞扫描
触发全量扫描
# 扫描单个镜像
curl -X POST
"$HARBOR_URL/api/v2.0/projects/my-app/repositories/my-app--api/artifacts/sha256:abc123.../scan"
-u "$HARBOR_USER:$HARBOR_PASS"
# 扫描整个项目所有镜像
curl -X POST
"$HARBOR_URL/api/v2.0/projects/my-app/scanAll"
-u "$HARBOR_USER:$HARBOR_PASS"
-H "Content-Type: application/json"
-d '{"selector":"all"}'
获取扫描报告
# 获取镜像扫描摘要
curl "$HARBOR_URL/api/v2.0/projects/my-app/repositories/my-app--api/artifacts/v1.2.3?with_scan_summary=true"
-u "$HARBOR_USER:$HARBOR_PASS" | jq '{scan: .scan_summary}'
# 导出详细扫描报告(CSV格式)
curl "$HARBOR_URL/api/v2.0/projects/my-app/repositories/my-app--api/artifacts/v1.2.3/scan_report?accept=text/csv"
-u "$HARBOR_USER:$HARBOR_PASS"
自动扫描策略
# 设置自动化扫描:镜像推送后自动触发扫描
curl -X PUT "$HARBOR_URL/api/v2.0/projects/my-app"
-u "$HARBOR_USER:$HARBOR_PASS"
-H "Content-Type: application/json"
-d '{"auto_scan": true}'
镜像签名(Notary)
# 1. 启用 Notary(需在 Harbor 部署时配置) # 2. 对镜像签名(需安装 docker content trust 相关工具) DOCKER_CONTENT_TRUST=1 DOCKER_CONTENT_TRUST_SERVER="$HARBOR_URL" docker pull my-app/my-app--api:v1.2.3 docker tag my-app/my-app--api:v1.2.3 harbor.mycompany.com/my-app/my-app--api:v1.2.3 docker push harbor.mycompany.com/my-app/my-app--api:v1.2.3 # 3. 验证签名 DOCKER_CONTENT_TRUST=1 docker pull harbor.mycompany.com/my-app/my-app--api:v1.2.3
机器人账号(Robot Account)
创建项目机器人账号
curl -X POST "$HARBOR_URL/api/v2.0/projects/my-app/robots"
-u "$HARBOR_USER:$HARBOR_PASS"
-H "Content-Type: application/json"
-d '{
"name": "ci-pipeline",
"description": "CI/CD流水线使用",
"access": [
{"resource": "/project/my-app/repository", "action": "push"},
{"resource": "/project/my-app/repository", "action": "pull"}
],
"expires_at": 0 # 永不过期
}'
CI 使用机器人账号
# 获取机器人 token(创建时返回的 credentials.secret)
docker login "$HARBOR_URL" -u "robot$my-app$ci-pipeline" -p "$ROBOT_TOKEN"
# Jenkinsfile / GitLab CI 示例
environment:
DOCKER_AUTH:
script: |
TOKEN=$(curl -s -u "robot$my-app$ci-pipeline:$ROBOT_SECRET"
"$HARBOR_URL/api/v2.0/robots/1/token" | jq -r '.token')
echo $TOKEN | docker login -u "robot$my-app$ci-pipeline" --password-stdin "$HARBOR_URL"
RBAC 权限管理
# 添加项目成员
curl -X POST "$HARBOR_URL/api/v2.0/projects/my-app/members"
-u "$HARBOR_USER:$HARBOR_PASS"
-H "Content-Type: application/json"
-d '{"member_user": {"username": "dev-user"}, "role_id": 2}' # 2=开发者
# 角色ID说明:1=项目管理员, 2=开发者, 3=访客, 4=维护者
Webhook
创建 Webhook
curl -X POST "$HARBOR_URL/api/v2.0/projects/my-app/webhook"
-u "$HARBOR_USER:$HARBOR_PASS"
-H "Content-Type: application/json"
-d '{
"name": "ci-trigger",
"targets": [{
"type": "http",
"address": "https://ci.mycompany.com/webhook/harbor",
"skip_cert_verify": true,
"auth_header": "Bearer xxxxx"
}],
"event_types": ["SCANNING_COMPLETED", "PUSH_ARTIFACT", "DELETE_ARTIFACT"]
}'
Webhook payload 示例:
{
"type": "PUSH_ARTIFACT",
"occur_at": 1700000000,
"artifact": {
"media_type": "application/vnd.docker.distribution.manifest.v2+json",
"digest": "sha256:abc123",
"tags": ["v1.2.3"]
},
"project": {"id": 1, "name": "my-app"},
"repository": {"name": "my-app--api"}
}
审计日志
# 查看项目审计日志 curl "$HARBOR_URL/api/v2.0/projects/my-app/logs?page=1&page_size=20" -u "$HARBOR_USER:$HARBOR_PASS" | jq '.' # 导出为 CSV curl "$HARBOR_URL/api/v2.0/projects/my-app/logs?page=1&page_size=100&sort=op_time_desc" -u "$HARBOR_USER:$HARBOR_PASS" | jq -r '.[] | [.op_time, .username, .resource, .operation] | @csv'
备份与恢复
备份(Harbor 数据)
# 备份清单(推荐 cron 定期执行) # refs: references/backup-recovery.md BACKUP_DIR="/data/harbor-backup" DATE=$(date +%Y%m%d_%H%M%S) # 1. 备份数据库 docker exec -t harbor-db pg_dump -U postgres registry > "$BACKUP_DIR/harbor-db-$DATE.sql" # 2. 备份核心配置(shared volume) tar czf "$BACKUP_DIR/harbor-config-$DATE.tar.gz" /data/harbor/redis /data/harbor/registry /data/harbor/trivy-adapter # 3. 上传至对象存储 # rclone sync "$BACKUP_DIR/" "s3:my-bucket/harbor-backups/" echo "备份完成: $DATE"
恢复
# 1. 停止 Harbor cd /opt/harbor && docker-compose down # 2. 恢复数据库 docker exec -i harbor-db psql -U postgres registry < "$BACKUP_DIR/harbor-db-$DATE.sql" # 3. 恢复配置文件 tar xzf "$BACKUP_DIR/harbor-config-$DATE.tar.gz" -C / # 4. 重启 Harbor docker-compose up -d
合规性检查
# 等保 2.0 / GDPR 检查项(详见 references/compliance.md) # 自动化检查脚本: python3 /root/.openclaw/workspace/skills/harbor-manager/scripts/compliance_check.py --harbor-url "$HARBOR_URL" --auth "$HARBOR_USER:$HARBOR_PASS" --standard " 等保2级" --output /tmp/harbor-compliance-report.html
检查项包括:
- ✅ 匿名访问是否关闭
- ✅ Robot Account 是否有过期设置
- ✅ 镜像扫描覆盖率
- ✅ CVE 漏洞是否在可接受阈值内
- ✅ 审计日志保留时长
- ✅ HTTPS 强制开启
- ✅ 密码策略配置
CI/CD 集成速查
| 工具 | 集成方式 |
|---|---|
| Jenkins | withCredentials([string(credentialsId: 'harbor', variable: 'HARBOR_TOKEN')]) + docker login |
| GitLab CI | image: docker:latest + before_script 登录 |
| GitHub Actions | uses: docker/login-action@v3 |
| Argo CD | Application YAML 中引用 Image Updater 或使用 Argo CD Image Updater |
| Tekton | Task 中用 dockerauth secret 登录后 docker push |
GitOps 配置管理
参考 references/gitops.md 了解更多 GitOps 工具与 Harbor 的集成方式。
参考文档
| 文件 | 内容 |
|---|---|
references/harbor-api.md |
完整 Harbor API v2.0 参考(认证、请求格式、错误码) |
references/cleanup-policy.md |
镜像清理策略详细规则与演练脚本 |
references/webhook.md |
Webhook 事件类型与 payload 格式说明 |
references/backup-recovery.md |
备份恢复详细步骤与灾难恢复预案 |
references/gitops.md |
GitOps 集成(Argo CD / Flux / Helm) |
references/compliance.md |
等保2.0 / GDPR 合规检查项说明 |
scripts/cleanup_dryrun.py |
清理演练脚本 |
scripts/compliance_check.py |
合规性检查脚本 |
scripts/robot_account.py |
机器人账号创建与轮换脚本 |
热门AI工具
相关专题
SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。
0
2026.11.17
SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。
0
2026.11.17
本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。
0
2026.11.12
本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.12
本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。
0
2026.11.12
本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。
0
2026.11.06
围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。
0
2026.11.06
详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。
0
2026.11.06
DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。
0
2026.11.05
热门下载
相关下载