Skip to content

Releases

Version 1.3.1

Choose a tag to compare

@hoverkraft-bot hoverkraft-bot released this 16 Nov 18:56

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

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

Choose a tag to compare

@hoverkraft-bot hoverkraft-bot released this 12 Nov 16:15

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

  • feat(ansible): manage controller Python setup in test actions (#29) @neilime

New Contributors

No new contributors in this release.

Full Changelog: 1.2.0...1.3.0

Version 1.2.0

Choose a tag to compare

@hoverkraft-bot hoverkraft-bot released this 12 Nov 10:23
49d8c32

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

  • feat(opentofu): add native test action and reports (#23) @neilime

Dependency Updates

Bug Fixes

Documentation

New Contributors

No new contributors in this release.

Full Changelog: 1.1.1...1.2.0

Version 1.1.1

Choose a tag to compare

@hoverkraft-bot hoverkraft-bot released this 09 Nov 19:07
31c11f7

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

New Contributors

No new contributors in this release.

Full Changelog: 1.1.0...1.1.1

Version 1.1.0

Choose a tag to compare

@hoverkraft-bot hoverkraft-bot released this 09 Nov 07:08

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

  • feat(test): support consolidated CI reporting (#14) @neilime

Dependency Updates

6 changes

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

Choose a tag to compare

@neilime neilime released this 04 Nov 18:11
89e3bf9

Features

  • Create disposable VMs with one vm/create action: 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.command or test-script with the required checkout-relative goss-file, plus optional goss-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-mapping and github-token. The action publishes its native Goss test reports automatically, uses github.token for eligible PR comments and no longer uploads application coverage to Codecov.
  • Configure Ansible inventory and collection search paths through ansible-config instead of the removed ansible/test.inventory and collections-path inputs. Remove its github-token input.
  • Remove references to outputs from vm/test and ansible/test, vm/create.id, and vm/destroy.removed. Test actions publish reports directly. Creation retains vm and name and adds ssh-config for provisioning and Molecule.
  • Keep vm-config explicit. 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

Choose a tag to compare

@neilime neilime released this 29 Oct 17:45

Features

  • Add actions/ansible/test for explicit test playbooks and collection sanity checks. It composes dawidd6/action-ansible-playbook and ansible-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.yml

See 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

Choose a tag to compare

@neilime neilime released this 29 Oct 10:58
7084336

First release of Hoverkraft's GitHub Actions for testing infrastructure in disposable virtual machines.

  • actions/vm/create installs 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/test runs 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/destroy verifies 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