3.4.5 Repository management

Creating repositories is performed in Repository management. YAML file management can be enabled when creating a repository. Enable YAML file management for repositories that will register YAML files.
In Repository management, you can also view a list of repositories belonging to a group by selecting a group displayed in the navigation area.

(Figure) Repository management window

(Figure) Repository management window (Figure) Repository management window


(Table) Repository management window information

Components Description
① Add button Creates a repository. Selecting a group in the group list activates it. For details on creating repositories, see "Creating a repository".
② Group list Displays a list of groups.
③ Repository list Displays a list of repositories belonging to the group selected in the group list. The displayed columns are as follows.
  • Repository: Repository name
  • Group: Group name
  • Description: Description of the repository
  • Manifest Management:
    Enable: YAML file management is enabled
    Disable: YAML file management is disabled

If a group with no repositories or a group to which you do not belong is selected, nothing will be displayed.
④ Copy URL Copies the Git URL "https://git.tenant name.ops-integration.com/group name/project name.git".

[Roles required for repository management]

An Ops I role and a Git role are required to view and operate the Repository management window.
Users assigned the Pre-Installed role of System Administrator, Site Reliability Engineer, or the Primitive role of Repository_admin can view the Repository management window.
A user must be assigned the Git role Reporter or higher for the group to which the user belongs in order to view the list of repositories in the Repository management window. Additionally, the user must be assigned the Git role of Maintainer to add repositories. If a user who has not been assigned the Maintainer role performs an operation to add a repository, an error will occur.


[Creating a repository]

The operation for creating a repository is as follows.

1. Select the group you wish to create a repository for from the group list and click the "Add" button.
2. When the entry window for the repository information appears, enter the required information.

(Figure) Repository information entry window

(Figure) Repository information entry window (Figure) Repository information entry window


(Table) Repository information entry items

Item Required Description
Repository Name Yes The repository name. The following restrictions apply to repository names.
  • Must be unique within the group.
  • Must begin with a single-bye (a-z or 0-9).
  • The characters that can be input are as follows.
    • Single-byte alphanumeric character:
      a-z 0-9
    • Single-byte symbol:
      . -
  • Cannot contain consecutive special characters.
  • Cannot end with a special character.
  • Cannot start with hyphen (-) and cannot end with ". git" or ". atom".
  • The entire name consisting of group name + slash (/) + repository name must be 255 characters or less.
  • GitLab reserved words cannot be used. See below for information on reserved words.
    "Reserved project names" in "https://archives.docs.gitlab.com/17.3/ee/user/reserved_names.html"
Group Automatic display The selected group name is automatically displayed. This is for reference only.
Description No Repository description
Manifest Management
checkbox		 No Check the checkbox for repositories used for YAML file management. Do not check the checkbox for repositories used for management of documents other than YAML files.
3. The "Save" button will be activated after the required information has been entered. Clicking it will create the repository and display it in the repository list in the repository management window.

NotesNotes
Repositories can also be created in the GitLab window, but the necessary Webhook settings, etc., will not be performed. Please do not create repositories in the GitLab window.

If you want to enable/disable YAML file management or modify the repository, you will need to delete it and re-create a new one. Deletion of repositories is done using the API. For details, see “API reference overview” > “Details of API function and execution examples” > “Deleting the repository for registering YAML files (manifest.yaml)” in “JP1 Cloud Service/Operations Integration API Reference”.