5.3. 访问 Red Hat Quay Swagger UI

流程

1. 输入以下命令来部署 Swagger UI 容器，将 URL 指向 Red Hat Quay 的 API 发现端点。例如：

   $ podman run -p 8080:8080 -e SWAGGER_JSON_URL=<quay-server.example.com> docker.swagger.io/swaggerapi/swagger-ui

   Copy to Clipboard Toggle word wrap

   输出示例

   ---
   /docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh
   20-envsubst-on-templates.sh: Running envsubst on /etc/nginx/templates/default.conf.template to /etc/nginx/conf.d/default.conf
   /docker-entrypoint.sh: Launching /docker-entrypoint.d/30-tune-worker-processes.sh
   /docker-entrypoint.sh: Launching /docker-entrypoint.d/40-swagger-ui.sh
   /docker-entrypoint.sh: Configuration complete; ready for start up
   ---

   Copy to Clipboard Toggle word wrap

2. 导航到 localhost URL。在这个示例中，它是 http://localhost:8080/。

3. 使用 Swagger UI 测试各种 API 端点。例如，要为用户创建新令牌，您可以点击 POST /api/v1/user/apptoken endpoint Try it out Execute 生成示例 curl 命令。

   注意

   目前，无法生成服务器响应。这是因为 Swagger UI 没有设置为接受 bearer 令牌。因此，每个命令会返回以下错误： {"error": "CSRF token is invalid or missing."}。作为临时解决方案，您可以将此命令复制到终端中，并手动添加 bearer 令牌，如 -H 'Authorization: Bearer <bearer_token>'