2023-03-25 14:58:20 +00:00
|
|
|
# Releases
|
|
|
|
|
|
|
|
|
|
A release consists of:
|
|
|
|
|
|
2024-10-03 16:59:48 +00:00
|
|
|
- A full set of `isle` binaries for all supported platforms, compiled from the
|
|
|
|
|
same source.
|
2023-03-25 14:58:20 +00:00
|
|
|
- A text file containing hashes of each binary.
|
|
|
|
|
- A file containing a signature of the hash file, created by whoever is building
|
|
|
|
|
the release.
|
|
|
|
|
|
|
|
|
|
## Building
|
|
|
|
|
|
|
|
|
|
*NOTE: This has only been tested from an x86_64 linux machine*
|
|
|
|
|
|
|
|
|
|
To create a release only a functional nix installation is required. Simply run
|
|
|
|
|
the `./release.sh` script, and input a release name when prompted.
|
|
|
|
|
|
2023-08-05 21:53:17 +00:00
|
|
|
From here an `isle` binary will be cross-compiled for all supported
|
2023-03-25 14:58:20 +00:00
|
|
|
platforms. This will take a long time the first time you perform it on your
|
|
|
|
|
machine.
|
|
|
|
|
|
2024-07-07 11:37:26 +00:00
|
|
|
Once compilation is completed, the release will be signed using the default GPG
|
2023-03-25 14:58:20 +00:00
|
|
|
key on your machine, and you will be prompted for its password in order to
|
|
|
|
|
create the signature.
|
|
|
|
|
|
|
|
|
|
## Releasing
|
|
|
|
|
|
2024-12-17 10:33:19 +00:00
|
|
|
Release artifactes are hosted at `micropelago.net` under
|
|
|
|
|
`/isle/releases/<release name>`. An `index.gmi` page should be created in that
|
|
|
|
|
directory which includes links to each artifact, as well as a changelog
|
|
|
|
|
detailing all new features and fixes included since the previous release.
|
|
|
|
|
|
|
|
|
|
A link to the new release should be included at `/isle/releases/index.gmi`.
|
|
|
|
|
|
|
|
|
|
The release shoulld be tagged in the git repo using its release name as well,
|
|
|
|
|
with the tag notes linking to the `micropelago.net` page.
|
