Creating a project - General

• Project name: Give your project a name and type it in.

• Project ID: Created automatically based on the specified project name, but can be modified if necessary.

• Code review ID pattern: A naming pattern that will be used in code review IDs. Created automatically based on the specified project name, but can be modified if necessary.

VCS

Choose the tab that corresponds to your VCS and specify its parameters as described below:

Git

• Repository URL: Examples: https://git.example.com/project or git://git.example.com/project

• Authentication method: Choose the preferred method: Anonymous, Password, or SSH and specify credentials to connect to your VCS

Mercurial

• Repository URL: Format: hostname:[port] Example: http://hg.example.com/project

• Authentication method: Choose the preferred method: Anonymous or Password and specify credentials to connect to your VCS

Perforce

• Server name: Example: perforce.example.com:1111

• Authentication method: Choose the preferred method: Anonymous or Password and specify credentials to connect to your VCS

• Workspace mapping:

  To include the entire project, specify: //<depot>/<project>/...

  To include only selected directories of the project, list these directories followed by corresponding directories in Upsource (divided by a space). Example:

  //depot/project1/directory1/... //upsource/depot/project1/directory1/... //depot/project1/directory2/... //upsource/depot/project1/directory2/...

• Important: In order for Upsource to recognise a Perforce repository, you need to:

  1. Download and install _P4:COMMAND LINE_ on the machine with your Upsource installation.
  2. For Mac OS and Linux, specify PATH to _P4:COMMAND LINE_ in your system environment variables (see P4 instructions).
  3. Restart Upsource

Subversion

• Repository URL: Example: http://svn.example.com/project/project

• Authentication method: Choose the preferred method: Anonymous, Password, or SSH and specify credentials to connect to your VCS

• Branches: you can define one or more SVN paths where Upsource should be looking for SVN branches. Use rules like +: or -: to include or exclude branches. Branch paths are relative to the repository URL specified above. Pattern may contain one * to match any number of characters in directory name.

  Example for a standard SVN layout:

  +:trunk +:branches/*

Multi-repository setup

• Project is hosted in multiple repositories: Select this option if your project is divided into a few separate repositories but building this project requires fetching all the repositories into specific locations under the root directory. Mapping multiple repositories allows you to watch and review changes in all of them from a single Upsource project.

  Click Add repository and specify the following settings for each repository:

  • Mount path: Specify a directory inside your project where this VCS root will reside.
  • Mapping ID: A unique ID of the VCS repository. It's generated automatically, but you can specify your own.

Check interval

• Check interval: Reflects how often Upsource checks for new revisions in the repository (every 300 seconds by default.)

  If commits to your repository aren't usually made this frequently, consider setting Check interval to a larger value.

Users

• Create user groups: Let Upsource create the following user groups for you:

  • Code viewers
  • Developers
  • Project admins

  or leave it unchecked to create them yourself later.

A group is a collection of users where each has the same permissions or Roles (sets of permissions).