Operate / Releases
Release history.
Published versions, what changed, and what to check before an upgrade.
Current stable: v0.8.2 · Controller with module 0.8.1. Install and verify.
Controller releases · Module releases · Pre-release archive · Upgrade guidance
Controller releases
v0.8.2Current stable
UTC · Module 0.8.1
Distribution maintenance with updated licensing notices.
Includes the same runtime features as v0.8.1 and the same infrastructure behavior as module 0.8.0. Use module 0.8.1 with this release.
Downloads and usage notes
| Component | Published reference |
|---|---|
| Controller | ghcr.io/gondola-build/gondola@sha256:ac8d25877adc96a73c4be07c1f079b1d6502aab7d8f6bee863682199b0dacb53 |
| Module | gondola-build/gondola/aws · 0.8.1 |
| Public artifact bundle | ghcr.io/gondola-build/gondola:v0.8.2-artifacts |
Verify the signed manifest and checksums in this version's artifact bundle before deployment.
Usage notes
- Earlier controller downloads and module versions have been withdrawn. Use this release for new installations and retain verified local copies for your own rollback needs.
- CLI downloads were checked natively on Apple silicon, through Rosetta for Intel macOS, and in Docker for Linux. This release does not add native Intel validation or a new live AWS workload acceptance run.
v0.8.1
UTC · Module 0.8.0
Optional adaptive warm capacity and daily fleet launch allowances.
Adjust warm replenishment within configured bounds using recent queue observations, and reserve estimated launch cost in a durable per-fleet ledger. Both policies are off by default and can be enabled independently.
Historical usage notes
Downloads for this version have been withdrawn. Use the current stable release.
Usage notes
- Warm targets affect replenishment, not existing runners or instance sizing. Learning resets when the listener or controller restarts.
- Allowances reserve estimated cost for the full maximum runner lifetime and do not refund unused reservations. They are not actual AWS billing caps and exclude other infrastructure charges.
- A depleted allowance pauses new launches; existing jobs keep their normal lifecycle. Enabling budgets adds a DynamoDB ledger with its own storage and recovery charges.
- CLI downloads were checked natively on Apple silicon, through Rosetta for Intel macOS, and in Docker for Linux. This release did not add native Intel validation or a new live AWS workload acceptance run.
v0.7.0
UTC · Module 0.7.0
Approved EC2 alternatives and scheduled minimum runner capacity.
Configure ordered instance-type alternatives and weekly UTC windows that raise a fleet’s minimum during busy periods. Includes all earlier features.
Historical usage notes
Downloads for this version have been withdrawn. Use the current stable release.
Usage notes
- Ending a window stops replenishment; existing runners finish their job or reach their configured lifetime.
v0.6.0
UTC · Module 0.6.0
Job-to-instance correlation and optional bootstrap-stage diagnostics.
Follow observed jobs and EC2 instances through CloudWatch logs, retain validated bootstrap stages, and inspect queue-to-assignment timing when GitHub supplies it.
Historical usage notes
Downloads for this version have been withdrawn. Use the current stable release.
Usage notes
- Bootstrap collection is optional and best effort. Raw workflow output and runner diagnostic files are not uploaded.
v0.5.0
UTC · Module 0.5.0
Optional lean and development runner images, plus gp3 performance controls.
Choose a signed x64/ARM64 image profile and configure root-volume IOPS and throughput globally or per fleet. Includes caching and automatic entitlement renewal.
Historical usage notes
Downloads for this version have been withdrawn. Use the current stable release.
Usage notes
- Existing image and storage defaults remain unchanged until configured. Additional EBS performance adds AWS charges.
v0.4.0
UTC · Module 0.4.0
Optional automatic entitlement renewal in your AWS account.
A scheduled helper verifies and installs renewed tokens, refreshes the controller, and reports failed or missed checks through CloudWatch alarms. Includes existing S3 caching.
Historical usage notes
Downloads for this version have been withdrawn. Use the current stable release.
Usage notes
- Enable the helper explicitly with a separate activation-key secret and working alarm notifications.
v0.3.0
UTC · Module 0.3.0
Optional S3 caching for dependency directories and Docker builds.
Restore and save dependency directories or exported BuildKit layers using the Gondola CLI or included cache action. Supports immutable keys, prefix fallback, read-only access, and configurable retention.
Historical usage notes
Downloads for this version have been withdrawn. Use the current stable release.
Usage notes
- Caching is disabled by default. Enable it for selected trusted fleets and add explicit restore/save steps.
- Existing GitHub cache actions continue using GitHub’s cache service.
- S3 storage, requests, and transfer are billed to your AWS account.
v0.2.1
UTC · Module 0.2.2
Read-only installation checks and clearer GitHub App setup.
Adds the gondola doctor command and its packaged diagnostic guide. GitHub App setup accepts current client identifiers and selects the appropriate organization or repository configuration.
Historical usage notes
Downloads for this version have been withdrawn. Use the current stable release.
Usage notes
- Linux x64 and ARM64 on AWS with GitHub.com. Windows, macOS, and GitHub Enterprise Server are not supported.
- Managed caching and automatic entitlement renewal are not included in this version. Paid renewal still requires updating the entitlement secret and rolling out the controller.
- Spot launch fallback does not retry a job interrupted after launch.
v0.2.0
UTC · Module 0.2.2
First stable release of customer-owned GitHub Actions runners on AWS.
Linux x64 and ARM64 EC2 runner fleets on GitHub.com; Terraform/OpenTofu installation; active/passive controller coordination; one-job runners; lifetime cleanup; offline signed entitlements; and customer-owned CloudWatch operations.
Historical usage notes
Downloads for this version have been withdrawn. Use the current stable release.
Usage notes
- No Windows, macOS, GitHub Enterprise Server, Azure, or GCP execution.
- No built-in managed cache. Minimum runner capacity can keep idle runners available; a stopped-standby service is not included.
- Spot launch fallback is distinct from retrying a job interrupted after launch.
- Paid entitlement renewal requires a secret update and controller rollout.
Module releases
The Terraform/OpenTofu module is versioned separately. Use the module version paired with your controller release above.
| Version | Published (UTC) | Changes |
|---|---|---|
| v0.8.1 | Distribution maintenance; infrastructure behavior is unchanged from module 0.8.0. Pair with controller v0.8.2. | |
| v0.8.0 · Withdrawn | Adds optional adaptive warm pools and durable daily fleet launch allowances. Pair with controller v0.8.1. | |
| v0.7.0 · Withdrawn | Adds approved instance alternatives and UTC minimum-capacity windows. | |
| v0.6.0 · Withdrawn | Adds opt-in bootstrap-stage collection with scoped EC2 console access. | |
| v0.5.0 · Withdrawn | Adds global and per-fleet gp3 IOPS and throughput controls. | |
| v0.4.0 · Withdrawn | Adds the optional scheduled renewal helper, scoped permissions, and failure alarms. Includes S3 caching. | |
| v0.3.0 · Withdrawn | Adds optional customer-owned S3 caches with scoped runner access, read-only mode, and lifecycle retention. | |
| v0.2.2 · Withdrawn | Clarifies the scope of the module’s Apache 2.0 license. | |
| v0.2.1 · Withdrawn | Adds the Apache 2.0 license to the public infrastructure module. | |
| v0.2.0 · Withdrawn | Initial public Terraform/OpenTofu module: a Fargate controller and ephemeral x64 and ARM64 EC2 fleets, with on-demand and Spot capacity. |
Pre-release archive
Earlier alpha releases are listed for historical reference; their downloads have been withdrawn. Use the current stable release for a new installation.
Public alpha releases (3)
v0.2.0-alpha.6 · Alpha
UTC
Downloads withdrawn.
v0.2.0-alpha.5 · Alpha
UTC
Downloads withdrawn.
v0.2.0-alpha.4 · Alpha
UTC
Downloads withdrawn.
Before an upgrade
Pin the published image digest and paired module version. Review the Terraform plan before applying, and retain the previous version for rollback.