Difference between revisions of "Swagger Editor and Gitlab"
From ETSI Forge
(Created page with "Warning: this tools is in Alpha version. == Try it yourself == [https://forge.etsi.org/swagger/editor-versions/v2.10.4-1 Click here] == 1. Log in with Gitlab == == 2. Impo...") |
(Tag: Visual edit) |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | Warning | + | {{Warning|this tool is in Alpha version.}} |
| + | |||
| + | == What is this? == | ||
| + | <big>To help ETSI Groups working over OpenAPIs in a smooth and efficient way, this tool integrates the well known Swagger Editor with the repository management system at ETSI Forge, namely Gitlab.</big> | ||
| + | |||
| + | <big>This modified version of the tool let's '''the user log into Gitlab and automatically import OpenAPIs from the user's repositories and the branches within'''.</big> | ||
| + | [[File:Swagger-editor-gitlab.png|center|frameless|593x593px]] | ||
| + | |||
| + | <big>'''Important''': the file needs to be already in the project and in the correct branch.</big> | ||
| + | |||
| + | <big>After editing, the user may save back the results into the project.</big> | ||
== Try it yourself == | == Try it yourself == | ||
| − | [https://forge.etsi.org/swagger/editor-versions/v2.10.4-1 Click here] | + | [https://forge.etsi.org/swagger/editor-versions/v2.10.4-1 <big>'''---> Click here <---'''</big>] |
| + | |||
| + | == Usage == | ||
| − | == 1. Log in with Gitlab == | + | === 1. Log in with Gitlab === |
| + | * <big>Click File -> Log into Gitlab</big> | ||
| + | * <big>Click Log into Gitlab in the model</big> | ||
| + | <big>You will be redirected to Gitlab login or, if you have already accessed, the page will simply reload.</big> | ||
| − | == 2. Import a YAML/JSON file from a project == | + | === 2. Import a YAML/JSON file from a project === |
| + | * <big>Click File -> Import from Gitlab</big> | ||
| + | * <big>You will need to select a project (among the ones you have access to)</big> | ||
| + | ** <big>If the list is empty please wait a few seconds or close the box and re-open it</big> | ||
| + | * <big>Select the branch (this branch will be used for the commit operation as well!)</big> | ||
| − | == 3. Save the file in the repository == | + | === 3. Save the file in the repository === |
| + | * Click File -> Submit to Gitlab | ||
| + | * Insert a description for your change. It will be used as Commit Message in the repository. | ||
| + | That's all! | ||
| − | == 4. Log out of Gitlab == | + | === 4. Log out of Gitlab === |
| + | * Click File -> Log out from Gitlab | ||
Latest revision as of 17:30, 5 November 2018
Warning:
this tool is in Alpha version.
Contents
What is this?
To help ETSI Groups working over OpenAPIs in a smooth and efficient way, this tool integrates the well known Swagger Editor with the repository management system at ETSI Forge, namely Gitlab.
This modified version of the tool let's the user log into Gitlab and automatically import OpenAPIs from the user's repositories and the branches within.
Important: the file needs to be already in the project and in the correct branch.
After editing, the user may save back the results into the project.
Try it yourself
Usage
1. Log in with Gitlab
- Click File -> Log into Gitlab
- Click Log into Gitlab in the model
You will be redirected to Gitlab login or, if you have already accessed, the page will simply reload.
2. Import a YAML/JSON file from a project
- Click File -> Import from Gitlab
- You will need to select a project (among the ones you have access to)
- If the list is empty please wait a few seconds or close the box and re-open it
- Select the branch (this branch will be used for the commit operation as well!)
3. Save the file in the repository
- Click File -> Submit to Gitlab
- Insert a description for your change. It will be used as Commit Message in the repository.
That's all!
4. Log out of Gitlab
- Click File -> Log out from Gitlab