Integrate your GitHub repository
Connect your GitHub repository
Integrate Zerops to your GitHub repository and configure the automatic builds and deploys.
Before you start the integration, create a runtime service in Zerops and add zerops.yml to your repository.
In Zerops GUI go to the service detail and select Build, deploy, run pipeline settings from the left menu.
Then follow these steps:
- Click on the Connect with a GitHub repository button.
- You will be prompted to grant Zerops access to your public and private repositories.
Zerops needs full access to your repositories on GitHub to be able to configure GitHub webhooks and download your application code into the build container. When the build pipeline is finished, the build container is deleted. Zerops doesn't store your source code.
- Select the repository you want to integrate with the runtime service.
- Choose the New tag option if you want to trigger the build & deploy pipeline each time you create a new tag. Optionally, Add a regular expression without slashes. Every new tag you create will be checked against the specified regular expression. New build and deploy pipeline will be triggered only if the tag matches the regular expression.
- Or choose the Push to branch option and select the branch from the list. Every push to the selected branch will trigger a new build & pipeline
// TODO Screenshot: connect to a repository with a GitHub repository selected.
Disconnect your GitHub repository
Once the integration to your GitHub repository is established, Zerops creates a webhook in your GitHub repository.
When you want to stop the integration, go to the service detail and select Build, deploy, run pipeline settings from the left menu. Then click on the Stop automatic build trigger button.
// TODO Screenshot: page where you can stop to automatic build trigger
Zerops removes the webhook in GitHub and deletes the integration configuration.