Connect applications to Git
Learn how to connect your Bonita UI Builder application to a remote Git repository.
-
Difficulty: Beginner
-
Estimated time: 15 minutes
-
Prerequisites: Basic knowledge of Git
Version control in Bonita UI Builder requires a Git hosting service that supports SSH protocol and deploys keys. HTTPS connections are not currently supported. |
The Git repository must be empty for the connection to be successful. |
How to connect an application to Git
Connect to GitHub
This section explains how to connect your Bonita UI Builder application to an empty GitHub repository.
-
Open the Bonita UI Builder application you want to connect to and click on Connect Git on the left side of the bottom bar.
-
Select GitHub as the service provider.
-
Create a new empty Git repository or open an existing one.
-
Go to the repository’s main page, click on the Code button, and copy the SSH URL.
-
Paste the SSH URL into the Generate SSH Key field in the Bonita UI Builder.
-
Click on the Generate SSH Keys button to generate unique
ECDSA 256
andRSA 4096
keys. Select the key type that meets your security requirements and system capabilities. -
Copy one of the keys, go to Repository settings on GitHub, navigate to Deploy keys, click Add deploy key, paste the key, and give it a descriptive title.
-
Enable the Allow write access option and add the key.
-
Back in Bonita UI Builder, click on Connect Git.
Your application is now connected to GitHub.
Connect to GitLab
This section explains how to connect your Bonita UI Builder application to an empty GitLab repository.
-
Open the Bonita UI Builder application you want to connect to and click on Connect Git on the left side of the bottom bar.
-
Select GitLab as the service provider.
-
Create a new empty Git repository or open an existing one. See the GitLab documentation for instructions on creating a repository.
-
Go to the repository’s main page, click on the Code button, and copy the SSH URL.
-
Paste the SSH URL into the Generate SSH Key field in the Bonita UI Builder.
-
Click on the Generate SSH Keys button to generate unique
ECDSA 256
andRSA 4096
keys. Select the key type that meets your security requirements and system capabilities. -
Copy one of the keys, go to Repository settings in GitLab, navigate to Deploy keys, click Add deploy key, paste the key and give it a descriptive title.
-
Enable the Allow write access option and add the key.
-
Back in Bonita UI Builder, click Connect Git.
Your application is now connected to GitLab.
Connect to Bitbucket
This section explains how to connect your Bonita UI Builder application to an empty Bitbucket repository.
-
Open the Bonita UI Builder application you want to connect to and click on Connect Git on the left side of the bottom bar.
-
Select Bitbucket as the service provider.
-
Create a new empty git repository if you don’t already have one. See the Bitbucket documentation for details.
-
Go to the repository’s main page, click on the Clone button, select SSH, and copy the SSH URL.
-
Paste the SSH URL into the Generate SSH Key field in the Bonita UI Builder, making sure to remove
git clone
from the URL. -
Click on the Generate SSH Keys button to generate unique
ECDSA 256
andRSA 4096
keys. Select the key type that meets your security requirements and system capabilities. -
Copy one of the keys, go to Workspace settings in Bitbucket, navigate to SSH keys, click Add SSH key, paste the key and give it a descriptive title.
-
Back in Bonita UI Builder, click Connect Git.
Your application is now be connected to Bitbucket.
Connect to other Git providers
This section explains how to connect your Bonita UI Builder application to any other Git provider, using Azure repos as an example.
-
Open the Bonita UI Builder application you want to connect to and click on Connect Git on the left side of the bottom bar.
-
Select Others as the service provider.
-
Create a new empty Git repository or open an existing one.
-
Go to the repository’s main page and copy the SSH URL.
-
Paste the SSH URL into the Generate SSH Key field in the Bonita UI Builder.
-
Click on the Generate SSH Keys button to generate unique
ECDSA 256
andRSA 4096
keys. When connecting to Azure Repos, select theRSA 4096
key. -
Copy the key, go to User Settings in Azure Repos, open SSH public keys and click + New key. Add a key name and paste the generated
RSA 4096
key into the Public Key Data field. -
Back in Bonita UI Builder, click Connect Git.
Your application is now connected to your chosen Git provider.