Updated on 2025-07-24 GMT+08:00

Creating a Repository Group

Constraints

Table 1 Constraints on creating a repository group

Item

Description

Permission constraint

You have the permission to create a repository group. If not, refer to Configuring Repo-Level Permissions.

Function constraint

  • A repository group supports a maximum of five levels of directories.
  • You can only create a repository group either in a new project or an existing one.

Overview

A repository group consists of one or more repositories. You can configure and manage repository rules for repositories or child repository groups in a repository group, including commit rules and member permissions.

Creating a Repository Group

  1. You can create a repository group in either of the following ways:

    • As shown in the following figure, go to a project or parent organization, click the drop-down list box next to Create Repository and select Create Repository Group. The page for creating a repository group is displayed.
      Figure 1 Project-level CodeArts Repo homepage
    • Go to the CodeArts Repo homepage, click any line under Repository Groups, and click Create Repository Group, as shown in the following figure.
    Figure 2 CodeArts Repo homepage

  2. Enter the basic information according to the following table and click OK. A repository group supports a maximum of five levels of directories.

    Table 2 Parameters for creating a repository group

    Parameters

    Description

    Project

    • If you access the page from a project or parent organization, this parameter is set by default.
    • If you access the page from the CodeArts Repo homepage, select an existing project from the Project drop-down list or Create Project.

    Path

    Optional. The default value is /, indicating that the repo group is the first-level repo group after the repo group path is created. You can also select an existing repo group path from the drop-down list.

    Name

    Mandatory. Start with a letter, digit, or underscore (_), and use letters, digits, hyphens (-), underscores (_), and periods (.). Do not end with .git, .atom, or periods (.). Max. 256 characters.

    Description

    Optional. Describe your repository group. Max. 2,000 characters.

    Visibility

    Mandatory. You can choose Private (default) or Public.

    • Private

      Only repository group members can access. The child repository groups and repositories in a private repository group can only be private.

    • Public

      Read-only for visitors via referral link and hidden from repo lists and search results. Child repository groups and repositories in a public repository group can be private or public.