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 がベアラートークンを受け入れるように設定されていないためです。その結果、各コマンドに対して、{"error": "CSRF token was invalid or missing."} のエラーが返されます。回避策として、このコマンドをターミナルにコピーし、ベアラートークンを手動で追加できます (例: -H 'Authorization: Bearer <bearer_token>')。