chore(inkless:release): add gh workflows to release inkless artifacts by jeqo · Pull Request #489 · aiven/inkless

jeqo · 2026-01-20T21:03:03Z

Add GitHub Actions workflows for automated release and edge builds, with unified docker build process via Makefile.

Changes

GitHub Workflows:

inkless-release.yml - Main release workflow supporting:
- Manual trigger for main releases (inkless-release-X.Y)
- Auto trigger for Kafka-base releases (inkless-4.x.y-*)
- Multi-arch builds (amd64, arm64)
- Binary distribution uploads to GitHub Releases
inkless-edge.yml - Edge/development builds on every push to main

Makefile:

Unified docker_build target supporting both local and CI usage
Optional parameters: PLATFORM, DOCKER_TAGS, PUSH, CACHE_FROM, CACHE_TO
Deterministic DIST_VERSION selection with sort -V
Portable date format (works on macOS/BSD)
GITHUB_USER validation in docker_login

Docker Image Tags

Tag	Description
`latest`	Latest stable Inkless release
`X.Y`	Specific Inkless version (e.g., `0.33`)
`A.B.C-X.Y`	Kafka + Inkless version (e.g., `4.1.0-0.33`)
`A.B-latest`	Latest patch for Kafka minor (e.g., `4.1-latest`)
`edge`	Latest development build from `main`

Testing

# Build locally
make docker_build

Follow-up

Demo and documentation updates are in a separate PR: #497

Copilot

Pull request overview

This pull request adds GitHub Actions workflows to automate the release process for Inkless artifacts, including Docker images and binary distributions. The PR introduces release automation for both stable releases and development edge builds.

Changes:

Added GitHub Actions workflows for releasing Inkless artifacts (Docker images to GHCR and binaries to GitHub Releases)
Created comprehensive documentation explaining how to download and use Inkless releases
Updated existing documentation with cross-references to the new release documentation

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
`.github/workflows/inkless-release.yml`	Main release workflow that builds multi-architecture Docker images and uploads binary distributions for both main releases and Kafka-base releases
`.github/workflows/inkless-edge.yml`	Development/edge build workflow for continuous integration, creating edge Docker images from the main branch
`docs/inkless/RELEASES.md`	New documentation file explaining Docker image tags, binary distribution naming, download instructions, and platform support
`docs/inkless/VERSIONING-STRATEGY.md`	Added cross-reference to the new RELEASES.md documentation
`docs/inkless/README.md`	Updated documentation index to include link to RELEASES.md

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

.github/workflows/inkless-release.yml

.github/workflows/inkless-edge.yml

.github/workflows/inkless-release.yml

Copilot

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

.github/workflows/inkless-release.yml

Copilot

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated no new comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Makefile

docs/inkless/VERSIONING-STRATEGY.md

Copilot

Pull request overview

Copilot reviewed 10 out of 10 changed files in this pull request and generated 11 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

docs/inkless/QUICKSTART.md

docker/examples/docker-compose-files/inkless/docker-compose.yml

.github/workflows/inkless-release.yml

Makefile

docker/examples/docker-compose-files/inkless/docker-compose.demo.yml

.github/workflows/inkless-release.yml

.github/workflows/inkless-edge.yml

Copilot

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 3 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

docs/inkless/QUICKSTART.md

.github/workflows/inkless-release.yml

docker/examples/docker-compose-files/inkless/Makefile

Copilot

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 8 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

docs/inkless/QUICKSTART.md

.github/workflows/inkless-release.yml

Makefile

docker/examples/docker-compose-files/inkless/README.md

docs/inkless/QUICKSTART.md

Makefile

Copilot

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 6 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

.github/workflows/inkless-release.yml

docs/inkless/QUICKSTART.md

docker/examples/docker-compose-files/inkless/README.md

.github/workflows/inkless-release.yml

Copilot

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Makefile

.github/workflows/inkless-release.yml

.github/workflows/inkless-edge.yml

Copilot

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

.github/workflows/inkless-edge.yml

.github/workflows/inkless-release.yml

Makefile

Add two workflows for automated Docker image and binary releases: - inkless-edge.yml: Builds and publishes edge images on push to main - Multi-arch support (amd64, arm64) - Tags: edge, edge-<sha> - inkless-release.yml: Handles stable releases - Triggered by kafka-base tags (inkless-4.x.y-*) or manual dispatch - Builds Docker images and binary distributions - Creates GitHub releases with attached binaries - Tags: latest, X.Y, A.B.C-X.Y, A.B-latest Both workflows use native runners per architecture for faster builds and include proper error handling and Buildx setup. Also fixes: - Use sort -V for deterministic DIST_VERSION selection - Use portable date format (works on macOS/BSD) - Add GITHUB_USER validation in docker_login - Add --push to docker_build_multiarch target - Support CI parameters (PLATFORM, DOCKER_TAGS, PUSH, etc.) - Remove KAFKA_VERSION override from demo target

- Add RELEASES.md with Docker tags and binary distribution info - Update VERSIONING-STRATEGY.md with workflow trigger details

Copilot

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 4 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Makefile

docs/inkless/RELEASES.md

viktorsomogyi · 2026-02-03T10:20:26Z

docker/inkless/Dockerfile

    apk update ; \
    apk upgrade ; \
    apk add --no-cache wget gcompat gpg gpg-agent procps bash; \
    mkdir opt/kafka; \


No strictly related to your change but should it be an absolute path instead? As I see other similar commands consistently use that.

We can also fix this in a separate PR, I found a few other similar pathing issues anyway.

Good catch. Yes, I think this inconsistency comes from upstream: https://github.com/apache/kafka/blob/5498eedf92a016e6838bce5383042bda1c798d76/docker/jvm/Dockerfile#L35

jeqo · 2026-02-03T11:18:39Z

https://github.com/aiven/inkless/releases/tag/inkless-release-0.33 is fully released now with binaries and docker images -- will have to do 0.34 manually as well as there are mismatch on Dockerfile expectations. After that, we can use the automated flow.

…#489) Add two workflows for automated Docker image and binary releases: - inkless-edge.yml: Builds and publishes edge images on push to main - Multi-arch support (amd64, arm64) - Tags: edge, edge-<sha> - inkless-release.yml: Handles stable releases - Triggered by kafka-base tags (inkless-4.x.y-*) or manual dispatch - Builds Docker images and binary distributions - Creates GitHub releases with attached binaries - Tags: latest, X.Y, A.B.C-X.Y, A.B-latest Both workflows use native runners per architecture for faster builds and include proper error handling and Buildx setup. Also fixes: - Use sort -V for deterministic DIST_VERSION selection - Use portable date format (works on macOS/BSD) - Add GITHUB_USER validation in docker_login - Add --push to docker_build_multiarch target - Support CI parameters (PLATFORM, DOCKER_TAGS, PUSH, etc.) - Remove KAFKA_VERSION override from demo target - Add RELEASES.md with Docker tags and binary distribution info - Update VERSIONING-STRATEGY.md with workflow trigger details

jeqo force-pushed the jeqo/release-workflow branch 2 times, most recently from 0d459b9 to a4ca68b Compare January 20, 2026 21:26

jeqo requested a review from Copilot January 21, 2026 09:58

Copilot started reviewing on behalf of jeqo January 21, 2026 09:58 View session

Copilot AI reviewed Jan 21, 2026

View reviewed changes

jeqo requested a review from Copilot January 21, 2026 10:24

Copilot started reviewing on behalf of jeqo January 21, 2026 10:24 View session

Copilot AI reviewed Jan 21, 2026

View reviewed changes

.github/workflows/inkless-release.yml Outdated Show resolved Hide resolved

.github/workflows/inkless-release.yml Outdated Show resolved Hide resolved

jeqo requested a review from Copilot January 21, 2026 10:50

Copilot started reviewing on behalf of jeqo January 21, 2026 10:51 View session

Copilot AI reviewed Jan 21, 2026

View reviewed changes

jeqo marked this pull request as ready for review January 21, 2026 11:39

jeqo requested a review from Copilot February 2, 2026 13:39

Copilot started reviewing on behalf of jeqo February 2, 2026 13:40 View session

Copilot AI reviewed Feb 2, 2026

View reviewed changes

Makefile Show resolved Hide resolved

Makefile Show resolved Hide resolved

docs/inkless/VERSIONING-STRATEGY.md Outdated Show resolved Hide resolved

jeqo requested a review from Copilot February 2, 2026 14:08

Copilot started reviewing on behalf of jeqo February 2, 2026 14:09 View session

Copilot AI reviewed Feb 2, 2026

View reviewed changes

jeqo force-pushed the jeqo/release-workflow branch from 9aae49f to 3e131c2 Compare February 2, 2026 16:41

jeqo requested a review from Copilot February 2, 2026 16:43

Copilot started reviewing on behalf of jeqo February 2, 2026 16:43 View session

Copilot AI reviewed Feb 2, 2026

View reviewed changes

docs/inkless/QUICKSTART.md Outdated Show resolved Hide resolved

.github/workflows/inkless-release.yml Show resolved Hide resolved

docker/examples/docker-compose-files/inkless/Makefile Outdated Show resolved Hide resolved

jeqo force-pushed the jeqo/release-workflow branch 3 times, most recently from 5ff073b to 76e6633 Compare February 2, 2026 17:40

jeqo requested a review from Copilot February 2, 2026 17:41

Copilot started reviewing on behalf of jeqo February 2, 2026 17:41 View session

Copilot AI reviewed Feb 2, 2026

View reviewed changes

jeqo force-pushed the jeqo/release-workflow branch 2 times, most recently from 74a430a to c965dc7 Compare February 2, 2026 18:56

Copilot started reviewing on behalf of jeqo February 3, 2026 06:00 View session

Copilot AI reviewed Feb 3, 2026

View reviewed changes

jeqo force-pushed the jeqo/release-workflow branch 2 times, most recently from 9ac5bae to 42c92ee Compare February 3, 2026 08:09

jeqo mentioned this pull request Feb 3, 2026

chore(inkless): Update demo and documentation for GHCR images #497

Merged

jeqo requested a review from Copilot February 3, 2026 08:11

Copilot started reviewing on behalf of jeqo February 3, 2026 08:12 View session

Copilot AI reviewed Feb 3, 2026

View reviewed changes

jeqo force-pushed the jeqo/release-workflow branch from 42c92ee to afa80b6 Compare February 3, 2026 08:54

jeqo requested a review from Copilot February 3, 2026 08:55

Copilot started reviewing on behalf of jeqo February 3, 2026 08:56 View session

Copilot AI reviewed Feb 3, 2026

View reviewed changes

.github/workflows/inkless-edge.yml Outdated Show resolved Hide resolved

.github/workflows/inkless-release.yml Outdated Show resolved Hide resolved

Makefile Show resolved Hide resolved

Makefile Outdated Show resolved Hide resolved

jeqo added 2 commits February 3, 2026 11:46

docs(inkless): add releases documentation

eec1436

- Add RELEASES.md with Docker tags and binary distribution info - Update VERSIONING-STRATEGY.md with workflow trigger details

jeqo force-pushed the jeqo/release-workflow branch from a2d648f to eec1436 Compare February 3, 2026 09:47

jeqo requested a review from Copilot February 3, 2026 09:47

Copilot started reviewing on behalf of jeqo February 3, 2026 09:48 View session

Copilot AI reviewed Feb 3, 2026

View reviewed changes

Makefile Show resolved Hide resolved

docs/inkless/RELEASES.md Show resolved Hide resolved

docs/inkless/RELEASES.md Show resolved Hide resolved

docs/inkless/RELEASES.md Show resolved Hide resolved

viktorsomogyi reviewed Feb 3, 2026

View reviewed changes

viktorsomogyi previously approved these changes Feb 3, 2026

View reviewed changes

jeqo added 2 commits February 3, 2026 13:14

fixup! feat(ci): add GitHub workflows for Inkless releases

7b5e551

fixup! docs(inkless): add releases documentation

38263d3

jeqo dismissed viktorsomogyi’s stale review via 38263d3 February 3, 2026 11:16

jeqo requested a review from viktorsomogyi February 3, 2026 11:17

viktorsomogyi approved these changes Feb 3, 2026

View reviewed changes

viktorsomogyi merged commit 79da621 into main Feb 3, 2026
5 checks passed

viktorsomogyi deleted the jeqo/release-workflow branch February 3, 2026 11:38

Conversation

jeqo commented Jan 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Docker Image Tags

Testing

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

jeqo commented Jan 20, 2026 •

edited

Loading