Hoverkraft GitHub Actions and Reusable Workflows
website·Indexed 30 days ago
https://docs.hoverkraft.cloudDocumentation for a collection of GitHub Actions and reusable workflows, including ci-github-publish for release management and ArgoCD deployments, ci-github-container for Docker image builds, and ci-github-nodejs for linting and testing. Features specialized actions for release planning, changelog summarization, Lighthouse URL checks, and OVH MKS scaling.
What's inside Hoverkraft
- ci-github-publish provides a set of opinionated GitHub Actions and reusable workflows designed to streamline the release, deployment, and publishing processes.
Overview of ci-github-common automation tools
Theci-github-commonlibrary provides a set of opinionated GitHub Actions and reusable workflows designed for foundational continuous-integration automation. It includes tools for repository automation, matrix data handling, repository insights, community hygiene, and quality gates.Overview of the Hoverkraft Methodology
The Hoverkraft methodology is a framework of practices, tools, and workflows designed for efficient, high-quality software development. It is built on six core pillars: Modularity (reusable components), Consistency (standardized approaches), Automation (CI/CD), Quality (built-in checks), Security (security-first approach), and Community (open-source collaboration).Overview of Hoverkraft Node.js CI Toolkit
The Hoverkraft toolkit provides opinionated GitHub Actions and reusable workflows designed to standardize Node.js continuous integration (CI) pipelines. It consists of composite actions for environment setup, dependency management, and CI steps (build, lint, test), as well as reusable workflows for full CI and release processes.Overview of hoverkraft ci-github-container
Theci-github-containerproject provides opinionated GitHub Actions and reusable workflows designed to create a consistent, supply-chain friendly pipeline for OCI assets (container images and Helm charts) managed within GitHub Actions. It covers the entire lifecycle from building and testing to signing and distribution.Overview of Clean Deploy - ArgoCD App Of Apps workflow
Theclean-deploy-argocd-app-of-appsreusable workflow is used to clean a deployment in an ArgoCD App Of Apps Pattern context. It is typically triggered by arepository_dispatchevent with the event typeclean-deploy. The expected payload for the dispatch event includes the repository name and the environment name.{ "event_type": "clean-deploy", "client_payload": { "repository": "repository name (e.g. my-repository)", "environment": "environment name (e.g. production, review-apps:pr-1234)" } }Overview of the parse-ci-reports GitHub Action
The
parse-ci-reportsaction parses reports from testing, linting, and coverage tools to provide visibility into CI diagnostics. It generates three types of output:- GitHub Step Summaries: For workflow runs.
- Markdown: Suitable for pull request or issue comments.
- GitHub Annotations: For failed tests and linting issues.
Overview of the Hoverkraft open-source ecosystem
Hoverkraft (also known as openkraft) is a collection of open-source projects dedicated to building developer-friendly tools and technologies. The ecosystem provides high-quality, well-documented software aimed at empowering developers.Overview of Hoverkraft Golden Paths
Hoverkraft Golden Paths are opinionated sequences for setting up new repositories with a standardized structure, workflows, and configurations. They leverage reusable components to automate CI/CD, releases, and maintenance, ensuring consistency across projects and reducing the infrastructure burden on developers. Key benefits include built-in semantic PR validation, automated testing, security scanning, and Dependabot integration for keeping workflows and dependencies current.Overview of the release-actions reusable workflow
Therelease-actionsreusable workflow automatically detects changes in GitHub Actions and workflow files, generates or updates their corresponding README documentation (including version updates), and publishes these changes back to the repository via a pull request. When pushed to the default branch, it publishes the documentation to GitHub Pages.Overview of the testcontainers-node test runner
Thetestcontainers-nodeimage provides a consistent environment for running integration tests against other Docker images. It is based on Node.js 25 Alpine and includes thetestcontainerslibrary and its dependencies. Tests are executed via Docker, and test files are mounted at runtime from the specific image directories rather than being baked into the image.Overview of the clean-deploy reusable workflow
The
clean-deployreusable workflow is designed to remove one or more deployments and execute a follow-up cleanup action (e.g., arepository-dispatchevent) to handle repository-specific cleanup. It can be triggered on-demand via a specific comment trigger (defaulting to/undeploy).Key behaviors include:
- Deleting matching deployments using a local action.
- Exposing deleted environments in the
environmentsstep output. - Optionally triggering a configured clean action and posting a summary comment if environments were deleted.