10.2. 使用 UI 创建通知
使用以下步骤添加通知。
先决条件
- 您已创建了软件仓库。
- 有存储库的管理特权。
流程
- 导航到 Red Hat Quay 上的存储库。
- 在导航窗格中,单击 Settings。
- 在 Events and Notifications 类别中,点 Create Notification 为存储库事件添加新通知。此时会出现 Create notification 弹出框。
在 Create repository 弹出窗口中,点 When this event occurs select a event。您可以为以下类型的事件选择通知:
- 推送到存储库
- 镜像构建失败
- 镜像构建已排队
- 镜像构建已启动
- 镜像构建成功
- 镜像构建已取消
- 镜像到期触发器
选择了事件类型后,选择 notification 方法。支持以下方法:
- Quay 通知
- 电子邮件通知
- Webhook POST
- Flowdock 团队通知
- HipChat Room 通知
Slack 通知
根据您选择的方法,您必须包含其他信息。例如,如果您选择 E-mail,则需要包含电子邮件地址和可选通知标题。
- 选择事件和通知方法后,单击 Create Notification。
10.2.1. 创建镜像过期通知
镜像过期事件触发器可以配置为通过电子邮件、Slack、webhook 等方式通知用户,并可在存储库级别进行配置。可以为在任意天数内过期的镜像设置触发器,并可与自动运行功能一起使用。
可以使用 Red Hat Quay v2 UI 或使用 createRepoNotification
API 端点来设置镜像过期通知。
先决条件
-
FEATURE_GARBAGE_COLLECTION: true
在config.yaml
文件中设置。 -
可选。
FEATURE_AUTO_PRUNE: true
在config.yaml
文件中设置。
流程
- 在 Red Hat Quay v2 UI 上,单击 Repositories。
- 选择存储库的名称。
-
点 Settings
Events and notifications。 - 单击 Create notification。此时会出现 Create notification 弹出框。
- 单击 Select event… 框,然后单击 Image expiry trigger。
-
在镜像以天为单位到期时,在您要接收警报时输入镜像过期前的天数。例如,在
1
天内使用 1。 在 Select method… 框中,点击以下之一:
- 电子邮件
- Webhook POST
- Flowdock 团队通知
- HipChat Room 通知
- Slack 通知
-
根据您选择的方法,包含必要的数据。例如,如果您选择 Webhook POST,请包含
Webhook URL
。 - 可选。提供 POST JSON 正文模板。
- 可选。为您的通知提供 标题。
- 点 Submit。您返回到 Events 和 notifications 页面,现在显示通知。
可选。您可以在 config.yaml 文件中设置
NOTIFICATION_TASK_RUN_MINIMUM_INTERVAL_MINUTES
变量。如果有任何过期镜像通知,则会自动发送。默认情况下,这设置为300
或 5 小时,但可调整为保证。NOTIFICATION_TASK_RUN_MINIMUM_INTERVAL_MINUTES: 300 1
- 1
- 默认情况下,此字段设置为
300
或 5 小时。
验证
点菜单 kebab
Test Notification。返回以下信息: Test Notification Queued A test version of this notification has been queued and should appear shortly
根据您选择的方法,检查您的电子邮件地址、webhook 地址、Slack 频道等。发送的信息应类似以下示例:
{ "repository": "sample_org/busybox", "namespace": "sample_org", "name": "busybox", "docker_url": "quay-server.example.com/sample_org/busybox", "homepage": "http://quay-server.example.com/repository/sample_org/busybox", "tags": [ "latest", "v1" ], "expiring_in": "1 days" }