Swagger Editor and Gitlab

From ETSI Forge
Revision as of 17:30, 5 November 2018 by Carignani (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Warning:
this tool is in Alpha version.

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.

Swagger-editor-gitlab.png

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

---> Click here <---

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