Install OpenTelemetry Weaver CLI in your GitHub Actions workflows.
steps:
- uses: actions/checkout@v4
- name: Setup Weaver
uses: open-telemetry/weaver/.github/actions/setup-weaver@main # You can use any git ref: @main, @v0.20.0, or @commit-sha
# with:
# version: '0.18.0' # Optional: pin Weaver CLI version
- name: Validate semantic conventions
run: weaver registry check -r ./model --diagnostic-format gh_workflow_commandFor complete workflow examples, see opentelemetry-weaver-examples.
| Input | Description | Required | Default |
|---|---|---|---|
version |
Weaver version to install (e.g., 0.18.0). Omit for latest release. |
No | '' (latest) |
cache |
Enable caching of Weaver binary for faster subsequent runs | No | 'true' |
| Output | Description |
|---|---|
version |
Installed Weaver version (e.g., v0.18.0) |
By default, this action caches the Weaver binary to speed up subsequent runs.
- Cache key:
setup-weaver-{os}-{arch}-{version} - First run: ~30-60 seconds (download + install)
- Cached run: ~2-5 seconds (restore from cache)
To disable caching:
- uses: open-telemetry/weaver/.github/actions/setup-weaver@main
with:
cache: 'false'| Platform | Architecture | Status |
|---|---|---|
| Ubuntu (Linux) | x86_64 | ✅ Supported |
| macOS | x86_64 (Intel) | ✅ Supported |
| macOS | aarch64 (Apple Silicon) | ✅ Supported |
| Windows | x86_64 | ✅ Supported |
The action automatically detects your platform and architecture.
Command not found: Ensure the setup step completed successfully and you're running commands after the setup step.
Cache issues: Temporarily disable caching with cache: 'false' or clear cache in repository settings (Actions → Caches).
Version issues: Pin to a known working version with version: '0.18.0'.
For more information:
- opentelemetry-weaver-examples - Complete workflow examples
- Weaver documentation - CLI commands and usage
- Weaver releases - Version history and changelogs