Integrating your GitHub repository
Integrate Zerops to your GitHub repository and configure the automatic builds and deploys.
Prerequisites​
Before you start the integration, ensure you have zerops.yml
file in the root of your repository.
For more information, refer to our zerops.yml documentation.
Integration Steps​
-
Access Service Settings
- Log into the Zerops GUI
- Select your service
- Navigate to "Build, deploy, run pipeline settings" in the left menu
-
Connect to GitHub
- Click "Connect with a GitHub repository"
- Grant Zerops access to your repositories when prompted
Note
Zerops requires full access to configure webhooks and download your code. We don't store your source code unless explicitly specified.
-
Select Repository and Trigger
- Choose the repository to integrate
- Select a trigger method
- New tag: Builds trigger on new tags (Recommended)
- Optionally add a regex to filter tags
- Push to branch: Builds trigger on pushes to specific branch
- New tag: Builds trigger on new tags (Recommended)
-
Finalize Setup
- Confirm your settings to complete the integration
Managing Your Integration​
To skip a build for a specific commit, include [ci skip]
or [skip ci]
(case insensitive) in your commit message.
Note
The webhook will still show as delivered in GitHub, but no action will be taken.
Disconnecting Your Repository​
To stop the integration:​
- Go to your service details
- Select "Build, deploy, run pipeline settings"
- Click "Stop automatic build trigger"
This action removes the GitHub webhook and deletes the integration configuration.