7.2. Creating a repository

There are three ways to create a repository: using the Administration perspective of Business Central, the kie-config-cli tool or the REST API calls.

⁠Creating a Repository in Business Central

Important

Note that only users with the admin role can create repositories.

Procedure 7.2. Using Business Central to Create a Repository

  1. In Business Central, go to Authoring → Administration.
  2. On the perspective menu, click Repositories → New repository.
  3. The New Repository pop-up window is displayed.
    A screenshot of the New Repository dialog window.

    Figure 7.2. New Repository Dialog Window

  4. Specify the two mandatory parameters:
    • repository name

      Note

      Make sure that the repository name is a valid file name. Avoid using a space or any special character that might lead to an invalid name.
    • organizational unit: specifies the location of the newly created repository.
  5. Click Finish.
The new repository can be viewed either in the File Explorer or Project Explorer views.

⁠Creating a Repository Using the kie-config-cli Tool

To create a new Git repository using the kie-config-cli tool, run the create-repo command. The tool then guides you through the entire process of creating a repository by asking for other required parameters. Type help for a list of all commands.
For more information about the kie-config-cli tool, see Chapter 4, Command line configuration.

⁠⁠Creating a Repository Using the REST API

To create a repository in the Knowledge Store, issue the POST REST API call. Details of the repository are defined by the JSON entity. Make sure you established an authenticated HTTP session before executing this call.
Input parameter is a RepositoryRequest instance. Returns a CreateOrCloneRepositoryRequest instance.

Example 7.2. Creating a Repository Using the Curl Utility

Example JSON entity containing details of a repository to be created: 
{
	"name"                   : "newRepository",
	"description"            : "Repository for the Hello World project.",
	"userName"               :  null,
	"password"               :  null,
	"gitURL"                 :  null,
	"requestType"            : "new",
	"organizationalUnitName" : "helloWorldUnit"
}
Execute the following command: 
curl -X POST 'localhost:8080/business-central/rest/repositories/' -u USERNAME:PASSWORD -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"name":"newRepository","description":"Repository for the Hello World project.","username":null,"password":null,"requestType":"new","gitURL":null,"organizationalUnitName":"helloWorldUnit"}'
For further information, refer to the Red Hat JBoss BPM Suite Development Guide, section Repository Calls.