A standalone Dagger module of reusable CI checks and toolchain primitives. It does not contain product-specific deployment recipes.
Created at Exowatt.
Provided as-is. The functions are reusable examples and primitives, not a managed CI service or a support commitment.
Install Dagger CLI v0.21.10 or later and use this module by its public Go module path:
dagger call -m github.com/exowatt-oss/ci-dagger@main go --src=. --repo=my-projectThe first call resolves the module, starts a Dagger engine and runs the Go checks (go vet ./... and go test -race ./...) in a container. Pin a released module version in production workflows rather than using @main.
Use Dagger CLI v0.21.10 or later and a Dagger engine. The engine needs access to public package registries and container images used by the selected toolchain; no Exowatt service or credential is required.
Choose a primitive for the repository's toolchain. For example, run the default Go checks:
dagger call -m github.com/exowatt-oss/ci-dagger@main go --src=. --repo=my-projectRun a Node project's test and build scripts:
dagger call -m github.com/exowatt-oss/ci-dagger@main npm \
--src=. --repo=my-project --dir=frontend \
--scripts=typecheck,test,buildRun a command in a digest-pinned container for a toolchain that does not have a dedicated primitive:
dagger call -m github.com/exowatt-oss/ci-dagger@main container-run \
--src=. --repo=my-project \
--image=public.ecr.aws/docker/library/alpine:3.22@sha256:<verified-digest> \
--run='make test'The generic toolchain functions include go, rust, python-uv, python-plain, npm, pnpm, bun, and container-run. The ephemeral-db and drop-db functions are optional helpers for test runs using a caller-provided PostgreSQL server.
After checkout and installing the pinned Dagger CLI, a GitHub Actions job can call a function:
- name: Run checks with Dagger
run: dagger call -m github.com/exowatt-oss/ci-dagger@main go --src=. --repo=my-projectThe same Dagger invocation can run from a Woodpecker pipeline on any runner with Dagger CLI and engine access. This repository ships only its public GitHub Actions workflow; callers provide their own runner configuration and credentials. No internal deployment lane or runner setup is included.
This module's own .github/workflows/ci.yml shows the public GitHub-hosted lane for formatting, module generation and tests. The primitives themselves are runner-agnostic.
- Defaults are public and service-free. Package-index overrides and the dependency-image cache are unset by default. The toolchains use their public package registries unless you explicitly pass
--npm-registryor--pypi-index. - Dependency cache is optional. Pass
--dep-cache=<registry>/<path>,--dep-cache-usernameand--dep-cache-passwordto reuse an OCI dependency image. The registry must support HTTP Basic authentication for the OCI Distribution API; credentials are supplied as a Dagger secret. This cache is disabled by default, and no registry is assumed. Without these arguments, Dagger's engine cache is used. - Test workers default to 2 where supported; pass
--test-workers=0to leave worker selection to the tool. - PostgreSQL is optional. The
--pg-admin-urlinput is a Dagger secret for an external PostgreSQL server; it is never configured by default. Omit it when tests do not need a database. - Source filtering excludes VCS metadata, the local
.ci-daggerscratch directory and common build outputs. Use the--dir,--apt,--env,--dep-includeand--runarguments to adapt generic checks to a repository without changing this module. container-runimages must be pinned by digest. Set--allow-tag=trueonly when you intentionally accept a moving image tag.
No Exowatt identity, credentials, internal registry or service is needed. Optional registry, cache and database settings are supplied by each caller.
Original code is licensed under Apache-2.0. See NOTICE for attribution. The Dagger SDK and Go dependencies retain their respective licenses; consult their module metadata and upstream license files when redistributing binaries.
Contributions are welcome through GitHub pull requests. Sign off each commit with git commit -s to certify the Developer Certificate of Origin (DCO); the repository's DCO check enforces this. No CLA is required.
Please report vulnerabilities privately using GitHub private vulnerability reporting, or contact software@exowatt.com. Do not open a public issue for security reports.