fleet/docs/development/release.md
Zach Wasserman 89c775dd95
Include fleetctl binary archives in release (#31)
This adds tooling to include fleetctl binaries (in separate .tar.gz
archives for each platform) in the release.
2020-11-12 18:03:01 -08:00

1.8 KiB

Releasing Fleet

  1. Update the CHANGELOG with the changes that have been made since the last Fleet release.

  2. Tag and push the new release in Git:

git tag <VERSION>
git push origin <VERSION>
  1. Build the new binary bundle (ensure working tree is clean because this will effect the version string built into the binary):
make binary-bundle

Make note of the SHA256 checksum output at the end of this build command to paste into the release documentation on GitHub.

  1. Create a new release on the GitHub releases page. Select the newly pushed tag (GitHub should say "Existing tag"). Use the version number as the release title. Use the below template for the release description (replace items in <> with the appropriate values):
### Changes

<COPY FROM CHANGELOG>

### Upgrading

Please visit our [update guide](https://github.com/fleetdm/fleet/blob/master/docs/infrastructure/updating-fleet.md) for upgrade instructions.

### Documentation

Documentation for this release can be found at https://github.com/fleetdm/fleet/blob/<VERSION>/docs/README.md

### Binary Checksum

**SHA256**
```
<HASH VALUE>  fleet.zip
<HASH VALUE>  fleetctl-linux.tar.gz
<HASH VALUE>  fleetctl-macos.tar.gz
<HASH VALUE>  fleetctl-windows.tar.gz
```

Upload the fleet.zip binary bundle along with the fleetctl-*.tar.gz for each platform and click "Publish Release".

  1. Push the new version to Docker Hub (ensure working tree is clean because this will effect the version string built into the binary):
make docker-push-release
  1. Announce the release in the #fleet channel of osquery Slack.