讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

harbor skills

Polar Sponsor
爱发电 赞助
.NET 9.0

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工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

相关专题

更多
SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

0

2026.11.17

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

0

2026.11.17

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

0

2026.11.12

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

0

2026.11.12

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

0

2026.11.12

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

0

2026.11.06

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

0

2026.11.06

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Codex官方文档
Codex官方文档

共0课时 | 0人学习

QClaw产品手册
QClaw产品手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn