Registering Gitweb projects

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

Before you begin

Make sure that you have registered the Gitweb server to make it known to the Rational Adapter for Git so that it can be recognized by Gitweb projects.
Restriction: Check that your project name does not contain special characters other than a space or 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 Gitweb 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 space or forward slash before you register the project.

About this task

Registering a Gitweb project makes the project known to the Change and Configuration Management project and enables the Gitweb 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 Gitweb home page; for example http://our.git.server/git

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

    Gitweb home with additions

  2. From the Gitweb home page, navigate to a project page.
    Warning: Project names can contain a space or 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.

    Register This Project

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

    Register 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 Gitweb project with.

      Associate Rational Team Concert Projects

    3. Click Associate Projects.

      Gitweb project associated with Rational Team Concert projects

  7. Click Register.
  8. The Gitweb 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 the links when commits are pushed to a Gitweb project. Record the Gitweb project URL. You need the Gitweb project URL to install and configure the receive hook for the project.

    Registered projects and further instructions

  9. Configure the receive hook for your registered project.
    1. Click Receive Hook
    2. Add change request tags and separate each one with a comma. For example, bug,task
    3. Add branch names and mark them as include or exclude to limit which branches the Git receive hook applies to. You can use the * glob pattern to match zero or more characters in a branch name. The adapter reviews all of the globs, and the last glob to match the branch name applies. For example, if you have a branch named bug180 and include bug1* and then exclude bug18*, the adapter excludes the branch named bug180 because the last glob to match the branch name applies.

    Add receive hook options for a registered git project

Results

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

What to do next

Configure the Git receive hook for the Gitweb project, see Deploying the Git receive hook.

Feedback