89 lines
No EOL
2.3 KiB
Markdown
89 lines
No EOL
2.3 KiB
Markdown
# CI Template
|
|
|
|
A template repository for setting up continuous integration and automatic semantic versioning with Gitea.
|
|
|
|
## Features
|
|
|
|
- Automated semantic versioning with [semantic-release](https://github.com/semantic-release/semantic-release)
|
|
- Integration with Gitea for releases
|
|
- Changelog generation
|
|
- Pull request workflows
|
|
|
|
## Setup Instructions
|
|
|
|
Follow these steps to set up the CI pipeline and release process:
|
|
|
|
### 1. Configure Branch Protection
|
|
|
|
Add yourself to the whitelist in the release branch protection rule.
|
|
|
|
|
|
|
|
Don't forget to save your changes.
|
|
|
|
|
|
|
|
### 2. Create the Release Branch
|
|
|
|
Create a new branch named `release`.
|
|
|
|
|
|
|
|
The pipeline for release will start automatically but will fail on the first run. This is expected behavior.
|
|
|
|
|
|
|
|
### 3. Create the Initial Version Tag
|
|
|
|
Run the following commands to create and push the first version tag:
|
|
|
|
```bash
|
|
git tag v0.1.0
|
|
git push origin tag v0.1.0
|
|
```
|
|
|
|
### 4. Configure Pull Request Settings
|
|
|
|
Set up your repository's pull request settings as shown:
|
|
|
|
|
|
|
|
### 5. Set Up Deploy Keys
|
|
|
|
1. Generate an SSH key pair (public and private)
|
|
2. Add the public key to deploy keys named "release" with write access enabled
|
|
|
|
|
|
|
|
3. Add the private key to the runner secret as `DEPLOY_KEY`
|
|
|
|
|
|
|
|
## Release Process
|
|
|
|
This template uses semantic versioning through conventional commits. When changes are merged to the release branch, a new version is automatically:
|
|
|
|
1. Determined based on commit messages
|
|
2. Tagged in Git
|
|
3. Published as a release
|
|
4. Added to the changelog
|
|
|
|
### Commit Message Format
|
|
|
|
Follow the [Conventional Commits](https://www.conventionalcommits.org/) specification:
|
|
|
|
- `feat: add new feature` (triggers MINOR version bump)
|
|
- `fix: resolve bug` (triggers PATCH version bump)
|
|
- `BREAKING CHANGE: redesign API` (triggers MAJOR version bump)
|
|
|
|
## Getting Started
|
|
|
|
After setup, you can:
|
|
1. Create a feature branch from main
|
|
2. Make changes and commit using conventional commit format
|
|
3. Create a pull request to main
|
|
4. After approval, changes will be merged to release automatically
|
|
|
|
## License
|
|
|
|
See the [LICENSE](LICENSE) file for details. |