Adding an external repository
One of the key actions you perform with Fisheye is to add a new external repository.
When you add a repository, and enable it, Fisheye builds an index and cache, which may take some time to complete.
Once a repository has been added, you can then browse and search it, and further configuration options become available, depending upon the type of repository.
Add a repository
- Click the 'cog' menu in the Fisheye header, and choose Repositories (to see this link you will need to be logged in as an administrator or have administration rights for at least one repository or have permission to add new repositories).
- Click Repositories (under 'Repository Settings').
- Click Native repository access, and then Add repository.
- Complete the wizard. See the following topics for more information:
- Click Add to finish.
Add a Git repository that is hosted in Bitbucket Server
You can add repositories that are hosted in Bitbucket Server to Fisheye, when these servers are connected using an application link. See Integrating Fisheye with Bitbucket Server for an overview.
When Bitbucket Server is integrated with Fisheye:
- You can easily add Git repositories to Fisheye. The repository behaves just like a native repository in Fisheye, so your team gets all the benefits of Fisheye indexing, browsing and searching.
- The repository becomes available to Crucible (when integrated), so you can perform in-depth code reviews for changes in the repository.
- When you add a Bitbucket Server repository to Fisheye, a push to the repository will by default automatically trigger Fisheye to run an incremental index. No further configuration is required – you don't have to configure polling for new commits, or set up dedicated Fisheye web hooks in your Bitbucket Server instance.
You'll need to have an account in the Bitbucket Server instance, as well as permission to view the repository that you want to add.
- Click the 'cog' menu in the Fisheye header, and choose Administration (you'll need to be logged in as an administrator to see this link).
- Click Repositories (under 'Repository Settings').
- Click the Bitbucket Server repositories tab, and authenticate with Bitbucket Server if necessary.
- If multiple instances of Bitbucket Server are connected to Fisheye, use the Bitbucket server list to choose the instance of Bitbucket Server that hosts the repository you wish to add.
- Optionally, type a filter pattern to restrict the list of displayed repositories to those with a matching name, key or project.
- Click Add for each repository that you wish to add to Fisheye.
- If the name of repository conflicts with already existing one, you will be asked to specify a different name.
Starting with Fisheye version 4.2, regular users granted the 'Can add repository' permission can add repositories using the Bitbucket Server repositories tab. Note that they can see only Fisheye repositories they have admin permission for.
When adding new repositories, Fisheye will prevent the creation of a repository using a name that already exists – Fisheye will prompt you for an alternative name.
When you add a Bitbucket Server repository:
- Fisheye creates a read-only SSH key and adds that as an access key to the repository in Bitbucket Server. If this operation fails, the key will be added as a user key to your profile in Bitbucket Server. You can check if an access key was added by viewing the repository's settings in Bitbucket Server. See Using SSH keys to secure Git operations in the Bitbucket Server documentation for more information.