How to add the repository and work with repositories

This instruction provides the convenience of adding your Git repositories from a Jira account and work with them directly from your Jira tickets for more efficient project management and tracking. The complete step by step description for adding new repositories is provided below.

Please make sure that all data is correct before submitting the repository. Git provider will be resolved automatically and if the repository is private you will have to provide credentials for authentication.

After adding a new repository, the table will be rendered with saved repositories.

1. Button leads to this page

2. Full URL path of your repository

3. Confirmation button

4. Cancel the saving button

5. Press this button to open the popup

You also may plug Jira integration for each of the following Git services. Choose the provider that you need to add repositories.

1. Repository page

2. Press this button to open the popup

3. Add Server: GitHub

4. Add Server: GitLab

5. Add Server: Bitbucket

6. Add Server: Beanstalk

7. Add Server: Microsoft

8. Add Server: Gitea

9. Selector between Cloud and Server services

10. Access Token

11. Group Filter

12. Next button

13. Close pop-up button

For such Service Providers as Bitbucket and Beanstalk, authentication by credentials is enabled as an alternate way to add server.

In order to connect to the repository, you need to have its URL. It is usually located on the main page and is easily accessible. Please note that you need an address starting with "https". Also, you can use the SSH URL.

 Copy URL to the clipboard by clicking on the "Сopy" button(1).

Same you can do with SSH URL.

Put your repository URL into the provided field. This one is public so no authentication credentials are required. 

Once we click the Add button, the plugin saves it.

Before clicking “Add”, please make sure all data in the repository URL field(1) is correct.

Successful save will lead to the automatic loading of the repositories table. It is a handy tool with filtering and pagination that helps you to manage all your repositories if you have to work with lots of them.

1. Repositories tab

2. Servers tab

3. Filter by URL field

4. Filter by Git Provider field

5. Filter by Last Update

6. Initiates filtering after filtering criterion is provided

7. Clear filter fields and show all repositories

8. Add repositories button open popup to add more repositories

9. Delete Selected repositories

10. Delete All repositories

11. Check-box for selected repositories

12. Repository URL

13. Last time of this repo update

14. Git Provider

15. Status of adding repositories

16. Actions with repositories (edited, delete, logs) 

For adding a new server you must go to the Servers tab and then you can add, edit or delete servers.

1. Repositories tab

2. Servers tab

3. Filter by URL field

4. Filter by Git Provider field

5. Initiates filtering after filtering criterion is provided

6. Clear filter fields and show all repositories

7. Add Server button open popup to add more repositories

8. Delete Selected servers

9. Delete All servers

10. Check-box for selected repositories

11. Server URL

12. Username owner of the server

13. Repositories - its numbers of repositories which include in the server

14. Provider

15. Status of adding repositories

16. Actions with repositories (edited, delete, refresh)

Workflow for adding a private repository is slightly different because it is impossible to connect without credentials.

1. Repository URL field.

After trying to add the private repo, you will get a message with instructions. 

1. Editable Repository URL

2. Token 

3. Informational message

For some Service Providers(Beanstalk and Bitbucket) authentication via login credentials is available as well.

Please note that the user needs to have access to the repository. 

1. Username

2. Password

3. Access token(for GitLab Provider as an alternate authentication way)

Repositories page with successfully added repositories.