一、引言

在当今的软件开发与运维环境中，容器化技术已成为提升应用部署效率与灵活性的关键手段。Harbor作为一款开源的企业级Docker镜像仓库，凭借其强大的功能性和可扩展性，被广泛应用于各类企业的CI/CD流程中。然而，随着项目迭代加速，Harbor仓库中往往会积累大量老旧、不再使用的镜像，这些“僵尸”镜像不仅占用宝贵的存储空间，还可能影响仓库的性能和安全性。因此，合理删除Harbor仓库中的老镜像，成为优化资源利用、维护仓库健康的重要一环。

二、Harbor镜像仓库老镜像的危害

1. 存储空间浪费

老镜像长期占据仓库空间，导致新镜像存储受限，尤其是在存储资源有限的环境下，这一问题尤为突出。

2. 性能下降

大量无用镜像会增加仓库的索引负担，降低镜像检索速度，影响开发者的使用体验。

3. 安全风险

老旧镜像可能包含已知的安全漏洞，若未及时清理，可能成为攻击者的利用目标，威胁整个系统的安全。

三、Harbor镜像删除策略

1. 手动删除

（1）通过Harbor Web界面

• 步骤一：登录Harbor管理界面。
• 步骤二：导航至“项目”或“系统管理”下的“镜像仓库”。
• 步骤三：选择需要删除的镜像，点击“删除”按钮。
• 注意事项：手动删除需谨慎，确保删除的镜像不再被任何服务依赖。

（2）使用Harbor API

对于需要批量删除或自动化处理的场景，可以通过调用Harbor的RESTful API实现。

# 示例：使用curl删除特定镜像
curl -X DELETE -u "username:password" "https://harbor-server/api/v2.0/projects/{project_id}/repositories/{repository_name}/artifacts/{tag}"

• 参数说明：替换username:password为Harbor管理员凭据，harbor-server为Harbor服务器地址，{project_id}、{repository_name}和{tag}分别为项目ID、仓库名和镜像标签。

2. 自动删除策略

（1）设置镜像保留策略

Harbor支持通过配置镜像保留策略，自动删除超过指定时间或版本数的老镜像。

• 操作路径：进入“系统管理”->“垃圾回收”->“配置”，设置保留策略。
• 策略类型：
  • 按时间保留：如保留最近30天的镜像。
  • 按版本数保留：如每个仓库保留最新5个版本。

（2）利用Cron作业定期清理

对于更复杂的清理需求，可以编写脚本结合Cron作业实现定期自动清理。

# 示例脚本：使用Harbor CLI删除超过90天的镜像
#!/bin/bash
HARBOR_CLI_PATH="/path/to/harbor-cli"
HARBOR_URL="https://harbor-server"
HARBOR_USER="admin"
HARBOR_PASS="password"
# 获取所有项目
PROJECTS=$($HARBOR_CLI_PATH --url $HARBOR_URL --username $HARBOR_USER --password $HARBOR_PASS project list | awk '{print $2}' | tail -n +3)
for PROJECT in $PROJECTS; do
    # 获取每个项目的镜像列表，并过滤出超过90天的镜像
    IMAGES=$($HARBOR_CLI_PATH --url $HARBOR_URL --username $HARBOR_USER --password $HARBOR_PASS repository list $PROJECT | awk '{print $2}')
    for IMAGE in $IMAGES; do
        TAGS=$($HARBOR_CLI_PATH --url $HARBOR_URL --username $HARBOR_USER --password $HARBOR_PASS artifact list $PROJECT/$IMAGE | jq -r '.[] | select(.push_time < "'$(date -d "90 days ago" +%Y-%m-%dT%H:%M:%SZ)'") | .tag')
        for TAG in $TAGS; do
            $HARBOR_CLI_PATH --url $HARBOR_URL --username $HARBOR_USER --password $HARBOR_PASS artifact delete $PROJECT/$IMAGE:$TAG
        done
    done
done

• 说明：此脚本需安装harbor-cli及jq工具，并根据实际情况调整Harbor CLI路径、URL、用户名和密码。

四、最佳实践与建议

1. 定期审计：建立定期审计机制，检查并清理无用镜像。
2. 备份重要镜像：在删除前，确保已备份关键镜像，以防误删。
3. 权限控制：限制删除操作的权限，避免非授权人员误操作。
4. 日志记录：记录所有删除操作，便于追踪和审计。
5. 结合监控：利用监控工具实时监控仓库空间使用情况，及时触发清理流程。

五、结语

Harbor镜像仓库的老镜像管理是确保系统高效、安全运行的重要环节。通过合理的手动删除与自动删除策略，结合最佳实践，可以有效优化存储资源，提升仓库性能，降低安全风险。作为开发者或运维人员，应持续关注仓库状态，定期执行清理任务，为应用的稳定部署和快速迭代提供坚实保障。