upstream/harbor
1
0
Fork 0
mirror of https://github.com/goharbor/harbor synced 2025-04-13 16:10:36 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #7657 from zhoumeina/swagger_guide

Browse Source 
add swagger user guide
This commit is contained in:
Wenkai Yin 2019-05-10 10:30:05 +08:00 committed by GitHub
commit ae3b75d33b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 13 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
docs/img/api_explorer_btn.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 34 KiB

BIN
docs/img/authorize.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 21 KiB

13
docs/user_guide.md
View File

@ -30,6 +30,7 @@ This guide walks you through the fundamentals of using Harbor. You'll learn how
* [Online Garbage Collection.](#online-garbage-collection)
* [View build history.](#build-history)
* [Manage robot account of a project.](#robot-account)
* [Using API Explorer](#api-explorer)
## Role Based Access Control(RBAC)
@ -637,3 +638,15 @@ If you are a project admin, you can disable a Robot Account by clicking "Disable
If you are a project admin, you can delete a Robot Account by clicking "Delete" in the `Robot Accounts` tab of a project.
![delete_robot_account](img/robotaccount/disable_delete_robot_account.png)
## API Explorer
Harbor integrated swagger UI from 1.8. That means all apis can be invoked through UI. Normally, user have 2 ways to navigate to API Explorer.
1. User can login harbor, and click the "API EXPLORER" button.All apis will be invoked with current user authorization.
![navigation bar](img/api_explorer_btn.png)
2. User can navigate to swagger page by ip address by router "devcenter". For example: https://10.192.111.118/devcenter. After go to the page, need to click "authorize" button to give basic authentication to all apis. All apis will be invoked with the authorized user authorization.
![authentication](img/authorize.png)