Overview

This is a plugin for Fisheye/Crucible that provides an API for creating/indexing and deleting git repositories.

Usage

To use it:

1. Build the jar (a built version is included in this git repo)
2. Add it to Fisheye/Crucible
3. Populate the git private key in the Git Repo API Config section in the admin interface.
4. Use the URLs below to interact with the API.

Adding/indexing a git repository

This will add the repository if not present and then initiate an indexing run. If the repository already exists, only the indexing will be started.

$ curl https://fish.domain/plugins/servlet/git-repo-api/update?url=ssh://git.domain/repo.git&name=repo-name

Deleting a git repository

This will delete the git repository.

$ curl https://fish.domain/plugins/servlet/git-repo-api/delete?name=repo-name

Return information

If the action is successful, a json response similar to the following will be returned:

{
  "response": "create/update successful"
}

If it fails, a json response similar to the following will be returned:

{
  "error": "delete failed, repo refused to stop"
}

Developing

Getting started

First, install the Atlassian Plugin SDK.

Change directory into a clone of this repo and run Fisheye (available at http://:3990/fecru):

$ atlas-run

Or to run against a specific version (list of available versions) :

$ atlas-run --version 2.7.13-20120517072828

Packaging

Run the atlas-package command. See full documentation.

Other available commands

• atlas-debug - same as atlas-run, but allows a debugger to attach at port 5005
• atlas-cli - after atlas-run or atlas-debug, opens a Maven command line window;'pi' reinstalls the plugin into the running Fisheye/Crucible instance
• atlas-help - prints description for all commands in the SDK

Resources

Inspiration

• FishEye plugin to synchronize Gerrit repositories

JavaDoc

• RepositoryAdminService
• RepositoryIndexer
• All JavaDoc

Atlas Plugin SDK Documentation

• Introduction
• Maven Repositories
• Atlassian Template Renderer
• Shared Access Layer

FishEye and Crucible Plugin Tutorials

• Tutorials