Registering Gerrit projects

The Gerrit projects must be registered with the Rational® Adapter for Git.

Before you begin

Make sure that you have registered the Gerrit server to make it known to the Rational Adapter for Git so that it can be recognized by Gerrit projects.
Restriction: Check that your project name does not contain special characters other than a forward slash. Other special characters might not resolve correctly when the project is registered and the project URL is assigned. For example, when the Gerrit project name is robin+new.git the resolved URL for the project is robin%2Bnew.git. Rename any projects that contain characters other than a forward slash before you register the project.

About this task

Registering a Gerrit project makes the project known to the Change and Configuration Management project and enables the Gerrit features of the Rational Adapter for Git. For this step you must be logged in as a Rational Team Concert™ user with administrator or project administrator privileges. Repeat this step for each project you want to register.

Procedure

  1. Point your web browser to the Gerrit home page; for example http://our.gerrit.server/gerrit

    The Rational Adapter for Git banner shows. This is one of the Gerrit additions that you deployed to the Gerrit server.

    Gerrit home with additions

  2. From the Gerrit home page, navigate to a list of changes for a project that you want to register.
    Warning: Project names can contain a forward slash. Other special characters might not display correctly in the resolved project URL. Rename the project before you register it.
  3. Click the Admin (Administration) icon in the top right portion of the banner and then click Register This Project.

    The Register Git Project opens in a new web browser window.

    Resister Git Project

  4. Confirm that the name of the project is prefilled to the project name that you navigated to.
  5. Optional: Add a summary.
  6. Associate the project with a Rational Team Concert project.
    1. Click Add.
    2. In the Associate Rational Team Concert Projects window, select the check box next to the Rational Team Concert project or projects that you want to associate this Gerrit project with.

      Associate Rational Team Concert projects

    3. Click Associate Projects.

      Gerrit project associated with Rational Team Concert projects

  7. Click Register.
  8. The Gerrit project is registered with the adapter. Check that the project name and resolved project URL match. If the project name and resolved project URL do not match, rename the project and repeat the steps to register the project. If the project name and resolved project URL do match, further instructions direct you to set up links when commits are pushed to a Gerrit project. Record the Gerrit project URL. You need the Gerrit project URL to install and configure the receive hook for the project.

    Projects Registered

Results

You have registered the Gerrit project with the Rational Adapter for Git. Registering the Gerrit project completes the configuration of the Gerrit server to work with Rational Adapter for Git.

What to do next

Configure the Gerrit receive hook for the Gerrit project, see Deploying the Gerrit receive hook.

Feedback