此内容没有您所选择的语言版本。
7.3. Cloning a Repository
It is possible to clone a repository either in Business Central or using the REST API calls. The kie-config-cli
tool cannot be used to clone arbitrary repositories. Run git clone
, or use one of the following options instead:
Cloning a Repository in Business Central
Note that only users with the admin
role in Business Central can clone repositories.
Procedure: Using Business Central to Clone a Repository
-
In Business Central, go to Authoring
Administration. On the perspective menu, choose Repositories
Clone repository. The Clone Repository pop-up window is displayed.
Figure 7.3. Clone Repository Dialog Window
In the Clone Repository dialog window, enter the repository details:
- Enter the Repository Name to be used as the repository identifier in the Asset repository and select the Organizational Unit it should be added to.
Enter the URL of the Git repository:
-
For a local repository, use
file:///PATH_TO_REPOSITORY/REPOSITORY_NAME
. For a remote or preexisting repository, use
https://github.com/USERNAME/REPOSITORY_NAME.git
orgit://HOST_NAME/REPOSITORY_NAME
.ImportantIt is important to use the HTTPS or Git protocol instead of a SCP-style SSH URL. Business Central does not support the basic SSH URL and fails with
Invalid URL format
.
NoteThe file protocol is only supported for READ operations. WRITE operations are not supported.
-
For a local repository, use
- If applicable, enter the User Name and Password of your Git account to be used for authentication.
Click Clone.
A confirmation prompt with the notification that the repository was created successfully is displayed.
Click Ok.
The repository is now being indexed. Some workbench features may be unavailable until the indexing has completed.
You can view the cloned repository either in the File Explorer or the Project Explorer.
If you are deploying Business Central on WebLogic server, set the following Java system property in the setDomainEnv.sh
file (for Linux) or setDomainEnv.cmd
file (for Windows):
JAVA_OPTIONS="%JAVA_OPTIONS% -DUseSunHttpHandler=true"
JAVA_OPTIONS="%JAVA_OPTIONS% -DUseSunHttpHandler=true"
This enables the WebLogic server to use the HTTP handlers.
Cloning a Repository Using the REST API
To clone a repository, issue the POST
REST API call. This call creates or clones (according to the value of the requestType
parameter) the repository defined by the JSON entity.
The input parameter of the call is a RepositoryRequest
instance. The Call returns a CreateOrCloneRepositoryRequest
instance.
Note that, only users with the rest-all
role can clone repositories.
Example 7.3. Cloning a Repository Using the Curl Utility
Example JSON entity containing details of a repository to be cloned:
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":"clonedRepository","description":null,"requestType":"clone","gitURL":"git://localhost:9418/newRepository","organizationalUnitName":"helloWorldUnit"}'
curl -X POST 'localhost:8080/business-central/rest/repositories/' -u USERNAME:PASSWORD -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"name":"clonedRepository","description":null,"requestType":"clone","gitURL":"git://localhost:9418/newRepository","organizationalUnitName":"helloWorldUnit"}'
For further information, refer to chapter Knowledge Store REST API, section Repository Calls of Red Hat JBoss BPM Suite Development Guide.