Help Center> CodeArts Repo> Getting Started
Updated on 2023-12-04 GMT+08:00

Getting Started

If you are new to Git, go to Getting Started with Git-Based CodeArts Repo to learn how Git and CodeArts Repo work.

If you have used Git for version management, we will show you a quick overview of CodeArts Repo functions.

Creating a Repository

The following procedure describes how to create a repository using a template.

  1. Go to a target project and choose Repo from the navigation pane.
  2. Click next to New Repository and select Template Repository from the drop-down list.

  3. On the Select Template page, enter a keyword for fuzzy search and select a template as required.
  4. Click Next. On the Basic Information page, enter basic repository information.

    Table 1 Parameters for creating a repository using a template




    Repository Name


    The name must start with a letter, digit, or underscore (_) and can contain periods (.) and hyphens (-), but cannot end with .git, .atom, or period (.). The name can contain a maximum of 200 characters.



    • A repository must be associated with a project.
    • If there is no project under your account, you can click Create Project in the Project drop-down list to create a basic, a Scrum or an IPD project.

    (For a basic project, only CodeArts Repo and CodeArts Check can be used. Other services are neither enabled nor displayed. You can change a project to a basic project on the project settings page.)


    If you create a repository in a project, the project is selected for Project by default, and the Project parameter is hidden on the repository creation page.



    Enter the description of your repository.



    • Make all project developers automatic repository members.

      A project manager is automatically set as the repository administrator, and A developer is set as a common repository member. When members of the two roles are added to the project, they are added to the repository member list by automatic synchronization. You can view the list.

    • Automatically create Check task (free of charge).

      After the repository is created, you can view the code check task of the repository in the CodeArts Check task list (Note: Switch to the region where the repository is located.)



    The options are as follows:

    • Private

      Only repository members can access and commit code.

    • Public

      Read-only for all visitors and hidden from repo list and search result. You can select an open-source license as the remarks.

  5. Click OK. The repository is created and the repository list is displayed.

We are done with the repository. Let's create a branch then.

Creating a Branch

Branch is the most commonly used method in version management. Branches isolate tasks in a project to prevent them from affecting each other, and can be merged for version release.

  1. Click a repository to go to the details page.

  2. Switch to the Branches tab page under the Code tab page. Branches in the remote repository are displayed.

  3. Click Create. In the displayed dialog box, select a version (branch or tag) based on which you want to create a branch and enter the branch name. You can associate the branch with an existing work item.

    Table 2 Parameter description




    Based On


    Create a branch based on an existing branch or tag.

    Branch Name


    Name of the new branch



    Description of the new branch

    Work Items to Associate


    Specify the work items to associate with this new branch.

  4. Click OK. The branch list is displayed.

We are done with the branch. Creating a file is our next step.

Creating a File

  1. Click a repository to go to the details page.

  2. Place the cursor on the folder name and click or . Then click Create File.

  3. Set the following parameters as required:

    Table 3 Parameter description




    File name


    Name of the new file

    Empty file (no template)


    You can select multiple template types. By default, no template is used.



    The value can be text (default) or base64.

    File content


    Content of the new file

    Commit Message


    It automatically synchronizes the file name and can be customized. You can associate work items here.

  4. Click OK. The file is created and the file list is displayed.

You have created a file. Next, you can create a request for merging the two branches.

Creating a Merge Request

CodeArts Repo supports development of multiple branches and establishes configurable review rules for branch merging. When a developer initiates an MR, some repository members can be selected to participate in code reviews to ensure the correctness of the merged code.

  1. Click a repository to go to the details page.

  2. Switch to the Merge Requests tab page, click New, and select the branches to be merged.

  3. Click Next. The system checks whether the two branches are different.

    • If there is no difference between the two, the system displays a message and the request cannot be created.
    • If the branches are different, the following Create Merge Request page is displayed.

    The lower part of the Create Merge Request page displays differences of the two branches and commit records of the source branch.

  4. Set the parameters according to the following table.

    Table 4 Parameter description



    Change Branch

    Click to return to the previous step and change the branch to be merged.


    Enter the MR title.


    A default description is generated based on the merge and commit messages of the source branch. You can modify the description as required.

    Associated Work Items

    You can associate a merge action with a work item to automatically change the status of the work item.


    Mergers have permissions to merge branches (by clicking the merge button) when all approvers approve MRs and all discussed issues are solved (or you can set the rule to allow merge with issues unsolved). They can also close the MR.


    Specified to participate in the merge branch review and can raise questions to the initiator.


    Appointed to participate in the merge branch review. You can provide review comments (approved or rejected) or raise questions to the initiator.

    Delete source branch after merge

    You can choose whether to delete the source branch after merge. The preset status in the MR settings is initially used.


    Squash is to merge all change commit information of an MR into one and keep a clean history. When you focus only on the current commit progress but not the commit information, you can use squash merge.

    Enabling Squash keeps the history of the basic branch clean, with meaningful commit messages, and can be restored more easily if necessary.

  5. Click Create Merge Request to submit the MR. The Details page is displayed.

Merging a Request

  1. Click a repository to go to the details page.

  2. Switch to the Merge Requests tab page and click the name of the target merge request. The merge request details page is displayed.

  3. Ask reviewers and approvers to do their jobs.

    Table 5 Merge conditions

    Merge Condition


    Code merge conflicts

    When a merge conflict occurs between the source and target branch code, resolve the conflict before performing the next operation. For details about how to resolve a code conflict, see Resolving Code Conflicts in an MR.

    Review comment gate

    After an initiator resolves the review comments of all reviewers or approvers, the gate is passed.


    The gate function takes effect only after you choose Settings > Policy Settings > Merge Requests and select Merge after all reviews are resolved.

    Pipeline gate

    When the latest commit or pre-merged commit starts and successfully executes the pipeline, the gate is passed. For details see Configuring a Pipeline.

    E2E ticket number not associated

    After an MR is associated with a work item, the gate is passed.


    To enable the gate function, choose Settings > Policy Settings > Merge Requests and select Must be associated with CodeArts Req.

    Review gate

    When the number of reviewers reaches the minimum number, the gate is passed.

    Approval gate

    When the number of approvers reaches the minimum number, the gate is passed.

  4. Ask the merger to merge the request after an initiator meets the preceding conditions. Otherwise, the merger can close the request.

We are now done with this tutorial. You can explore more functions.