Create a source code repository

Each project can have one or more source code repositories.

Before you can create a source code repository, a site administrator must first add one or more SCM servers to the TeamForge environment.
  1. Click SOURCE CODE from the Project Home menu.
  2. In the list of the project repositories, click Create Repository.
  3. On the Create Repository page, enter the directory name for the repository.
    Note: For CVS repositories, the directory name is the name of the directory relative to the CVS server's repository root directory. A UNIX group by the same name is also created to enforce permissions.
  4. Enter a name and description for the repository. If you plan to use an SCM server that requires approval for new repositories, use the DESCRIPTION field to provide your reason for asking to create this repository.
  5. Choose the server on which you want to create the repository.
    Note: The menu contains all of the SCM servers that the TeamForge administrators have added to the TeamForge environment.
  6. If you want to require that each code commit be associated with an artifact (or a task or some other work item), select Required on Commit. Selecting this check box enables the following options:
    • Artifact must be in open state: Select this check box to ensure that users cannot perform a commit for closed artifacts. Therefore, if a user attempts to commit changes for a closed artifact, an appropriate error message is displayed.
      Note: When the commit log includes multiple artifact ids, then all artifacts must be in the OPEN state for the user to perform a commit.
    • Committer must Own Artifact: Select this check box to ensure that only an artifact owner can perform the relevant commit. If the committer is not the artifact owner, then an appropriate error message is displayed preventing them from committing the changes to the specific artifact.
      Note:
      • In the case of a Git repository, the pusher who pushes the commits must be the owner of the artifact.
      • Once you enforce the above rules, validations are strictly enforced for commits against tracker artifacts only. In case you commit against any other TeamForge object, for example a wiki or a document, mere existence of the object ID ensures successful commit and association; no validations are performed against the status of the artifact or who it is assigned to.
  7. For security reasons, you may want to restrict email notifications to the essential information. If so, select HIDE DETAILS IN MONITORING MESSAGES.
  8. By default, the Available in Search Results check box is selected. Clear the check box if you want to exclude the repository from searches.
    Tip: You have the ability to control whether source code is included in search results. For example, you may want to exclude source code from searches that have sensitive information. You may also want to omit some repositories, such as the branding and publishing repositories, from search results. The Available in Search Results setting in Create Repository or Edit Repository page allows you to configure this. By default, this option is selected for all repositories, except for the branding repository in the look project and for Publishing repositories.
  9. Click Save.
Your request for a new repository is submitted. You will receive an email notification when your repository is created or if your request for a new repository is denied.
Note: By default, repository requests on unmanaged CVS servers require approval, because the SCM administrator must manually create the repository.