使用 Red Hat Quay

步骤

1. 以超级用户身份登录 Red Hat Quay 存储库。
2. 在导航窗格中，选择您的帐户名称，然后单击 Super User Admin Panel。
3. 单击列中的 Users 图标。
4. 单击创建用户 按钮。
5. 输入新用户的用户名和电子邮件地址，然后单击 创建用户 按钮。

6. 您会被重定向到 Users 页面，其中现在还有另一个 Red Hat Quay 用户。

   注意

   您可能需要刷新 Users 页面来显示其他用户。

7. 在 Users 页面中，点与新用户关联的 Options cogwheel。此时会出现一个下拉菜单，如下图所示：

   

8. 单击 "更改密码 "。

9. 添加新密码，然后单击 Change User Password。

   新用户现在可以使用该用户名和密码通过 Web UI 或其首选容器客户端（如 Podman）登录。

步骤

1. 输入以下命令使用 POST /api/v1/superuser/users/ 端点来创建新用户：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST -H "Authorization: Bearer <bearer_token>" -H "Content-Type: application/json" -d '{
     "username": "newuser",
     "email": "newuser@example.com"
   }' "https://<quay-server.example.com>/api/v1/superuser/users/"

   输出示例

   Copy to Clipboard Toggle word wrap

   {"username": "newuser", "email": "newuser@example.com", "password": "123456789", "encrypted_password": "<example_encrypted_password>/JKY9pnDcsw="}

2. 导航到您的 Red Hat Quay registry 端点，如 quay-server.example.com，并使用从 API 调用生成的用户名和密码登录。在这种情况下，用户名是 newuser，密码则为 123456789。或者，您可以使用 CLI 登录 registry。例如：

   Copy to Clipboard Toggle word wrap

   $ podman login <quay-server.example.com>

   输出示例

   Copy to Clipboard Toggle word wrap

   username: newuser
   password: 123456789

3. 可选。您可以使用 GET /api/v1/superuser/users/ 端点获取所有用户（包括超级用户）的列表：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET -H "Authorization: Bearer <bearer_token>" "https://<quay-server.example.com>/api/v1/superuser/users/"

   注意

   如果 config.yaml 文件中设置了 AUTHENTICATION_TYPE: Database，GET /api/v1/superuser/users/ 端点才会返回用户和超级用户。它不适用于 LDAP 身份验证类型。

   输出示例

   Copy to Clipboard Toggle word wrap

   {"users": [{"kind": "user", "name": "quayadmin", "username": "quayadmin", "email": "quay@quay.com", "verified": true, "avatar": {"name": "quayadmin", "hash": "b28d563a6dc76b4431fc7b0524bbff6b810387dac86d9303874871839859c7cc", "color": "#17becf", "kind": "user"}, "super_user": true, "enabled": true}, {"kind": "user", "name": "newuser", "username": "newuser", "email": "newuser@example.com", "verified": true, "avatar": {"name": "newuser", "hash": "f338a2c83bfdde84abe2d3348994d70c34185a234cfbf32f9e323e3578e7e771", "color": "#9edae5", "kind": "user"}, "super_user": false, "enabled": true}]}

步骤

1. 以超级用户身份登录 Red Hat Quay 存储库。
2. 在导航窗格中，选择您的帐户名称，然后单击 Super User Admin Panel。
3. 单击导航窗格中的 Users 图标。
4. 点要删除的用户旁边的 Options cogwheel。
5. 单击 删除用户，然后单击 删除用户 进行确认。

步骤

1. 输入以下 DELETE /api/v1/superuser/users/{username} 命令，以从命令行删除用户：

   Copy to Clipboard Toggle word wrap

   $ curl -X DELETE -H "Authorization: Bearer <insert token here>" https://<quay-server.example.com>/api/v1/superuser/users/<username>

2. 从 CLI 删除用户时，CLI 不会返回信息。要确认删除操作，您可以通过进入到 Superuser Admin Panel → Users 或输入以下 GET /api/v1/superuser/users/ 命令来检查 Red Hat Quay UI。然后您可以检查是否存在它们。

   注意

   如果 config.yaml 文件中设置了 AUTHENTICATION_TYPE: Database，GET /api/v1/superuser/users/ 端点才会返回用户和超级用户。它不适用于 LDAP 身份验证类型。

   Copy to Clipboard Toggle word wrap

   $ curl -X GET -H "Authorization: Bearer <bearer_token>" "https://<quay-server.example.com>/api/v1/superuser/users/"

步骤

1. 登录到您的 Red Hat Quay registry。
2. 在导航窗格中，单击 Organization。
3. 单击 Create Organization。
4. 输入 组织名称，如 testorg。
5. 输入 机构电子邮件。
6. 点 Create。

步骤

1. 输入以下命令使用 POST /api/v1/organization/ 端点创建新机构：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST   -H "Authorization: Bearer <bearer_token>" -H "Content-Type: application/json"   -d '{
       "name": "<new_organization_name>"
     }'   "https://<quay-server.example.com>/api/v1/organization/"

   输出示例

   Copy to Clipboard Toggle word wrap

   "Created"

2. 创建后，可以更改机构详情，如添加电子邮件地址，带有 PUT /api/v1/organization/{orgname} 命令。例如：

   Copy to Clipboard Toggle word wrap

   $ curl -X PUT "https://<quay-server.example.com>/api/v1/organization/<orgname>" \
     -H "Authorization: Bearer <access_token>" \
     -H "Content-Type: application/json" \
     -d '{
           "email": "<org_email>",
           "invoice_email": <true/false>,
           "invoice_email_address": "<billing_email>"
         }'

   输出示例

   Copy to Clipboard Toggle word wrap

   {"name": "test", "email": "new-contact@test-org.com", "avatar": {"name": "test", "hash": "a15d479002b20f211568fd4419e76686d2b88a4980a5b4c4bc10420776c5f6fe", "color": "#aec7e8", "kind": "user"}, "is_admin": true, "is_member": true, "teams": {"owners": {"name": "owners", "description": "", "role": "admin", "avatar": {"name": "owners", "hash": "6f0e3a8c0eb46e8834b43b03374ece43a030621d92a7437beb48f871e90f8d90", "color": "#c7c7c7", "kind": "team"}, "can_view": true, "repo_count": 0, "member_count": 1, "is_synced": false}}, "ordered_teams": ["owners"], "invoice_email": true, "invoice_email_address": "billing@test-org.com", "tag_expiration_s": 1209600, "is_free_account": true, "quotas": [{"id": 2, "limit_bytes": 10737418240, "limits": [{"id": 1, "type": "Reject", "limit_percent": 90}]}], "quota_report": {"quota_bytes": 0, "configured_quota": 10737418240, "running_backfill": "complete", "backfill_status": "complete"}}

步骤

1. 在 v2 UI 上，单击 Organizations。
2. 单击您要为其创建机器人帐户的组织名称，如 test-org。
3. 点 Settings 选项卡。
4. 可选。输入与机构关联的电子邮件地址。

5. 可选。将 Time Machine 功能的分配时间设置为以下之一：

   • 几秒钟
   • 一天
   • 7 天
   • 14 天
   • 一个月
6. 点击 Save。

步骤

1. 在 Organizations 页面上，选择您要删除的组织的名称，如 testorg。
2. 点 More Actions 下拉菜单。

3. 点 Delete。

   注意

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

4. 通过在框中键入 确认，确认您要永久删除该机构。

5. 点 Delete。

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

   注意

   您可以通过选择多个机构，然后点击 More Actions → Delete 一次删除多个机构。

步骤

1. 输入以下命令使用 DELETE /api/v1/organization/{orgname} 端点删除机构：

   Copy to Clipboard Toggle word wrap

   $ curl -X DELETE \
     -H "Authorization: Bearer <bearer_token>" \
     "https://<quay-server.example.com>/api/v1/organization/<organization_name>"

2. 从 CLI 删除机构时，CLI 不会返回信息。要确认删除操作，您可以检查 Red Hat Quay UI，或者您可以输入 GET /api/v1/organization/{orgname} 命令来查看是否返回已删除机构的详情：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     "<quay-server.example.com>/api/v1/organization/<organization_name>"

   输出示例

   Copy to Clipboard Toggle word wrap

   {"detail": "Not Found", "error_message": "Not Found", "error_type": "not_found", "title": "not_found", "type": "http://<quay-server.example.com>/api/v1/error/not_found", "status": 404}

步骤

1. 单击导航窗格上的 Repositories。
2. 单击 Create Repository。

3. 选择一个命名空间，如 quayadmin，然后输入 Repository name，如 testrepo。

   重要

   不要在存储库名称中使用以下词语：* build * trigger * tag * notification

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

4. 点 Create。

   现在，您的 example 存储库应该在 Repositories 页面中填充。

5. 可选。点 Settings → Repository visibility → Make private 将存储库设置为私有。

步骤

1. 从示例 registry 中拉取示例页面。例如：

   Copy to Clipboard Toggle word wrap

   $ sudo podman pull busybox

   输出示例

   Copy to Clipboard Toggle word wrap

   Trying to pull docker.io/library/busybox...
   Getting image source signatures
   Copying blob 4c892f00285e done
   Copying config 22667f5368 done
   Writing manifest to image destination
   Storing signatures
   22667f53682a2920948d19c7133ab1c9c3f745805c14125859d20cede07f11f9

2. 使用新存储库和镜像名称标记本地系统上的镜像。例如：

   Copy to Clipboard Toggle word wrap

   $ sudo podman tag docker.io/library/busybox quay-server.example.com/quayadmin/busybox:test

3. 将镜像推送到 registry。在这一步后，您可以使用浏览器在存储库中查看标记的镜像。

   Copy to Clipboard Toggle word wrap

   $ sudo podman push --tls-verify=false quay-server.example.com/quayadmin/busybox:test

   输出示例

   Copy to Clipboard Toggle word wrap

   Getting image source signatures
   Copying blob 6b245f040973 done
   Copying config 22667f5368 done
   Writing manifest to image destination
   Storing signatures

步骤

1. 输入以下命令使用 POST /api/v1/repository 端点创建存储库：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     -d '{
       "repository": "<new_repository_name>",
       "visibility": "<private>",
       "description": "<This is a description of the new repository>."
     }' \
     "https://quay-server.example.com/api/v1/repository"

   输出示例

   Copy to Clipboard Toggle word wrap

   {"namespace": "quayadmin", "name": "<new_repository_name>", "kind": "image"}

步骤

1. 在 v2 UI 的 Repositories 页面上，选中您要删除的存储库的复选框，如 quayadmin/busybox。
2. 点 Actions 下拉菜单。
3. 点击 Delete。

4. 在框中键入 confirm，然后单击 Delete。

   删除后，您将返回到 Repositories 页面。

步骤

1. 输入以下命令使用 DELETE /api/v1/repository/{repository} 端点删除存储库：

   Copy to Clipboard Toggle word wrap

   $ curl -X DELETE   -H "Authorization: Bearer <bearer_token>" "<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>"

2. 从 CLI 删除存储库时，CLI 不会返回信息。要确认删除操作，您可以检查 Red Hat Quay UI，或者您可以输入以下 GET /api/v1/repository/{repository} 命令来查看是否返回已删除存储库的详情：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET -H "Authorization: Bearer <bearer_token>" "<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>"

   输出示例

   Copy to Clipboard Toggle word wrap

   {"detail": "Not Found", "error_message": "Not Found", "error_type": "not_found", "title": "not_found", "type": "http://quay-server.example.com/api/v1/error/not_found", "status": 404}

步骤

1. 在 v2 UI 上，单击 Organizations。
2. 单击您要为其创建机器人帐户的组织名称，如 test-org。
3. 点 Robot accounts 选项卡 → Create robot account。
4. 在 Provide a name for your robot account 框中，输入名称，如 robot1。您的 Robot 帐户的名称是您的用户名与机器人的名称的组合，如 quayadmin+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. 可选。您可以单击 Expand 或 Collapse 来显示有关机器人帐户的描述性信息。
8. 可选。您可以点击 kebab 菜单 → Set repository 权限来更改机器人帐户的权限。此时会出现以下信息： Successfully updated repository permission。

9. 可选。您可以点击机器人帐户的名称来获取以下信息：

   • 机器人帐户 ：选择此项获取机器人令牌。您可以点 Regenerate token 来重新 生成令牌。
   • Kubernetes Secret ：选择此项以 Kubernetes pull secret YAML 文件的形式下载凭证。
   • Podman: 选择它复制包含凭据的完整 podman login 命令行。
   • Docker Configuration ：选择此项复制包含凭据的完整 docker login 命令行。

步骤

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

5. 在 Set repository permissions 页面上，选中机器人帐户要添加到的存储库的框。例如：

   

6. 设置机器人帐户的权限，例如 None、Read、Write、Admin。
7. 单击保存。警告显示 Success alert: Successfully updated repository permission appears on Set repository permissions 页，确认更改。
8. 返回到 Organizations → Robot 帐户 页面。现在，机器人帐户的 Repositories 列会显示机器人帐户已添加到的存储库数量。

步骤

1. 更新 config.yaml 字段以添加 ROBOTS_DISALLOW 变量，例如：

   Copy to Clipboard Toggle word wrap

   ROBOTS_DISALLOW: true

2. 重启 Red Hat Quay 部署。

验证：创建新的机器人帐户

1. 导航到您的 Red Hat Quay 存储库。
2. 点存储库的名称。
3. 在导航窗格中，单击 Robot Accounts。
4. 单击 Create Robot Account。
5. 输入机器人帐户的名称，例如 < organization-name/username>+<robot-name >。
6. 单击 Create robot account 以确认创建。此时会出现以下信息：Cannot create robot account。机器人帐户已被禁用。请联系您的管理员。

验证：登录到机器人帐户

1. 在命令行界面(CLI)中，输入以下命令尝试作为机器人帐户登录：

   Copy to Clipboard Toggle word wrap

   $ podman login -u="<organization-name/username>+<robot-name>" -p="KETJ6VN0WT8YLLNXUJJ4454ZI6TZJ98NV41OE02PC2IQXVXRFQ1EJ36V12345678" <quay-server.example.com>

   返回以下出错信息：

   Copy to Clipboard Toggle word wrap

   Error: logging into "<quay-server.example.com>": invalid username/password

2. 您可以传递 log-level=debug 标志，以确认机器人帐户已被停用：

   Copy to Clipboard Toggle word wrap

   $ podman login -u="<organization-name/username>+<robot-name>" -p="KETJ6VN0WT8YLLNXUJJ4454ZI6TZJ98NV41OE02PC2IQXVXRFQ1EJ36V12345678" --log-level=debug <quay-server.example.com>

   Copy to Clipboard Toggle word wrap

   ...
   DEBU[0000] error logging into "quay-server.example.com": unable to retrieve auth token: invalid username/password: unauthorized: Robot accounts have been disabled. Please contact your administrator.

流程

1. 登录到您的 Red Hat Quay registry：
2. 单击具有机器人帐户的组织名称。
3. 单击 Robot accounts。
4. 选中要删除的机器人帐户的框。
5. 点 kebab 菜单。
6. 点击 Delete。
7. 在文本框中键入 confirm，然后单击 Delete。

流程

1. 输入以下命令，使用 DELETE /api/v1/organization/{orgname}/robots/{robot_shortname} 端点删除机构的机器人帐户：

   Copy to Clipboard Toggle word wrap

   curl -X DELETE \
     -H "Authorization: Bearer <bearer_token>" \
     "<quay-server.example.com>/api/v1/organization/<organization_name>/robots/<robot_shortname>"

2. 在使用 API 删除机器人帐户时，CLI 不会返回信息。要确认删除操作，您可以检查 Red Hat Quay UI，或者您可以输入以下 GET /api/v1/organization/{orgname}/robots 命令，以查看是否为机器人帐户返回详情：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET   -H "Authorization: Bearer <bearer_token>"   "https://<quay-server.example.com>/api/v1/organization/<organization_name>/robots"

   输出示例

   Copy to Clipboard Toggle word wrap

   {"robots": []}

3. 输入以下命令，使用 DELETE /api/v1/user/robots/{robot_shortname} 端点删除当前用户的机器人帐户：

   Copy to Clipboard Toggle word wrap

   $ curl -X DELETE \
     -H "Authorization: Bearer <bearer_token>" \
     "<quay-server.example.com>/api/v1/user/robots/<robot_shortname>"

4. 在使用 API 删除当前用户的机器人帐户时，CLI 不会返回信息。要确认删除操作，您可以检查 Red Hat Quay UI，或者您可以输入以下 GET /api/v1/user/robots/{robot_shortname} 命令，以查看是否为机器人帐户返回详情：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     "<quay-server.example.com>/api/v1/user/robots/<robot_shortname>"

   输出示例

   Copy to Clipboard Toggle word wrap

   {"message":"Could not find robot with specified username"}

步骤

1. 点机构的名称。
2. 单击 Default permissions。
3. 单击 Create default permissions。此时会出现 toggle drawer。

4. 选择 Anyone 或 Specific 用户，以在创建存储库时创建默认权限。

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

      • 应用到。搜索、邀请或添加用户/机器人/团队。
      • 权限.将权限设置为 Read、Write 或 Admin 之一。

   2. 如果选择特定用户，则必须提供以下信息：

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

步骤

1. 输入以下命令使用 POST /api/v1/organization/{orgname}/prototypes 端点创建默认权限：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST   -H "Authorization: Bearer <bearer_token>"   -H "Content-Type: application/json"   --data '{
       "role": "<admin_read_or_write>",
       "delegate": {
         "name": "<username>",
         "kind": "user"
       },
       "activating_user": {
         "name": "<robot_name>"
       }
     }'   https://<quay-server.example.com>/api/v1/organization/<organization_name>/prototypes

   输出示例

   Copy to Clipboard Toggle word wrap

   {"activating_user": {"name": "test-org+test", "is_robot": true, "kind": "user", "is_org_member": true, "avatar": {"name": "test-org+test", "hash": "aa85264436fe9839e7160bf349100a9b71403a5e9ec684d5b5e9571f6c821370", "color": "#8c564b", "kind": "robot"}}, "delegate": {"name": "testuser", "is_robot": false, "kind": "user", "is_org_member": false, "avatar": {"name": "testuser", "hash": "f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a", "color": "#6b6ecf", "kind": "user"}}, "role": "admin", "id": "977dc2bc-bc75-411d-82b3-604e5b79a493"}

2. 输入以下命令，使用 PUT /api/v1/organization/{orgname}/prototypes/{prototypeid} 端点更新默认权限，例如，如果要更改权限类型。您必须包含创建策略时返回的 ID。

   Copy to Clipboard Toggle word wrap

   $ curl -X PUT \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     --data '{
       "role": "write"
     }' \
     https://<quay-server.example.com>/api/v1/organization/<organization_name>/prototypes/<prototypeid>

   输出示例

   Copy to Clipboard Toggle word wrap

   {"activating_user": {"name": "test-org+test", "is_robot": true, "kind": "user", "is_org_member": true, "avatar": {"name": "test-org+test", "hash": "aa85264436fe9839e7160bf349100a9b71403a5e9ec684d5b5e9571f6c821370", "color": "#8c564b", "kind": "robot"}}, "delegate": {"name": "testuser", "is_robot": false, "kind": "user", "is_org_member": false, "avatar": {"name": "testuser", "hash": "f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a", "color": "#6b6ecf", "kind": "user"}}, "role": "write", "id": "977dc2bc-bc75-411d-82b3-604e5b79a493"}

3. 您可以通过输入 DELETE /api/v1/organization/{orgname}/prototypes/{prototypeid} 命令删除权限：

   Copy to Clipboard Toggle word wrap

   curl -X DELETE \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/organization/<organization_name>/prototypes/<prototype_id>

   此命令不会返回输出。您可以通过输入 GET /api/v1/organization/{orgname}/prototypes 命令来获取所有权限的列表：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/organization/<organization_name>/prototypes

   输出示例

   Copy to Clipboard Toggle word wrap

   {"prototypes": []}

步骤

1. 登录到 Red Hat Quay。
2. 在 v2 UI 上，单击 Repositories。
3. 单击存储库的名称，如 quayadmin/busybox。
4. 点 Settings 选项卡。

5. 可选。单击 User and robot permissions。您可以通过单击 权限 下的下拉菜单选项来调整用户或机器人帐户的设置。您可以将设置更改为 Read、Write 或 Admin。

   • 读取.用户或 Robot 帐户可以从存储库查看和拉取。
   • 写入。用户或 Robot 帐户可以从中读取（提取）并将其写入（推送）到存储库。
   • 管理.用户或 Robot 帐户有权访问从存储库拉取并推送到存储库，以及执行与存储库关联的管理任务。

步骤

1. 输入以下 PUT /api/v1/repository/{repository}/permissions/user/{username} 命令更改用户权限：

   Copy to Clipboard Toggle word wrap

   $ curl -X PUT \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     -d '{"role": "admin"}' \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository>/permissions/user/<username>

   输出示例

   Copy to Clipboard Toggle word wrap

   {"role": "admin", "name": "quayadmin+test", "is_robot": true, "avatar": {"name": "quayadmin+test", "hash": "ca9afae0a9d3ca322fc8a7a866e8476dd6c98de543decd186ae090e420a88feb", "color": "#8c564b", "kind": "robot"}}

2. 要删除当前权限，您可以输入 DELETE /api/v1/repository/{repository}/permissions/user/{username} 命令：

   Copy to Clipboard Toggle word wrap

   $ curl -X DELETE \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository>/permissions/user/<username>

   此命令不会返回 CLI 中的任何输出。反之，您可以通过输入 GET /api/v1/repository/{repository}/permissions/user/ 命令来检查权限是否已删除：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository>/permissions/user/<username>/

   输出示例

   Copy to Clipboard Toggle word wrap

   {"message":"User does not have permission for repo."}

步骤

1. 在 v2 UI 上，单击 Repositories。
2. 点存储库的名称。

3. 点标签的名称。您会进入该标签的 Details 页面。该页面显示以下信息：

   • Name
   • 软件仓库
   • 摘要
   • 安全漏洞
   • 创建
   • 修改
   • Size
   • 标签
   • 如何获取镜像标签
4. 点 Security Report 查看标签的漏洞。您可以扩展公告列来打开 CVE 数据。
5. 点 Packages 查看标签的软件包。
6. 单击存储库的名称，以返回到 Tags 页面。

步骤

1. 要获取标签信息，您必须使用 GET /api/v1/repository/{repository} API 端点并传递 includeTags 参数。例如：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>?includeTags=true

   输出示例

   Copy to Clipboard Toggle word wrap

   {"namespace": "quayadmin", "name": "busybox", "kind": "image", "description": null, "is_public": false, "is_organization": false, "is_starred": false, "status_token": "d8f5e074-690a-46d7-83c8-8d4e3d3d0715", "trust_enabled": false, "tag_expiration_s": 1209600, "is_free_account": true, "state": "NORMAL", "tags": {"example": {"name": "example", "size": 2275314, "last_modified": "Tue, 14 May 2024 14:48:51 -0000", "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d"}, "test": {"name": "test", "size": 2275314, "last_modified": "Tue, 14 May 2024 14:04:48 -0000", "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d"}}, "can_write": true, "can_admin": true}

2. 或者，您可以使用 GET /api/v1/repository/{repository}/tag/ 端点。例如：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/tag/

   输出示例

   Copy to Clipboard Toggle word wrap

   {"tags": [{"name": "test-two", "reversion": true, "start_ts": 1718737153, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 18 Jun 2024 18:59:13 -0000"}, {"name": "test-two", "reversion": false, "start_ts": 1718737029, "end_ts": 1718737153, "manifest_digest": "sha256:0cd3dd6236e246b349e63f76ce5f150e7cd5dbf2f2f1f88dbd734430418dbaea", "is_manifest_list": false, "size": 2275317, "last_modified": "Tue, 18 Jun 2024 18:57:09 -0000", "expiration": "Tue, 18 Jun 2024 18:59:13 -0000"}, {"name": "test-two", "reversion": false, "start_ts": 1718737018, "end_ts": 1718737029, "manifest_digest": "sha256:0cd3dd6236e246b349e63f76ce5f150e7cd5dbf2f2f1f88dbd734430418dbaea", "is_manifest_list": false, "size": 2275317, "last_modified": "Tue, 18 Jun 2024 18:56:58 -0000", "expiration": "Tue, 18 Jun 2024 18:57:09 -0000"}, {"name": "sample_tag", "reversion": false, "start_ts": 1718736147, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 18 Jun 2024 18:42:27 -0000"}, {"name": "test-two", "reversion": false, "start_ts": 1717680780, "end_ts": 1718737018, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Thu, 06 Jun 2024 13:33:00 -0000", "expiration": "Tue, 18 Jun 2024 18:56:58 -0000"}, {"name": "tag-test", "reversion": false, "start_ts": 1717680378, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Thu, 06 Jun 2024 13:26:18 -0000"}, {"name": "example", "reversion": false, "start_ts": 1715698131, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:48:51 -0000"}], "page": 1, "has_additional": false}

步骤

1. 在 Red Hat Quay v2 UI 仪表板上，单击导航窗格中的 Repositories。
2. 单击具有镜像标签的存储库的名称。
3. 单击菜单 kebab，然后单击 Add new tag。

4. 输入标签的名称，然后单击 Create tag。

   新标签现在列在 Repository Tags 页面中。

步骤

1. 您可以使用 PUT /api/v1/repository/{repository}/tag/{tag} 命令更改标签指向或创建新标签：

   Copy to Clipboard Toggle word wrap

   $ curl -X PUT \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     --data '{
       "manifest_digest": "<manifest_digest>"
     }' \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/tag/<tag>

   输出示例

   Copy to Clipboard Toggle word wrap

   "Updated"

2. 您可以使用 POST /api/v1/repository/{repository}/tag/{tag}/restore 命令将存储库标签恢复到以前的镜像。例如：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     --data '{
       "manifest_digest": <manifest_digest>
     }' \
     quay-server.example.com/api/v1/repository/quayadmin/busybox/tag/test/restore

   输出示例

   Copy to Clipboard Toggle word wrap

   {}

3. 要在创建新标签后查看标签列表，您可以使用 GET /api/v1/repository/{repository}/tag/ 命令。例如：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
      https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/tag

   输出示例

   Copy to Clipboard Toggle word wrap

   {"tags": [{"name": "test", "reversion": false, "start_ts": 1716324069, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 21 May 2024 20:41:09 -0000"}, {"name": "example", "reversion": false, "start_ts": 1715698131, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:48:51 -0000"}, {"name": "example", "reversion": false, "start_ts": 1715697708, "end_ts": 1715698131, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:41:48 -0000", "expiration": "Tue, 14 May 2024 14:48:51 -0000"}, {"name": "test", "reversion": false, "start_ts": 1715695488, "end_ts": 1716324069, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:04:48 -0000", "expiration": "Tue, 21 May 2024 20:41:09 -0000"}, {"name": "test", "reversion": false, "start_ts": 1715631517, "end_ts": 1715695488, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Mon, 13 May 2024 20:18:37 -0000", "expiration": "Tue, 14 May 2024 14:04:48 -0000"}], "page": 1, "has_additional": false}

步骤

1. 在 v2 UI 控制面板上，单击导航窗格中的 Repositories。
2. 单击具有镜像标签的存储库的名称。
3. 点镜像菜单 kebab，然后选择 Edit labels。
4. 在 Edit labels 窗口中，单击 Add new label。

5. 使用 key=value 格式输入镜像标签的标签，例如 com.example.release-date=2023-11-14。

   注意

   当无法使用 key=value 格式时返回以下错误： Invalid label format, must be key value by =.

6. 单击框的空格以添加标签。
7. 可选。添加第二个标签。
8. 点 Save labels 将标签保存到镜像标签。返回以下通知： 成功创建标签。
9. 可选。点击标签上的同一镜像标签菜单 kebab → Edit labels → X 将其删除；或者，您可以编辑文本。点 Save labels。现在，标签已被删除或编辑。

步骤

1. 使用 GET /api/v1/repository/{repository}/manifest/{manifestref} 命令检索存储库中特定清单的详细信息：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/repository/<repository>/manifest/<manifestref>

2. 使用 GET /api/v1/repository/{repository}/manifest/{manifestref}/labels 命令检索特定清单的标签列表：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/repository/<repository>/manifest/<manifestref>/labels

   输出示例

   Copy to Clipboard Toggle word wrap

   {"labels": [{"id": "e9f717d2-c1dd-4626-802d-733a029d17ad", "key": "org.opencontainers.image.url", "value": "https://github.com/docker-library/busybox", "source_type": "manifest", "media_type": "text/plain"}, {"id": "2d34ec64-4051-43ad-ae06-d5f81003576a", "key": "org.opencontainers.image.version", "value": "1.36.1-glibc", "source_type": "manifest", "media_type": "text/plain"}]}

3. 使用 GET /api/v1/repository/{repository}/manifest/{manifestref}/labels/{labelid} 命令获取有关特定清单的信息：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
     https://<quay-server.example.com>/api/v1/repository/<repository>/manifest/<manifestref>/labels/<label_id>

   输出示例

   Copy to Clipboard Toggle word wrap

   {"id": "e9f717d2-c1dd-4626-802d-733a029d17ad", "key": "org.opencontainers.image.url", "value": "https://github.com/docker-library/busybox", "source_type": "manifest", "media_type": "text/plain"}

4. 您可以使用 POST /api/v1/repository/{repository}/manifest/{manifestref}/labels 命令在给定存储库中向清单添加额外标签。例如：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     --data '{
       "key": "<key>",
       "value": "<value>",
       "media_type": "<media_type>"
     }' \
     https://<quay-server.example.com>/api/v1/repository/<repository>/manifest/<manifestref>/labels

   输出示例

   Copy to Clipboard Toggle word wrap

   {"label": {"id": "346593fd-18c8-49db-854f-4cb1fb76ff9c", "key": "example-key", "value": "example-value", "source_type": "api", "media_type": "text/plain"}}

5. 您可以使用 DELETE /api/v1/repository/{repository}/manifest/{manifestref}/labels/{labelid} 命令删除标签：

   Copy to Clipboard Toggle word wrap

   $ curl -X DELETE \
     -H "Authorization: Bearer <bearer_token>" \
     https://<quay-server.example.com>/api/v1/repository/<repository>/manifest/<manifestref>/labels/<labelid>

   此命令不会在 CLI 中返回输出。您可以使用以上其中一个命令来确保它已被成功删除。

步骤

1. 导航到存储库的 Tags 页面。
2. 在 清单 下，单击 Fetch Tag 图标。

3. 当出现弹出窗口时，用户会显示以下选项：

   • podman Pull （按标签）
   • Docker Pull （通过标签）
   • podman Pull （按摘要）

   • Docker Pull （按摘要）

     选择任何四个选项之一可返回相应客户端的命令，供用户拉取(pull)镜像。

4. 单击 Copy Command 以复制该命令，该命令可用于命令行界面(CLI)。例如：

   Copy to Clipboard Toggle word wrap

   $ podman pull quay-server.example.com/quayadmin/busybox:test2

步骤

1. 在 Red Hat Quay v2 UI 仪表板上，单击导航窗格中的 Repositories。
2. 单击具有镜像标签的存储库的名称。

3. 单击 Tag History。在这个页面中，您可以执行以下操作：

   • 按标签名称搜索
   • 选择一个日期范围
   • 查看标签更改
   • 查看标签修改日期以及更改的时间

步骤

1. 使用以下命令，使用 GET /api/v1/repository/{repository}/tag/ 命令查看标签历史记录，并传递以下查询之一：

   • onlyActiveTags=<true/false&gt; : Filters to only include active tags。
   • page=<number > : 指定要检索的结果页数。
   • limit=<number > : 限制每个页面的结果数。

   • specificTag=<tag_name > ：过滤标签，使其只包含具有指定名称的标签。

     Copy to Clipboard Toggle word wrap

     $ curl -X GET \
       -H "Authorization: Bearer <bearer_token>" \
       -H "Accept: application/json" \
       "https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository>/tag/?onlyActiveTags=true&page=1&limit=10"

     输出示例

     Copy to Clipboard Toggle word wrap

     {"tags": [{"name": "test-two", "reversion": false, "start_ts": 1717680780, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Thu, 06 Jun 2024 13:33:00 -0000"}, {"name": "tag-test", "reversion": false, "start_ts": 1717680378, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Thu, 06 Jun 2024 13:26:18 -0000"}, {"name": "example", "reversion": false, "start_ts": 1715698131, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:48:51 -0000"}], "page": 1, "has_additional": false}

2. 通过使用 specificTag=<tag_name > 查询，您可以过滤特定标签的结果。例如：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET   -H "Authorization: Bearer <bearer_token>"   -H "Accept: application/json"   "<quay-server.example.com>/api/v1/repository/quayadmin/busybox/tag/?onlyActiveTags=true&page=1&limit=20&specificTag=test-two"

   输出示例

   Copy to Clipboard Toggle word wrap

   {"tags": [{"name": "test-two", "reversion": true, "start_ts": 1718737153, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 18 Jun 2024 18:59:13 -0000"}], "page": 1, "has_additional": false}

步骤

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

3. 点 Delete。

   注意

   如果需要，您可以单击 Make Public 或 Make Private。

4. 在框中键入 confirm，然后单击 Delete。

5. 删除后，您将返回到 Repositories 页面。

   注意

   根据分配给 时间机器 功能的时间量，可以恢复镜像标签。如需更多信息，请参阅"恢复标签更改"。

步骤

1. 您可以使用 DELETE /api/v1/repository/{repository}/tag/{tag} 命令删除镜像标签：

   Copy to Clipboard Toggle word wrap

   $ curl -X DELETE \
     -H "Authorization: Bearer <bearer_token>" \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/tag/<tag>

   此命令不会在 CLI 中返回输出。继续下一步，以返回标签列表。

2. 要在删除标签后查看标签列表，您可以使用 GET /api/v1/repository/{repository}/tag/ 命令。例如：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
      https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/tag

   输出示例

   Copy to Clipboard Toggle word wrap

   {"tags": [{"name": "test", "reversion": false, "start_ts": 1716324069, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 21 May 2024 20:41:09 -0000"}, {"name": "example", "reversion": false, "start_ts": 1715698131, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:48:51 -0000"}, {"name": "example", "reversion": false, "start_ts": 1715697708, "end_ts": 1715698131, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:41:48 -0000", "expiration": "Tue, 14 May 2024 14:48:51 -0000"}, {"name": "test", "reversion": false, "start_ts": 1715695488, "end_ts": 1716324069, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:04:48 -0000", "expiration": "Tue, 21 May 2024 20:41:09 -0000"}, {"name": "test", "reversion": false, "start_ts": 1715631517, "end_ts": 1715695488, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Mon, 13 May 2024 20:18:37 -0000", "expiration": "Tue, 14 May 2024 14:04:48 -0000"}], "page": 1, "has_additional": false}

步骤

1. 在 v2 UI 的 Repositories 页面上，单击您要恢复的镜像的名称。
2. 单击 Tag History 选项卡。
3. 在时间表中找到镜像标签已更改或删除的时间点。接下来，单击 Revert 下的选项，将标签恢复到其镜像。

步骤

1. 您可以使用 POST /api/v1/repository/{repository}/tag/{tag}/restore 命令将存储库标签恢复到以前的镜像。例如：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     --data '{
       "manifest_digest": <manifest_digest>
     }' \
     quay-server.example.com/api/v1/repository/quayadmin/busybox/tag/test/restore

   输出示例

   Copy to Clipboard Toggle word wrap

   {}

2. 要在恢复旧标签后查看标签列表，您可以使用 GET /api/v1/repository/{repository}/tag/ 命令。例如：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Accept: application/json" \
      https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/tag

   输出示例

   Copy to Clipboard Toggle word wrap

   {"tags": [{"name": "test", "reversion": false, "start_ts": 1716324069, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 21 May 2024 20:41:09 -0000"}, {"name": "example", "reversion": false, "start_ts": 1715698131, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:48:51 -0000"}, {"name": "example", "reversion": false, "start_ts": 1715697708, "end_ts": 1715698131, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:41:48 -0000", "expiration": "Tue, 14 May 2024 14:48:51 -0000"}, {"name": "test", "reversion": false, "start_ts": 1715695488, "end_ts": 1716324069, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Tue, 14 May 2024 14:04:48 -0000", "expiration": "Tue, 21 May 2024 20:41:09 -0000"}, {"name": "test", "reversion": false, "start_ts": 1715631517, "end_ts": 1715695488, "manifest_digest": "sha256:57583a1b9c0a7509d3417387b4f43acf80d08cdcf5266ac87987be3f8f919d5d", "is_manifest_list": false, "size": 2275314, "last_modified": "Mon, 13 May 2024 20:18:37 -0000", "expiration": "Tue, 14 May 2024 14:04:48 -0000"}], "page": 1, "has_additional": false}

步骤

1. 登录到您的 Red Hat Quay registry。
2. 导航到您作为管理员的机构、存储库或命名空间。

3. 点 Logs。

   

4. 可选。通过向 From 和 To box 添加日期来设置查看日志条目的日期范围。
5. 可选。单击导出，以导出日志。您必须输入一个电子邮件地址或以 http:// 或 https:// 开头的有效回调 URL。这个过程可能需要一小时，具体取决于存在的日志数量。

步骤

1. 选择具有管理员特权的存储库。
2. 点 Logs 选项卡。
3. 可选。如果要指定特定的日期，请在 From 和 to box 中输入范围。

4. 点 Export Logs 按钮。此时会出现 Export Usage Logs 弹出窗口，如下所示

   

5. 输入电子邮件地址或回调 URL 以接收导出的日志。对于回调 URL，您可以使用指定域的 URL，例如 <webhook.site>。
6. 选择 Confirm 以开始收集所选日志条目的流程。根据收集的日志记录数据量，这可能需要几分钟到几小时才能完成。

7. 当日志导出完成后，会出现以下两个事件之一：

   • 收到一封电子邮件，提醒您所请求的导出日志条目的可用警报。
   • 返回来自 webhook URL 的日志导出请求的成功状态。此外，您也提供了一个到导出数据的链接，供您删除以下载日志。

步骤

1. 使用 POST /api/v1/user/exportlogs 端点为当前用户导出日志：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{
           "starttime": "<MM/DD/YYYY>",
           "endtime": "<MM/DD/YYYY>",
           "callback_email": "your.email@example.com"
         }' \
     "http://<quay-server.example.com>/api/v1/user/exportlogs"

   输出示例

   Copy to Clipboard Toggle word wrap

   {"export_id": "6a0b9ea9-444c-4a19-9db8-113201c38cd4"}

2. 使用 POST /api/v1/organization/{orgname}/exportlogs 端点导出机构的日志：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{
           "starttime": "<MM/DD/YYYY>",
           "endtime": "<MM/DD/YYYY>",
           "callback_email": "org.logs@example.com"
         }' \
     "http://<quay-server.example.com>/api/v1/organization/{orgname}/exportlogs"

3. 使用 POST /api/v1/repository/{repository}/exportlogs 端点导出存储库的日志：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{
           "starttime": "2024-01-01",
           "endtime": "2024-06-18",
           "callback_url": "http://your-callback-url.example.com"
         }' \
     "http://<quay-server.example.com>/api/v1/repository/{repository}/exportlogs"

步骤

1. 导航到存储库，再单击导航窗格中的 Tags。此页面显示安全扫描的结果。
2. 要显示有关多架构镜像的更多信息，请点 Child Manifests 以查看扩展视图中的清单列表。
3. 单击 See Child Manifests 下的相关链接，例如，1 Unknown 以重定向到 Security Scanner 页面。
4. Security Scanner 页面提供了标签的信息，如镜像的 CVE 易受影响，以及您可能可用的补救选项。

步骤

1. 导航到 Red Hat Quay 上的存储库。
2. 在导航窗格中，单击 Settings。
3. 在 Events and Notifications 类别中，点 Create Notification 为存储库事件添加新通知。此时会出现 Create notification 弹出框。

4. 在 Create repository 弹出窗口中，点 When this event occurs select a event。您可以为以下类型的事件选择通知：

   • 推送到存储库
   • 镜像构建失败
   • 镜像构建已排队
   • 镜像构建已启动
   • 镜像构建成功
   • 镜像构建已取消
   • 镜像到期触发器

5. 选择了事件类型后，选择 notification 方法。支持以下方法：

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

   • Slack 通知

     根据您选择的方法，您必须包含其他信息。例如，如果您选择 E-mail，则需要包含电子邮件地址和可选通知标题。

6. 选择事件和通知方法后，单击 Create Notification。

步骤

1. 输入以下 POST /api/v1/repository/{repository}/notification 命令在存储库上创建通知：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST \
     -H "Authorization: Bearer <bearer_token>" \
     -H "Content-Type: application/json" \
     --data '{
       "event": "<event>",
       "method": "<method>",
       "config": {
         "<config_key>": "<config_value>"
       },
       "eventConfig": {
         "<eventConfig_key>": "<eventConfig_value>"
       }
     }' \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/notification/

   此命令不会在 CLI 中返回输出。相反，您可以输入以下 GET /api/v1/repository/{repository}/notification/{uuid} 命令来获取有关存储库通知的信息：

   Copy to Clipboard Toggle word wrap

   {"uuid": "240662ea-597b-499d-98bb-2b57e73408d6", "title": null, "event": "repo_push", "method": "quay_notification", "config": {"target": {"name": "quayadmin", "kind": "user", "is_robot": false, "avatar": {"name": "quayadmin", "hash": "b28d563a6dc76b4431fc7b0524bbff6b810387dac86d9303874871839859c7cc", "color": "#17becf", "kind": "user"}}}, "event_config": {}, "number_of_failures": 0}

2. 您可以通过输入以下 POST /api/v1/repository/{repository}/notification/{uuid}/test 命令来测试存储库通知：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST \
     -H "Authorization: Bearer <bearer_token>" \
     https://<quay-server.example.com>/api/v1/repository/<repository>/notification/<uuid>/test

   输出示例

   Copy to Clipboard Toggle word wrap

   {}

3. 您可以通过输入以下 POST /api/v1/repository/{repository}/notification/{uuid} 命令重置存储库通知失败：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST \
     -H "Authorization: Bearer <bearer_token>" \
     https://<quay-server.example.com>/api/v1/repository/<repository>/notification/<uuid>

4. 输入以下 DELETE /api/v1/repository/{repository}/notification/{uuid} 命令来删除存储库通知：

   Copy to Clipboard Toggle word wrap

   $ curl -X DELETE \
     -H "Authorization: Bearer <bearer_token>" \
     https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/notification/<uuid>

   此命令不会在 CLI 中返回输出。相反，您可以输入以下 GET /api/v1/repository/{repository}/notification/ 命令来检索所有通知的列表：

   Copy to Clipboard Toggle word wrap

   $ curl -X GET  -H "Authorization: Bearer <bearer_token>"   -H "Accept: application/json"  https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/notification

   输出示例

   Copy to Clipboard Toggle word wrap

   {"notifications": []}

步骤

1. 要为机构设置配额，您可以使用 POST /api/v1/organization/{orgname}/quota 端点：

   Copy to Clipboard Toggle word wrap

   $ curl -X POST "https://<quay-server.example.com>/api/v1/organization/<orgname>/quota" \
        -H "Authorization: Bearer <access_token>" \
        -H "Content-Type: application/json" \
        -d '{
            "limit_bytes": 10737418240,
            "limits": "10 Gi"
        }'

   输出示例

   Copy to Clipboard Toggle word wrap

   "Created"

2. 使用 GET /api/v1/organization/{orgname}/quota 命令查看您的机构是否已建立的配额：

   Copy to Clipboard Toggle word wrap

   $ curl -k -X GET -H "Authorization: Bearer <token>" -H 'Content-Type: application/json'  https://<quay-server.example.com>/api/v1/organization/<organization_name>/quota  | jq

   输出示例

   Copy to Clipboard Toggle word wrap

   [{"id": 1, "limit_bytes": 10737418240, "limit": "10.0 GiB", "default_config": false, "limits": [], "default_config_exists": false}]

3. 您可以使用 PUT /api/v1/organization/{orgname}/quota/{quota_id} 命令修改现有的配额限制。例如：

   Copy to Clipboard Toggle word wrap

   $ curl -X PUT "https://<quay-server.example.com>/api/v1/organization/<orgname>/quota/<quota_id>" \
        -H "Authorization: Bearer <access_token>" \
        -H "Content-Type: application/json" \
        -d '{
            "limit_bytes": <limit_in_bytes>
        }'

   输出示例

   Copy to Clipboard Toggle word wrap

   {"id": 1, "limit_bytes": 21474836480, "limit": "20.0 GiB", "default_config": false, "limits": [], "default_config_exists": false}

步骤

1. 在 Red Hat Quay v2 UI 上，单击组织的名称，如 cache-org。
2. 在导航窗格中，单击 Settings。

3. 在 Remote Registry 框中，输入要缓存的远程 registry 的名称，如 quay.io，然后点 Save。

   注意

   通过向 Remote Registry 添加命名空间（如 quay.io/<namespace > ），您机构中的用户只能从该命名空间中代理。

4. 可选。在 Remote Registry username 框中，输入用于向上一步中指定的远程 registry 进行身份验证的用户名。对于上游的匿名拉取，您可以将此留空。如果您在创建时设置用户名，则无法在不删除代理缓存和创建新 registry 的情况下添加用户名。
5. 可选。在 Remote registry 密码 框中，输入要在远程 registry 中进行身份验证的密码。对于上游的匿名拉取，您可以将此留空。如果您在创建时设置用户名，则无法在不删除代理缓存和创建新 registry 的情况下添加用户名。

6. 可选。在 Expiration 字段中设置一个时间。

   注意
   • 代理机构中缓存的镜像的默认标签 Expiration 字段被设置为 86400 秒。在代理机构中，每次拉取标签时，标签过期时间都会刷新为 UI 的 Expiration 字段中设置的值。此功能与 Quay 的默认 单个标签过期 功能不同。在代理机构中，可以覆盖单个标签功能。发生这种情况时，会根据代理机构的 Expiration 字段重置单个标签的过期时间。
   • 过期的镜像将在分配的时间后消失，但仍然存储在 Red Hat Quay 中。镜像被完全删除或收集的时间取决于您的机构的 Time Machine 设置。垃圾回收的默认时间为 14 天，除非另有指定。
7. 可选。如果要使用不安全的协议，请选中 http 框。如果没有选中，则使用 https 来请求远程 registry。
8. 点击 Save。

验证

1. 在 CLI 中，从指定的远程 registry （如 quay.io ）拉取公共镜像，充当代理缓存：

   Copy to Clipboard Toggle word wrap

   $ podman pull <registry_url>/<organization_name>/<quayio_namespace>/<image_name>

   重要

   如果将您的机构设置为从远程 registry 中的单个命名空间中拉取，则必须从 URL 中省略远程 registry 命名空间。例如，podman pull <registry_url>/<organization_name>/<image_name>。

步骤

1. 输入以下命令添加 chart 存储库：

   Copy to Clipboard Toggle word wrap

   $ helm repo add redhat-cop https://redhat-cop.github.io/helm-charts

2. 输入以下命令在本地从 chart 仓库中更新可用 chart 的信息：

   Copy to Clipboard Toggle word wrap

   $ helm repo update

3. 输入以下命令从存储库中提取 chart：

   Copy to Clipboard Toggle word wrap

   $ helm pull redhat-cop/etherpad --version=0.0.4 --untar

4. 输入以下命令将 chart 打包到 chart 归档中：

   Copy to Clipboard Toggle word wrap

   $ helm package ./etherpad

   输出示例

   Copy to Clipboard Toggle word wrap

   Successfully packaged chart and saved it to: /home/user/linux-amd64/etherpad-0.0.4.tgz

5. 使用 helm registry login 登录到 Red Hat Quay：

   Copy to Clipboard Toggle word wrap

   $ helm registry login quay370.apps.quayperf370.perfscale.devcluster.openshift.com

6. 使用 helm push 命令将 chart 推送到存储库：

   Copy to Clipboard Toggle word wrap

   $ helm push etherpad-0.0.4.tgz oci://quay370.apps.quayperf370.perfscale.devcluster.openshift.com

   输出示例：

   Copy to Clipboard Toggle word wrap

   Pushed: quay370.apps.quayperf370.perfscale.devcluster.openshift.com/etherpad:0.0.4
   Digest: sha256:a6667ff2a0e2bd7aa4813db9ac854b5124ff1c458d170b70c2d2375325f2451b

7. 通过删除本地副本，然后从存储库拉取 chart 来确保推送可以正常工作：

   Copy to Clipboard Toggle word wrap

   $ rm -rf etherpad-0.0.4.tgz

   Copy to Clipboard Toggle word wrap

   $ helm pull oci://quay370.apps.quayperf370.perfscale.devcluster.openshift.com/etherpad --version 0.0.4

   输出示例：

   Copy to Clipboard Toggle word wrap

   Pulled: quay370.apps.quayperf370.perfscale.devcluster.openshift.com/etherpad:0.0.4
   Digest: sha256:4f627399685880daf30cf77b6026dc129034d68c7676c7e07020b70cf7130902

验证

1. 使用 或as 拉取镜像。例如：

   Copy to Clipboard Toggle word wrap

   $ oras pull quay.io/<organization_name>/<repository>/<image_name>:<tag>

2. 使用 oras 检查更改。例如：

   Copy to Clipboard Toggle word wrap

   $ oras manifest fetch quay.io/<organization_name>/<repository>/<image_name>:<tag>

   输出示例

   Copy to Clipboard Toggle word wrap

   {"schemaVersion":2,"mediaType":"application/vnd.oci.image.manifest.v1+json","artifactType":"application/vnd.unknown.artifact.v1","config":{"mediaType":"application/vnd.oci.empty.v1+json","digest":"sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a","size":2,"data":"e30="},"layers":[{"mediaType":"application/vnd.oci.empty.v1+json","digest":"sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a","size":2,"data":"e30="}],"annotations":{"org.opencontainers.image.created":"2024-07-11T15:22:42Z","version ":" 8.11"}}

步骤

1. 输入以下命令标记 OCI 介质工件：

   Copy to Clipboard Toggle word wrap

   $ podman tag <myartifact_image> <quay-server.example.com>/<organization_name>/<repository>/<image_name>:<tag>

2. 将工件推送到 Red Hat Quay registry。例如：

   Copy to Clipboard Toggle word wrap

   $ podman push <myartifact_image> <quay-server.example.com>/<organization_name>/<repository>/<image_name>:<tag>

3. 输入以下命令，使用带有 oras 的 OCI 1.1 引用 API 模式来附加清单：

   Copy to Clipboard Toggle word wrap

   $ oras attach --artifact-type <MIME_type> --distribution-spec v1.1-referrers-api <myartifact_image> \
   <quay-server.example.com>/<organization_name>/<repository>/<image_name>:<tag> \
   <example_file>.txt

   输出示例

   Copy to Clipboard Toggle word wrap

   -spec v1.1-referrers-api quay.io/testorg3/myartifact-image:v1.0 hi.txt
   ✓ Exists    hi.txt                                                               3/3  B 100.00%     0s
     └─ sha256:98ea6e4f216f2fb4b69fff9b3a44842c38686ca685f3f55dc48c5d3fb1107be4
   ✓ Exists    application/vnd.oci.empty.v1+json                                    2/2  B 100.00%     0s
     └─ sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a
   ✓ Uploaded  application/vnd.oci.image.manifest.v1+json                       723/723  B 100.00%  677ms
     └─ sha256:31c38e6adcc59a3cfbd2ef971792aaf124cbde8118e25133e9f9c9c4cd1d00c6
   Attached to [registry] quay.io/testorg3/myartifact-image@sha256:db440c57edfad40c682f9186ab1c1075707ce7a6fdda24a89cb8c10eaad424da
   Digest: sha256:31c38e6adcc59a3cfbd2ef971792aaf124cbde8118e25133e9f9c9c4cd1d00c6

4. 输入以下命令使用 OCI 1.1 引用器 标签 模式附加清单：

   Copy to Clipboard Toggle word wrap

   $ oras attach --artifact-type <MIME_type> --distribution-spec v1.1-referrers-tag \
   <myartifact_image> <quay-server.example.com>/<organization_name>/<repository>/<image_name>:<tag> \
   <example_file>.txt

   输出示例

   Copy to Clipboard Toggle word wrap

   ✓ Exists    hi.txt                                                             3/3  B 100.00%     0s
     └─ sha256:98ea6e4f216f2fb4b69fff9b3a44842c38686ca685f3f55dc48c5d3fb1107be4
   ✓ Exists    application/vnd.oci.empty.v1+json                                  2/2  B 100.00%     0s
     └─ sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a
   ✓ Uploaded  application/vnd.oci.image.manifest.v1+json                     723/723  B 100.00%  465ms
     └─ sha256:2d4b54201c8b134711ab051389f5ba24c75c2e6b0f0ff157fce8ffdfe104f383
   Attached to [registry] quay.io/testorg3/myartifact-image@sha256:db440c57edfad40c682f9186ab1c1075707ce7a6fdda24a89cb8c10eaad424da
   Digest: sha256:2d4b54201c8b134711ab051389f5ba24c75c2e6b0f0ff157fce8ffdfe104f383

5. 输入以下命令 使用标签 模式发现工件的引用器：

   Copy to Clipboard Toggle word wrap

   $ oras discover --insecure --distribution-spec v1.1-referrers-tag \
   <quay-server.example.com>/<organization_name>/<repository>/<image_name>:<tag>

   输出示例

   Copy to Clipboard Toggle word wrap

   quay.io/testorg3/myartifact-image@sha256:db440c57edfad40c682f9186ab1c1075707ce7a6fdda24a89cb8c10eaad424da
   └── doc/example
       └── sha256:2d4b54201c8b134711ab051389f5ba24c75c2e6b0f0ff157fce8ffdfe104f383

6. 输入以下命令使用 API 模式发现工件的引用器：

   Copy to Clipboard Toggle word wrap

   $ oras discover --distribution-spec v1.1-referrers-api \
   <quay-server.example.com>/<organization_name>/<repository>/<image_name>:<tag>

   输出示例

   Copy to Clipboard Toggle word wrap

   Discovered 3 artifacts referencing v1.0
   Digest: sha256:db440c57edfad40c682f9186ab1c1075707ce7a6fdda24a89cb8c10eaad424da
   
   Artifact Type   Digest
                   sha256:2d4b54201c8b134711ab051389f5ba24c75c2e6b0f0ff157fce8ffdfe104f383
                   sha256:22b7e167793808f83db66f7d35fbe0088b34560f34f8ead36019a4cc48fd346b
                   sha256:bb2b7e7c3a58fd9ba60349473b3a746f9fe78995a88cb329fc2fd1fd892ea4e4

7. 可选。您还可以使用 /v2/<organization_name>/<repository_name>/referrers/<sha256_digest& gt; 端点来发现引用器。要实现此目的，您必须在 config.yaml 文件中生成 v2 API 令牌并设置 FEATURE_REFERRERS_API: true。

   1. 更新 config.yaml 文件，使其包含 FEATURE_REFERRERS_API 字段。例如：

      Copy to Clipboard Toggle word wrap

      # ...
      FEATURE_REFERRERS_API: true
      # ...

   2. 输入以下命令对凭证进行 Base64 编码：

      Copy to Clipboard Toggle word wrap

      $ echo -n '<username>:<password>' | base64

      输出示例

      Copy to Clipboard Toggle word wrap

      abcdeWFkbWluOjE5ODlraWROZXQxIQ==

   3. 输入以下命令使用 base64 编码的令牌，并将 URL 端点改为 Red Hat Quay 服务器：

      Copy to Clipboard Toggle word wrap

      $ curl --location '<quay-server.example.com>/v2/auth?service=<quay-server.example.com>&scope=repository:quay/listocireferrs:pull,push' --header 'Authorization: Basic <base64_username:password_encode_token>' -k | jq

      输出示例

      Copy to Clipboard Toggle word wrap

      {
        "token": "<example_token_output>..."
      }

8. 输入以下命令使用 v2 API 令牌列出存储库下清单的 OCI 引用器：

   Copy to Clipboard Toggle word wrap

   $ GET https://<quay-server.example.com>/v2/<organization_name>/<repository_name>/referrers/sha256:0de63ba2d98ab328218a1b6373def69ec0d0e7535866f50589111285f2bf3fb8
   --header 'Authorization: Bearer <v2_bearer_token> -k | jq

   输出示例

   Copy to Clipboard Toggle word wrap

   {
     "schemaVersion": 2,
     "mediaType": "application/vnd.oci.image.index.v1+json",
     "manifests": [
       {
         "mediaType": "application/vnd.oci.image.manifest.v1+json",
         "digest": "sha256:2d4b54201c8b134711ab051389f5ba24c75c2e6b0f0ff157fce8ffdfe104f383",
         "size": 793
       },
     ]
   }