mirror of
https://github.com/outbackdingo/matchbox.git
synced 2026-01-28 10:19:36 +00:00
ff7112e9d3
* Update deployment docs to target Fedora CoreOS and Flatcar Linux * Remove redundant systemd units
74 lines
1.7 KiB
Markdown
74 lines
1.7 KiB
Markdown
|
|
# Release guide
|
|
|
|
This guide covers releasing new versions of matchbox.
|
|
|
|
## Version
|
|
|
|
Create a release commit which updates old version references.
|
|
|
|
```sh
|
|
$ export VERSION=v0.9.0
|
|
```
|
|
|
|
## Tag
|
|
|
|
Tag, sign the release version, and push it to Github.
|
|
|
|
```sh
|
|
$ git tag -s vX.Y.Z -m 'vX.Y.Z'
|
|
$ git push origin --tags
|
|
$ git push origin master
|
|
```
|
|
|
|
## Images
|
|
|
|
Travis CI will build the Docker image and push it to Quay.io when the tag is pushed to master. Verify the new image and version.
|
|
|
|
```sh
|
|
$ sudo docker run quay.io/poseidon/matchbox:$VERSION -version
|
|
```
|
|
|
|
## Github release
|
|
|
|
Publish the release on Github with release notes.
|
|
|
|
## Tarballs
|
|
|
|
Build the release tarballs.
|
|
|
|
```sh
|
|
$ make release
|
|
```
|
|
|
|
Verify the reported version.
|
|
|
|
```
|
|
./_output/matchbox-v0.9.0-linux-amd64/matchbox -version
|
|
```
|
|
|
|
## Signing
|
|
|
|
Release tarballs are signed by Dalton Hubble's GPG [Key](/docs/deployment.md#download)
|
|
|
|
```sh
|
|
cd _output
|
|
gpg2 --armor --detach-sign matchbox-$VERSION-linux-amd64.tar.gz
|
|
gpg2 --armor --detach-sign matchbox-$VERSION-darwin-amd64.tar.gz
|
|
gpg2 --armor --detach-sign matchbox-$VERSION-linux-arm.tar.gz
|
|
gpg2 --armor --detach-sign matchbox-$VERSION-linux-arm64.tar.gz
|
|
```
|
|
|
|
Verify the signatures.
|
|
|
|
```sh
|
|
gpg2 --verify matchbox-$VERSION-linux-amd64.tar.gz.asc matchbox-$VERSION-linux-amd64.tar.gz
|
|
gpg2 --verify matchbox-$VERSION-darwin-amd64.tar.gz.asc matchbox-$VERSION-darwin-amd64.tar.gz
|
|
gpg2 --verify matchbox-$VERSION-linux-arm.tar.gz.asc matchbox-$VERSION-linux-arm.tar.gz
|
|
gpg2 --verify matchbox-$VERSION-linux-arm64.tar.gz.asc matchbox-$VERSION-linux-arm64.tar.gz
|
|
```
|
|
|
|
## Publish
|
|
|
|
Upload the signed tarball(s) with the Github release. Promote the release from a `pre-release` to an official release.
|