mirror of
https://github.com/outbackdingo/matchbox.git
synced 2026-03-22 02:43:30 +00:00
* Local QEMU/KVM tutorials use either docker or rkt/acbuild, but they're dated. rkt and acbuild are no longer in mainstream use since they successfully drove OCI standardization * Remove the rkt examples, as they are just more difficult for newcomers to use and seldom maintained at this point * Retain Docker examples, although podman will likely supplant all docker usage in future
1.9 KiB
1.9 KiB
Release guide
This guide covers releasing new versions of matchbox.
Version
Create a release commit which updates old version references.
$ export VERSION=v0.7.1
Tag
Tag, sign the release version, and push it to Github.
$ 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.
$ sudo docker run quay.io/coreos/matchbox:$VERSION -version
$ sudo rkt run --no-store quay.io/coreos/matchbox:$VERSION -- -version
Github release
Publish the release on Github with release notes.
Tarballs
Build the release tarballs.
$ make release
Verify the reported version.
./_output/matchbox-v0.7.1-linux-amd64/matchbox -version
Signing
Sign the release tarballs with a CoreOS App Signing Key subkey.
cd _output
gpg2 --armor --local-user A6F71EE5BEDDBA18! --detach-sign matchbox-$VERSION-linux-amd64.tar.gz
gpg2 --armor --local-user A6F71EE5BEDDBA18! --detach-sign matchbox-$VERSION-darwin-amd64.tar.gz
gpg2 --armor --local-user A6F71EE5BEDDBA18! --detach-sign matchbox-$VERSION-linux-arm.tar.gz
gpg2 --armor --local-user A6F71EE5BEDDBA18! --detach-sign matchbox-$VERSION-linux-arm64.tar.gz
Verify the signatures.
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.