Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

“PlantUML diagrams Diagrams for Confluence” cloud allows users to import their GitLab diagrams into Confluence pages.

...

In order to connect GitLab account with “PlantUML diagrams for Confluence”plugin add-on, user should first create OAuth app on his their GitLab account. For Companies companies, we strongly suggest creating separate account for this role as a security measure.

  1. Go to gitlab.com and login into account.

  2. Click on the account image on top left side:

    gitlab_app_2.png

  3. From the drop-down menu select “Preferences“

  4. From the left menu bar select “Applications”

  5. Click “Add new Application“ on the right.

  6. Give OAuth app some a name and insert redirect URL as shown on “PlantUML diagrams Diagrams for Confluence“ plugin’s Settings page. Give only read_api permission.

    gitlab_app_3.png

  7. Save application. On the next page copy and save applications application secret and ID. Make sure newly created OAuth App is listed under “Authorized Applications”.

    gitlab_app_1.png

...

  1. Open “PlantUML Diagrams for Confluence“ setup page. Select “GitLab” tab.

  2. Populate fields and click on “Save Settings“. This will persist connection details. make sure you entered them correctly.

    settings gitlab.png

  3. Click on “Connect With GitLab“ button. This will initiate connection procedure. At this point you need to grant permission to OAuth App to communicate with “PlantuML diagrams “PlantUML Diagrams for Confluence”. After you allowed allow communication, both apps are connectec connected and Confluence users will be able to use repositories visible to OAuth app.

...

When Plugin editor is opened user will see GitLab icon next to the GitHub icon. When GitLab ivon icon is clicked Repositoru Repository Explorer will open showing available repositories. User Users can browse them as he browse repositories using File Explorer or he cn use search functionality on the upper right cornerinput the URL directly.

...

Repository URL feature

In order to avoid browsing repositories user , users can directly put repositoru repository URL into “GitLab repository URL” field. It should be in standard format It’s a HTTPS URL received from “Clone from HTTPS“ feature on the GitLab project page. When user provides users provide this URL he , they will be automatically redirected to given project Branches view. If URL is invalid error message is will be shown.