Stacks sBTC Github Actions

Monorepo of composite actions used in the stacks-sbtc organisation

• attest-build-provenance - Generate signed build provenance attestations for workflow artifacts
• aws - Actions used for AWS configuration/login
• cache - Create and use caches
• checkout - Clone the repository in the calling runner
• cleanup - Removes unused packages/dirs from a runner, freeing around 30GB of space on a runner
• docker - Setup docker on the runner and optionally log in to dockerhub
• download-artifact - Download one or more artifacts from GitHub
• github-pages - Configure, upload and deploy GitHub Pages
• github-script - Execute JavaScript code within the runner
• install-action - Install development tools
• setup-buf - Install buf tool to build, lint and format
• setup-mold - Install mold linker
• setup-node - Install Node.js
• setup-pnpm - Install pnpm package manager
• setup-python - Install Python
• setup-rust-toolchain - Install Rust toolchain with additional components
• setup-uv - Set up GitHub Actions workflow with a specific version of uv
• upload-artifact - Upload an artifact to the GitHub's workflow
• wait-other-jobs - Wait for all or specific jobs to finish

Repo Structure

This repo is structured as a typical monorepo, with agnostic composite actions at the top level. Repository specific composite actions are added at the top level, for example ./aws/amazon-ecr-login.

At a minimum, any new composite actions will need the following 2 files:

• action.yml - The composite action workflow (ex: docker/action.yml)
• README.md - How to use the composite action (ex: docker/README.md)

There may or may not be additional folders/logic depending upon the complexity of the workflow, the above 2 files are the minimum requirement.