arch-release-promotion 0.3.0.post0

Openmetrics

如果上游项目提供基于 openmetrics 的指标文件，则可以从其中使用数据作为 JSON 有效负载的附加信息。

以下指标被考虑。

# TYPE version_info info
# HELP version_info Package description and version information
version_info{name="my-package",description="Version of my-package used for build",version="1.0.0-1"} 1

"version_metrics": [
  {
    "name": "my-package",
    "description": "Version of my-package used for build",
    "version": "1.0.0-1"
  }
]

# TYPE artifact_bytes gauge
# HELP artifact_bytes Artifact sizes in Bytes
artifact_bytes{name="foo",description="Size of foo in MiB"} 832

"size_metrics": [
  {
    "name": "foo",
    "description": "Size of foo in MiB",
    "size": 832
  }
]

# TYPE data_count summary
# HELP data_count The amount of something used in some context
data_count{name="foo",description="The amount of packages in foo"} 369

"amount_metrics": [
  {
    "name": "foo",
    "description": "The amount of packages in foo",
    "amount": 369
  }
]

JSON有效负载

发布的推广包括一个或多个JSON有效负载，描述了发布中的每个发布类型。

{
  "amount_metrics": [
    {
      "name": "foo",
      "description": "The amount of packages in foo",
      "size": 369
    }
  ],
  "developer": "Foobar McFooface <foobar@mcfooface.com>",
  "files": ["something.txt", "something.txt.sig"],
  "name": "foo",
  "pgp_public_key": "SOMEONESPGPKEYID",
  "size_metrics": [
    {
      "name": "foo",
      "description": "Size of foo in MiB",
      "size": 832
    }
  ],
  "torrent_file": "foo-0.1.0.torrent",
  "version_metrics": [
    {
      "name": "my-package",
      "description": "Version of my-package used for build",
      "version": "1.0.0-1"
    }
  ],
  "version": "0.1.0"
}

• amount_metrics：一个描述某物数量的对象列表（可选）。列表取决于项目的配置是否定义了amount_metrics以及这些指标是否在特定发布版中可用。

• developer：推广（和可选地签名工件）的人员的全uid。

• files：发布类型中的文件列表。

• name：发布类型的名称。

• pgp_public_key：发布类型中签名文件的PGP密钥ID。

• size_metrics：一个描述某物大小的对象列表（可选）。列表取决于项目的配置是否定义了size_metrics以及这些指标是否在特定发布版中可用。

• torrent_file（可选）：为发布类型创建的种子文件的名称。值取决于发布类型的配置是否将create_torrent设置为True。

• version_metrics：一个描述某物版本的对象列表（可选）。列表取决于项目的配置是否定义了version_metrics以及这些指标是否在特定发布版中可用。

• version：发布类型的版本。

位置和清理

每个发布版本的每个发布类型都同步到一个本地目录。该目录和同步的发布版本的最大数量可以在全局或按项目进行配置。

sync_dir
├── example_a
│   ├── example_a-0.1.0
│   │   ├── foo.txt
│   │   └── foo.txt.sig
│   ├── example_a-0.1.0.json
│   ├── example_a-0.1.0.torrent
│   └── latest -> example_a-0.1.0
└── example_b
    ├── example_b-0.1.0
    │   ├── bar.txt
    │   └── bar.txt.sig
    ├── example_b-0.1.0.json
    ├── example_b-0.1.0.torrent
    └── latest -> example_b-0.1.0

创建一个指向每个发布类型的当前最新版本的latest符号链接。

任何不属于当前同步发布版本发布类型版本的文件和目录都将从同步目录中删除。

如果目标目录中的文件引入了更改（由于同步操作），可以在全局或按项目配置的文件中写入Unix时间戳（文件所在的目录必须存在）。

系统集成

对于基于systemd的系统，提供了示例systemd系统服务和定时器文件，位于examples/systemd/。提供的服务文件依赖于用户arch-release-sync，可能使用sysusers.d集成在examples/sysusers.d/中创建。