使用 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. 单击 Change Password。

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

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

流程

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

   $ 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/"

   输出示例

   {"username": "newuser", "email": "newuser@example.com", "password": "IJWZ8TIY301KPFOW3WEUJEVZ3JR11CY1", "encrypted_password": "9Q36xF54YEOLjetayC0NBaIKgcFFmIHsS3xTZDLzZSrhTBkxUc9FDwUKfnxLWhco6oBJV1NDBjoBcDGmsZMYPt1dSA4yWpPe/JKY9pnDcsw="}

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

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

   输出示例

   username: newuser
   password: IJWZ8TIY301KPFOW3WEUJEVZ3JR11CY1

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

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

   输出示例

   {"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} 命令，以从命令行删除用户：

   $ 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。然后您可以检查是否存在它们。

   $ 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/ 端点创建新机构：

   $ 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/"

   输出示例

   "Created"

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

   $ 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>"
         }'

   输出示例

   {"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 页面中，有一个 搜索 输入框。有了此框，用户可以搜索特定的组织，以确保它们被正确地安排删除。例如，如果用户正在删除 10 个机构，并希望确保删除了一个特定的机构，他们可以使用 搜索 输入框确认机构标记为删除。

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

5. 点 Delete。

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

   注意

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

流程

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

   $ 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} 命令来查看是否返回已删除机构的详情：

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

   输出示例

   {"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。

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

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

流程

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

   $ sudo podman pull busybox

   输出示例

   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. 使用新存储库和镜像名称标记本地系统上的镜像。例如：

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

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

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

   输出示例

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

流程

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

   $ 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"

   输出示例

   {"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} 端点删除存储库：

   $ 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} 命令来查看是否返回已删除存储库的详情：

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

   输出示例

   {"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 权限。

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 帐户。
4. 对于将添加到多个存储库的机器人帐户，点 kebab 图标 → Set repository 权限。

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

   

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

流程

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

   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)中，输入以下命令尝试以机器人帐户身份登录：

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

   返回以下出错信息：

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

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

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

   ...
   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} 端点删除机构的机器人帐户：

   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 命令，以查看是否为机器人帐户返回详情：

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

   输出示例

   {"robots": []}

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

   $ 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} 命令，以查看是否为机器人帐户返回详情：

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

   输出示例

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

流程

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

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

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

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

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

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

流程

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

   $ 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

   输出示例

   {"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。

   $ 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>

   输出示例

   {"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} 命令删除权限：

   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 命令来获取所有权限的列表：

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

   输出示例

   {"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} 命令更改用户权限：

   $ 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>

   输出示例

   {"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} 命令：

   $ 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/ 命令来检查权限是否已删除：

   $ 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>/

   输出示例

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

流程

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

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

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

流程

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

   $ 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

   输出示例

   {"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/ 端点。例如：

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

   输出示例

   {"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} 命令更改标签指向或创建新标签：

   $ 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>

   输出示例

   "Updated"

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

   $ 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

   输出示例

   {}

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

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

   输出示例

   {"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，必须为由 = 分隔的键值。

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

流程

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

   $ 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 命令检索特定清单的标签列表：

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

   输出示例

   {"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} 命令获取有关特定清单的信息：

   $ 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>

   输出示例

   {"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 命令在给定存储库中向清单添加额外标签。例如：

   $ 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

   输出示例

   {"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} 命令删除标签：

   $ 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)。例如：

   $ 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 > ：过滤标签，使其只包含具有指定名称的标签。

     $ 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"

     输出示例

     {"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 > 查询，您可以过滤特定标签的结果。例如：

   $ 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"

   输出示例

   {"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} 命令删除镜像标签：

   $ 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/ 命令。例如：

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

   输出示例

   {"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 命令将存储库标签恢复到以前的镜像。例如：

   $ 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

   输出示例

   {}

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

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

   输出示例

   {"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. 导航到您作为管理员的 Organization、repository 或 namespace。

3. 点 Logs。

   

4. 可选。通过将日期添加到 From 和 To 框来设置用于查看日志条目的日期范围。
5. 可选。点 Export 来导出日志。您必须输入电子邮件地址或以 http:// 或 https:// 开头的有效回调 URL。根据存在多少个日志，此过程可能需要一小时。

流程

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

4. 点 Export Logs 按钮。此时会出现一个出口使用日志弹出，如下所示

   

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

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

   • 会收到一封电子邮件，提醒您请求的导出日志条目可用。
   • 从 Webhook URL 返回日志导出请求的成功状态。另外，还会提供一个到导出的数据的链接，供您删除以下载日志。

流程

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

   $ 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"

   输出示例

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

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

   $ 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 端点导出存储库的日志：

   $ 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. 要显示有关多架构镜像的更多信息，请点 See Child Manifests 查看扩展视图中的清单列表。
3. 点 See Child Manifests 下的相关链接，例如，1 Unknown 被重定向到 Security Scanner 页面。
4. Security Scanner 页面提供了标签的信息，如镜像易受哪些 CVE，以及您可能可用的补救选项。

流程

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

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

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

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

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

   • Slack 通知

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

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

流程

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

   $ 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} 命令来获取有关存储库通知的信息：

   {"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 命令来测试存储库通知：

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

   输出示例

   {}

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

   $ 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} 命令来删除存储库通知：

   $ 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/ 命令来检索所有通知的列表：

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

   输出示例

   {"notifications": []}

流程

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

   $ 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"
        }'

   输出示例

   "Created"

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

   $ curl -k -X GET -H "Authorization: Bearer <token>" -H 'Content-Type: application/json'  https://example-registry-quay-quay-enterprise.apps.docs.gcp.quaydev.org/api/v1/organization/testorg/quota  | jq

   输出示例

   [{"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} 命令修改现有的配额限制。例如：

   $ 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>
        }'

   输出示例

   {"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。

   注意

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

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

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

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

验证

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

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

   重要

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

流程

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

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

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

   $ helm repo update

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

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

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

   $ helm package ./etherpad

   输出示例

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

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

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

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

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

   输出示例：

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

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

   $ rm -rf etherpad-0.0.4.tgz

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

   输出示例：

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

验证

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

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

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

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

   输出示例

   {"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 介质工件：

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

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

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

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

   $ 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

   输出示例

   -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 引用器 标签 模式附加清单：

   $ 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

   输出示例

   ✓ 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. 输入以下命令 使用标签 模式发现工件的引用器：

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

   输出示例

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

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

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

   输出示例

   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 字段。例如：

      # ...
      FEATURE_REFERRERS_API: true
      # ...

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

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

      输出示例

      abcdeWFkbWluOjE5ODlraWROZXQxIQ==

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

      $ 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

      输出示例

      {
        "token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Ijl5RWNtWmdiZ0l6czBBZW16emhTMHM1R0g2RDJnV2JGUTdUNGZYand4MlUiLCJ0eXAiOiJKV1QifQ..."
      }

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

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

   输出示例

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