OpsScript Gate v0.9.4
Runtime Verification Gate for Shell Scripts

ShellCheck passed with zero warnings.
Your installer still crashed on Alpine.

Syntax linters inspect AST tokens and quoting rules, but cannot determine whether external binaries exist on target systems. OpsScript Gate runs your scripts inside isolated, unprivileged container matrices to catch missing commands, dialect traps, and unattended hangs before release.

Debug command not found Try Interactive Simulator
Section 01 • Example walkthrough

Explore compatibility examples

Illustrative results only. This page does not run ShellCheck or execute scripts. Use the Action to verify your script in real containers.

File: install.sh
Local editor • edited scripts remain unverified 8 lines
ShellCheck example output 0 WARNINGS
Validates AST syntax structure and POSIX variable expansion rules.
Blind Spot: Cannot verify whether external packages or binaries exist on target image.
OpsScript Gate example output 1 DISTRO FAILED
Executes in unprivileged, isolated containers across Linux distributions.
Resolution: Captures container exit codes, exact missing commands, and line annotations.
Remediation Suggestion Exit Code 127

The execution path calls apt-get. Alpine Linux base images use apk, resulting in termination at line 6.

# Portable conditional dispatch across package managers:
if command -v apt-get >/dev/null 2>&1; then apt-get update -qq && apt-get install -y curl;
elif command -v apk >/dev/null 2>&1; then apk add --no-cache curl; fi
Section 02 • CI Summary Artifact

GitHub Actions Summary Integration

OpsScript Gate writes formatted tables directly to $GITHUB_STEP_SUMMARY and emits native workflow annotations.

Distribution Result Exit Code Duration Diagnostic
debian:12-slim PASS 0 0.24s -
ubuntu:22.04 PASS 0 0.28s -
ubuntu:24.04 PASS 0 0.31s -
alpine:3.20 FAIL 127 0.18s apt-get: not found (line 6)
::error file=install.sh,line=6,title=OpsScript Gate (alpine:3.20)::command not found: apt-get. Hint: Alpine uses apk instead of apt-get.
Section 03 • Pipeline Automation

Workflow Definition

Executes locally within the runner Docker daemon without tokens, external webhooks, or account setup.

Testing a downloading installer? A zero exit code alone does not prove installation succeeded. Use the installation smoke test guide to check the installed binary inside each container.

.github/workflows/gate.yml 
# OpsScript Gate - Cross-distribution runtime verification
name: Script Runtime Compatibility
on: [push, pull_request]

jobs:
  compatibility:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
        with:
          persist-credentials: false
      - name: Validate scripts across distributions
        uses: Mresyzz/opsscript-gate@v0.9.4
        with:
          script-path: ./install.sh
          shell: auto
          timeout: 120
Runs in your GitHub Actions runner

Ready to secure your scripts across Linux distributions?

Embed container verification into your GitHub Actions workflow in less than two minutes. Zero tokens, zero external servers.

View on GitHub