4. 同步状态查看：Harbor UI中的同步任务列表、任务详情与执行日志、同步历史记录查询

镜像复制（Replication）是 Harbor 实现跨实例分发与灾备的核心能力。当复制规则配置完成后，运维人员需要频繁查看同步任务的执行状态、分析失败原因并追溯历史记录。本章聚焦 Harbor UI 中与同步状态查看相关的三个关键界面：任务列表、任务详情与执行日志、同步历史记录查询。

4.1 同步任务列表：全局状态总览

在 Harbor 左侧导航栏选择 “复制” → “任务”，即可进入同步任务列表页面。该页面以表格形式展示所有已触发的复制任务，是日常巡检的首选入口。

4.2 任务详情与执行日志：逐层下钻分析

点击任务列表中的任意任务 ID，进入任务详情页。该页面分为两个核心区域：任务概要 和 资源列表。

4.2.1 任务概要

展示该任务的完整元数据，包括规则配置快照、触发方式、执行节点、总耗时、最终状态等。运维人员可在此确认任务是否按照预期规则执行。

4.2.2 资源列表与执行日志

资源列表以表格形式展示每个待同步的镜像/Chart 的传输状态：

• 资源名称：如 library/nginx:1.25
• 状态：成功 / 失败 / 跳过
• 源端摘要：源仓库的镜像 digest
• 目标端摘要：目标仓库的镜像 digest（成功时显示）
• 错误信息：失败时的简要错误描述

点击资源行右侧的 “日志” 按钮，弹出该资源传输的详细执行日志。日志内容包含以下关键阶段：

2025-03-21 14:30:05 [INFO] 开始拉取镜像: library/nginx:1.25
2025-03-21 14:30:06 [INFO] 源端连接成功，获取 manifest
2025-03-21 14:30:08 [INFO] 开始传输层: sha256:abc123...
2025-03-21 14:30:10 [INFO] 层传输完成 (12.5 MB)
2025-03-21 14:30:11 [INFO] 开始传输层: sha256:def456...
2025-03-21 14:30:15 [ERROR] 层传输失败: 连接目标仓库超时 (30s)
2025-03-21 14:30:16 [INFO] 重试第 1 次...
2025-03-21 14:30:46 [ERROR] 重试第 1 次失败: 连接目标仓库超时 (30s)
2025-03-21 14:30:46 [ERROR] 资源传输失败，已达最大重试次数

4.3 同步历史记录查询：趋势分析与审计

Harbor 保留所有复制任务的执行历史，支持按时间范围、规则名称、状态等条件进行过滤查询。历史记录界面位于 “复制” → “历史”。

4.3.1 查询条件

• 时间范围：支持最近 1 小时、24 小时、7 天、自定义时间段。
• 规则名称：下拉选择特定复制规则。
• 状态：全部 / 成功 / 失败 / 运行中。
• 触发方式：手动 / 定时 / 事件驱动。

4.3.2 历史记录列表

查询结果以表格形式呈现，包含任务 ID、规则名称、状态、开始时间、结束时间、耗时、资源总数、成功数、失败数。支持按开始时间降序排列，便于快速定位最新任务。

4.3.3 历史趋势分析

通过分析历史记录，运维人员可以识别出以下模式：

4.4 同步状态查看流程总览

以下 SVG 图展示了从任务列表到日志分析的完整查看路径，帮助运维人员建立系统化的排查思路。

4.5 常见状态码与处理建议

在任务详情和日志中，Harbor 使用标准 HTTP 状态码表示传输结果。以下表格汇总了常见状态码及其含义：