Connect GitHub, GitLab, Bitbucket¶
The Amverum service provides the ability to use a third-party git service as the main one. To do this, you will need to set up a webhook and connect the git service on the «Repository» tab of your project.
Let’s look at the connection process using a public GitHub repository as an example.
Go to the «Repository» tab of your project
Select your git service from the list
Select an event, if successful, the Amverum repository will make a pull. If both events are selected, the Amverum repository will respond to the CI event
Come up with and add a secret (required field). After adding it, you can change it, but you will not be able to see the value
Specify the target branch of the remote repository
Copy the proposed address
Click «Apply»
Important
CI for GitHub - Worflow runs, for GitLab - Pipeline events.
During git pull the merge strategy their is used.
Afterwards, you will need to set up a webhook in GitHub.
Add a new webhook
Paste the copied address
Select Content-type: application/json
Add the secret that you added to Amverum
Select the event you want to start building the project (Push / Workflow runs). Amverum will respond to other events with status 400
Click «Add webhook»
Now you can do git push to the remote GitHub repository, after which all changes will be applied to the Amverum repository. The build will start automatically.
Connecting a private GitHub repository.
The process is completely identical, except for the need to generate and add an access token.
Go to your GitHub account settings
Select «Developer settings» on the bottom left
Select Tokens (classic) -> Generate new token
Enter a name
Set Expiration to No expiration
Check the repo box
Click «Generate token»
Copy its value
Go to the «Repository» tab of your project in Amverum and add the copied token. After the changes have been successfully applied, you can git push to the private repository, and all changes will be applied to the Amverum repository.