---
url: /zh/repo/annotations.md
description: |
  介绍仓库元数据功能， 支持为 Tag 和 Commit 存储键值对形式的注解数据， 并说明如何在页面查看以及通过 API 增删查元数据。
---
## 什么是元数据？

元数据是仓库提供的数据存储能力，支持为 Tag 和 Commit 存储键值对形式的注解信息。

## 存储形式

以 `key: value` 键值对形式存储，例如：Tag `v1.0.0` 的元数据：

```yaml
key1: value1
key2: value2
# ...
```

## 查看方式

* **Tag 元数据**：仓库 → Tag 或 Release 列表 → 详情 → 元数据（无数据时不展示）
* **Commit 元数据**：仓库 → Commit 列表 → 详情 → 元数据

> 目前页面仅支持查看，不支持增删改操作。

## 管理操作

可在云原生构建流水线中通过插件增删查元数据，
详见 [元数据插件](https://cnb.cool/cnb/plugins/cnbcool/annotations)。