mirror of
https://github.com/apricote/releaser-pleaser.git
synced 2026-02-10 03:37:03 +00:00
Compare commits
2 commits
33c1035733
...
8ce5b765e2
| Author | SHA1 | Date | |
|---|---|---|---|
| 8ce5b765e2 | |||
| 955bd0ad10 |
3 changed files with 2 additions and 78 deletions
|
|
@ -8,11 +8,8 @@
|
||||||
<a href="https://apricote.github.io/releaser-pleaser" target="_blank"><img src="https://img.shields.io/badge/Documentation-brightgreen?style=flat-square" alt="Badge: Documentation"/></a>
|
<a href="https://apricote.github.io/releaser-pleaser" target="_blank"><img src="https://img.shields.io/badge/Documentation-brightgreen?style=flat-square" alt="Badge: Documentation"/></a>
|
||||||
<a href="https://github.com/apricote/releaser-pleaser/releases" target="_blank"><img src="https://img.shields.io/github/v/release/apricote/releaser-pleaser?sort=semver&display_name=release&style=flat-square&color=green" alt="Badge: Stable Release"/></a>
|
<a href="https://github.com/apricote/releaser-pleaser/releases" target="_blank"><img src="https://img.shields.io/github/v/release/apricote/releaser-pleaser?sort=semver&display_name=release&style=flat-square&color=green" alt="Badge: Stable Release"/></a>
|
||||||
<img src="https://img.shields.io/badge/License-GPL--3.0-green?style=flat-square" alt="Badge: License GPL-3.0"/>
|
<img src="https://img.shields.io/badge/License-GPL--3.0-green?style=flat-square" alt="Badge: License GPL-3.0"/>
|
||||||
<<<<<<< HEAD
|
|
||||||
<img src="https://img.shields.io/codecov/c/github/apricote/releaser-pleaser?style=flat-square" alt="Badge: Test Coverage"/>
|
<img src="https://img.shields.io/codecov/c/github/apricote/releaser-pleaser?style=flat-square" alt="Badge: Test Coverage"/>
|
||||||
<img src="https://img.shields.io/github/go-mod/go-version/apricote/releaser-pleaser?style=flat-square" alt="Badge: Go Version"/>
|
<img src="https://img.shields.io/github/go-mod/go-version/apricote/releaser-pleaser?style=flat-square" alt="Badge: Go Version"/>
|
||||||
=======
|
|
||||||
>>>>>>> d78ab9d (docs: update README with badges)
|
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Getting started on GitHub
|
# Getting Started on GitHub
|
||||||
|
|
||||||
In this tutorial you will learn how to set up `releaser-pleaser` in your GitHub project with GitHub Actions.
|
In this tutorial we show how to install `releaser-pleaser` in your GitHub project.
|
||||||
|
|
||||||
## 1. Repository Settings
|
## 1. Repository Settings
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,74 +1 @@
|
||||||
# Getting started on GitLab
|
# Getting started on GitLab
|
||||||
|
|
||||||
In this tutorial you will learn how to set up `releaser-pleaser` in your GitLab repository with GitLab CI.
|
|
||||||
|
|
||||||
## 1. Repository Settings
|
|
||||||
|
|
||||||
### 1.1. Fast-forward merge method
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### 1.1. Squashing
|
|
||||||
|
|
||||||
`releaser-pleaser` requires you to use `squash` merging. With other merge options it can not reliably find the right pull request for every commit on `main`.
|
|
||||||
|
|
||||||
Open your repository settings to page _General_:
|
|
||||||
|
|
||||||
> `https://github.com/YOUR-NAME/YOUR-PROJECT/settings`
|
|
||||||
|
|
||||||
In the "Pull Requests" section make sure that only "Allow squash merging" is enabled and "Allow merge commits" and "Allow rebase merging" is disabled.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
### 1.2. Workflow Permissions
|
|
||||||
|
|
||||||
`releaser-pleaser` creates [release pull requests](../explanation/release-pr.md) for you. By default, Actions are not allowed to create pull requests, so we need to enable this.
|
|
||||||
|
|
||||||
Open your repository settings to page _Actions > General_:
|
|
||||||
|
|
||||||
> `https://github.com/YOUR-NAME/YOUR-PROJECT/settings/actions`
|
|
||||||
|
|
||||||
In the "Workflow permissions" section make sure that "Allow GitHub Actions to create and approve pull requests" is enabled.
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
## 2. GitHub Actions Workflow
|
|
||||||
|
|
||||||
Create a new file `.github/workflows/releaser-pleaser.yaml` with this content. Make sure that it is available on the `main` branch.
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
name: releaser-pleaser
|
|
||||||
|
|
||||||
on:
|
|
||||||
push:
|
|
||||||
branches: [main]
|
|
||||||
pull_request_target:
|
|
||||||
types:
|
|
||||||
- edited
|
|
||||||
- labeled
|
|
||||||
- unlabeled
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
releaser-pleaser:
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
permissions:
|
|
||||||
contents: write
|
|
||||||
pull-requests: write
|
|
||||||
steps:
|
|
||||||
- name: releaser-pleaser
|
|
||||||
uses: apricote/releaser-pleaser@v0.2.0
|
|
||||||
```
|
|
||||||
|
|
||||||
## 3. Release Pull Request
|
|
||||||
|
|
||||||
Once this job runs for the first time, you can check the logs to see what it did.
|
|
||||||
If you have releasable commits since the last tag, `releaser-pleaser` opens a release pull request for the proposed release.
|
|
||||||
|
|
||||||
Once you merge this pull request, `releaser-pleaser` automatically creates a Git tag and GitHub Release with the proposed version and changelog.
|
|
||||||
|
|
||||||
## Related Documentation
|
|
||||||
|
|
||||||
- **Explanation**
|
|
||||||
- [Release Pull Request](../explanation/release-pr.md)
|
|
||||||
- **Reference**
|
|
||||||
- [GitHub CI/CD Component](../reference/gitlab-cicd-component.md)
|
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue