Repository navigation
Releases
Version 1.3.1
Release Summary
Updated documentation for the ansible, opentofu, and VM actions and workflows.
Internally, CI workflows were updated and aligned across validation, release, and documentation processes, and shared actions and workflows were refreshed with immutable pins and dependency updates.
Breaking changes
There is no breaking change.
What's Changed
Documentation
- docs: update actions and workflows documentation (#30) @hoverkraft-bot[bot]
Maintenance
- ci: update shared actions and workflows (#32) @neilime
- ci: align validation, releases and documentation workflows (#31) @neilime
New Contributors
No new contributors in this release.
Full Changelog: 1.3.0...1.3.1
Version 1.3.0
Release Summary
For the ansible scope, test actions now manage controller Python setup themselves and accept an optional checkout-relative python-version-file. The playbook action also adds its isolated environment to PATH after Python setup so the maintained execution action uses the pinned Ansible installation.
Internal validation and documentation were refreshed for this change.
Breaking changes
There is no confirmed breaking change.
What's Changed
Features
New Contributors
No new contributors in this release.
Full Changelog: 1.2.0...1.3.0
Version 1.2.0
Release Summary
Added a native OpenTofu test action with reports. Fixed Ansible support for rebuilt sanity test images.
Internal changes updated the Lima dependency to v2.3.0, updated the ci-dokumentor CLI Docker tag to v0.6.0, and refreshed actions and workflows documentation.
Breaking changes
There is no breaking change.
What's Changed
Features
Dependency Updates
- chore(deps): update dependency lima-vm/lima to v2.3.0 (#26) @hoverkraft-bot[bot]
- chore(deps): update ghcr.io/hoverkraft-tech/ci-dokumentor/cli docker tag to v0.6.0 (#27) @hoverkraft-bot[bot]
Bug Fixes
- fix(ansible): support rebuilt sanity test images (#22) @dependabot[bot] and @neilime
Documentation
- docs: update actions and workflows documentation (#28) @hoverkraft-bot[bot]
- docs: update actions and workflows documentation (#25) @hoverkraft-bot[bot]
- docs: update actions and workflows documentation (#24) @hoverkraft-bot[bot]
New Contributors
No new contributors in this release.
Full Changelog: 1.1.1...1.2.0
Version 1.1.1
Release Summary
Documentation was updated for actions and workflows, including the READMEs for ansible test-molecule, ansible test, vm create, vm destroy, and vm test.
There were no fixes or internal changes in this release.
Breaking changes
There is no breaking change.
What's Changed
Documentation
- docs: update actions and workflows documentation (#21) @hoverkraft-bot[bot]
New Contributors
No new contributors in this release.
Full Changelog: 1.1.0...1.1.1
Version 1.1.0
Release Summary
Test actions now support consolidated CI reporting, allowing callers to publish a shared PR report while preserving job summaries, annotations, and artifacts. Artifact naming was updated so the shared publisher can collect results from the current run attempt without stale reports.
Internal changes updated actions, reusable workflows, and development dependencies, added release preparation and publication workflows, aligned commit checks with repository configuration, and adjusted test timing for uploaded report discovery.
Breaking changes
There is no breaking change.
What's Changed
Features
Dependency Updates
6 changes
- build(deps): update actions and workflows to latest releases (#19) @neilime
- chore(deps-dev): update GitHub Toolkit test helpers for ESM (#10) @dependabot[bot]
- chore(deps): update node.js to v26 (#12) @hoverkraft-bot[bot]
- chore(deps): bump actions/create-github-app-token from 3.2.0 to 3.3.0 (#2) @dependabot[bot]
- chore(deps): bump hoverkraft-tech/docker-base-images/super-linter from 1.1.0 to 2.0.0 (#3) @dependabot[bot]
- chore(deps): bump renovatebot/github-action from 46.3.8 to 46.3.10 (#9) @dependabot[bot]
Maintenance
- ci: add release preparation and publication workflows (#20) @neilime
- ci: align commit checks with repository configuration (#13) @neilime
- test: wait for uploaded report discovery (#11) @neilime
New Contributors
No new contributors in this release.
Full Changelog: 1.0.0...1.1.0
1.0.0
Features
- Create disposable VMs with one
vm/createaction: choose Lima for provisioned cloud images or direct QEMU for unattended installer ISOs and QCOW2 images. Both backends expose the same VM and SSH references. - Verify guest state with Goss through
vm/test. The action downloads the checksum-pinned verifier, renders suites and variables, uses fresh SSH logins, and publishes native JUnit, summaries, annotations, PR comments and artifacts, including after assertion failures. - Run native Ansible Molecule scenarios through
ansible/test-molecule. Scenarios own their inventory, target environment and deployment, idempotence, verification and reboot sequence; a VM is optional. - Preserve workflow-owned VM lifetime, startup rollback, bounded execution, failure reporting and verified cleanup. Empty assertion suites fail.
Breaking changes and upgrading from 0.2.0
- Replace
vm/test.commandortest-scriptwith the required checkout-relativegoss-file, plus optionalgoss-vars. Move provisioning into dedicated workflow steps or Molecule scenarios. Test commands inside Goss remain available for consumer-owned assertions. - Remove
vm/test.report-file,coverage,path-mappingandgithub-token. The action publishes its native Goss test reports automatically, usesgithub.tokenfor eligible PR comments and no longer uploads application coverage to Codecov. - Configure Ansible inventory and collection search paths through
ansible-configinstead of the removedansible/test.inventoryandcollections-pathinputs. Remove itsgithub-tokeninput. - Remove references to outputs from
vm/testandansible/test,vm/create.id, andvm/destroy.removed. Test actions publish reports directly. Creation retainsvmandnameand addsssh-configfor provisioning and Molecule. - Keep
vm-configexplicit. Use all VM actions in the same job and always schedule destruction, including after test failures. Use ephemeral Linux x86-64 runners with KVM and enough disk and memory for the configured guest.
Usage
Pin related actions to 89e3bf93adc94b592188e714f61d4abc391aab46 (1.0.0). After checkout:
- name: Create VM
id: vm
uses: hoverkraft-tech/ci-github-iac/actions/vm/create@89e3bf93adc94b592188e714f61d4abc391aab46 # 1.0.0
with:
vm-config: tests/lima.yml
- name: Verify VM
uses: hoverkraft-tech/ci-github-iac/actions/vm/test@89e3bf93adc94b592188e714f61d4abc391aab46 # 1.0.0
with:
vm: ${{ steps.vm.outputs.vm }}
goss-file: tests/goss.yaml
- name: Destroy VM
if: ${{ always() && steps.vm.outputs.vm != '' }}
uses: hoverkraft-tech/ci-github-iac/actions/vm/destroy@89e3bf93adc94b592188e714f61d4abc391aab46 # 1.0.0
with:
vm: ${{ steps.vm.outputs.vm }}Grant contents: read for checkout and pull-requests: write for PR comments. See the VM creation reference, Goss reference, and Molecule reference.
Validation
Merged-main CI passed: 43 unit tests, lint/security checks, Lima and QEMU lifecycle scenarios, fresh SSH group membership, successful/failed/empty/timed-out Goss suites, native reports, Ansible playbook/collection checks and Molecule deployment, idempotence, reboot and cleanup.
Full changelog: 0.2.0...1.0.0
0.2.0
Features
- Add
actions/ansible/testfor explicit test playbooks and collection sanity checks. It composesdawidd6/action-ansible-playbookandansible-community/ansible-test-gh-action; linting remains separate. - Publish native JUnit reports as job summaries, annotations, PR comments and artifacts, including after test failures.
- Read the consumer's exact Ansible Core requirement and support an optional target Python version for collection sanity. Use a workflow matrix for multiple collections.
The existing VM action implementations are unchanged from 0.1.0.
Usage
Pin consumers to 5c4b7307d7a2c58a01a3b62607cebde65f96b0a2 (0.2.0). Test playbooks execute assertions against consumer-prepared disposable environments.
- uses: hoverkraft-tech/ci-github-iac/actions/ansible/test@5c4b7307d7a2c58a01a3b62607cebde65f96b0a2 # 0.2.0
with:
ansible-requirements: ansible/requirements.txt
test-playbook: tests/ansible/test.ymlSee the Ansible action reference for inputs, outputs and reporting permissions.
Validation
Merged-main CI passed: 45 unit tests, lint/security checks, playbook and collection success/failure scenarios, and VM lifecycle scenarios.
Full changelog: 0.1.0...0.2.0
0.1.0
First release of Hoverkraft's GitHub Actions for testing infrastructure in disposable virtual machines.
actions/vm/createinstalls Lima and QEMU, starts a guest from a required consumer configuration, and rolls back failed startup. It exports the private runtime and instance name for subsequent actions and host-side tools.actions/vm/testruns guest Bash commands or a test script, collects selected test and coverage reports, and publishes GitHub summaries, annotations, PR comments and artifacts. Optional Codecov upload uses OIDC.actions/vm/destroyverifies guest deletion before removing its runtime and keys. Workflows retain control of test sequencing and application-specific cleanup.
Use an ephemeral Linux x86-64 runner with KVM. Pin all VM actions to 70843368d5f5f7b0a2cec1e8435d81cc40beee64 (0.1.0), and schedule destruction after failures. See the action references and prerequisites.
Validation: merged-main CI passed unit, static/security and hosted VM scenarios covering successful execution and startup, assertion and reporting failures. The identical action source passed workstation-manager's complete consumer scenario, including verified browser-device removal and VM destruction. A live Codecov upload has not been exercised.
Included change: #1