GitHub Actions

Valqore ships a reusable composite action. Every pull request gets an automated comment with verdict, score delta, findings, cost comparison, carbon assessment, and architecture diagram.

Quick Start

uses: valqore/valqore-engine@master

Complete Workflow

# .github/workflows/valqore.yml
name: Valqore Analysis
 
on:
  pull_request:
    branches: [main, master]
    paths:
      - "k8s/**"
      - "manifests/**"
      - "helm/**"
      - "terraform/**"
 
permissions:
  contents: read
  pull-requests: write
 
jobs:
  valqore:
    name: Valqore Gate
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
 
      - name: Run Valqore
        uses: valqore/valqore-engine@master
        with:
          manifests: "k8s/"
          fail_on: block
          carbon_region: us-east-1
          carbon_budget: "50"
          include_score: "true"
          include_cost: "true"
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          VALQORE_API_KEY: ${{ secrets.VALQORE_API_KEY }}

Inputs

Input	Required	Default	Description
`manifests`	Yes	--	Glob or directory path to manifests.
`fail_on`	No	`block`	Verdict level that fails the check: `block`, `warn`, or `info`.
`carbon_region`	No	`us-east-1`	Cloud region for carbon calculations.
`carbon_budget`	No	`100`	Monthly carbon budget in kg CO2e.
`include_score`	No	`true`	Show overall score and delta in PR comment.
`include_cost`	No	`true`	Include cost comparison.

Auto-fix Commit

Enable auto_fix to let Valqore push a commit resolving auto-fixable findings:

- name: Run Valqore
  uses: valqore/valqore-engine@master
  with:
    manifests: "k8s/"
    fail_on: block
    auto_fix: "true"
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
    VALQORE_API_KEY: ${{ secrets.VALQORE_API_KEY }}