第 20 章 使用 v2 UI

20.1. v2 用户界面配置

重要
  • 这个 UI 目前处于 beta 阶段,可能会有变化。在其当前状态中,用户只能创建、查看和删除机构、存储库和镜像标签。
  • 使用旧 UI 时,超时会话将要求用户在弹出窗口中再次输入密码。使用新的 UI 时,用户将返回到主页面,并需要输入其用户名和密码凭证。这是一个已知问题,并将在以后的新 UI 版本中解决。
  • 在传统 UI 和新 UI 之间如何报告镜像清单大小时,有一个差异。在传统 UI 中,镜像清单以兆字节为单位报告。v2 UI 使用标准定义兆字节(MB)来报告镜像清单大小。

流程

  1. 登录您的部署。
  2. 在部署的导航窗格中,您可以选择在 Current UINew UI 之间切换。点击切换按钮将其设置为新 UI,然后点 Use Beta Environment,例如:

    Red Hat Quay v2 UI toggle

20.1.1. 使用 v2 UI 创建新机构

先决条件

  • 您已将部署切换为使用 v2 UI。

使用以下步骤使用 v2 UI 创建机构。

流程

  1. 单击导航窗格中的 Organization
  2. 单击 Create Organization
  3. 输入 组织名称,例如 testorg
  4. Create

现在,您的示例组织应在 Organizations 页面下填充。

20.1.2. 使用 v2 UI 删除机构

使用以下步骤使用 v2 UI 删除机构。

流程

  1. Organizations 页面上,选择您要删除的机构的名称,如 testorg
  2. More Actions 下拉菜单。
  3. Delete

    注意

    Delete 页面中,有一个 搜索 输入框。有了此框,用户可以搜索特定的组织,以确保它们被正确地安排删除。例如,如果用户正在删除 10 个机构,并希望确保删除了一个特定的机构,他们可以使用 搜索 输入框确认机构标记为删除。

  4. 通过在框中输入 confirm 确认您要永久删除组织。
  5. Delete

    删除后,您将返回到 Organizations 页面。

    注意

    您可以通过选择多个机构,然后点 More ActionsDelete 一次删除多个机构。

20.1.3. 使用 v2 UI 创建新存储库

使用以下步骤使用 v2 UI 创建存储库。

流程

  1. 单击导航窗格上的 Repositories
  2. 单击 Create Repository
  3. 选择一个命名空间,如 quayadmin,然后输入 Repository name,如 testrepo

    重要

    不要在您的仓库名称中使用以下词语:* build * trigger * tag

    当这些词语用于存储库名称时,用户无法访问存储库,且无法永久删除存储库。尝试删除这些软件仓库会返回以下错误: Failed to delete repository <repository_name>, HTTP404 - Not Found。

  4. Create

    现在,您的示例存储库应在 Repositories 页面下填充。

20.1.4. 使用 v2 UI 删除存储库

先决条件

  • 您已创建了一个存储库。

流程

  1. 在 v2 UI 的 Repositories 页面中,单击您要删除的镜像的名称,如 quay/admin/busybox
  2. More Actions 下拉菜单。
  3. Delete

    注意

    如果需要,您可以点击 Make PublicMake Private

  4. 在框中键入 confirm,然后单击 Delete
  5. 删除后,您将返回到 Repositories 页面。

20.1.5. 将镜像推送到 v2 UI

使用以下步骤将镜像推送到 v2 UI。

流程

  1. 从外部 registry 拉取示例镜像:

    $ podman pull busybox
  2. 标记镜像:

    $ podman tag docker.io/library/busybox quay-server.example.com/quayadmin/busybox:test
  3. 将镜像推送到 registry:

    $ podman push quay-server.example.com/quayadmin/busybox:test
  4. 导航到 v2 UI 上的 Repositories 页面,并确保您的镜像已被正确推送。
  5. 您可以选择镜像标签来检查安全详情,然后导航到 Security Report 页面。

20.1.6. 使用 v2 UI 删除镜像

使用以下步骤通过 v2 UI 删除镜像。

先决条件

  • 您已将镜像推送到 registry。

流程

  1. 在 v2 UI 的 Repositories 页面中,单击您要删除的镜像的名称,如 quay/admin/busybox
  2. More Actions 下拉菜单。
  3. Delete

    注意

    如果需要,您可以点击 Make PublicMake Private

  4. 在框中键入 confirm,然后单击 Delete
  5. 删除后,您将返回到 Repositories 页面。

20.1.7. 使用 Red Hat Quay v2 UI 创建新团队

使用以下步骤使用 Red Hat Quay v2 UI 创建新团队。

先决条件

  • 您已创建了一个带有存储库的组织。

流程

  1. 在 Red Hat Quay v2 UI 上,点机构的名称。
  2. 在您的机构页面中,点 Teams 和 membership
  3. Create new team 复选框。
  4. Create team 弹出窗口中,为您的新团队提供一个名称。
  5. 可选。为您的新团队提供描述。
  6. 单击 Proceed。此时会出现一个新的弹出窗口。
  7. 可选。将此团队添加到存储库,并将权限设置为 ReadWriteAdminNone 之一。
  8. 可选。添加团队成员或机器人帐户。要添加团队成员,请输入其 Red Hat Quay 帐户的名称。
  9. 检查并填写信息,然后点 Review and Finish。新团队会出现在 Teams 和 membership 页面 下。在这里,您可以点 kebab 菜单并选择以下选项之一:

    • 管理团队成员.在此页面上,您可以查看所有成员、团队成员、机器人帐户或被邀请的用户。您还可以通过单击 Add new member 来添加新团队成员。
    • 设置存储库权限。在本页中,您可以将存储库权限设置为 ReadWriteAdminNone 之一。
    • 删除。此弹出窗口允许您通过单击 Delete 来删除团队。
  10. 可选。您可以点击以下选项之一来显示有关团队、成员和协作者的更多信息:

    • 团队视图.此菜单显示所有团队名称、成员数量、存储库数量以及每个团队的角色。
    • 成员视图.此菜单显示团队成员的所有用户名,以及他们所属的团队,以及用户的存储库权限。
    • collaborators View.此菜单显示存储库协作器。collaborator 是不属于机构中的任何团队的用户,但他们对属于该组织的一个或多个存储库具有直接权限。

20.1.8. 使用 v2 UI 创建机器人帐户

使用以下步骤,使用 v2 UI 创建机器人帐户。

流程

  1. 在 v2 UI 上,单击 Organizations
  2. 单击您要为其创建机器人帐户的组织名称,如 test-org
  3. Robot accounts 选项卡 → Create robot account
  4. Provide a name for your robot account 框中,输入名称,如 robot1
  5. 可选。如果需要,可以使用以下选项:

    1. 将机器人添加到团队。
    2. 将机器人添加到存储库。
    3. 调整机器人的权限。
  6. Review and finish 页面中,查看您提供的信息,然后点 Review and finish。此时会出现以下警报: Successfully created robot account with robot name: <organization_name> + <robot_name>.

    或者,如果您试图创建与另一个机器人帐户相同的机器人帐户,您可能会收到以下错误消息: Error create robot account

  7. 可选。您可以单击 ExpandCollapse 以显示有关机器人帐户的描述性信息。
  8. 可选。您可以点 kebab 菜单 → Set repository 权限来更改机器人帐户的权限。显示以下消息: Successfully updated repository 权限
  9. 可选。要删除您的机器人帐户,请选中机器人帐户的复选框,然后单击回收站图标。此时会出现弹出窗口。在文本框中键入 confirm,然后单击 Delete。或者,您可以点 kebab 菜单 → Delete。显示以下消息: Successfully deleted robot account.

20.1.8.1. 使用 Red Hat Quay v2 UI 批量管理机器人帐户存储库访问权限

使用以下步骤,使用 Red Hat Quay v2 UI 在批量、机器人帐户存储库访问中。

先决条件

  • 您已创建了机器人帐户。
  • 您已在单个机构中创建多个软件仓库。

流程

  1. 在 Red Hat Quay v2 UI 登录页面中,单击导航窗格中的 Organizations
  2. Organizations 页面上,选择具有多个存储库的组织的名称。单个机构下的存储库数量可在 Repo Count 列下找到。
  3. 在您的组织页面中,单击 Robot 帐户
  4. 对于将添加到多个存储库的机器人帐户,点 kebab 图标 → Set repository 权限
  5. Set repository permissions 页面上,选中机器人帐户要添加到的存储库的框。例如:

    Set repository permissions

  6. 设置机器人帐户的权限,如 NoneReadWriteAdmin
  7. 单击保存。显示 Success alert: Successfully updated repository 权限 的警报会出现在 Set repository permissions 页面中,确认更改。
  8. 返回到 OrganizationsRobot accounts 页面。现在,您的机器人帐户的 Repositories 列显示机器人帐户已添加到的存储库数量。

20.1.9. 使用 Red Hat Quay v2 UI 创建默认权限

默认权限定义在创建存储库时应自动授予的权限,除了存储库的默认创建者之外。根据创建存储库的用户分配权限。

使用以下步骤使用 Red Hat Quay v2 UI 创建默认权限。

流程

  1. 点机构的名称。
  2. 单击 Default permissions
  3. 单击 创建默认权限。此时会出现切换 drawer。
  4. 选择 AnyoneSpecific 用户,在创建存储库时创建默认权限。

    1. 如果选择 Anyone,则必须提供以下信息:

      • 应用到。搜索、邀请或添加用户/机器/团队。
      • 权限.将权限设置为 Read,Write, 或 Admin 之一。
    2. 如果选择特定用户,则必须提供以下信息:

      • 存储库创建者.提供用户或机器人帐户。
      • 应用到。提供用户名、机器人帐户或团队名称。
      • 权限.将权限设置为 Read,Write, 或 Admin 之一。
  5. Create default permissions。此时会出现确认框,返回以下警报: Successfully created default permissions for creator

20.1.10. v2 UI 的组织设置

使用以下步骤使用 v2 UI 更改您的机构设置。

流程

  1. 在 v2 UI 上,单击 Organizations
  2. 单击您要为其创建机器人帐户的组织名称,如 test-org
  3. Settings 选项卡。
  4. 可选。输入与机构关联的电子邮件地址。
  5. 可选。将 Time Machine 功能的分配时间设置为以下之一:

    • 1 周
    • 1 个月
    • 1 年
    • Never
  6. 点击 Save

20.1.11. 使用 v2 UI 查看镜像标签信息

使用以下步骤通过 v2 UI 查看镜像标签信息。

流程

  1. 在 v2 UI 上,单击 Repositories
  2. 点存储库的名称,例如 quayadmin/busybox
  3. 单击标签的名称,例如 test。您会进入标签的 Details 页面。该页面显示以下信息:

    • Name
    • 软件仓库
    • 摘要
    • 安全漏洞
    • 创建
    • modified
    • Size
    • 标签
    • 如何获取镜像标签
  4. 可选。点 Security Report 查看标签的漏洞。您可以扩展公告列以打开 CVE 数据。
  5. 可选。点 Packages 查看标签的软件包。
  6. 单击存储库的名称,如 busybox,以返回到 Tags 页面。
  7. 可选。将鼠标悬停在 Pull 图标上,以显示获取标签的方法。
  8. 选中标签框或多个标签,单击 Actions 下拉菜单,然后单击 Delete 以删除该标签。在弹出框中单击 Delete 来确认删除。

20.1.12. 使用 v2 UI 调整存储库设置

使用以下步骤使用 v2 UI 调整存储库的各种设置。

流程

  1. 在 v2 UI 上,单击 Repositories
  2. 点存储库的名称,例如 quayadmin/busybox
  3. Settings 选项卡。
  4. 可选。单击 User and robot permissions。您可以通过单击 权限 下的下拉菜单选项来调整用户或机器人帐户的设置。您可以将设置更改为 ReadWriteAdmin
  5. 可选。单击 Events 和 notification。您可以通过单击 Create Notification 来创建事件和通知。可用的事件选项如下:

    • 推送到存储库
    • 发现软件包漏洞
    • 镜像构建失败
    • 镜像构建已排队
    • 镜像构建已启动
    • 镜像构建成功
    • 镜像构建已取消

      然后,发出通知。可用的选项如下:

    • 电子邮件通知
    • Flowdock 团队通知
    • HipChat Room 通知
    • Slack 通知
    • Webhook POST

      选择事件选项和通知方法后,包括一个 Room ID #, a Room Notification Token,然后点 Submit

  6. 可选。单击 Repository visibility。您可以通过单击 Make Public 使存储库为私有或公共存储库。
  7. 可选。单击 Delete repository。您可以通过单击 Delete Repository 来删除存储库。