This content is dedicated to our next version. It is work in progress: its content will evolve until the new version is released.

Before that time, it cannot be considered as official.

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.

Currently, a remote Git repository can be linked to one UI Builder application only. Of course, you can use multiple repositories to connect to multiple applications.

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.

  1. Open the Bonita UI Builder application you want to connect to and click on Connect Git on the left side of the bottom bar.

  2. Select GitHub as the service provider.

  3. Create a new empty Git repository or open an existing one.

  4. Go to the repository’s main page, click on the Code button, and copy the SSH URL.

  5. Paste the SSH URL into the Generate SSH Key field in the Bonita UI Builder.

  6. Click on the Generate SSH Keys button to generate unique ECDSA 256 and RSA 4096 keys. Select the key type that meets your security requirements and system capabilities.

  7. 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.

  8. Enable the Allow write access option and add the key.

  9. 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.

  1. Open the Bonita UI Builder application you want to connect to and click on Connect Git on the left side of the bottom bar.

  2. Select GitLab as the service provider.

  3. Create a new empty Git repository or open an existing one. See the GitLab documentation for instructions on creating a repository.

  4. Go to the repository’s main page, click on the Code button, and copy the SSH URL.

  5. Paste the SSH URL into the Generate SSH Key field in the Bonita UI Builder.

  6. Click on the Generate SSH Keys button to generate unique ECDSA 256 and RSA 4096 keys. Select the key type that meets your security requirements and system capabilities.

  7. 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.

  8. Enable the Allow write access option and add the key.

  9. 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.

  1. Open the Bonita UI Builder application you want to connect to and click on Connect Git on the left side of the bottom bar.

  2. Select Bitbucket as the service provider.

  3. Create a new empty git repository if you don’t already have one. See the Bitbucket documentation for details.

  4. Go to the repository’s main page, click on the Clone button, select SSH, and copy the SSH URL.

  5. Paste the SSH URL into the Generate SSH Key field in the Bonita UI Builder, making sure to remove git clone from the URL.

  6. Click on the Generate SSH Keys button to generate unique ECDSA 256 and RSA 4096 keys. Select the key type that meets your security requirements and system capabilities.

  7. 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.

  8. 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.

  1. Open the Bonita UI Builder application you want to connect to and click on Connect Git on the left side of the bottom bar.

  2. Select Others as the service provider.

  3. Create a new empty Git repository or open an existing one.

  4. Go to the repository’s main page and copy the SSH URL.

  5. Paste the SSH URL into the Generate SSH Key field in the Bonita UI Builder.

  6. Click on the Generate SSH Keys button to generate unique ECDSA 256 and RSA 4096 keys. When connecting to Azure Repos, select the RSA 4096 key.

  7. 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.

  8. Back in Bonita UI Builder, click Connect Git.

Your application is now connected to your chosen Git provider.

See also