# Chainguard Checks

URL: https://edu.chainguard.dev/chainguard/checks.md

CI that runs each check in its own Chainguard microVM on every GitHub pull request, configured by a .chainguard/ci.yaml file in your repository.

## Pages

- [Chainguard Checks overview](https://edu.chainguard.dev/chainguard/checks/overview.md): Learn how Chainguard Checks runs your repository's CI checks in isolated microVMs on every GitHub pull request, with no network access unless a check asks for it.
- [Get started with Chainguard Checks](https://edu.chainguard.dev/chainguard/checks/getting-started.md): Sign up for Chainguard Checks, add a .chainguard/ci.yaml file to a repository, and see your first checks run on a GitHub pull request.
- [Chainguard Checks configuration reference](https://edu.chainguard.dev/chainguard/checks/configuration.md): Reference for the .chainguard/ci.yaml file that defines Chainguard Checks: file layouts, packages, commands, network access, conditions, triggers, resources, and environment variables.
- [Variations, inputs, services, and caches in Chainguard Checks](https://edu.chainguard.dev/chainguard/checks/variations-services-caches.md): Run a Chainguard Checks check once per variation, pass files between checks, check out another repository, start services such as a database, run checks as another user, and reuse Go build output with caches.
- [Workload identities and trust in Chainguard Checks](https://edu.chainguard.dev/chainguard/checks/identity-and-trust.md): Learn how a Chainguard Checks check gets short-lived Google Cloud or Chainguard credentials through a workload identity, how to limit which pull requests get one, and how to revoke access.
- [Use Chainguard Checks on GitHub](https://edu.chainguard.dev/chainguard/checks/github.md): Learn when Chainguard Checks runs on GitHub, how to read its results, and how to require checks before merging, rerun them, and run checks on request.
- [Run checks before you push with Chainguard Workspaces](https://edu.chainguard.dev/chainguard/checks/run-checks.md): Run your repository's checks against uncommitted changes in a Chainguard Workspaces session, and validate your Chainguard Checks configuration offline before you push.
- [Inspect and run checks with chainctl](https://edu.chainguard.dev/chainguard/checks/inspect-and-run-checks.md): Read a pull request's Chainguard Checks results and logs from your terminal, run checks on a pushed commit without a pull request, and find the checks that take the most time or fail most often.
- [Migrate from GitHub Actions to Chainguard Checks](https://edu.chainguard.dev/chainguard/checks/migrate-from-github-actions.md): Draft a Chainguard Checks configuration from GitHub Actions pull request workflows with chainctl, or convert workflows by hand with a mapping of common GitHub Actions keys.
- [chainctl checks command reference](https://edu.chainguard.dev/chainguard/checks/chainctl-checks-reference.md): Reference for the chainctl checks commands that inspect pull request runs, start and rerun checks, summarize check history, and validate your Chainguard Checks configuration.
- [Troubleshoot Chainguard Checks](https://edu.chainguard.dev/chainguard/checks/troubleshooting.md): Fix common problems with Chainguard Checks, including pull requests that get no checks, refused configurations, failed runs, checks that couldn't run, network errors, missing tools, and unused caches.