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
- In Business Central, go to Authoring → Administration.
- On the perspective menu, click Repositories → New repository.
- The New Repository pop-up window is displayed.
Figure 7.2. New Repository Dialog Window
- 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.
- 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.